@decaf-ts/for-nest 0.11.2 → 0.12.0

package/lib/cjs/decaf-model/FromModelController.cjs

@@ -15,9 +15,7 @@ var __metadata = (this && this.__metadata) || function (k, v) {
     if (typeof Reflect === "object" && typeof Reflect.metadata === "function")
         return Reflect.metadata(k, v);
 };
-var __param = (this && this.__param) || function (paramIndex, decorator) {
-    return function (target, key) { decorator(target, key, paramIndex); };
-};
+var DynamicModelController_1;
 const common_1 = require("@nestjs/common");
 const swagger_1 = require("@nestjs/swagger");
 const core_1 = require("@decaf-ts/core");
@@ -26,64 +24,24 @@ const logging_1 = require("@decaf-ts/logging");
 const db_decorators_1 = require("@decaf-ts/db-decorators");
 const decoration_1 = require("@decaf-ts/decoration");
 const index_js_1 = require("./decorators/index.cjs");
+const utils_js_1 = require("./decorators/utils.cjs");
 const index_js_2 = require("./../request/index.cjs");
 const constants_js_1 = require("./../constants.cjs");
-const utils_js_1 = require("./utils.cjs");
-const decorators_js_1 = require("./decorators/decorators.cjs");
+const constants_js_2 = require("./../auth/constants.cjs");
+const decorators_js_1 = require("./../auth/decorators.cjs");
 const controllers_js_1 = require("./../controllers.cjs");
 const DtoBuilder_js_1 = require("./../factory/openapi/DtoBuilder.cjs");
 require("./../overrides/index.cjs");
-/**
- * @description
- * Factory and utilities for generating dynamic NestJS controllers from Decaf {@link Model} definitions.
- *
- * @summary
- * The `FromModelController` class provides the infrastructure necessary to automatically generate
- * strongly-typed CRUD controllers based on a given {@link ModelConstructor}. It inspects metadata from
- * the model, derives route paths, parameters, and generates a dynamic controller class at runtime with
- * full support for querying, creation, update, and deletion of model entities through a {@link Repo}.
- *
- * @template T The {@link Model} type associated with the generated controller.
- *
- * @param ModelClazz The model class to generate the controller from.
- *
- * @class FromModelController
- *
- * @example
- * ```ts
- * // Given a Decaf Model:
- * class User extends Model<User> {
- *   id!: string;
- *   name!: string;
- * }
- *
- * // Register controller:
- * const UserController = FromModelController.create(User);
- *
- * // NestJS will expose:
- * // POST   /user
- * // GET    /user/:id
- * // GET    /user/query/:method
- * // PUT    /user/:id
- * // DELETE /user/:id
- * ```
- *
- * @mermaid
- * sequenceDiagram
- *     participant Client
- *     participant Controller
- *     participant Repo
- *     participant DB
- *
- *     Client->>Controller: HTTP Request
- *     Controller->>Repo: Resolve repository for Model
- *     Repo->>DB: Execute DB operation
- *     DB-->>Repo: DB Result
- *     Repo-->>Controller: Model Instance(s)
- *     Controller-->>Client: JSON Response
- */
+const server_1 = require("@decaf-ts/for-http/server");
 class FromModelController {
     static { this.log = logging_1.Logging.for(FromModelController.name); }
+    static toDecafError(error, fallbackMessage) {
+        if (error instanceof db_decorators_1.BaseError)
+            return error;
+        return new db_decorators_1.InternalError(error instanceof Error
+            ? `${fallbackMessage}: ${error.message}`
+            : fallbackMessage);
+    }
     static getPersistence(ModelClazz) {
         try {
             return core_1.Service.get(ModelClazz);
@@ -91,756 +49,537 @@ class FromModelController {
         catch (e) {
             try {
                 return core_1.ModelService.getService(ModelClazz);
-                // eslint-disable-next-line @typescript-eslint/no-unused-vars
             }
-            catch (e) {
+            catch (e2) {
                 return core_1.Repository.forModel(ModelClazz);
             }
         }
     }
     static createQueryRoutesFromRepository(persistence, prefix = core_1.PersistenceKeys.QUERY) {
-        const log = FromModelController.log.for(FromModelController.createQueryRoutesFromRepository);
         const repo = persistence instanceof core_1.ModelService ? persistence.repo : persistence;
-        const ModelConstr = repo.class;
         const queryMethods = decoration_1.Metadata.get(repo.constructor, decoration_1.Metadata.key(core_1.PersistenceKeys.QUERY)) ?? {};
         const routeMethods = decoration_1.Metadata.get(persistence.constructor, decoration_1.Metadata.key(constants_js_1.DECAF_ROUTE)) ?? {};
-        // create base class
         class QueryController extends controllers_js_1.DecafModelController {
             get class() {
-                throw new Error("Method not implemented.");
+                throw new db_decorators_1.InternalError("Method not implemented.");
             }
             constructor(clientContext, name) {
                 super(clientContext, name);
             }
         }
         for (const [methodName, params] of Object.entries(routeMethods)) {
-            // regex to trim slashes from start and end
             const routePath = [params.path.replace(/^\/+|\/+$/g, "")]
                 .filter((segment) => segment && segment.trim())
                 .join("/");
-            // const handler = params.handler.value;
-            const handler = (0, utils_js_1.createRouteHandler)(methodName);
-            if (!handler) {
-                const message = `Invalid or missing handler for model ${ModelConstr.name} on decorated method ${methodName}`;
-                log.error(message);
-                throw new Error(message);
-            }
-            const descriptor = (0, utils_js_1.defineRouteMethod)(QueryController, methodName, handler);
-            if (descriptor) {
-                const decorators = (0, utils_js_1.getApiDecorators)(methodName, routePath, params.httpMethod);
-                (0, utils_js_1.applyApiDecorators)(QueryController, methodName, descriptor, decorators);
-            }
+            const handler = FromModelController.createComplexQueryHandler(methodName);
+            FromModelController.defineMethod(QueryController, methodName, handler);
+            const httpDecorator = (0, utils_js_1.HttpVerbToDecorator)(params.httpMethod)(routePath || undefined);
+            const decorators = FromModelController.getQueryDecorators(methodName, routePath, params.httpMethod);
+            FromModelController.applyDecorators(QueryController, methodName, [
+                httpDecorator,
+                ...decorators,
+            ]);
         }
         for (const [methodName, objValues] of Object.entries(queryMethods)) {
             const fields = objValues.fields ?? [];
             const routePath = [prefix, methodName, ...fields.map((f) => `:${f}`)]
                 .filter((segment) => segment && segment.trim())
                 .join("/");
-            const handler = (0, utils_js_1.createRouteHandler)(methodName);
-            const descriptor = (0, utils_js_1.defineRouteMethod)(QueryController, methodName, handler);
-            if (descriptor) {
-                const decorators = (0, utils_js_1.getApiDecorators)(methodName, routePath, "GET", true);
-                (0, utils_js_1.applyApiDecorators)(QueryController, methodName, descriptor, decorators);
-            }
+            const handler = FromModelController.createComplexQueryHandler(methodName);
+            FromModelController.defineMethod(QueryController, methodName, handler);
+            const httpDecorator = (0, utils_js_1.HttpVerbToDecorator)("GET")(routePath || undefined);
+            const decorators = FromModelController.getQueryDecorators(methodName, routePath, "GET", true);
+            FromModelController.applyDecorators(QueryController, methodName, [
+                httpDecorator,
+                ...decorators,
+            ]);
         }
         return QueryController;
     }
-    static create(ModelConstr) {
+    static create(ModelConstr, moduleConfigOverrides, globalDefaults) {
         const log = FromModelController.log.for(FromModelController.create);
         const tableName = decorator_validation_1.Model.tableName(ModelConstr);
         const routePath = (0, logging_1.toKebabCase)(tableName);
         const modelClazzName = ModelConstr.name;
         const persistence = FromModelController.getPersistence(ModelConstr);
-        // eslint-disable-next-line @typescript-eslint/no-unused-vars
-        const { description, getPK, apiProperties, path } = FromModelController.getRouteParametersFromModel(ModelConstr);
-        log.debug(`Creating controller for model: ${modelClazzName}`);
-        const BaseController = FromModelController.createQueryRoutesFromRepository(persistence // instanceof ModelService ? persistence.repo : persistence
-        );
-        let DynamicModelController = class DynamicModelController extends BaseController {
+        // When persistence is a ModelService, the @query/@route metadata lives on
+        // the underlying repository class (custom repo), not on ModelService itself.
+        // Pass the repo to the factory so addComplexQueries() can discover them.
+        const factoryPersistence = persistence instanceof core_1.ModelService ? persistence.repo : persistence;
+        const decoratorConfig = decoration_1.Metadata.get(ModelConstr, decoration_1.Metadata.key(constants_js_1.DECAF_CONTROLLER_CONFIG));
+        const moduleOverride = moduleConfigOverrides?.[ModelConstr.name];
+        const mergedConfig = {
+            ...(globalDefaults || {}),
+            ...(decoratorConfig || {}),
+            ...(moduleOverride || {}),
+        };
+        const FactoryController = server_1.ModelControllerFactory.create(ModelConstr, factoryPersistence, mergedConfig);
+        const factoryRoutes = FactoryController.__routes__;
+        const { getPK, apiProperties, path: pkPath, } = FromModelController.getRouteParametersFromModel(ModelConstr);
+        log.debug(`Creating controller for model: ${modelClazzName} with ${factoryRoutes?.length ?? 0} factory routes`);
+        const authConfig = mergedConfig.auth;
+        function applyClassAuth(target) {
+            if (authConfig?.public) {
+                (0, decorators_js_1.Public)()(target);
+            }
+            else if (authConfig?.roles?.length) {
+                (0, decorators_js_1.RequireRoles)(...authConfig.roles)(target);
+            }
+            else {
+                (0, decorators_js_1.Auth)(ModelConstr)(target);
+            }
+            if (authConfig?.skipModelRoles) {
+                (0, common_1.SetMetadata)(constants_js_2.SKIP_MODEL_ROLES_KEY, true)(target);
+            }
+        }
+        let DynamicModelController = DynamicModelController_1 = class DynamicModelController extends controllers_js_1.DecafModelController {
             static get class() {
                 return ModelConstr;
             }
             get class() {
                 return ModelConstr;
-                // return DynamicModelController.class;
             }
             constructor(clientContext) {
-                super(clientContext);
+                super(clientContext, DynamicModelController_1.name);
                 this.pk = decorator_validation_1.Model.pk(ModelConstr);
                 log.info(`Registering dynamic controller for model: ${this.class.name} route: /${routePath}`);
             }
-            //
-            // @ApiOperationFromModel(ModelClazz, "GET", "query/:condition/:orderBy")
-            // @ApiOperation({ summary: `Retrieve ${modelClazzName} records by query.` })
-            // @ApiParam({ name: "method", description: "Query method to be called" })
-            // @ApiOkResponse({
-            //   description: `${modelClazzName} retrieved successfully.`,
-            // })
-            // @ApiNotFoundResponse({
-            //   description: `No ${modelClazzName} records matches the query.`,
-            // })
-            // async query(
-            //   @Param("condition") condition: Condition<any>,
-            //   @Param("orderBy") orderBy: string,
-            //   @QueryDetails() details: DirectionLimitOffset,
-            // ) {
-            //   const {direction, limit, offset} = details;
-            //   return this.persistence.query(condition, orderBy as keyof Model, direction, limit, offset);
-            // }
-            async listBy(key, details) {
-                const { ctx } = (await this.logCtx([], core_1.PreparedStatementKeys.LIST_BY, true)).for(this.listBy);
-                return this.persistence(ctx).listBy(key, details.direction, ctx);
-            }
-            async paginateBy(key, details) {
-                const { ctx } = (await this.logCtx([], core_1.PreparedStatementKeys.PAGE_BY, true)).for(this.paginateBy);
-                return this.persistence(ctx).paginateBy(key, details.direction, details, ctx);
-            }
-            async find(value, details) {
-                const { ctx } = (await this.logCtx([], core_1.PreparedStatementKeys.FIND, true)).for(this.find);
-                const direction = (details.direction ??
-                    core_1.OrderDirection.ASC);
-                return (0, utils_js_1.resolvePersistenceMethod)(this.persistence(ctx), this.find.name, value, direction, ctx);
-            }
-            async page(value, details) {
-                const { ctx } = (await this.logCtx([], core_1.PreparedStatementKeys.PAGE, true)).for(this.page);
-                const { direction = core_1.OrderDirection.ASC, limit, offset, bookmark, } = details;
-                const ref = {
-                    offset: offset ?? 1,
-                    limit: limit ?? 10,
-                    bookmark,
-                };
-                return (0, utils_js_1.resolvePersistenceMethod)(this.persistence(ctx), this.page.name, value, direction, ref, ctx);
-            }
-            async findOneBy(key, value) {
-                const { ctx } = (await this.logCtx([], core_1.PreparedStatementKeys.FIND_ONE_BY, true)).for(this.findOneBy);
-                return this.persistence(ctx).findOneBy(key, value, ctx);
-            }
-            async findBy(key, value, details) {
-                const { ctx } = (await this.logCtx([], core_1.PreparedStatementKeys.FIND_BY, true)).for(this.findBy);
-                return this.persistence(ctx)
-                    .for(ctx.toOverrides())
-                    .findBy(key, value, ctx);
-            }
-            async statement(name, args, details) {
-                const { ctx } = (await this.logCtx([], core_1.PersistenceKeys.STATEMENT, true)).for(this.statement);
-                const { direction, offset, limit, bookmark } = details;
-                args = args.map((a) => (typeof a === "string" ? parseInt(a) : a) || a);
-                const pathDirection = args.length > 1 ? args[1] : undefined;
-                const resolvedDirection = (direction ?? pathDirection);
-                if (resolvedDirection && args.length > 1)
-                    args[1] = resolvedDirection;
-                switch (name) {
-                    case core_1.PreparedStatementKeys.FIND:
-                    case core_1.PreparedStatementKeys.FIND_BY:
-                        break;
-                    case core_1.PreparedStatementKeys.LIST_BY:
-                        args.push(direction);
-                        break;
-                    case core_1.PreparedStatementKeys.PAGE:
-                    case core_1.PreparedStatementKeys.PAGE_BY:
-                        args = [
-                            args[0],
-                            resolvedDirection,
-                            {
-                                limit: limit,
-                                offset: offset,
-                                bookmark: bookmark,
-                            },
-                        ];
-                        break;
-                    case core_1.PreparedStatementKeys.FIND_ONE_BY:
-                        break;
-                    case core_1.PreparedStatementKeys.COUNT_OF:
-                    case core_1.PreparedStatementKeys.MAX_OF:
-                    case core_1.PreparedStatementKeys.MIN_OF:
-                    case core_1.PreparedStatementKeys.AVG_OF:
-                    case core_1.PreparedStatementKeys.SUM_OF:
-                    case core_1.PreparedStatementKeys.DISTINCT_OF:
-                    case core_1.PreparedStatementKeys.GROUP_OF:
-                        // Aggregation methods - args[0] is the field name (if provided)
-                        break;
+        };
+        DynamicModelController = DynamicModelController_1 = __decorate([
+            (0, common_1.Controller)(routePath),
+            (0, swagger_1.ApiTags)(modelClazzName),
+            (0, swagger_1.ApiExtraModels)(ModelConstr),
+            __metadata("design:paramtypes", [index_js_2.DecafRequestContext])
+        ], DynamicModelController);
+        applyClassAuth(DynamicModelController);
+        if (factoryRoutes) {
+            const sortedRoutes = [...factoryRoutes].sort((a, b) => {
+                const aSegments = a.path.split("/").filter(Boolean);
+                const bSegments = b.path.split("/").filter(Boolean);
+                const aParamCount = aSegments.filter((s) => s.startsWith(":")).length;
+                const bParamCount = bSegments.filter((s) => s.startsWith(":")).length;
+                const aLiteralCount = aSegments.length - aParamCount;
+                const bLiteralCount = bSegments.length - bParamCount;
+                if (aLiteralCount !== bLiteralCount)
+                    return bLiteralCount - aLiteralCount;
+                if (aParamCount !== bParamCount)
+                    return aParamCount - bParamCount;
+                return 0;
+            });
+            for (const route of sortedRoutes) {
+                const methodName = route.implementation?.name || route.method.toLowerCase();
+                const registration = FromModelController.matchRoute(methodName, route, pkPath, apiProperties, getPK, ModelConstr, modelClazzName);
+                if (!registration)
+                    continue;
+                const { methodName: registeredMethodName, handler, decorators, paramDecorators, } = registration;
+                const descriptor = FromModelController.defineMethod(DynamicModelController, registeredMethodName, handler);
+                if (descriptor) {
+                    const httpDecorator = (0, utils_js_1.HttpVerbToDecorator)(route.method)(route.path.replace(/^\/+|\/+$/g, "") || undefined);
+                    FromModelController.applyDecorators(DynamicModelController, registeredMethodName, [httpDecorator, ...decorators], paramDecorators);
                 }
-                return this.persistence(ctx).statement(name, ...args, ctx);
             }
-            //
-            // @ApiOperationFromModel(ModelConstr, "GET", "countOf")
-            // @ApiOperation({ summary: `Count all ${modelClazzName} records.` })
-            // @ApiOkResponse({
-            //   description: `Count of ${modelClazzName} records.`,
-            //   type: Number,
-            // })
-            // async countOf() {
-            //   const { ctx } = (
-            //     await this.logCtx([], PreparedStatementKeys.COUNT_OF, true)
-            //   ).for(this.countOf);
-            //   return this.persistence(ctx).statement(
-            //     PreparedStatementKeys.COUNT_OF,
-            //     ctx
-            //   );
-            // }
-            //
-            // @ApiOperationFromModel(ModelConstr, "GET", "countOf/:field")
-            // @ApiOperation({ summary: `Count ${modelClazzName} records by field.` })
-            // @ApiParam({ name: "field", description: "The field to count" })
-            // @ApiOkResponse({
-            //   description: `Count of ${modelClazzName} records.`,
-            //   type: Number,
-            // })
-            // async countOfField(@Param("field") field: string) {
-            //   const { ctx } = (
-            //     await this.logCtx([], PreparedStatementKeys.COUNT_OF, true)
-            //   ).for(this.countOfField);
-            //   return this.persistence(ctx).statement(
-            //     PreparedStatementKeys.COUNT_OF,
-            //     field,
-            //     ctx
-            //   );
-            // }
-            //
-            // @ApiOperationFromModel(ModelConstr, "GET", "maxOf/:field")
-            // @ApiOperation({
-            //   summary: `Find maximum value of a field in ${modelClazzName}.`,
-            // })
-            // @ApiParam({ name: "field", description: "The field to find max of" })
-            // @ApiOkResponse({
-            //   description: `Maximum value of the field in ${modelClazzName}.`,
-            // })
-            // async maxOf(@Param("field") field: string) {
-            //   const { ctx } = (
-            //     await this.logCtx([], PreparedStatementKeys.MAX_OF, true)
-            //   ).for(this.maxOf);
-            //   return this.persistence(ctx).statement(
-            //     PreparedStatementKeys.MAX_OF,
-            //     field,
-            //     ctx
-            //   );
-            // }
-            //
-            // @ApiOperationFromModel(ModelConstr, "GET", "minOf/:field")
-            // @ApiOperation({
-            //   summary: `Find minimum value of a field in ${modelClazzName}.`,
-            // })
-            // @ApiParam({ name: "field", description: "The field to find min of" })
-            // @ApiOkResponse({
-            //   description: `Minimum value of the field in ${modelClazzName}.`,
-            // })
-            // async minOf(@Param("field") field: string) {
-            //   const { ctx } = (
-            //     await this.logCtx([], PreparedStatementKeys.MIN_OF, true)
-            //   ).for(this.minOf);
-            //   return this.persistence(ctx).statement(
-            //     PreparedStatementKeys.MIN_OF,
-            //     field,
-            //     ctx
-            //   );
-            // }
-            //
-            // @ApiOperationFromModel(ModelConstr, "GET", "avgOf/:field")
-            // @ApiOperation({
-            //   summary: `Calculate average of a field in ${modelClazzName}.`,
-            // })
-            // @ApiParam({
-            //   name: "field",
-            //   description: "The field to calculate average of",
-            // })
-            // @ApiOkResponse({
-            //   description: `Average value of the field in ${modelClazzName}.`,
-            //   type: Number,
-            // })
-            // async avgOf(@Param("field") field: string) {
-            //   const { ctx } = (
-            //     await this.logCtx([], PreparedStatementKeys.AVG_OF, true)
-            //   ).for(this.avgOf);
-            //   return this.persistence(ctx).statement(
-            //     PreparedStatementKeys.AVG_OF,
-            //     field,
-            //     ctx
-            //   );
-            // }
-            //
-            // @ApiOperationFromModel(ModelConstr, "GET", "sumOf/:field")
-            // @ApiOperation({
-            //   summary: `Calculate sum of a field in ${modelClazzName}.`,
-            // })
-            // @ApiParam({ name: "field", description: "The field to calculate sum of" })
-            // @ApiOkResponse({
-            //   description: `Sum of the field in ${modelClazzName}.`,
-            //   type: Number,
-            // })
-            // async sumOf(@Param("field") field: string) {
-            //   const { ctx } = (
-            //     await this.logCtx([], PreparedStatementKeys.SUM_OF, true)
-            //   ).for(this.sumOf);
-            //   return this.persistence(ctx).statement(
-            //     PreparedStatementKeys.SUM_OF,
-            //     field,
-            //     ctx
-            //   );
-            // }
-            //
-            // @ApiOperationFromModel(ModelConstr, "GET", "distinctOf/:field")
-            // @ApiOperation({
-            //   summary: `Find distinct values of a field in ${modelClazzName}.`,
-            // })
-            // @ApiParam({
-            //   name: "field",
-            //   description: "The field to find distinct values of",
-            // })
-            // @ApiOkResponse({
-            //   description: `Distinct values of the field in ${modelClazzName}.`,
-            //   type: [String],
-            // })
-            // async distinctOf(@Param("field") field: string) {
-            //   const { ctx } = (
-            //     await this.logCtx([], PreparedStatementKeys.DISTINCT_OF, true)
-            //   ).for(this.distinctOf);
-            //   return this.persistence(ctx).statement(
-            //     PreparedStatementKeys.DISTINCT_OF,
-            //     field,
-            //     ctx
-            //   );
-            // }
-            //
-            // @ApiOperationFromModel(ModelConstr, "GET", "groupOf/:field")
-            // @ApiOperation({
-            //   summary: `Group ${modelClazzName} records by a field.`,
-            // })
-            // @ApiParam({ name: "field", description: "The field to group by" })
-            // @ApiOkResponse({
-            //   description: `${modelClazzName} records grouped by the field.`,
-            // })
-            // async groupOf(@Param("field") field: string) {
-            //   const { ctx } = (
-            //     await this.logCtx([], PreparedStatementKeys.GROUP_OF, true)
-            //   ).for(this.groupOf);
-            //   return this.persistence(ctx).statement(
-            //     PreparedStatementKeys.GROUP_OF,
-            //     field,
-            //     ctx
-            //   );
-            // }
-            async createAll(data, resp) {
-                const { ctx, log } = (await this.logCtx([], db_decorators_1.BulkCrudOperationKeys.CREATE_ALL, true)).for(this.createAll);
-                log.verbose(`creating new ${modelClazzName}`);
-                let created;
-                try {
-                    created = await this.persistence(ctx).createAll(data.map((d) => new ModelConstr(d)), ctx);
-                }
-                catch (e) {
-                    log.error(`Failed to create new ${modelClazzName}`, e);
-                    throw e;
-                }
-                log.info(`created new ${modelClazzName} with id ${created[this.pk]}`);
-                ctx.toResponse(resp);
-                return created;
+        }
+        return DynamicModelController;
+    }
+    static getRouteParametersFromModel(ModelClazz) {
+        const pk = decorator_validation_1.Model.pk(ModelClazz);
+        const composed = decoration_1.Metadata.get(ModelClazz, decoration_1.Metadata.key(db_decorators_1.DBKeys.COMPOSED, pk));
+        const composedKeys = composed?.args ?? [];
+        const uniqueKeys = Array.isArray(composedKeys) && composedKeys.length > 0
+            ? Array.from(new Set([...composedKeys]))
+            : Array.from(new Set([pk]));
+        const description = decoration_1.Metadata.description(ModelClazz) ?? "";
+        const path = `:${uniqueKeys.join("/:")}`;
+        const apiProperties = uniqueKeys.map((key) => {
+            return {
+                name: key,
+                description: decoration_1.Metadata.description(ModelClazz, key),
+                required: true,
+                type: String,
+            };
+        });
+        return {
+            path,
+            description,
+            apiProperties,
+            getPK: (...params) => composed?.separator ? params.join(composed.separator) : params.join(""),
+        };
+    }
+    static routeParamDecorators(path) {
+        let paramIndex = 0;
+        return path
+            .split("/")
+            .filter(Boolean)
+            .flatMap((segment) => {
+            if (segment.startsWith(":")) {
+                return [
+                    { decorator: (0, common_1.Param)(segment.slice(1)), index: paramIndex++ },
+                ];
             }
-            async create(data, resp) {
-                const { ctx, log } = (await this.logCtx([], db_decorators_1.OperationKeys.CREATE, true)).for(this.create);
-                log.verbose(`creating new ${modelClazzName}`);
-                let created;
-                try {
-                    const persistence = this.persistence(ctx);
-                    created = await persistence.create(data, ctx);
-                }
-                catch (e) {
-                    log.error(`Failed to create new ${modelClazzName}`, e);
-                    throw e;
-                }
-                log.info(`created new ${modelClazzName} with id ${created[this.pk]}`);
-                ctx.toResponse(resp);
-                return created;
+            if (segment.startsWith("*")) {
+                return [
+                    { decorator: (0, common_1.Param)(segment.slice(1)), index: paramIndex++ },
+                ];
             }
-            async readAll(ids) {
-                const { ctx, log } = (await this.logCtx([], db_decorators_1.BulkCrudOperationKeys.READ_ALL, true)).for(this.readAll);
-                const normalizedIds = Array.isArray(ids) ? ids : [ids];
-                let read;
-                try {
-                    log.debug(`reading ${normalizedIds} ${modelClazzName}: ${normalizedIds}`);
-                    const persistence = this.persistence(ctx);
-                    read = await persistence.readAll(normalizedIds, ctx);
-                }
-                catch (e) {
-                    log.error(`Failed to ${modelClazzName} with id ${normalizedIds}`, e);
-                    throw e;
-                }
-                log.info(`read ${read.length} ${modelClazzName}`);
-                return read;
+            return [];
+        });
+    }
+    static defineMethod(target, methodName, handler) {
+        Object.defineProperty(target.prototype || target, methodName, {
+            value: handler,
+            writable: false,
+            configurable: true,
+            enumerable: false,
+        });
+        return Object.getOwnPropertyDescriptor(target.prototype || target, methodName);
+    }
+    static applyDecorators(target, methodName, methodDecorators, paramDecorators = []) {
+        const proto = target?.prototype ?? target;
+        const descriptor = Object.getOwnPropertyDescriptor(proto, methodName);
+        methodDecorators.forEach((d) => d(proto, methodName, descriptor));
+        paramDecorators.forEach(({ decorator, index }) => decorator(proto, methodName, index));
+    }
+    static matchRoute(methodName, route, pkPath, apiProperties, getPK, ModelConstr, modelClazzName) {
+        const { method, path } = route;
+        const normalizedPath = path.replace(/^\/+|\/+$/g, "");
+        const handler = route.implementation;
+        if (method === "POST" && normalizedPath === "") {
+            return FromModelController.createRegistration("create", handler, FromModelController.createCreateDecorators(ModelConstr, modelClazzName), [
+                { decorator: (0, index_js_1.DecafBody)(), index: 0 },
+                { decorator: (0, common_1.Response)({ passthrough: true }), index: 1 },
+            ]);
+        }
+        if (method === "POST" && normalizedPath === "bulk") {
+            return FromModelController.createRegistration("createAll", handler, FromModelController.bulkCreateDecorators(ModelConstr, modelClazzName), [
+                { decorator: (0, index_js_1.DecafBody)(), index: 0 },
+                { decorator: (0, common_1.Response)({ passthrough: true }), index: 1 },
+            ]);
+        }
+        if (method === "GET" && normalizedPath === "bulk") {
+            return FromModelController.createRegistration("readAll", handler, FromModelController.bulkReadDecorators(ModelConstr, modelClazzName), [{ decorator: (0, common_1.Query)("ids"), index: 0 }]);
+        }
+        if (method === "PUT" && normalizedPath === "bulk") {
+            return FromModelController.createRegistration("updateAll", handler, FromModelController.bulkUpdateDecorators(ModelConstr, modelClazzName, apiProperties), [
+                { decorator: (0, index_js_1.DecafBody)(), index: 0 },
+                { decorator: (0, common_1.Response)({ passthrough: true }), index: 1 },
+            ]);
+        }
+        if (method === "DELETE" && normalizedPath === "bulk") {
+            return FromModelController.createRegistration("deleteAll", handler, FromModelController.bulkDeleteDecorators(ModelConstr, modelClazzName, apiProperties), [
+                { decorator: (0, common_1.Query)("ids"), index: 0 },
+                { decorator: (0, common_1.Response)({ passthrough: true }), index: 1 },
+            ]);
+        }
+        if (method === "GET" && normalizedPath === pkPath) {
+            return FromModelController.createRegistration("read", handler, FromModelController.readDecorators(ModelConstr, modelClazzName, apiProperties, pkPath), FromModelController.routeParamDecorators(normalizedPath));
+        }
+        if (method === "PUT" && normalizedPath === pkPath) {
+            const routeParams = FromModelController.routeParamDecorators(normalizedPath);
+            return FromModelController.createRegistration("update", handler, FromModelController.updateDecorators(ModelConstr, modelClazzName, apiProperties, pkPath), [
+                { decorator: (0, index_js_1.DecafBody)(), index: 0 },
+                ...routeParams.map(({ decorator, index }) => ({
+                    decorator,
+                    index: index + 1,
+                })),
+            ]);
+        }
+        if (method === "DELETE" && normalizedPath === pkPath) {
+            const routeParams = FromModelController.routeParamDecorators(normalizedPath);
+            return FromModelController.createRegistration("delete", handler, FromModelController.deleteDecorators(ModelConstr, modelClazzName, apiProperties, pkPath), routeParams);
+        }
+        // Composed PK fallback routes (filterEmpty) — path differs from pkPath
+        const fallbackSegments = normalizedPath.split("/").filter(Boolean);
+        const isAllParams = fallbackSegments.length > 0 &&
+            fallbackSegments.every((s) => s.startsWith(":"));
+        if (isAllParams && normalizedPath !== pkPath) {
+            const fallbackApiProps = fallbackSegments
+                .map((s) => s.slice(1))
+                .map((name) => ({
+                name,
+                description: `${name} parameter`,
+                required: true,
+                type: String,
+            }));
+            const suffix = fallbackSegments.map((s) => s.slice(1)).join("And");
+            const routeParams = FromModelController.routeParamDecorators(normalizedPath);
+            if (method === "GET") {
+                return FromModelController.createRegistration(`readBy${suffix}`, handler, FromModelController.readDecorators(ModelConstr, modelClazzName, fallbackApiProps, normalizedPath), routeParams);
             }
-            async read(routeParams) {
-                const { ctx, log } = (await this.logCtx([], db_decorators_1.OperationKeys.READ, true)).for(this.read);
-                const id = getPK(...routeParams.valuesInOrder);
-                if (typeof id === "undefined")
-                    throw new db_decorators_1.ValidationError(`No ${this.pk} provided`);
-                let read;
-                try {
-                    log.debug(`reading ${modelClazzName} with ${this.pk} ${id}`);
-                    const persistence = this.persistence(ctx);
-                    read = await persistence.read(id, ctx);
-                }
-                catch (e) {
-                    log.error(`Failed to read ${modelClazzName} with id ${id}`, e);
-                    throw e;
-                }
-                log.info(`read ${modelClazzName} with id ${read[this.pk]}`);
-                return read;
+            if (method === "PUT") {
+                return FromModelController.createRegistration(`updateBy${suffix}`, handler, FromModelController.updateDecorators(ModelConstr, modelClazzName, fallbackApiProps, normalizedPath), [
+                    { decorator: (0, index_js_1.DecafBody)(), index: 0 },
+                    ...routeParams.map(({ decorator, index }) => ({
+                        decorator,
+                        index: index + 1,
+                    })),
+                ]);
             }
-            async updateAll(body, resp) {
-                const { ctx, log } = (await this.logCtx([], db_decorators_1.BulkCrudOperationKeys.UPDATE_ALL, true)).for(this.updateAll);
-                let updated;
-                try {
-                    log.info(`updating ${body.length} ${modelClazzName}`);
-                    updated = await this.persistence(ctx).updateAll(body, ctx);
-                }
-                catch (e) {
-                    log.error(e);
-                    throw e;
-                }
-                ctx.toResponse(resp);
-                return updated;
+            if (method === "DELETE") {
+                return FromModelController.createRegistration(`deleteBy${suffix}`, handler, FromModelController.deleteDecorators(ModelConstr, modelClazzName, fallbackApiProps, normalizedPath), routeParams);
             }
-            async update(routeParams, body, resp) {
-                const { ctx, log } = (await this.logCtx([], db_decorators_1.OperationKeys.UPDATE, true)).for(this.update);
-                const id = getPK(...routeParams.valuesInOrder);
-                if (typeof id === "undefined")
-                    throw new db_decorators_1.ValidationError(`No ${this.pk} provided`);
-                let updated;
-                try {
-                    log.info(`updating ${modelClazzName} with ${this.pk} ${id}`);
-                    const payload = JSON.parse(JSON.stringify(body));
-                    const persistence = this.persistence(ctx);
-                    updated = await persistence.update(new ModelConstr({
-                        ...payload,
-                        [this.pk]: id,
-                    }), ctx);
+        }
+        if (method === "GET" && normalizedPath === "statement/:method/*args") {
+            return FromModelController.createRegistration("statement", handler, FromModelController.statementDecorators(ModelConstr, modelClazzName), [
+                { decorator: (0, common_1.Param)("method"), index: 0 },
+                { decorator: (0, common_1.Param)("args"), index: 1 },
+                { decorator: (0, index_js_1.DecafQuery)(), index: 2 },
+            ]);
+        }
+        if (method === "GET" && normalizedPath === "findOneBy/:key/:value") {
+            return FromModelController.createRegistration("findOneBy", handler, FromModelController.statementShortcutDecorators(ModelConstr, modelClazzName, normalizedPath, core_1.PreparedStatementKeys.FIND_ONE_BY), FromModelController.statementShortcutParams(normalizedPath));
+        }
+        const statementRoutes = {
+            "listBy/:key": core_1.PreparedStatementKeys.LIST_BY,
+            "paginateBy/:key/:page": core_1.PreparedStatementKeys.PAGE_BY,
+            "find/:value": core_1.PreparedStatementKeys.FIND,
+            "page/:value": core_1.PreparedStatementKeys.PAGE,
+            "findOneBy/:key/:value": core_1.PreparedStatementKeys.FIND_ONE_BY,
+            "findBy/:key/:value": core_1.PreparedStatementKeys.FIND_BY,
+            "countOf/:field": core_1.PreparedStatementKeys.COUNT_OF,
+            "maxOf/:field": core_1.PreparedStatementKeys.MAX_OF,
+            "minOf/:field": core_1.PreparedStatementKeys.MIN_OF,
+            "avgOf/:field": core_1.PreparedStatementKeys.AVG_OF,
+            "sumOf/:field": core_1.PreparedStatementKeys.SUM_OF,
+            "distinctOf/:field": core_1.PreparedStatementKeys.DISTINCT_OF,
+            "groupOf/:field": core_1.PreparedStatementKeys.GROUP_OF,
+        };
+        const statementKey = statementRoutes[normalizedPath];
+        if (statementKey && method === "GET") {
+            return FromModelController.createRegistration(FromModelController.statementMethodName(normalizedPath), handler, FromModelController.statementShortcutDecorators(ModelConstr, modelClazzName, normalizedPath, statementKey), FromModelController.statementShortcutParams(normalizedPath));
+        }
+        if (method === "GET" && normalizedPath.startsWith("query/")) {
+            const queryMethod = normalizedPath.replace(/^query\//, "").split("/")[0];
+            return FromModelController.createRegistration(queryMethod, handler, FromModelController.getQueryDecorators(queryMethod, normalizedPath, "GET", true), FromModelController.complexQueryParams(normalizedPath));
+        }
+        const pathSegments = normalizedPath.split("/").filter(Boolean);
+        const knownPrefixes = new Set([
+            "listBy",
+            "findBy",
+            "findByPaginate",
+            "findOneBy",
+            "paginateBy",
+            "find",
+            "page",
+            "countOf",
+            "maxOf",
+            "minOf",
+            "avgOf",
+            "sumOf",
+            "distinctOf",
+            "groupOf",
+            "statement",
+            "bulk",
+            "query",
+        ]);
+        if (pathSegments.length > 0 &&
+            !normalizedPath.startsWith("query/") &&
+            !normalizedPath.startsWith("statement/") &&
+            !knownPrefixes.has(pathSegments[0])) {
+            const apiPathParams = pathSegments
+                .filter((s) => s.startsWith(":"))
+                .map((s) => s.slice(1))
+                .map((name) => ({
+                name,
+                description: `${name} parameter for the query`,
+                required: true,
+                type: String,
+            }));
+            return FromModelController.createRegistration(methodName, handler, [
+                ...apiPathParams.map((p) => (0, swagger_1.ApiParam)(p)),
+                (0, swagger_1.ApiOperation)({ summary: `Retrieve records using "${methodName}".` }),
+                (0, swagger_1.ApiOkResponse)({ description: "Result successfully retrieved." }),
+                (0, swagger_1.ApiNoContentResponse)({
+                    description: "No content returned by the method.",
+                }),
+            ], FromModelController.routeParamDecorators(normalizedPath));
+        }
+        return undefined;
+    }
+    static createRegistration(methodName, handler, decorators, paramDecorators) {
+        return { methodName, handler, decorators, paramDecorators };
+    }
+    static statementMethodName(path) {
+        const firstSegment = path.split("/")[0];
+        return firstSegment;
+    }
+    static statementShortcutParams(path) {
+        const segments = path.split("/").filter((s) => s.startsWith(":"));
+        const params = [];
+        segments.forEach((seg, i) => {
+            const name = seg.replace(":", "");
+            params.push({ decorator: (0, common_1.Param)(name), index: i });
+        });
+        if (path.startsWith("listBy/") ||
+            path.startsWith("paginateBy/") ||
+            path.startsWith("find/") ||
+            path.startsWith("page/")) {
+            params.push({ decorator: (0, index_js_1.DecafQuery)(), index: segments.length });
+        }
+        return params;
+    }
+    static complexQueryParams(path) {
+        const segments = path.split("/").filter((s) => s.startsWith(":"));
+        const params = [];
+        segments.forEach((seg, i) => {
+            const name = seg.replace(":", "");
+            params.push({ decorator: (0, common_1.Param)(name), index: i });
+        });
+        if (path.startsWith("query/")) {
+            params.push({ decorator: (0, index_js_1.DecafQuery)(), index: segments.length });
+        }
+        return params;
+    }
+    static createComplexQueryHandler(methodName) {
+        return async function complexQuery(...args) {
+            const log = this.log?.for?.(complexQuery);
+            try {
+                if (log)
+                    log.debug(`Invoking custom query "${methodName}"`);
+                const { ctx } = (await this.logCtx([], methodName, true)).for(complexQuery);
+                const persistence = this.persistence(ctx);
+                const spreadArgs = FromModelController.normalizeQueryArgs(args);
+                if (persistence?.repo &&
+                    typeof persistence.repo[methodName] === "function") {
+                    return persistence.repo[methodName](...spreadArgs);
                 }
-                catch (e) {
-                    log.error(e);
-                    throw e;
+                if (typeof persistence[methodName] === "function") {
+                    return persistence[methodName](...spreadArgs);
                 }
-                ctx.toResponse(resp);
-                return updated;
-            }
-            async deleteAll(ids, resp) {
-                const { ctx, log } = (await this.logCtx([], db_decorators_1.BulkCrudOperationKeys.DELETE_ALL, true)).for(this.deleteAll);
-                const normalizedIds = Array.isArray(ids) ? ids : [ids];
-                let read;
-                try {
-                    log.debug(`deleting ${normalizedIds.length} ${modelClazzName}: ${normalizedIds}`);
-                    read = await this.persistence(ctx).deleteAll(normalizedIds, ctx);
+                if (persistence?.query && typeof persistence.query === "function") {
+                    return persistence.query(methodName, ...spreadArgs);
                 }
-                catch (e) {
-                    log.error(`Failed to delete ${modelClazzName} with id ${normalizedIds}`, e);
-                    throw e;
+                if (typeof persistence.statement === "function") {
+                    return persistence.statement(methodName, ...spreadArgs, ctx);
                 }
-                log.info(`deleted ${read.length} ${modelClazzName}`);
-                ctx.toResponse(resp);
-                return read;
+                throw new db_decorators_1.InternalError(`Persistence method "${methodName}" not found on ${persistence?.constructor?.name}`);
             }
-            async delete(routeParams, resp) {
-                const { ctx, log } = (await this.logCtx([], db_decorators_1.OperationKeys.DELETE, true)).for(this.delete);
-                const id = getPK(...routeParams.valuesInOrder);
-                if (typeof id === "undefined")
-                    throw new db_decorators_1.ValidationError(`No ${this.pk} provided`);
-                let del;
-                try {
-                    log.debug(`deleting ${modelClazzName} with ${this.pk} ${id}`);
-                    del = await this.persistence(ctx).delete(id, ctx);
-                }
-                catch (e) {
-                    log.error(`Failed to delete ${modelClazzName} with id ${id}`, e);
-                    throw e;
-                }
-                log.info(`deleted ${modelClazzName} with id ${id}`);
-                ctx.toResponse(resp);
-                return del;
+            catch (e) {
+                if (log)
+                    log.error(`Custom query "${methodName}" failed`, e);
+                throw FromModelController.toDecafError(e, `Custom query "${methodName}" failed`);
             }
         };
-        __decorate([
-            (0, index_js_1.ApiOperationFromModel)(ModelConstr, "GET", "listBy/:key"),
-            (0, swagger_1.ApiOperation)({ summary: `Retrieve ${modelClazzName} records by query.` }),
-            (0, swagger_1.ApiParam)({ name: "key", description: "the model key to sort by" }),
-            (0, swagger_1.ApiQuery)({ name: "direction", required: true, enum: core_1.OrderDirection }),
-            (0, swagger_1.ApiOkResponse)({
-                description: `${modelClazzName} listed successfully.`,
-            }),
-            __param(0, (0, common_1.Param)("key")),
-            __param(1, (0, index_js_1.DecafQuery)()),
-            __metadata("design:type", Function),
-            __metadata("design:paramtypes", [String, Object]),
-            __metadata("design:returntype", Promise)
-        ], DynamicModelController.prototype, "listBy", null);
-        __decorate([
-            (0, index_js_1.ApiOperationFromModel)(ModelConstr, "GET", "paginateBy/:key/:page"),
-            (0, swagger_1.ApiOperation)({ summary: `Retrieve ${modelClazzName} records by query.` }),
-            (0, swagger_1.ApiParam)({ name: "key", description: "the model key to sort by" }),
-            (0, swagger_1.ApiParam)({
-                name: "page",
-                description: "the page to retrieve or the bookmark",
-            }),
-            (0, swagger_1.ApiQuery)({
-                name: "direction",
-                required: true,
-                enum: core_1.OrderDirection,
-                description: "the sort order",
-            }),
-            (0, swagger_1.ApiQuery)({ name: "limit", required: true, description: "the page size" }),
-            (0, swagger_1.ApiQuery)({ name: "offset", description: "the bookmark when necessary" }),
-            (0, swagger_1.ApiOkResponse)({
-                description: `${modelClazzName} listed paginated.`,
-            }),
-            __param(0, (0, common_1.Param)("key")),
-            __param(1, (0, index_js_1.DecafQuery)()),
-            __metadata("design:type", Function),
-            __metadata("design:paramtypes", [String, Object]),
-            __metadata("design:returntype", Promise)
-        ], DynamicModelController.prototype, "paginateBy", null);
-        __decorate([
-            (0, index_js_1.ApiOperationFromModel)(ModelConstr, "GET", "find/:value"),
-            (0, swagger_1.ApiOperation)({
-                summary: `Find ${modelClazzName} records using the default query attributes.`,
-            }),
-            (0, swagger_1.ApiParam)({
-                name: "value",
-                description: "The string to match against the default query attributes",
-            }),
-            (0, swagger_1.ApiQuery)({
-                name: "direction",
-                required: false,
-                enum: core_1.OrderDirection,
-                description: "the sort order for the matching results",
-            }),
-            (0, swagger_1.ApiOkResponse)({
-                description: `${modelClazzName} records matching the provided prefix.`,
-            }),
-            __param(0, (0, common_1.Param)("value")),
-            __param(1, (0, index_js_1.DecafQuery)()),
-            __metadata("design:type", Function),
-            __metadata("design:paramtypes", [String, Object]),
-            __metadata("design:returntype", Promise)
-        ], DynamicModelController.prototype, "find", null);
-        __decorate([
-            (0, index_js_1.ApiOperationFromModel)(ModelConstr, "GET", "page/:value"),
-            (0, swagger_1.ApiOperation)({
-                summary: `Page ${modelClazzName} records using the default query attributes.`,
-            }),
-            (0, swagger_1.ApiParam)({
-                name: "value",
-                description: "The string to match against the default query attributes",
-            }),
-            (0, swagger_1.ApiQuery)({
-                name: "direction",
-                required: false,
-                enum: core_1.OrderDirection,
-                description: "the sort order for the paged results",
-            }),
-            (0, swagger_1.ApiQuery)({
-                name: "limit",
-                required: false,
-                description: "page size",
-            }),
-            (0, swagger_1.ApiQuery)({
-                name: "offset",
-                required: false,
-                description: "page number",
-            }),
-            (0, swagger_1.ApiQuery)({
-                name: "bookmark",
-                required: false,
-                description: "bookmark for cursor pagination",
-            }),
-            (0, swagger_1.ApiOkResponse)({
-                description: `${modelClazzName} records paged by the provided prefix.`,
-            }),
-            __param(0, (0, common_1.Param)("value")),
-            __param(1, (0, index_js_1.DecafQuery)()),
-            __metadata("design:type", Function),
-            __metadata("design:paramtypes", [String, Object]),
-            __metadata("design:returntype", Promise)
-        ], DynamicModelController.prototype, "page", null);
-        __decorate([
-            (0, index_js_1.ApiOperationFromModel)(ModelConstr, "GET", "findOneBy/:key"),
-            (0, swagger_1.ApiOperation)({ summary: `Retrieve ${modelClazzName} records by query.` }),
-            (0, swagger_1.ApiParam)({ name: "key", description: "the model key to sort by" }),
-            (0, swagger_1.ApiOkResponse)({
-                description: `${modelClazzName} listed found.`,
-            }),
-            (0, swagger_1.ApiNotFoundResponse)({
-                description: `No ${modelClazzName} record matches the provided identifier.`,
-            }),
-            __param(0, (0, common_1.Param)("key")),
-            __param(1, (0, common_1.Param)("value")),
-            __metadata("design:type", Function),
-            __metadata("design:paramtypes", [String, Object]),
-            __metadata("design:returntype", Promise)
-        ], DynamicModelController.prototype, "findOneBy", null);
-        __decorate([
-            (0, index_js_1.ApiOperationFromModel)(ModelConstr, "GET", "findBy/:key/:value"),
-            (0, swagger_1.ApiOperation)({ summary: `Retrieve ${modelClazzName} records by query.` }),
-            (0, swagger_1.ApiParam)({ name: "key", description: "the model key to compare" }),
-            (0, swagger_1.ApiParam)({ name: "value", description: "the value to match" }),
-            (0, swagger_1.ApiQuery)({
-                name: "direction",
-                required: true,
-                enum: core_1.OrderDirection,
-                description: "the sort order when  applicable",
-            }),
-            (0, swagger_1.ApiOkResponse)({
-                description: `${modelClazzName} listed found.`,
-            }),
-            (0, swagger_1.ApiNotFoundResponse)({
-                description: `No ${modelClazzName} record matches the provided identifier.`,
-            }),
-            __param(0, (0, common_1.Param)("key")),
-            __param(1, (0, common_1.Param)("value")),
-            __param(2, (0, index_js_1.DecafQuery)()),
-            __metadata("design:type", Function),
-            __metadata("design:paramtypes", [String, Object, Object]),
-            __metadata("design:returntype", Promise)
-        ], DynamicModelController.prototype, "findBy", null);
-        __decorate([
-            (0, index_js_1.ApiOperationFromModel)(ModelConstr, "GET", "statement/:method/*args"),
-            (0, swagger_1.ApiOperation)({
-                summary: `Executes a prepared statement on ${modelClazzName}.`,
-            }),
-            (0, swagger_1.ApiParam)({
-                name: "method",
-                description: "the prepared statement to execute",
-            }),
-            (0, swagger_1.ApiParam)({
-                name: "args",
-                description: "concatenated list of arguments the prepared statement can accept",
-            }),
-            (0, swagger_1.ApiQuery)({
-                name: "direction",
-                required: true,
-                enum: core_1.OrderDirection,
-                description: "the sort order when  applicable",
-            }),
-            (0, swagger_1.ApiQuery)({
-                name: "limit",
-                required: true,
-                description: "limit or page size when applicable",
-            }),
-            (0, swagger_1.ApiQuery)({
-                name: "offset",
-                required: true,
-                description: "offset or bookmark when applicable",
-            }),
-            (0, swagger_1.ApiOkResponse)({
-                description: `${modelClazzName} listed found.`,
-            }),
-            (0, swagger_1.ApiNotFoundResponse)({
-                description: `No ${modelClazzName} record matches the provided identifier.`,
-            }),
-            __param(0, (0, common_1.Param)("method")),
-            __param(1, (0, common_1.Param)("args")),
-            __param(2, (0, index_js_1.DecafQuery)()),
-            __metadata("design:type", Function),
-            __metadata("design:paramtypes", [String, Array, Object]),
-            __metadata("design:returntype", Promise)
-        ], DynamicModelController.prototype, "statement", null);
-        __decorate([
-            (0, index_js_1.ApiOperationFromModel)(ModelConstr, "POST", "bulk"),
+    }
+    static extractQueryArgs(args) {
+        if (args.length === 0)
+            return args;
+        const last = args[args.length - 1];
+        if (last && typeof last === "object" && !Array.isArray(last)) {
+            const queryObj = args.pop();
+            const hasDirection = queryObj.direction !== undefined;
+            const hasLimit = queryObj.limit !== undefined;
+            const hasOffset = queryObj.offset !== undefined;
+            if (!hasDirection && !hasLimit && !hasOffset)
+                return args;
+            const extras = [];
+            if (hasDirection)
+                extras.push(queryObj.direction);
+            else if (hasLimit || hasOffset)
+                extras.push(undefined);
+            if (hasLimit)
+                extras.push(queryObj.limit);
+            if (hasOffset)
+                extras.push(queryObj.offset);
+            return [...args, ...extras];
+        }
+        return args;
+    }
+    static normalizeQueryArgs(args) {
+        const normalized = FromModelController.extractQueryArgs(args);
+        if (normalized.length === 0)
+            return normalized;
+        const last = normalized[normalized.length - 1];
+        if (!last || typeof last !== "object" || Array.isArray(last)) {
+            return normalized;
+        }
+        const queryObj = last;
+        const hasQueryFields = queryObj.direction !== undefined ||
+            queryObj.limit !== undefined ||
+            queryObj.offset !== undefined ||
+            queryObj.bookmark !== undefined;
+        if (!hasQueryFields) {
+            normalized.pop();
+            return normalized;
+        }
+        normalized.pop();
+        if (queryObj.direction !== undefined)
+            normalized.push(queryObj.direction);
+        if (queryObj.limit !== undefined)
+            normalized.push(queryObj.limit);
+        if (queryObj.offset !== undefined)
+            normalized.push(queryObj.offset);
+        if (queryObj.bookmark !== undefined)
+            normalized.push(queryObj.bookmark);
+        return normalized;
+    }
+    static createCreateDecorators(ModelConstr, modelClazzName) {
+        return [
+            (0, index_js_1.ApiOperationFromModel)(ModelConstr, "POST"),
             (0, swagger_1.ApiOperation)({ summary: `Create a new ${modelClazzName}.` }),
             (0, swagger_1.ApiBody)({
                 description: `Payload for ${modelClazzName}`,
-                schema: {
-                    type: "array",
-                    items: {
-                        $ref: (0, swagger_1.getSchemaPath)(ModelConstr),
-                        // $ref: getSchemaPath(DtoFor(OperationKeys.CREATE, ModelConstr)),
-                    },
-                },
+                type: (0, DtoBuilder_js_1.DtoFor)(db_decorators_1.OperationKeys.CREATE, ModelConstr),
             }),
             (0, swagger_1.ApiCreatedResponse)({
                 description: `${modelClazzName} created successfully.`,
-                schema: {
-                    type: "array",
-                    items: {
-                        $ref: (0, swagger_1.getSchemaPath)(ModelConstr),
-                    },
-                },
+                schema: { $ref: (0, swagger_1.getSchemaPath)(ModelConstr) },
             }),
             (0, swagger_1.ApiBadRequestResponse)({ description: "Payload validation failed." }),
             (0, swagger_1.ApiUnprocessableEntityResponse)({
                 description: "Repository rejected the provided payload.",
             }),
-            __param(0, (0, index_js_1.DecafBody)()),
-            __param(1, (0, common_1.Response)({ passthrough: true })),
-            __metadata("design:type", Function),
-            __metadata("design:paramtypes", [Array, Object]),
-            __metadata("design:returntype", Promise)
-        ], DynamicModelController.prototype, "createAll", null);
-        __decorate([
-            (0, index_js_1.ApiOperationFromModel)(ModelConstr, "POST"),
+        ];
+    }
+    static bulkCreateDecorators(ModelConstr, modelClazzName) {
+        return [
+            (0, index_js_1.ApiOperationFromModel)(ModelConstr, "POST", "bulk"),
             (0, swagger_1.ApiOperation)({ summary: `Create a new ${modelClazzName}.` }),
             (0, swagger_1.ApiBody)({
                 description: `Payload for ${modelClazzName}`,
-                type: (0, DtoBuilder_js_1.DtoFor)(db_decorators_1.OperationKeys.CREATE, ModelConstr),
+                schema: {
+                    type: "array",
+                    items: { $ref: (0, swagger_1.getSchemaPath)(ModelConstr) },
+                },
             }),
             (0, swagger_1.ApiCreatedResponse)({
                 description: `${modelClazzName} created successfully.`,
                 schema: {
-                    $ref: (0, swagger_1.getSchemaPath)(ModelConstr),
+                    type: "array",
+                    items: { $ref: (0, swagger_1.getSchemaPath)(ModelConstr) },
                 },
             }),
             (0, swagger_1.ApiBadRequestResponse)({ description: "Payload validation failed." }),
             (0, swagger_1.ApiUnprocessableEntityResponse)({
                 description: "Repository rejected the provided payload.",
             }),
-            __param(0, (0, index_js_1.DecafBody)()),
-            __param(1, (0, common_1.Response)({ passthrough: true })),
-            __metadata("design:type", Function),
-            __metadata("design:paramtypes", [Object, Object]),
-            __metadata("design:returntype", Promise)
-        ], DynamicModelController.prototype, "create", null);
-        __decorate([
+        ];
+    }
+    static bulkReadDecorators(ModelConstr, modelClazzName) {
+        return [
             (0, index_js_1.ApiOperationFromModel)(ModelConstr, "GET", "bulk"),
-            (0, swagger_1.ApiOperation)({ summary: `Retrieve a ${modelClazzName} record by id.` }),
+            (0, swagger_1.ApiOperation)({ summary: `Retrieve ${modelClazzName} records by ids.` }),
             (0, swagger_1.ApiQuery)({ name: "ids", required: true, type: "array" }),
             (0, swagger_1.ApiOkResponse)({
                 description: `${modelClazzName} retrieved successfully.`,
                 schema: {
                     type: "array",
-                    items: {
-                        $ref: (0, swagger_1.getSchemaPath)(ModelConstr),
-                    },
-                },
-            }),
-            (0, swagger_1.ApiNotFoundResponse)({
-                description: `No ${modelClazzName} record matches the provided identifier.`,
-            }),
-            __param(0, (0, common_1.Query)("ids")),
-            __metadata("design:type", Function),
-            __metadata("design:paramtypes", [Array]),
-            __metadata("design:returntype", Promise)
-        ], DynamicModelController.prototype, "readAll", null);
-        __decorate([
-            (0, index_js_1.ApiOperationFromModel)(ModelConstr, "GET", path),
-            (0, index_js_1.ApiParamsFromModel)(apiProperties),
-            (0, swagger_1.ApiOperation)({ summary: `Retrieve a ${modelClazzName} record by id.` }),
-            (0, swagger_1.ApiOkResponse)({
-                description: `${modelClazzName} retrieved successfully.`,
-                schema: {
-                    $ref: (0, swagger_1.getSchemaPath)(ModelConstr),
+                    items: { $ref: (0, swagger_1.getSchemaPath)(ModelConstr) },
                 },
             }),
             (0, swagger_1.ApiNotFoundResponse)({
                 description: `No ${modelClazzName} record matches the provided identifier.`,
             }),
-            __param(0, (0, index_js_1.DecafParams)(apiProperties)),
-            __metadata("design:type", Function),
-            __metadata("design:paramtypes", [Object]),
-            __metadata("design:returntype", Promise)
-        ], DynamicModelController.prototype, "read", null);
-        __decorate([
-            (0, index_js_1.ApiOperationFromModel)(ModelConstr, "PUT", `bulk`),
+        ];
+    }
+    static bulkUpdateDecorators(ModelConstr, modelClazzName, apiProperties) {
+        return [
+            (0, index_js_1.ApiOperationFromModel)(ModelConstr, "PUT", "bulk"),
             (0, index_js_1.ApiParamsFromModel)(apiProperties),
             (0, swagger_1.ApiOperation)({
-                summary: `Replace an existing ${modelClazzName} record with a new payload.`,
+                summary: `Replace existing ${modelClazzName} records with new payloads.`,
             }),
             (0, swagger_1.ApiBody)({
-                description: `Payload for replace a existing record of ${modelClazzName}`,
+                description: `Payload for replacing existing records of ${modelClazzName}`,
                 schema: {
                     type: "array",
                     $ref: (0, swagger_1.getSchemaPath)((0, DtoBuilder_js_1.DtoFor)(db_decorators_1.OperationKeys.UPDATE, ModelConstr)),
@@ -850,125 +589,212 @@ class FromModelController {
                 description: `${modelClazzName} updated successfully.`,
                 schema: {
                     type: "array",
-                    items: {
-                        $ref: (0, swagger_1.getSchemaPath)(ModelConstr),
-                    },
+                    items: { $ref: (0, swagger_1.getSchemaPath)(ModelConstr) },
                 },
             }),
             (0, swagger_1.ApiNotFoundResponse)({
                 description: `No ${modelClazzName} record matches the provided identifier.`,
             }),
             (0, swagger_1.ApiBadRequestResponse)({ description: "Payload validation failed." }),
-            __param(0, (0, index_js_1.DecafBody)()),
-            __param(1, (0, common_1.Response)({ passthrough: true })),
-            __metadata("design:type", Function),
-            __metadata("design:paramtypes", [Array, Object]),
-            __metadata("design:returntype", Promise)
-        ], DynamicModelController.prototype, "updateAll", null);
-        __decorate([
-            (0, index_js_1.ApiOperationFromModel)(ModelConstr, "PUT", path),
+        ];
+    }
+    static bulkDeleteDecorators(ModelConstr, modelClazzName, apiProperties) {
+        return [
+            (0, index_js_1.ApiOperationFromModel)(ModelConstr, "DELETE", "bulk"),
+            (0, index_js_1.ApiParamsFromModel)(apiProperties),
+            (0, swagger_1.ApiOperation)({ summary: `Delete ${modelClazzName} records by ids.` }),
+            (0, swagger_1.ApiQuery)({ name: "ids", required: true, type: "array" }),
+            (0, swagger_1.ApiOkResponse)({
+                description: `${modelClazzName} deleted successfully.`,
+                schema: {
+                    type: "array",
+                    items: { $ref: (0, swagger_1.getSchemaPath)(ModelConstr) },
+                },
+            }),
+            (0, swagger_1.ApiNotFoundResponse)({
+                description: `No ${modelClazzName} record matches the provided identifier.`,
+            }),
+        ];
+    }
+    static readDecorators(ModelConstr, modelClazzName, apiProperties, pkPath) {
+        return [
+            (0, index_js_1.ApiOperationFromModel)(ModelConstr, "GET", pkPath),
+            (0, index_js_1.ApiParamsFromModel)(apiProperties),
+            (0, swagger_1.ApiOperation)({ summary: `Retrieve a ${modelClazzName} record by id.` }),
+            (0, swagger_1.ApiOkResponse)({
+                description: `${modelClazzName} retrieved successfully.`,
+                schema: { $ref: (0, swagger_1.getSchemaPath)(ModelConstr) },
+            }),
+            (0, swagger_1.ApiNotFoundResponse)({
+                description: `No ${modelClazzName} record matches the provided identifier.`,
+            }),
+        ];
+    }
+    static updateDecorators(ModelConstr, modelClazzName, apiProperties, pkPath) {
+        return [
+            (0, index_js_1.ApiOperationFromModel)(ModelConstr, "PUT", pkPath),
             (0, index_js_1.ApiParamsFromModel)(apiProperties),
             (0, swagger_1.ApiOperation)({
                 summary: `Replace an existing ${modelClazzName} record with a new payload.`,
             }),
             (0, swagger_1.ApiBody)({
-                description: `Payload for replace a existing record of ${modelClazzName}`,
+                description: `Payload for replacing an existing record of ${modelClazzName}`,
                 type: (0, DtoBuilder_js_1.DtoFor)(db_decorators_1.OperationKeys.UPDATE, ModelConstr),
             }),
             (0, swagger_1.ApiOkResponse)({
                 description: `${modelClazzName} updated successfully.`,
-                schema: {
-                    $ref: (0, swagger_1.getSchemaPath)(ModelConstr),
-                },
+                schema: { $ref: (0, swagger_1.getSchemaPath)(ModelConstr) },
             }),
             (0, swagger_1.ApiNotFoundResponse)({
                 description: `No ${modelClazzName} record matches the provided identifier.`,
             }),
             (0, swagger_1.ApiBadRequestResponse)({ description: "Payload validation failed." }),
-            __param(0, (0, index_js_1.DecafParams)(apiProperties)),
-            __param(1, (0, index_js_1.DecafBody)()),
-            __param(2, (0, common_1.Response)({ passthrough: true })),
-            __metadata("design:type", Function),
-            __metadata("design:paramtypes", [Object, Object, Object]),
-            __metadata("design:returntype", Promise)
-        ], DynamicModelController.prototype, "update", null);
-        __decorate([
-            (0, index_js_1.ApiOperationFromModel)(ModelConstr, "DELETE", "bulk"),
+        ];
+    }
+    static deleteDecorators(ModelConstr, modelClazzName, apiProperties, pkPath) {
+        return [
+            (0, index_js_1.ApiOperationFromModel)(ModelConstr, "DELETE", pkPath),
             (0, index_js_1.ApiParamsFromModel)(apiProperties),
-            (0, swagger_1.ApiOperation)({ summary: `Retrieve a ${modelClazzName} record by id.` }),
-            (0, swagger_1.ApiQuery)({ name: "ids", required: true, type: "array" }),
+            (0, swagger_1.ApiOperation)({ summary: `Delete a ${modelClazzName} record by id.` }),
             (0, swagger_1.ApiOkResponse)({
                 description: `${modelClazzName} deleted successfully.`,
-                schema: {
-                    type: "array",
-                    items: {
-                        $ref: (0, swagger_1.getSchemaPath)(ModelConstr),
-                    },
-                },
+                schema: { $ref: (0, swagger_1.getSchemaPath)(ModelConstr) },
             }),
             (0, swagger_1.ApiNotFoundResponse)({
                 description: `No ${modelClazzName} record matches the provided identifier.`,
             }),
-            __param(0, (0, common_1.Query)("ids")),
-            __param(1, (0, common_1.Response)({ passthrough: true })),
-            __metadata("design:type", Function),
-            __metadata("design:paramtypes", [Array, Object]),
-            __metadata("design:returntype", Promise)
-        ], DynamicModelController.prototype, "deleteAll", null);
-        __decorate([
-            (0, index_js_1.ApiOperationFromModel)(ModelConstr, "DELETE", path),
-            (0, index_js_1.ApiParamsFromModel)(apiProperties),
-            (0, swagger_1.ApiOperation)({ summary: `Delete a ${modelClazzName} record by id.` }),
-            (0, swagger_1.ApiOkResponse)({
-                description: `${modelClazzName} deleted successfully.`,
-                schema: {
-                    $ref: (0, swagger_1.getSchemaPath)(ModelConstr),
-                },
+        ];
+    }
+    static statementDecorators(ModelConstr, modelClazzName) {
+        return [
+            (0, index_js_1.ApiOperationFromModel)(ModelConstr, "GET", "statement/:method/*args"),
+            (0, swagger_1.ApiOperation)({
+                summary: `Executes a prepared statement on ${modelClazzName}.`,
+            }),
+            (0, swagger_1.ApiParam)({
+                name: "method",
+                description: "the prepared statement to execute",
+            }),
+            (0, swagger_1.ApiParam)({
+                name: "args",
+                description: "concatenated list of arguments the prepared statement can accept",
+            }),
+            (0, swagger_1.ApiQuery)({
+                name: "direction",
+                required: true,
+                enum: core_1.OrderDirection,
+                description: "the sort order when applicable",
             }),
+            (0, swagger_1.ApiQuery)({
+                name: "limit",
+                required: true,
+                description: "limit or page size when applicable",
+            }),
+            (0, swagger_1.ApiQuery)({
+                name: "offset",
+                required: true,
+                description: "offset or bookmark when applicable",
+            }),
+            (0, swagger_1.ApiOkResponse)({ description: `${modelClazzName} listed found.` }),
             (0, swagger_1.ApiNotFoundResponse)({
                 description: `No ${modelClazzName} record matches the provided identifier.`,
             }),
-            __param(0, (0, index_js_1.DecafParams)(apiProperties)),
-            __param(1, (0, common_1.Response)({ passthrough: true })),
-            __metadata("design:type", Function),
-            __metadata("design:paramtypes", [Object, Object]),
-            __metadata("design:returntype", Promise)
-        ], DynamicModelController.prototype, "delete", null);
-        DynamicModelController = __decorate([
-            (0, common_1.Controller)(routePath),
-            (0, swagger_1.ApiTags)(modelClazzName),
-            (0, swagger_1.ApiExtraModels)(ModelConstr),
-            (0, decorators_js_1.Auth)(ModelConstr),
-            __metadata("design:paramtypes", [index_js_2.DecafRequestContext])
-        ], DynamicModelController);
-        return DynamicModelController;
+        ];
     }
-    static getRouteParametersFromModel(ModelClazz) {
-        const pk = decorator_validation_1.Model.pk(ModelClazz);
-        const composed = decoration_1.Metadata.get(ModelClazz, decoration_1.Metadata.key(db_decorators_1.DBKeys.COMPOSED, pk));
-        const composedKeys = composed?.args ?? [];
-        // remove duplicates while preserving order
-        const uniqueKeys = Array.isArray(composedKeys) && composedKeys.length > 0
-            ? Array.from(new Set([...composedKeys]))
-            : Array.from(new Set([pk]));
-        const description = decoration_1.Metadata.description(ModelClazz);
-        const path = `:${uniqueKeys.join("/:")}`;
-        const apiProperties = uniqueKeys.map((key) => {
-            return {
-                name: key,
-                description: decoration_1.Metadata.description(ModelClazz, key),
-                required: true,
-                type: String,
-            };
+    static statementShortcutDecorators(ModelConstr, modelClazzName, path, statementKey) {
+        const base = [
+            (0, index_js_1.ApiOperationFromModel)(ModelConstr, "GET", path),
+            (0, swagger_1.ApiOperation)({ summary: `Retrieve ${modelClazzName} records.` }),
+            (0, swagger_1.ApiOkResponse)({
+                description: `${modelClazzName} retrieved successfully.`,
+            }),
+        ];
+        const segments = path.split("/").filter((s) => s.startsWith(":"));
+        segments.forEach((seg) => {
+            const name = seg.replace(":", "");
+            base.push((0, swagger_1.ApiParam)({ name, description: `The ${name} parameter` }));
         });
-        return {
-            path,
-            description,
-            apiProperties,
-            getPK: (...params) => composed?.separator ? params.join(composed.separator) : params.join(""),
-        };
+        if (path.startsWith("listBy/") ||
+            path.startsWith("paginateBy/") ||
+            path.startsWith("find/") ||
+            path.startsWith("page/")) {
+            base.push((0, swagger_1.ApiQuery)({
+                name: "direction",
+                required: true,
+                enum: core_1.OrderDirection,
+                description: "the sort order",
+            }));
+        }
+        if (path.startsWith("paginateBy/") || path.startsWith("page/")) {
+            base.push((0, swagger_1.ApiQuery)({ name: "limit", required: false, description: "page size" }), (0, swagger_1.ApiQuery)({
+                name: "offset",
+                required: false,
+                description: "page number",
+            }), (0, swagger_1.ApiQuery)({
+                name: "bookmark",
+                required: false,
+                description: "bookmark for cursor pagination",
+            }));
+        }
+        if (path.startsWith("findOneBy/") || path.startsWith("findBy/")) {
+            base.push((0, swagger_1.ApiNotFoundResponse)({
+                description: `No ${modelClazzName} record matches the provided identifier.`,
+            }));
+        }
+        if (statementKey === core_1.PreparedStatementKeys.COUNT_OF ||
+            statementKey === core_1.PreparedStatementKeys.AVG_OF ||
+            statementKey === core_1.PreparedStatementKeys.SUM_OF) {
+            base.push((0, swagger_1.ApiOkResponse)({
+                description: `Result for ${modelClazzName}.`,
+                type: Number,
+            }));
+        }
+        if (statementKey === core_1.PreparedStatementKeys.DISTINCT_OF) {
+            base.push((0, swagger_1.ApiOkResponse)({
+                description: `Distinct values for ${modelClazzName}.`,
+                type: [String],
+            }));
+        }
+        return base;
+    }
+    static getQueryDecorators(methodName, routePath, httpVerb, includeQueryParams = false) {
+        const extractPathParams = (p) => p
+            .split("/")
+            .filter((s) => s.startsWith(":"))
+            .map((s) => s.slice(1));
+        const apiPathParams = extractPathParams(routePath).map((name) => ({
+            name,
+            description: `${name} parameter for the query`,
+            required: true,
+            type: String,
+        }));
+        const decorators = [
+            ...apiPathParams.map((p) => (0, swagger_1.ApiParam)(p)),
+            (0, swagger_1.ApiOperation)({ summary: `Retrieve records using "${methodName}".` }),
+            (0, swagger_1.ApiOkResponse)({ description: "Result successfully retrieved." }),
+            (0, swagger_1.ApiNoContentResponse)({
+                description: "No content returned by the method.",
+            }),
+        ];
+        if (httpVerb === "GET" && includeQueryParams) {
+            decorators.push((0, swagger_1.ApiQuery)({
+                name: "direction",
+                required: false,
+                enum: core_1.OrderDirection,
+                description: "the sort order when applicable",
+            }), (0, swagger_1.ApiQuery)({
+                name: "limit",
+                required: false,
+                description: "limit or page size",
+            }), (0, swagger_1.ApiQuery)({
+                name: "offset",
+                required: false,
+                description: "offset or bookmark",
+            }));
+        }
+        return decorators;
     }
 }
 exports.FromModelController = FromModelController;
 //# sourceMappingURL=FromModelController.js.map
-//# sourceMappingURL=FromModelController.js.map
+//# sourceMappingURL=FromModelController.cjs.map