nicot 1.2.4 → 1.2.6

package/dist/index.cjs

@@ -38,6 +38,8 @@ var __decorateClass = (decorators, target, key, kind) => {
 // index.ts
 var index_exports = {};
 __export(index_exports, {
+  BindingColumn: () => BindingColumn,
+  BindingValue: () => BindingValue,
   BlankCursorPaginationReturnMessageDto: () => BlankCursorPaginationReturnMessageDto,
   BoolColumn: () => BoolColumn,
   CrudBase: () => CrudBase,
@@ -45,6 +47,7 @@ __export(index_exports, {
   CursorPaginationDto: () => CursorPaginationDto,
   CursorPaginationReturnMessageDto: () => CursorPaginationReturnMessageDto,
   DateColumn: () => DateColumn,
+  DefaultBindingKey: () => DefaultBindingKey,
   EnumColumn: () => EnumColumn,
   FloatColumn: () => FloatColumn,
   GenericCursorPaginationReturnMessageDto: () => GenericCursorPaginationReturnMessageDto,
@@ -870,6 +873,18 @@ var QueryOr = (...decs) => {
   });
 };
 
+// src/decorators/binding.ts
+var DefaultBindingKey = "default";
+var BindingColumn = (bindingKey = DefaultBindingKey) => Metadata.set("bindingColumn", bindingKey, "bindingColumnFields");
+var BindingValue = (bindingKey = DefaultBindingKey) => (obj, key, des) => {
+  const isMethod = !!des && typeof des.value === "function";
+  Metadata.set(
+    "bindingValue",
+    { bindingKey, isMethod },
+    "bindingValueFields"
+  )(obj, key);
+};
+
 // src/dto/cursor-pagination.ts
 var CursorPaginationDto = class {
 };
@@ -1458,6 +1473,30 @@ async function getPaginatedResult(qb, entityClass, entityAliasName, take, cursor
 
 // src/crud-base.ts
 var import_p_queue = __toESM(require("p-queue"));
+
+// src/utility/observe-diff.ts
+var observeDiff = (obj, cb) => {
+  return new Proxy(obj, {
+    set(target, key, value) {
+      const oldValue = target[key];
+      const type = Object.prototype.hasOwnProperty.call(target, key) ? "update" : "add";
+      target[key] = value;
+      cb({ type, key, oldValue, newValue: value });
+      return true;
+    },
+    deleteProperty(target, key) {
+      if (Object.prototype.hasOwnProperty.call(target, key)) {
+        const oldValue = target[key];
+        delete target[key];
+        cb({ type: "delete", key, oldValue, newValue: void 0 });
+        return true;
+      }
+      return false;
+    }
+  });
+};
+
+// src/crud-base.ts
 var Relation = (name, options = {}) => {
   return { name, inner: false, ...options };
 };
@@ -1491,7 +1530,11 @@ var CrudBase = class {
     });
     this.log = new import_common2.ConsoleLogger(`${this.entityClass.name}Service`);
     this._typeormRelations = getTypeormRelations(this.entityClass);
+    // binding things
+    this._tmpBindingMap = /* @__PURE__ */ new Map();
+    this._bindingCache = /* @__PURE__ */ new Map();
   }
+  // cleaning entities
   _cleanEntityNotInResultFields(ent) {
     const visited = /* @__PURE__ */ new Set();
     const runSingleObject = (o, cl) => {
@@ -1535,6 +1578,105 @@ var CrudBase = class {
       return this._cleanEntityNotInResultFields(ents);
     }
   }
+  _lookForBindingValueField(bindingKey) {
+    if (this._bindingCache.has(bindingKey)) {
+      return this._bindingCache.get(bindingKey);
+    }
+    const bindingServiceFields = getSpecificFields(this, "bindingValue");
+    const useField = bindingServiceFields.find((f) => {
+      const meta = reflector.get("bindingValue", this, f);
+      return meta?.bindingKey === bindingKey;
+    });
+    if (useField) {
+      const meta = reflector.get("bindingValue", this, useField);
+      const res = {
+        ...meta,
+        field: useField
+      };
+      this._bindingCache.set(bindingKey, res);
+      return res;
+    }
+    return void 0;
+  }
+  _resolveBindingValue(entityField) {
+    const bindingKey = reflector.get(
+      "bindingColumn",
+      this.entityClass,
+      entityField
+    );
+    if (!bindingKey) {
+      return void 0;
+    }
+    if (this._tmpBindingMap.has(bindingKey)) {
+      return this._tmpBindingMap.get(bindingKey);
+    }
+    const bindingValueField = this._lookForBindingValueField(bindingKey);
+    if (!bindingValueField) {
+      return void 0;
+    }
+    if (bindingValueField.isMethod) {
+      return this[bindingValueField.field]();
+    } else {
+      return this[bindingValueField.field];
+    }
+  }
+  // MUST be called 1st on every CRUD operation
+  async getBindingPartialEntity() {
+    const bindingFields = getSpecificFields(this.entityClass, "bindingColumn");
+    if (!bindingFields.length) {
+      return {};
+    }
+    const values = bindingFields.map((field, i) => {
+      return {
+        field,
+        value: this._resolveBindingValue(field),
+        i
+      };
+    });
+    this._tmpBindingMap.clear();
+    const containingPromiseValues = values.filter(
+      (v) => v.value instanceof Promise
+    );
+    if (containingPromiseValues.length) {
+      await Promise.all(
+        containingPromiseValues.map(async (v) => {
+          v.value = await v.value;
+        })
+      );
+    }
+    const res = {};
+    for (const v of values) {
+      if (v.value != null) {
+        res[v.field] = v.value;
+      }
+    }
+    return res;
+  }
+  useBinding(value, bindngKey = DefaultBindingKey) {
+    this._tmpBindingMap.set(bindngKey, value);
+    return this;
+  }
+  _freezeBindings() {
+    const res = {};
+    for (const [key, value] of this._tmpBindingMap.entries()) {
+      res[key] = value;
+    }
+    this._tmpBindingMap.clear();
+    return res;
+  }
+  _restoreBindings(frozen) {
+    this._tmpBindingMap.clear();
+    for (const key of Object.keys(frozen)) {
+      this._tmpBindingMap.set(key, frozen[key]);
+    }
+    return this;
+  }
+  async beforeSuper(fn) {
+    const snap = this._freezeBindings();
+    const res = await fn();
+    this._restoreBindings(snap);
+    return res;
+  }
   async _batchCreate(ents, beforeCreate, skipErrors = false) {
     const entsWithId = ents.filter((ent) => ent.id != null);
     return this.repo.manager.transaction(async (mdb) => {
@@ -1640,6 +1782,7 @@ var CrudBase = class {
     });
   }
   async create(_ent, beforeCreate) {
+    const bindingEnt = await this.getBindingPartialEntity();
     if (!_ent) {
       throw new import_nesties8.BlankReturnMessageDto(400, "Invalid entity").toException();
     }
@@ -1674,6 +1817,7 @@ var CrudBase = class {
           }
         }
       }
+      Object.assign(ent, bindingEnt);
       if (beforeCreate) {
         await beforeCreate(repo);
       }
@@ -1739,10 +1883,20 @@ var CrudBase = class {
   queryBuilder() {
     return this.repo.createQueryBuilder(this.entityAliasName);
   }
+  _applyQueryFromBinding(bindingEnt, qb) {
+    for (const [key, value] of Object.entries(bindingEnt)) {
+      const typeormKey = `_binding_${key}`;
+      qb.andWhere(`${this.entityAliasName}.${key} = :${typeormKey}`, {
+        [typeormKey]: value
+      });
+    }
+  }
   async findOne(id, extraQuery = () => {
   }) {
+    const bindingEnt = await this.getBindingPartialEntity();
     const query = this.queryBuilder().where(`${this.entityAliasName}.id = :id`, { id }).take(1);
     this._applyQueryRelations(query);
+    this._applyQueryFromBinding(bindingEnt, query);
     this.extraGetQuery(query);
     extraQuery(query);
     query.take(1);
@@ -1773,6 +1927,7 @@ var CrudBase = class {
   }
   async _preFindAll(ent, extraQuery = () => {
   }) {
+    const bindingEnt = await this.getBindingPartialEntity();
     const query = this.queryBuilder().where("1 = 1");
     const newEnt = new this.entityClass();
     if (ent) {
@@ -1782,6 +1937,7 @@ var CrudBase = class {
     }
     this._applyQueryRelations(query);
     this._applyQueryFilters(query, newEnt);
+    this._applyQueryFromBinding(bindingEnt, query);
     const pageSettings = newEnt instanceof PageSettingsDto ? newEnt : Object.assign(new PageSettingsDto(), newEnt);
     this.extraGetQuery(query);
     extraQuery(query);
@@ -1840,6 +1996,7 @@ var CrudBase = class {
     }
   }
   async update(id, entPart, cond = {}) {
+    const bindingEnt = await this.getBindingPartialEntity();
     let result;
     const ent = new this.entityClass();
     Object.assign(ent, entPart);
@@ -1852,6 +2009,7 @@ var CrudBase = class {
       result = await this.repo.update(
         {
           id,
+          ...bindingEnt,
           ...cond
         },
         ent
@@ -1873,9 +2031,11 @@ var CrudBase = class {
     return new import_nesties8.BlankReturnMessageDto(200, "success");
   }
   async delete(id, cond = {}) {
+    const bindingEnt = await this.getBindingPartialEntity();
     let result;
     const searchCond = {
       id,
+      ...bindingEnt,
       ...cond
     };
     try {
@@ -1893,6 +2053,7 @@ var CrudBase = class {
     return new import_nesties8.BlankReturnMessageDto(200, "success");
   }
   async importEntities(_ents, extraChecking) {
+    const bindingEnt = await this.getBindingPartialEntity();
     const ents = _ents.map((ent) => {
       const newEnt = new this.entityClass();
       Object.assign(
@@ -1920,6 +2081,9 @@ var CrudBase = class {
     const remainingEnts = ents.filter(
       (ent) => !invalidResults.find((result) => result.entry === ent)
     );
+    for (const ent of remainingEnts) {
+      Object.assign(ent, bindingEnt);
+    }
     await Promise.all(remainingEnts.map((ent) => ent.beforeCreate?.()));
     const data = await this._batchCreate(remainingEnts, void 0, true);
     await Promise.all(data.results.map((e) => e.afterCreate?.()));
@@ -1939,9 +2103,72 @@ var CrudBase = class {
       })
     );
   }
-  async exists(id) {
-    const ent = await this.repo.findOne({ where: { id }, select: ["id"] });
-    return !!ent;
+  async exists(id, cond = {}) {
+    const bindingEnt = await this.getBindingPartialEntity();
+    return this.repo.exists({
+      where: { id, ...bindingEnt, ...cond }
+    });
+  }
+  async operation(id, cb, extraOptions = {}) {
+    const bindingEnt = await this.getBindingPartialEntity();
+    const where = {
+      id,
+      ...bindingEnt,
+      ...extraOptions.where || {}
+    };
+    const throw404 = () => {
+      throw new import_nesties8.BlankReturnMessageDto(
+        404,
+        `${this.entityName} ID ${id} not found.`
+      ).toException();
+    };
+    if (!await this.repo.exists({ where })) {
+      throw404();
+    }
+    const res = await this.repo.manager.transaction(async (tdb) => {
+      const repo = tdb.getRepository(this.entityClass);
+      const ent = await repo.findOne({
+        lock: { mode: "pessimistic_write" },
+        ...extraOptions,
+        where
+      });
+      if (!ent) {
+        throw404();
+      }
+      const initial = { ...ent };
+      let changes = {};
+      const entProxy = observeDiff(ent, (change) => {
+        if (change.type === "delete") {
+          if (initial[change.key] === null) {
+            delete changes[change.key];
+          } else {
+            changes[change.key] = null;
+          }
+        } else {
+          if (change.newValue !== initial[change.key]) {
+            changes[change.key] = change.newValue;
+          } else {
+            delete changes[change.key];
+          }
+        }
+      });
+      const flush = async () => {
+        if (Object.keys(changes).length) {
+          const currentChanges = { ...changes };
+          Object.assign(initial, changes);
+          changes = {};
+          await repo.update({ id }, currentChanges);
+        }
+      };
+      const result = await cb(entProxy, { repo, flush });
+      await flush();
+      return result;
+    });
+    if (res == null) {
+      return new import_nesties8.BlankReturnMessageDto(200, "success");
+    } else {
+      return new import_nesties8.GenericReturnMessageDto(200, "success", res);
+    }
   }
   async _loadFullTextIndex() {
     const fields = reflector.getArray(
@@ -2163,7 +2390,132 @@ var _RestfulFactory = class _RestfulFactory {
       filterRelations(entityClass, options.relations);
     }
   }
-  getEntityClassName() {
+  omitInput(...fields) {
+    return new _RestfulFactory(
+      this.entityClass,
+      {
+        ...this.options,
+        fieldsToOmit: import_lodash5.default.uniq([...this.options.fieldsToOmit || [], ...fields])
+      },
+      this.__resolveVisited
+    );
+  }
+  omitWrite(...fields) {
+    return new _RestfulFactory(
+      this.entityClass,
+      {
+        ...this.options,
+        writeFieldsToOmit: import_lodash5.default.uniq([
+          ...this.options.writeFieldsToOmit || [],
+          ...fields
+        ])
+      },
+      this.__resolveVisited
+    );
+  }
+  omitCreate(...fields) {
+    return new _RestfulFactory(
+      this.entityClass,
+      {
+        ...this.options,
+        createFieldsToOmit: import_lodash5.default.uniq([
+          ...this.options.createFieldsToOmit || [],
+          ...fields
+        ])
+      },
+      this.__resolveVisited
+    );
+  }
+  omitUpdate(...fields) {
+    return new _RestfulFactory(
+      this.entityClass,
+      {
+        ...this.options,
+        updateFieldsToOmit: import_lodash5.default.uniq([
+          ...this.options.updateFieldsToOmit || [],
+          ...fields
+        ])
+      },
+      this.__resolveVisited
+    );
+  }
+  omitFindAll(...fields) {
+    return new _RestfulFactory(
+      this.entityClass,
+      {
+        ...this.options,
+        findAllFieldsToOmit: import_lodash5.default.uniq([
+          ...this.options.findAllFieldsToOmit || [],
+          ...fields
+        ])
+      },
+      this.__resolveVisited
+    );
+  }
+  omitOutput(...fields) {
+    return new _RestfulFactory(
+      this.entityClass,
+      {
+        ...this.options,
+        outputFieldsToOmit: import_lodash5.default.uniq([
+          ...this.options.outputFieldsToOmit || [],
+          ...fields
+        ])
+      },
+      this.__resolveVisited
+    );
+  }
+  pathPrefix(prefix) {
+    return new _RestfulFactory(
+      this.entityClass,
+      {
+        ...this.options,
+        prefix
+      },
+      this.__resolveVisited
+    );
+  }
+  keepEntityVersioningDates(enable = true) {
+    return new _RestfulFactory(
+      this.entityClass,
+      {
+        ...this.options,
+        keepEntityVersioningDates: enable
+      },
+      this.__resolveVisited
+    );
+  }
+  skipNonQueryableFields(enable = true) {
+    return new _RestfulFactory(
+      this.entityClass,
+      {
+        ...this.options,
+        skipNonQueryableFields: enable
+      },
+      this.__resolveVisited
+    );
+  }
+  renameEntityClass(name) {
+    return new _RestfulFactory(
+      this.entityClass,
+      {
+        ...this.options,
+        entityClassName: name
+      },
+      this.__resolveVisited
+    );
+  }
+  useRelations(...relations) {
+    return new _RestfulFactory(
+      this.entityClass,
+      {
+        ...this.options,
+        relations: [...this.options.relations || [], ...relations]
+      },
+      this.__resolveVisited
+    );
+  }
+  get entityClassName() {
     return this.options.entityClassName || this.entityClass.name;
   }
   get fieldsToOmit() {
@@ -2187,7 +2539,7 @@ var _RestfulFactory = class _RestfulFactory {
   get createDto() {
     return (0, import_nesties11.RenameClass)(
       OmitTypeExclude(this.entityClass, this.fieldsInCreateToOmit),
-      `Create${this.entityClass.name}Dto`
+      `Create${this.entityClassName}Dto`
     );
   }
   get fieldsInUpdateToOmit() {
@@ -2202,7 +2554,7 @@ var _RestfulFactory = class _RestfulFactory {
   get updateDto() {
     return (0, import_nesties11.RenameClass)(
       (0, import_swagger6.PartialType)(OmitTypeExclude(this.entityClass, this.fieldsInUpdateToOmit)),
-      `Update${this.entityClass.name}Dto`
+      `Update${this.entityClassName}Dto`
     );
   }
   get importDto() {
@@ -2246,7 +2598,7 @@ var _RestfulFactory = class _RestfulFactory {
     if (this.options.skipNonQueryableFields) {
       cl = PickTypeExpose(cl, this.queryableFields);
     }
-    return (0, import_nesties11.RenameClass)(cl, `Find${this.entityClass.name}Dto`);
+    return (0, import_nesties11.RenameClass)(cl, `Find${this.entityClassName}Dto`);
   }
   get findAllCursorPaginatedDto() {
     return (0, import_nesties11.RenameClass)(
@@ -2254,7 +2606,7 @@ var _RestfulFactory = class _RestfulFactory {
         OmitTypeExclude(this.findAllDto, ["pageCount"]),
         CursorPaginationDto
       ),
-      `Find${this.entityClass.name}CursorPaginatedDto`
+      `Find${this.entityClassName}CursorPaginatedDto`
     );
   }
   get entityResultDto() {
@@ -2297,7 +2649,7 @@ var _RestfulFactory = class _RestfulFactory {
         const relationFactory = new _RestfulFactory(
           relation.propertyClass,
           {
-            entityClassName: `${this.getEntityClassName()}${this.options.relations ? (0, import_lodash5.upperFirst)(relation.propertyName) : relation.propertyClass.name}`,
+            entityClassName: `${this.entityClassName}${this.options.relations ? (0, import_lodash5.upperFirst)(relation.propertyName) : relation.propertyClass.name}`,
             relations: this.options.relations && getNextLevelRelations(
               this.options.relations.map(extractRelationName),
               relation.propertyName
@@ -2328,7 +2680,7 @@ var _RestfulFactory = class _RestfulFactory {
     }
     const res = (0, import_nesties11.RenameClass)(
       resultDto,
-      `${this.getEntityClassName()}ResultDto`
+      `${this.entityClassName}ResultDto`
     );
     const currentContainer = this.__resolveVisited.get(this.entityClass);
     if (currentContainer) {
@@ -2348,7 +2700,7 @@ var _RestfulFactory = class _RestfulFactory {
           (m) => !m.keepInCreate
         )
       ]),
-      `${this.getEntityClassName()}CreateResultDto`
+      `${this.entityClassName}CreateResultDto`
     );
   }
   get entityReturnMessageDto() {
@@ -2390,15 +2742,12 @@ var _RestfulFactory = class _RestfulFactory {
       this.usePrefix(import_common3.Post),
       (0, import_common3.HttpCode)(200),
       (0, import_swagger6.ApiOperation)({
-        summary: `Create a new ${this.getEntityClassName()}`,
+        summary: `Create a new ${this.entityClassName}`,
         ...extras
       }),
       (0, import_swagger6.ApiBody)({ type: this.createDto }),
       (0, import_swagger6.ApiOkResponse)({ type: this.entityCreateReturnMessageDto }),
-      (0, import_swagger6.ApiBadRequestResponse)({
-        type: import_nesties10.BlankReturnMessageDto,
-        description: `The ${this.getEntityClassName()} is not valid`
-      })
+      (0, import_nesties10.ApiError)(400, `The ${this.entityClassName} is not valid`)
     ]);
   }
   createParam() {
@@ -2408,15 +2757,15 @@ var _RestfulFactory = class _RestfulFactory {
     return (0, import_nesties10.MergeMethodDecorators)([
       this.usePrefix(import_common3.Get, ":id"),
       (0, import_swagger6.ApiOperation)({
-        summary: `Find a ${this.getEntityClassName()} by id`,
+        summary: `Find a ${this.entityClassName} by id`,
         ...extras
       }),
       (0, import_swagger6.ApiParam)({ name: "id", type: this.idType, required: true }),
       (0, import_swagger6.ApiOkResponse)({ type: this.entityReturnMessageDto }),
-      (0, import_swagger6.ApiNotFoundResponse)({
-        type: import_nesties10.BlankReturnMessageDto,
-        description: `The ${this.getEntityClassName()} with the given id was not found`
-      })
+      (0, import_nesties10.ApiError)(
+        400,
+        `The ${this.entityClassName} with the given id was not found`
+      )
     ]);
   }
   idParam() {
@@ -2430,7 +2779,7 @@ var _RestfulFactory = class _RestfulFactory {
     return (0, import_nesties10.MergeMethodDecorators)([
       this.usePrefix(import_common3.Get),
       (0, import_swagger6.ApiOperation)({
-        summary: `Find all ${this.getEntityClassName()}`,
+        summary: `Find all ${this.entityClassName}`,
         ...extras
       }),
       (0, import_swagger6.ApiOkResponse)({ type: this.entityArrayReturnMessageDto })
@@ -2440,7 +2789,7 @@ var _RestfulFactory = class _RestfulFactory {
     return (0, import_nesties10.MergeMethodDecorators)([
       this.usePrefix(import_common3.Get),
       (0, import_swagger6.ApiOperation)({
-        summary: `Find all ${this.getEntityClassName()}`,
+        summary: `Find all ${this.entityClassName}`,
         ...extras
       }),
       (0, import_swagger6.ApiOkResponse)({ type: this.entityCursorPaginationReturnMessageDto })
@@ -2467,24 +2816,18 @@ var _RestfulFactory = class _RestfulFactory {
       this.usePrefix(import_common3.Patch, ":id"),
       (0, import_common3.HttpCode)(200),
       (0, import_swagger6.ApiOperation)({
-        summary: `Update a ${this.getEntityClassName()} by id`,
+        summary: `Update a ${this.entityClassName} by id`,
         ...extras
       }),
       (0, import_swagger6.ApiParam)({ name: "id", type: this.idType, required: true }),
       (0, import_swagger6.ApiBody)({ type: this.updateDto }),
-      (0, import_swagger6.ApiOkResponse)({ type: import_nesties10.BlankReturnMessageDto }),
-      (0, import_swagger6.ApiNotFoundResponse)({
-        type: import_nesties10.BlankReturnMessageDto,
-        description: `The ${this.getEntityClassName()} with the given id was not found`
-      }),
-      (0, import_swagger6.ApiBadRequestResponse)({
-        type: import_nesties10.BlankReturnMessageDto,
-        description: `The ${this.getEntityClassName()} is not valid`
-      }),
-      (0, import_swagger6.ApiInternalServerErrorResponse)({
-        type: import_nesties10.BlankReturnMessageDto,
-        description: "Internal error"
-      })
+      (0, import_nesties10.ApiBlankResponse)(),
+      (0, import_nesties10.ApiError)(
+        404,
+        `The ${this.entityClassName} with the given id was not found`
+      ),
+      (0, import_nesties10.ApiError)(400, `The ${this.entityClassName} is not valid`),
+      (0, import_nesties10.ApiError)(500, "Internal error")
     ]);
   }
   updateParam() {
@@ -2495,35 +2838,44 @@ var _RestfulFactory = class _RestfulFactory {
       this.usePrefix(import_common3.Delete, ":id"),
       (0, import_common3.HttpCode)(200),
       (0, import_swagger6.ApiOperation)({
-        summary: `Delete a ${this.getEntityClassName()} by id`,
+        summary: `Delete a ${this.entityClassName} by id`,
         ...extras
       }),
       (0, import_swagger6.ApiParam)({ name: "id", type: this.idType, required: true }),
-      (0, import_swagger6.ApiOkResponse)({ type: import_nesties10.BlankReturnMessageDto }),
-      (0, import_swagger6.ApiNotFoundResponse)({
-        type: import_nesties10.BlankReturnMessageDto,
-        description: `The ${this.getEntityClassName()} with the given id was not found`
-      }),
-      (0, import_swagger6.ApiInternalServerErrorResponse)({
-        type: import_nesties10.BlankReturnMessageDto,
-        description: "Internal error"
-      })
+      (0, import_nesties10.ApiBlankResponse)(),
+      (0, import_nesties10.ApiError)(
+        404,
+        `The ${this.entityClassName} with the given id was not found`
+      ),
+      (0, import_nesties10.ApiError)(500, "Internal error")
     ]);
   }
   import(extras = {}) {
     return (0, import_nesties10.MergeMethodDecorators)([
-      (0, import_common3.Post)("import"),
+      this.usePrefix(import_common3.Post, "import"),
       (0, import_common3.HttpCode)(200),
       (0, import_swagger6.ApiOperation)({
-        summary: `Import ${this.getEntityClassName()}`,
+        summary: `Import ${this.entityClassName}`,
         ...extras
       }),
       (0, import_swagger6.ApiBody)({ type: this.importDto }),
       (0, import_swagger6.ApiOkResponse)({ type: this.importReturnMessageDto }),
-      (0, import_swagger6.ApiInternalServerErrorResponse)({
-        type: import_nesties10.BlankReturnMessageDto,
-        description: "Internal error"
-      })
+      (0, import_nesties10.ApiError)(500, "Internal error")
+    ]);
+  }
+  operation(operationName, options = {}) {
+    return (0, import_nesties10.MergeMethodDecorators)([
+      this.usePrefix(import_common3.Post, `:id/${operationName}`),
+      (0, import_common3.HttpCode)(200),
+      (0, import_swagger6.ApiOperation)({
+        summary: `${(0, import_lodash5.upperFirst)(operationName)} a ${this.entityClassName} by id`,
+        ...options.operationExtras || {}
+      }),
+      options.returnType ? (0, import_nesties10.ApiTypeResponse)(options.returnType) : (0, import_nesties10.ApiBlankResponse)(),
+      (0, import_nesties10.ApiError)(
+        404,
+        `The ${this.entityClassName} with the given id was not found`
+      )
     ]);
   }
   baseController(routeOptions = {}) {
@@ -2637,7 +2989,7 @@ var _RestfulFactory = class _RestfulFactory {
         Object.defineProperty(cl.prototype, method, descriptor);
       });
     }
-    return (0, import_nesties11.RenameClass)(cl, `${this.getEntityClassName()}Controller`);
+    return (0, import_nesties11.RenameClass)(cl, `${this.entityClassName}Controller`);
   }
   crudService(options = {}) {
     return CrudService(this.entityClass, {
@@ -2769,6 +3121,8 @@ var applyQueryMatchBooleanMySQL = createQueryCondition(
 );
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  BindingColumn,
+  BindingValue,
   BlankCursorPaginationReturnMessageDto,
   BoolColumn,
   CrudBase,
@@ -2776,6 +3130,7 @@ var applyQueryMatchBooleanMySQL = createQueryCondition(
   CursorPaginationDto,
   CursorPaginationReturnMessageDto,
   DateColumn,
+  DefaultBindingKey,
   EnumColumn,
   FloatColumn,
   GenericCursorPaginationReturnMessageDto,