nicot 1.2.5 → 1.2.6

package/dist/index.mjs

@@ -1045,6 +1045,7 @@ import { camelCase } from "typeorm/util/StringUtils";
 import _3, { omit } from "lodash";
 import {
   BlankReturnMessageDto as BlankReturnMessageDto2,
+  GenericReturnMessageDto,
   PaginatedReturnMessageDto,
   ReturnMessageDto
 } from "nesties";
@@ -1393,6 +1394,30 @@ async function getPaginatedResult(qb, entityClass, entityAliasName, take, cursor
 
 // src/crud-base.ts
 import PQueue from "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 };
 };
@@ -1999,13 +2024,72 @@ var CrudBase = class {
       })
     );
   }
-  async exists(id) {
+  async exists(id, cond = {}) {
     const bindingEnt = await this.getBindingPartialEntity();
-    const ent = await this.repo.findOne({
-      where: { id, ...bindingEnt },
-      select: ["id"]
+    return this.repo.exists({
+      where: { id, ...bindingEnt, ...cond }
     });
-    return !!ent;
+  }
+  async operation(id, cb, extraOptions = {}) {
+    const bindingEnt = await this.getBindingPartialEntity();
+    const where = {
+      id,
+      ...bindingEnt,
+      ...extraOptions.where || {}
+    };
+    const throw404 = () => {
+      throw new BlankReturnMessageDto2(
+        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 BlankReturnMessageDto2(200, "success");
+    } else {
+      return new GenericReturnMessageDto(200, "success", res);
+    }
   }
   async _loadFullTextIndex() {
     const fields = reflector.getArray(
@@ -2067,18 +2151,17 @@ import {
   Query
 } from "@nestjs/common";
 import {
-  BlankReturnMessageDto as BlankReturnMessageDto3,
   MergeMethodDecorators,
   PaginatedReturnMessageDto as PaginatedReturnMessageDto2,
   ReturnMessageDto as ReturnMessageDto2,
   getApiProperty as getApiProperty2,
-  DataPipe
+  DataPipe,
+  ApiTypeResponse,
+  ApiBlankResponse,
+  ApiError
 } from "nesties";
 import {
-  ApiBadRequestResponse,
   ApiBody,
-  ApiInternalServerErrorResponse,
-  ApiNotFoundResponse,
   ApiOkResponse,
   ApiOperation,
   ApiParam,
@@ -2613,10 +2696,7 @@ var _RestfulFactory = class _RestfulFactory {
       }),
       ApiBody({ type: this.createDto }),
       ApiOkResponse({ type: this.entityCreateReturnMessageDto }),
-      ApiBadRequestResponse({
-        type: BlankReturnMessageDto3,
-        description: `The ${this.entityClassName} is not valid`
-      })
+      ApiError(400, `The ${this.entityClassName} is not valid`)
     ]);
   }
   createParam() {
@@ -2631,10 +2711,10 @@ var _RestfulFactory = class _RestfulFactory {
       }),
       ApiParam({ name: "id", type: this.idType, required: true }),
       ApiOkResponse({ type: this.entityReturnMessageDto }),
-      ApiNotFoundResponse({
-        type: BlankReturnMessageDto3,
-        description: `The ${this.entityClassName} with the given id was not found`
-      })
+      ApiError(
+        400,
+        `The ${this.entityClassName} with the given id was not found`
+      )
     ]);
   }
   idParam() {
@@ -2690,19 +2770,13 @@ var _RestfulFactory = class _RestfulFactory {
       }),
       ApiParam({ name: "id", type: this.idType, required: true }),
       ApiBody({ type: this.updateDto }),
-      ApiOkResponse({ type: BlankReturnMessageDto3 }),
-      ApiNotFoundResponse({
-        type: BlankReturnMessageDto3,
-        description: `The ${this.entityClassName} with the given id was not found`
-      }),
-      ApiBadRequestResponse({
-        type: BlankReturnMessageDto3,
-        description: `The ${this.entityClassName} is not valid`
-      }),
-      ApiInternalServerErrorResponse({
-        type: BlankReturnMessageDto3,
-        description: "Internal error"
-      })
+      ApiBlankResponse(),
+      ApiError(
+        404,
+        `The ${this.entityClassName} with the given id was not found`
+      ),
+      ApiError(400, `The ${this.entityClassName} is not valid`),
+      ApiError(500, "Internal error")
     ]);
   }
   updateParam() {
@@ -2717,20 +2791,17 @@ var _RestfulFactory = class _RestfulFactory {
         ...extras
       }),
       ApiParam({ name: "id", type: this.idType, required: true }),
-      ApiOkResponse({ type: BlankReturnMessageDto3 }),
-      ApiNotFoundResponse({
-        type: BlankReturnMessageDto3,
-        description: `The ${this.entityClassName} with the given id was not found`
-      }),
-      ApiInternalServerErrorResponse({
-        type: BlankReturnMessageDto3,
-        description: "Internal error"
-      })
+      ApiBlankResponse(),
+      ApiError(
+        404,
+        `The ${this.entityClassName} with the given id was not found`
+      ),
+      ApiError(500, "Internal error")
     ]);
   }
   import(extras = {}) {
     return MergeMethodDecorators([
-      Post("import"),
+      this.usePrefix(Post, "import"),
       HttpCode(200),
       ApiOperation({
         summary: `Import ${this.entityClassName}`,
@@ -2738,10 +2809,22 @@ var _RestfulFactory = class _RestfulFactory {
       }),
       ApiBody({ type: this.importDto }),
       ApiOkResponse({ type: this.importReturnMessageDto }),
-      ApiInternalServerErrorResponse({
-        type: BlankReturnMessageDto3,
-        description: "Internal error"
-      })
+      ApiError(500, "Internal error")
+    ]);
+  }
+  operation(operationName, options = {}) {
+    return MergeMethodDecorators([
+      this.usePrefix(Post, `:id/${operationName}`),
+      HttpCode(200),
+      ApiOperation({
+        summary: `${upperFirst(operationName)} a ${this.entityClassName} by id`,
+        ...options.operationExtras || {}
+      }),
+      options.returnType ? ApiTypeResponse(options.returnType) : ApiBlankResponse(),
+      ApiError(
+        404,
+        `The ${this.entityClassName} with the given id was not found`
+      )
     ]);
   }
   baseController(routeOptions = {}) {