@decaf-ts/for-nest 0.1.7 → 0.1.9

package/lib/decaf-model/decorators/ApiOperationFromModel.d.ts

@@ -19,3 +19,12 @@ export declare function isOperationBlocked(ModelConstructor: ModelConstructor<an
  * @return {MethodDecorator} A method decorator that either excludes the endpoint from Swagger (and route registration) or applies the correct HTTP decorator.
  */
 export declare function ApiOperationFromModel(ModelConstructor: ModelConstructor<any>, verb: HttpVerbs, path?: string): MethodDecorator;
+/**
+ * @description Conditionally applies an HTTP method decorator for a given model and verb, hiding the endpoint in Swagger (and not registering the route) when the model blocks that CRUD operation.
+ * @summary Maps an HTTP verb to its corresponding `CrudOperations` key and Nest HTTP decorator (`@Get`, `@Post`, etc.). It checks `isOperationBlocked(ModelConstructor, crudOp)` and, if blocked, applies only `@ApiExcludeEndpoint()` (Swagger-hidden, no Nest route). If permitted, it applies the appropriate HTTP decorator with the optional `path`.
+ * @param {ModelConstructor<any>} ModelConstructor - The model constructor used to resolve operation-blocking rules.
+ * @param {HttpVerbs} verb - The HTTP verb to map (e.g., `"GET" | "POST" | "PUT" | "PATCH" | "DELETE"`).
+ * @param {string} [path] - Optional route path passed through to the corresponding Nest HTTP method decorator.
+ * @return {MethodDecorator} A method decorator that either excludes the endpoint from Swagger (and route registration) or applies the correct HTTP decorator.
+ */
+export declare function BulkApiOperationFromModel(ModelConstructor: ModelConstructor<any>, verb: HttpVerbs, path?: string): MethodDecorator;

package/lib/decaf-model/decorators/ApiOperationFromModel.js.map

@@ -1 +1 @@
-{"version":3,"file":"ApiOperationFromModel.js","sourceRoot":"","sources":["../../../src/decaf-model/decorators/ApiOperationFromModel.ts"],"names":[],"mappings":";;AAgBA,gDAiBC;AAUD,sDAoBC;AA/DD,qDAAgD;AAChD,2CAA+D;AAC/D,6CAAqD;AACrD,qDAA6C;AAC7C,2DAAwE;AAIxE;;;;;;;GAOG;AACH,SAAgB,kBAAkB,CAChC,gBAAuC,EACvC,EAAkB;IAElB,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,CAAC,qBAAQ,CAAC,GAAG,CACrC,gBAAuB,EACvB,6BAAa,CAAC,OAAO,GAAG,6BAAa,CAAC,KAAK,CAC5C,IAAI,EAAE,CAMN,CAAC;IAEF,+BAA+B;IAC/B,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,IAAI,EAAE,EAAE,CAAC,IAAI,KAAK,CAAC,CAAC;AAC5D,CAAC;AAED;;;;;;;GAOG;AACH,SAAgB,qBAAqB,CACnC,gBAAuC,EACvC,IAAe,EACf,IAAa;IAEb,MAAM,UAAU,GAGZ;QACF,GAAG,EAAE,CAAC,6BAAa,CAAC,IAAI,EAAE,YAAG,CAAC;QAC9B,IAAI,EAAE,CAAC,6BAAa,CAAC,MAAM,EAAE,aAAI,CAAC;QAClC,GAAG,EAAE,CAAC,6BAAa,CAAC,MAAM,EAAE,YAAG,CAAC;QAChC,KAAK,EAAE,CAAC,6BAAa,CAAC,MAAM,EAAE,cAAK,CAAC;QACpC,MAAM,EAAE,CAAC,6BAAa,CAAC,MAAM,EAAE,eAAM,CAAC;KACvC,CAAC;IAEF,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC;IACvD,OAAO,kBAAkB,CAAC,gBAAgB,EAAE,MAAM,CAAC;QACjD,CAAC,CAAC,IAAA,kBAAK,EAAC,IAAA,4BAAkB,GAAE,CAAC;QAC7B,CAAC,CAAC,IAAA,kBAAK,EAAC,mBAAmB,CAAC,IAAI,CAAC,CAAC,CAAC;AACvC,CAAC"}
+{"version":3,"file":"ApiOperationFromModel.js","sourceRoot":"","sources":["../../../src/decaf-model/decorators/ApiOperationFromModel.ts"],"names":[],"mappings":";;AAoBA,gDAiBC;AAUD,sDAoBC;AASD,8DAoBC;AAhGD,qDAAgD;AAChD,2CAA+D;AAC/D,6CAAqD;AACrD,qDAA6C;AAC7C,2DAIiC;AAIjC;;;;;;;GAOG;AACH,SAAgB,kBAAkB,CAChC,gBAAuC,EACvC,EAAkB;IAElB,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,CAAC,qBAAQ,CAAC,GAAG,CACrC,gBAAuB,EACvB,6BAAa,CAAC,OAAO,GAAG,6BAAa,CAAC,KAAK,CAC5C,IAAI,EAAE,CAMN,CAAC;IAEF,+BAA+B;IAC/B,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,IAAI,EAAE,EAAE,CAAC,IAAI,KAAK,CAAC,CAAC;AAC5D,CAAC;AAED;;;;;;;GAOG;AACH,SAAgB,qBAAqB,CACnC,gBAAuC,EACvC,IAAe,EACf,IAAa;IAEb,MAAM,UAAU,GAGZ;QACF,GAAG,EAAE,CAAC,6BAAa,CAAC,IAAI,EAAE,YAAG,CAAC;QAC9B,IAAI,EAAE,CAAC,6BAAa,CAAC,MAAM,EAAE,aAAI,CAAC;QAClC,GAAG,EAAE,CAAC,6BAAa,CAAC,MAAM,EAAE,YAAG,CAAC;QAChC,KAAK,EAAE,CAAC,6BAAa,CAAC,MAAM,EAAE,cAAK,CAAC;QACpC,MAAM,EAAE,CAAC,6BAAa,CAAC,MAAM,EAAE,eAAM,CAAC;KACvC,CAAC;IAEF,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC;IACvD,OAAO,kBAAkB,CAAC,gBAAgB,EAAE,MAAM,CAAC;QACjD,CAAC,CAAC,IAAA,kBAAK,EAAC,IAAA,4BAAkB,GAAE,CAAC;QAC7B,CAAC,CAAC,IAAA,kBAAK,EAAC,mBAAmB,CAAC,IAAI,CAAC,CAAC,CAAC;AACvC,CAAC;AACD;;;;;;;GAOG;AACH,SAAgB,yBAAyB,CACvC,gBAAuC,EACvC,IAAe,EACf,IAAa;IAEb,MAAM,UAAU,GAGZ;QACF,GAAG,EAAE,CAAC,qCAAqB,CAAC,QAAQ,EAAE,YAAG,CAAC;QAC1C,IAAI,EAAE,CAAC,qCAAqB,CAAC,UAAU,EAAE,aAAI,CAAC;QAC9C,GAAG,EAAE,CAAC,qCAAqB,CAAC,UAAU,EAAE,YAAG,CAAC;QAC5C,KAAK,EAAE,CAAC,qCAAqB,CAAC,UAAU,EAAE,cAAK,CAAC;QAChD,MAAM,EAAE,CAAC,qCAAqB,CAAC,UAAU,EAAE,eAAM,CAAC;KACnD,CAAC;IAEF,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC;IACvD,OAAO,kBAAkB,CAAC,gBAAgB,EAAE,MAAa,CAAC;QACxD,CAAC,CAAC,IAAA,kBAAK,EAAC,IAAA,4BAAkB,GAAE,CAAC;QAC7B,CAAC,CAAC,IAAA,kBAAK,EAAC,mBAAmB,CAAC,IAAI,CAAC,CAAC,CAAC;AACvC,CAAC"}

package/lib/decaf-model/decorators/ApiParamsFromModel.d.ts

@@ -1,4 +1,4 @@
-import type { DecafApiProperties } from "./types";
+import type { DecafApiProperty } from "./types";
 /**
  * @description Applies a set of Swagger `@ApiParam` decorators generated from a typed specification array.
  * @summary Transforms each entry of the provided `ApiParam[]` into a corresponding `@ApiParam()` decorator (defaulting `description`, `required`, and `type` when omitted) and composes them into a single decorator via Nest's `applyDecorators`. Useful for synchronizing runtime route params with OpenAPI documentation in a concise, declarative way.
@@ -10,4 +10,4 @@ import type { DecafApiProperties } from "./types";
  * @return {any} A composed decorator applying all generated `@ApiParam` decorators to the target method or controller.
  * @function ApiParamsFromModel
  */
-export declare function ApiParamsFromModel(props?: DecafApiProperties[]): MethodDecorator & ClassDecorator;
+export declare function ApiParamsFromModel(props?: DecafApiProperty[]): MethodDecorator & ClassDecorator;

package/lib/decaf-model/decorators/ApiParamsFromModel.js.map

@@ -1 +1 @@
-{"version":3,"file":"ApiParamsFromModel.js","sourceRoot":"","sources":["../../../src/decaf-model/decorators/ApiParamsFromModel.ts"],"names":[],"mappings":";;AAeA,gDAaC;AA5BD,2CAAiD;AACjD,6CAA0D;AAG1D;;;;;;;;;;GAUG;AACH,SAAgB,kBAAkB,CAChC,QAA8B,EAAE;IAEhC,MAAM,UAAU,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CACjC,IAAA,kBAAW,EAAC;QACV,IAAI,EAAE,CAAC,CAAC,IAAI;QACZ,WAAW,EAAE,CAAC,CAAC,WAAW,IAAI,mBAAmB,CAAC,CAAC,IAAI,EAAE;QACzD,QAAQ,EAAE,CAAC,CAAC,QAAQ,IAAI,IAAI;QAC5B,8BAA8B;QAC9B,IAAI,EAAE,CAAC,CAAC,IAAI,IAAI,MAAM;KACvB,CAAC,CACH,CAAC;IACF,OAAO,IAAA,wBAAe,EAAC,GAAG,UAAU,CAAC,CAAC;AACxC,CAAC"}
+{"version":3,"file":"ApiParamsFromModel.js","sourceRoot":"","sources":["../../../src/decaf-model/decorators/ApiParamsFromModel.ts"],"names":[],"mappings":";;AAeA,gDAaC;AA5BD,2CAAiD;AACjD,6CAA0D;AAG1D;;;;;;;;;;GAUG;AACH,SAAgB,kBAAkB,CAChC,QAA4B,EAAE;IAE9B,MAAM,UAAU,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CACjC,IAAA,kBAAW,EAAC;QACV,IAAI,EAAE,CAAC,CAAC,IAAI;QACZ,WAAW,EAAE,CAAC,CAAC,WAAW,IAAI,mBAAmB,CAAC,CAAC,IAAI,EAAE;QACzD,QAAQ,EAAE,CAAC,CAAC,QAAQ,IAAI,IAAI;QAC5B,8BAA8B;QAC9B,IAAI,EAAE,CAAC,CAAC,IAAI,IAAI,MAAM;KACvB,CAAC,CACH,CAAC;IACF,OAAO,IAAA,wBAAe,EAAC,GAAG,UAAU,CAAC,CAAC;AACxC,CAAC"}

package/lib/decaf-model/decorators/DecafParams.cjs

@@ -19,7 +19,7 @@ const OrderedParams = (0, common_1.createParamDecorator)((order, ctx) => {
     const original = (req?.params ?? {});
     const orderList = order ?? Object.keys(original);
     const ordered = orderList.map((k) => original[k]);
-    return { original, ordered, order: orderList };
+    return { raw: original, valuesInOrder: ordered, keysInOrder: orderList };
 });
 /**
  * @description A higher-level decorator factory that leverages `OrderedParams` to extract route parameters in a specific order derived from a list of `ApiParam` definitions.
@@ -31,4 +31,12 @@ function DecafParams(props = []) {
     const order = props.map((p) => p.name);
     return OrderedParams(order);
 }
+//
+// export function Ctx(){
+//   return createParamDecorator((data: unknown, ctx: ExecutionContext) => {
+//     const req = ctx.switchToHttp().getRequest();
+//
+//     const Context.args
+//   })
+// }
 //# sourceMappingURL=DecafParams.js.map

package/lib/decaf-model/decorators/DecafParams.d.ts

@@ -1,8 +1,8 @@
-import { DecafApiProperties } from "./types";
+import { DecafApiProperty } from "./types";
 /**
  * @description A higher-level decorator factory that leverages `OrderedParams` to extract route parameters in a specific order derived from a list of `ApiParam` definitions.
  * @summary `DecafParams` computes the order of route parameters based on the provided `ApiParam[]` specification (using each element’s `name`), then applies `OrderedParams(order)` as a parameter decorator. This enables parameter-level binding that remains consistent with the documented API parameter metadata.
  * @param {ApiParam[]} [props=[]] Array of `ApiParam` definitions whose `name` fields determine the parameter extraction order.
  * @return {ParameterDecorator} A NestJS parameter decorator that injects an ordered list of parameters and metadata into the controller method argument.
  */
-export declare function DecafParams(props?: DecafApiProperties[]): ParameterDecorator;
+export declare function DecafParams(props?: DecafApiProperty[]): ParameterDecorator;

package/lib/decaf-model/decorators/DecafParams.js.map

@@ -1 +1 @@
-{"version":3,"file":"DecafParams.js","sourceRoot":"","sources":["../../../src/decaf-model/decorators/DecafParams.ts"],"names":[],"mappings":";;AA8BA,kCAKC;AAnCD,2CAAwE;AAExE;;;;;;;;;;;GAWG;AACH,MAAM,aAAa,GAAG,IAAA,6BAAoB,EACxC,CAAC,KAA2B,EAAE,GAAqB,EAAmB,EAAE;IACtE,MAAM,GAAG,GAAG,GAAG,CAAC,YAAY,EAAE,CAAC,UAAU,EAAE,CAAC;IAC5C,MAAM,QAAQ,GAAG,CAAC,GAAG,EAAE,MAAM,IAAI,EAAE,CAAwB,CAAC;IAC5D,MAAM,SAAS,GAAG,KAAK,IAAI,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACjD,MAAM,OAAO,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;IAClD,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC;AACjD,CAAC,CACF,CAAC;AAEF;;;;;GAKG;AACH,SAAgB,WAAW,CACzB,QAA8B,EAAE;IAEhC,MAAM,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IACvC,OAAO,aAAa,CAAC,KAAK,CAAC,CAAC;AAC9B,CAAC"}
+{"version":3,"file":"DecafParams.js","sourceRoot":"","sources":["../../../src/decaf-model/decorators/DecafParams.ts"],"names":[],"mappings":";;AA8BA,kCAKC;AAnCD,2CAAwE;AAExE;;;;;;;;;;;GAWG;AACH,MAAM,aAAa,GAAG,IAAA,6BAAoB,EACxC,CAAC,KAA2B,EAAE,GAAqB,EAAmB,EAAE;IACtE,MAAM,GAAG,GAAG,GAAG,CAAC,YAAY,EAAE,CAAC,UAAU,EAAE,CAAC;IAC5C,MAAM,QAAQ,GAAG,CAAC,GAAG,EAAE,MAAM,IAAI,EAAE,CAAwB,CAAC;IAC5D,MAAM,SAAS,GAAG,KAAK,IAAI,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACjD,MAAM,OAAO,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;IAClD,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,aAAa,EAAE,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,CAAC;AAC3E,CAAC,CACF,CAAC;AAEF;;;;;GAKG;AACH,SAAgB,WAAW,CACzB,QAA4B,EAAE;IAE9B,MAAM,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IACvC,OAAO,aAAa,CAAC,KAAK,CAAC,CAAC;AAC9B,CAAC;AACD,EAAE;AACF,yBAAyB;AACzB,4EAA4E;AAC5E,mDAAmD;AACnD,EAAE;AACF,yBAAyB;AACzB,OAAO;AACP,IAAI"}

package/lib/decaf-model/decorators/index.cjs

@@ -18,4 +18,5 @@ __exportStar(require("./types.cjs"), exports);
 __exportStar(require("./ApiOperationFromModel.cjs"), exports);
 __exportStar(require("./ApiParamsFromModel.cjs"), exports);
 __exportStar(require("./DecafParams.cjs"), exports);
+__exportStar(require("./decorators.cjs"), exports);
 //# sourceMappingURL=index.js.map

package/lib/decaf-model/decorators/index.d.ts

@@ -2,3 +2,4 @@ export * from "./types";
 export * from "./ApiOperationFromModel";
 export * from "./ApiParamsFromModel";
 export * from "./DecafParams";
+export * from "./decorators";

package/lib/decaf-model/decorators/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/decaf-model/decorators/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,8CAAwB;AACxB,8DAAwC;AACxC,2DAAqC;AACrC,oDAA8B"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/decaf-model/decorators/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,8CAAwB;AACxB,8DAAwC;AACxC,2DAAqC;AACrC,oDAA8B;AAC9B,mDAA6B"}

package/lib/decaf-model/decorators/types.d.ts

@@ -1,5 +1,5 @@
 export type HttpVerbs = "GET" | "POST" | "PUT" | "PATCH" | "DELETE";
-export type DecafApiProperties = {
+export type DecafApiProperty = {
     name: string;
     description?: string;
     required?: boolean;
@@ -8,11 +8,11 @@ export type DecafApiProperties = {
 export type DecafModelRoute = {
     path: string;
     description?: string;
-    apiProperties: DecafApiProperties[];
+    apiProperties: DecafApiProperty[];
     getPK: (...args: Array<string | number>) => string;
 };
 export type DecafParamProps = {
-    original: Record<string, any>;
-    ordered: any[];
-    order: string[];
+    raw: Record<string, string | number>;
+    keysInOrder: Array<string>;
+    valuesInOrder: Array<string | number>;
 };

package/lib/decaf-model/types.cjs

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AbstractQueryController = void 0;
+const logging_1 = require("@decaf-ts/logging");
+class AbstractQueryController extends logging_1.LoggedClass {
+    constructor(clientContext) {
+        super();
+        this.clientContext = clientContext;
+    }
+    get persistence() {
+        throw new Error("Not implemented");
+    }
+}
+exports.AbstractQueryController = AbstractQueryController;
+//# sourceMappingURL=types.js.map

package/lib/decaf-model/types.d.ts

@@ -0,0 +1,18 @@
+import { ModelService, Repo } from "@decaf-ts/core";
+import { LoggedClass, Logger } from "@decaf-ts/logging";
+import { DecafRequestContext } from "../request/index";
+export interface Controller {
+    log: Logger;
+    persistence: Repo<any> | ModelService<any>;
+}
+export declare abstract class AbstractQueryController extends LoggedClass {
+    protected readonly clientContext: DecafRequestContext;
+    protected _persistence: Repo<any> | ModelService<any>;
+    protected constructor(clientContext: DecafRequestContext);
+    get persistence(): Repo<any> | ModelService<any>;
+}
+export type ControllerConstructor<T> = new (...args: any[]) => T;
+export type DecoratorBundle = {
+    method: MethodDecorator[];
+    params?: ParameterDecorator[];
+};

package/lib/decaf-model/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/decaf-model/types.ts"],"names":[],"mappings":";;;AACA,+CAAwD;AAQxD,MAAsB,uBAAwB,SAAQ,qBAAW;IAI/D,YAAsB,aAAkC;QACtD,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,aAAa,GAAG,aAAa,CAAC;IACrC,CAAC;IAED,IAAI,WAAW;QACb,MAAM,IAAI,KAAK,CAAC,iBAAiB,CAAC,CAAC;IACrC,CAAC;CACF;AAZD,0DAYC"}

package/lib/decaf-model/utils.cjs

@@ -0,0 +1,67 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getApiDecorators = getApiDecorators;
+exports.applyApiDecorators = applyApiDecorators;
+exports.createRouteHandler = createRouteHandler;
+exports.defineRouteMethod = defineRouteMethod;
+const common_1 = require("@nestjs/common");
+const swagger_1 = require("@nestjs/swagger");
+const decorators_1 = require("./decorators/index.cjs");
+const extractPathParams = (routePath) => {
+    return routePath
+        .split("/")
+        .filter((p) => p.startsWith(":"))
+        .map((p) => p.slice(1));
+};
+const apiParamSpec = (name) => ({
+    name,
+    description: `${name} parameter for the query`,
+    required: true,
+    type: String,
+});
+function getApiDecorators(methodName, routePath) {
+    const apiPathParams = extractPathParams(routePath).map(apiParamSpec);
+    return {
+        method: [
+            (0, common_1.Get)(routePath),
+            ...apiPathParams.map(swagger_1.ApiParam),
+            (0, swagger_1.ApiOperation)({
+                summary: `Retrieve records using custom query "${methodName}".`,
+            }),
+            (0, swagger_1.ApiOkResponse)({
+                description: `Results successfully retrieved.`,
+            }),
+            (0, swagger_1.ApiNoContentResponse)({
+                description: `No content returned by the query.`,
+            }),
+        ],
+        params: [(0, decorators_1.DecafParams)(apiPathParams), (0, common_1.Query)()],
+    };
+}
+function applyApiDecorators(target, methodName, descriptor, decorators) {
+    const proto = target?.prototype ?? target;
+    decorators.method.forEach((d) => d(proto, methodName, descriptor));
+    decorators.params?.forEach((d, index) => d(proto, methodName, index));
+}
+function createRouteHandler(methodName) {
+    return async function (pathParams, queryParams) {
+        const log = this.log.for(methodName);
+        try {
+            log.debug(`Invoking persistence method "${methodName}" given parameters: ${JSON.stringify(pathParams.valuesInOrder)}`);
+            const { direction, limit, offset } = queryParams;
+            return (await this.persistence[methodName](...pathParams.valuesInOrder, direction, limit, offset));
+        }
+        catch (e) {
+            log.error(`Custom query "${methodName}" failed`, e);
+            throw e;
+        }
+    };
+}
+function defineRouteMethod(ControllerClass, methodName, handler) {
+    Object.defineProperty(ControllerClass.prototype || ControllerClass, methodName, {
+        value: handler,
+        writable: false,
+    });
+    return Object.getOwnPropertyDescriptor(ControllerClass.prototype || ControllerClass, methodName);
+}
+//# sourceMappingURL=utils.js.map

package/lib/decaf-model/utils.d.ts

@@ -0,0 +1,7 @@
+import { Controller, type DecoratorBundle } from "./types";
+import { type DecafParamProps } from "./decorators";
+import { DirectionLimitOffset } from "@decaf-ts/core";
+export declare function getApiDecorators(methodName: string, routePath: string): DecoratorBundle;
+export declare function applyApiDecorators(target: any, methodName: string, descriptor: PropertyDescriptor, decorators: DecoratorBundle): void;
+export declare function createRouteHandler<T>(methodName: string): (this: Controller, pathParams: DecafParamProps, queryParams: DirectionLimitOffset) => Promise<T>;
+export declare function defineRouteMethod(ControllerClass: new (...args: any[]) => any, methodName: string, handler: (...args: any[]) => any): PropertyDescriptor | undefined;

package/lib/decaf-model/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../src/decaf-model/utils.ts"],"names":[],"mappings":";;AA8BA,4CAqBC;AAED,gDASC;AAED,gDAwBC;AAED,8CAkBC;AA5GD,2CAA4C;AAG5C,6CAKyB;AACzB,uDAIsB;AAGtB,MAAM,iBAAiB,GAAG,CAAC,SAAiB,EAAY,EAAE;IACxD,OAAO,SAAS;SACb,KAAK,CAAC,GAAG,CAAC;SACV,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;SAChC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;AAC5B,CAAC,CAAC;AAEF,MAAM,YAAY,GAAG,CAAC,IAAY,EAAoB,EAAE,CAAC,CAAC;IACxD,IAAI;IACJ,WAAW,EAAE,GAAG,IAAI,0BAA0B;IAC9C,QAAQ,EAAE,IAAI;IACd,IAAI,EAAE,MAAM;CACb,CAAC,CAAC;AAEH,SAAgB,gBAAgB,CAC9B,UAAkB,EAClB,SAAiB;IAEjB,MAAM,aAAa,GAAG,iBAAiB,CAAC,SAAS,CAAC,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;IACrE,OAAO;QACL,MAAM,EAAE;YACN,IAAA,YAAG,EAAC,SAAS,CAAC;YACd,GAAG,aAAa,CAAC,GAAG,CAAC,kBAAQ,CAAC;YAC9B,IAAA,sBAAY,EAAC;gBACX,OAAO,EAAE,wCAAwC,UAAU,IAAI;aAChE,CAAC;YACF,IAAA,uBAAa,EAAC;gBACZ,WAAW,EAAE,iCAAiC;aAC/C,CAAC;YACF,IAAA,8BAAoB,EAAC;gBACnB,WAAW,EAAE,mCAAmC;aACjD,CAAC;SACH;QACD,MAAM,EAAE,CAAC,IAAA,wBAAW,EAAC,aAAa,CAAC,EAAE,IAAA,cAAK,GAAE,CAAC;KAC9C,CAAC;AACJ,CAAC;AAED,SAAgB,kBAAkB,CAChC,MAAW,EACX,UAAkB,EAClB,UAA8B,EAC9B,UAA2B;IAE3B,MAAM,KAAK,GAAG,MAAM,EAAE,SAAS,IAAI,MAAM,CAAC;IAC1C,UAAU,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,EAAE,UAAU,EAAE,UAAU,CAAC,CAAC,CAAC;IACnE,UAAU,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,EAAE,UAAU,EAAE,KAAK,CAAC,CAAC,CAAC;AACxE,CAAC;AAED,SAAgB,kBAAkB,CAAI,UAAkB;IACtD,OAAO,KAAK,WAEV,UAA2B,EAC3B,WAAiC;QAEjC,MAAM,GAAG,GAAW,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QAE7C,IAAI,CAAC;YACH,GAAG,CAAC,KAAK,CACP,gCAAgC,UAAU,uBAAuB,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,aAAa,CAAC,EAAE,CAC5G,CAAC;YACF,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,WAAW,CAAC;YACjD,OAAO,CAAC,MAAO,IAAI,CAAC,WAAmC,CAAC,UAAU,CAAC,CACjE,GAAG,UAAU,CAAC,aAAa,EAC3B,SAAS,EACT,KAAK,EACL,MAAM,CACP,CAAM,CAAC;QACV,CAAC;QAAC,OAAO,CAAM,EAAE,CAAC;YAChB,GAAG,CAAC,KAAK,CAAC,iBAAiB,UAAU,UAAU,EAAE,CAAC,CAAC,CAAC;YACpD,MAAM,CAAC,CAAC;QACV,CAAC;IACH,CAAC,CAAC;AACJ,CAAC;AAED,SAAgB,iBAAiB,CAC/B,eAA4C,EAC5C,UAAkB,EAClB,OAAgC;IAEhC,MAAM,CAAC,cAAc,CACnB,eAAe,CAAC,SAAS,IAAI,eAAe,EAC5C,UAAU,EACV;QACE,KAAK,EAAE,OAAO;QACd,QAAQ,EAAE,KAAK;KAChB,CACF,CAAC;IAEF,OAAO,MAAM,CAAC,wBAAwB,CACpC,eAAe,CAAC,SAAS,IAAI,eAAe,EAC5C,UAAU,CACX,CAAC;AACJ,CAAC"}

package/lib/esm/decaf-model/DecafModelModule.d.ts

@@ -1,7 +1,7 @@
-import { DynamicModule, Type } from "@nestjs/common";
-import { type DecafRequestHandler } from "../types";
+import { DynamicModule } from "@nestjs/common";
+import { DecafModuleOptions } from "../types";
 export declare class DecafModelModule {
     private static readonly log;
     private static createModelServices;
-    static forRoot(flavour: string, handlers?: Type<DecafRequestHandler>[]): DynamicModule;
+    static forRoot(flavour: string, options?: Partial<DecafModuleOptions>): DynamicModule;
 }

package/lib/esm/decaf-model/DecafModelModule.js

@@ -22,11 +22,16 @@ let DecafModelModule = class DecafModelModule {
             useFactory: () => ModelService.forModel(model),
         }));
     }
-    static forRoot(flavour, handlers = []) {
+    static forRoot(flavour, options = {}) {
         const log = this.log.for(this.forRoot);
         log.info(`Generating controllers for flavour...`);
         const trackedModels = Adapter.models(flavour);
-        const modelServices = this.createModelServices(trackedModels);
+        let modelServices = [];
+        if (options.autoServices) {
+            log.info("Auto-services enabled. Initializing service generation.");
+            modelServices = this.createModelServices(trackedModels);
+            log.info(`Auto-services completed. ${modelServices.length} services initialized.`);
+        }
         const controllers = trackedModels.map(FromModelController.create);
         log.info(`Generated ${controllers.length} controllers`);
         return {
@@ -36,10 +41,10 @@ let DecafModelModule = class DecafModelModule {
                 {
                     provide: DECAF_HANDLERS,
                     useFactory: () => {
-                        return handlers.map((H) => {
+                        return (options.handlers?.map((H) => {
                             log.info(`Registered request handler: ${H.name}`);
                             return new H();
-                        });
+                        }) ?? []);
                     },
                 },
                 DecafRequestContext,

package/lib/esm/decaf-model/DecafModelModule.js.map

@@ -1 +1 @@
-{"version":3,"file":"DecafModelModule.js","sourceRoot":"","sources":["../../../src/decaf-model/DecafModelModule.ts"],"names":[],"mappings":";;;;;;;AAAA,OAAO,EAAiB,MAAM,EAAkB,MAAM,gBAAgB,CAAC;AACvE,OAAO,EAAE,OAAO,EAAE,YAAY,EAAW,MAAM,gBAAgB,CAAC;AAChE,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAC5C,OAAO,EAAE,mBAAmB,EAAE,iCAA8B;AAC5D,OAAO,EAAE,8BAA8B,EAAE,mCAAwB;AACjE,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAE/C,OAAO,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,8BAAmB;AACvE,OAAO,EAAE,cAAc,EAAE,0BAAqB;AAGvC,IAAM,gBAAgB,GAAtB,MAAM,gBAAgB;;aACH,QAAG,GAAG,OAAO,CAAC,GAAG,CAAC,kBAAgB,CAAC,IAAI,CAAC,AAArC,CAAsC;IAEzD,MAAM,CAAC,mBAAmB,CAAC,MAAa;QAC9C,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;YAC5B,OAAO,EAAE,GAAG,KAAK,CAAC,IAAI,SAAS;YAC/B,UAAU,EAAE,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,CAAC,KAAK,CAAC;SAC/C,CAAC,CAAC,CAAC;IACN,CAAC;IAED,MAAM,CAAC,OAAO,CACZ,OAAe,EACf,WAAwC,EAAE;QAE1C,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACvC,GAAG,CAAC,IAAI,CAAC,uCAAuC,CAAC,CAAC;QAElD,MAAM,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QAC9C,MAAM,aAAa,GAAG,IAAI,CAAC,mBAAmB,CAAC,aAAa,CAAC,CAAC;QAC9D,MAAM,WAAW,GAAG,aAAa,CAAC,GAAG,CAAC,mBAAmB,CAAC,MAAM,CAAC,CAAC;QAElE,GAAG,CAAC,IAAI,CAAC,aAAa,WAAW,CAAC,MAAM,cAAc,CAAC,CAAC;QAExD,OAAO;YACL,MAAM,EAAE,kBAAgB;YACxB,WAAW;YACX,SAAS,EAAE;gBACT;oBACE,OAAO,EAAE,cAAc;oBACvB,UAAU,EAAE,GAAG,EAAE;wBACf,OAAO,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;4BACxB,GAAG,CAAC,IAAI,CAAC,+BAA+B,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;4BAClD,OAAO,IAAI,CAAC,EAAE,CAAC;wBACjB,CAAC,CAAC,CAAC;oBACL,CAAC;iBACF;gBACD,mBAAmB;gBACnB,oBAAoB;gBACpB;oBACE,OAAO,EAAE,eAAe;oBACxB,QAAQ,EAAE,8BAA8B;iBACzC;gBACD,GAAG,aAAa;aACjB;SACF,CAAC;IACJ,CAAC;;AA7CU,gBAAgB;IAD5B,MAAM,CAAC,EAAE,CAAC;GACE,gBAAgB,CA8C5B"}
+{"version":3,"file":"DecafModelModule.js","sourceRoot":"","sources":["../../../src/decaf-model/DecafModelModule.ts"],"names":[],"mappings":";;;;;;;AAAA,OAAO,EAAiB,MAAM,EAAY,MAAM,gBAAgB,CAAC;AACjE,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAC5C,OAAO,EAAE,mBAAmB,EAAE,iCAA8B;AAC5D,OAAO,EAAE,8BAA8B,EAAE,mCAAwB;AACjE,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAE/C,OAAO,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,8BAAmB;AACvE,OAAO,EAAE,cAAc,EAAE,0BAAqB;AAIvC,IAAM,gBAAgB,GAAtB,MAAM,gBAAgB;;aACH,QAAG,GAAG,OAAO,CAAC,GAAG,CAAC,kBAAgB,CAAC,IAAI,CAAC,AAArC,CAAsC;IAEzD,MAAM,CAAC,mBAAmB,CAChC,MAA6B;QAE7B,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;YAC5B,OAAO,EAAE,GAAG,KAAK,CAAC,IAAI,SAAS;YAC/B,UAAU,EAAE,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,CAAC,KAAK,CAAC;SAC/C,CAAC,CAAC,CAAC;IACN,CAAC;IAED,MAAM,CAAC,OAAO,CACZ,OAAe,EACf,UAAuC,EAAE;QAEzC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACvC,GAAG,CAAC,IAAI,CAAC,uCAAuC,CAAC,CAAC;QAElD,MAAM,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QAE9C,IAAI,aAAa,GAAe,EAAE,CAAC;QACnC,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;YACzB,GAAG,CAAC,IAAI,CAAC,yDAAyD,CAAC,CAAC;YACpE,aAAa,GAAG,IAAI,CAAC,mBAAmB,CAAC,aAAa,CAAC,CAAC;YACxD,GAAG,CAAC,IAAI,CACN,4BAA4B,aAAa,CAAC,MAAM,wBAAwB,CACzE,CAAC;QACJ,CAAC;QAED,MAAM,WAAW,GAAG,aAAa,CAAC,GAAG,CAAC,mBAAmB,CAAC,MAAM,CAAC,CAAC;QAClE,GAAG,CAAC,IAAI,CAAC,aAAa,WAAW,CAAC,MAAM,cAAc,CAAC,CAAC;QAExD,OAAO;YACL,MAAM,EAAE,kBAAgB;YACxB,WAAW;YACX,SAAS,EAAE;gBACT;oBACE,OAAO,EAAE,cAAc;oBACvB,UAAU,EAAE,GAAG,EAAE;wBACf,OAAO,CACL,OAAO,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;4BAC1B,GAAG,CAAC,IAAI,CAAC,+BAA+B,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;4BAClD,OAAO,IAAI,CAAC,EAAE,CAAC;wBACjB,CAAC,CAAC,IAAI,EAAE,CACT,CAAC;oBACJ,CAAC;iBACF;gBACD,mBAAmB;gBACnB,oBAAoB;gBACpB;oBACE,OAAO,EAAE,eAAe;oBACxB,QAAQ,EAAE,8BAA8B;iBACzC;gBACD,GAAG,aAAa;aACjB;SACF,CAAC;IACJ,CAAC;;AAzDU,gBAAgB;IAD5B,MAAM,CAAC,EAAE,CAAC;GACE,gBAAgB,CA0D5B"}

package/lib/esm/decaf-model/FromModelController.d.ts

@@ -1,5 +1,7 @@
+import { ModelService, type Repo } from "@decaf-ts/core";
 import { Model, ModelConstructor } from "@decaf-ts/decorator-validation";
-import type { DecafModelRoute } from "./decorators";
+import { type DecafModelRoute } from "./decorators";
+import { AbstractQueryController, ControllerConstructor } from "./types";
 /**
  * @description
  * Factory and utilities for generating dynamic NestJS controllers from Decaf {@link Model} definitions.
@@ -51,6 +53,8 @@ import type { DecafModelRoute } from "./decorators";
  */
 export declare class FromModelController {
     private static readonly log;
-    static create<T extends Model<any>>(ModelClazz: ModelConstructor<T>): any;
+    static getPersistence<T extends Model<boolean>>(ModelClazz: ModelConstructor<T>): Repo<T> | ModelService<T>;
+    static createQueryRoutesFromRepository<T extends Model<boolean>>(persistence: Repo<T> | ModelService<T>, prefix?: string): ControllerConstructor<AbstractQueryController>;
+    static create<T extends Model<any>>(ModelConstr: ModelConstructor<T>): any;
     static getRouteParametersFromModel<T extends Model<any>>(ModelClazz: ModelConstructor<T>): DecafModelRoute;
 }