nicot 1.2.3 → 1.2.5

package/dist/index.mjs

@@ -783,6 +783,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 {
 };
@@ -796,7 +808,8 @@ __decorateClass([
     required: false,
     type: String
   }),
-  NotInResult()
+  NotInResult(),
+  QueryManual()
 ], CursorPaginationDto.prototype, "paginationCursor", 2);
 __decorateClass([
   NotWritable(),
@@ -808,7 +821,8 @@ __decorateClass([
     type: Number,
     minimum: 1
   }),
-  NotInResult()
+  NotInResult(),
+  QueryManual()
 ], CursorPaginationDto.prototype, "recordsPerPage", 2);
 var BlankCursorPaginationReturnMessageDto = class extends BlankReturnMessageDto {
   constructor(statusCode, message, cursorResponse) {
@@ -900,7 +914,8 @@ __decorateClass([
     minimum: 1
   }),
   NotInResult(),
-  Reflect.metadata("design:type", Number)
+  Reflect.metadata("design:type", Number),
+  QueryManual()
 ], PageSettingsDto.prototype, "pageCount", 2);
 __decorateClass([
   NotWritable(),
@@ -912,6 +927,7 @@ __decorateClass([
     minimum: 1
   }),
   NotInResult(),
+  QueryManual(),
   Reflect.metadata("design:type", Number)
 ], PageSettingsDto.prototype, "recordsPerPage", 2);
 
@@ -1410,7 +1426,11 @@ var CrudBase = class {
     });
     this.log = new 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) => {
@@ -1454,6 +1474,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) => {
@@ -1559,6 +1678,7 @@ var CrudBase = class {
     });
   }
   async create(_ent, beforeCreate) {
+    const bindingEnt = await this.getBindingPartialEntity();
     if (!_ent) {
       throw new BlankReturnMessageDto2(400, "Invalid entity").toException();
     }
@@ -1593,6 +1713,7 @@ var CrudBase = class {
           }
         }
       }
+      Object.assign(ent, bindingEnt);
       if (beforeCreate) {
         await beforeCreate(repo);
       }
@@ -1658,10 +1779,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);
@@ -1692,6 +1823,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) {
@@ -1701,6 +1833,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);
@@ -1759,6 +1892,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);
@@ -1771,6 +1905,7 @@ var CrudBase = class {
       result = await this.repo.update(
         {
           id,
+          ...bindingEnt,
           ...cond
         },
         ent
@@ -1792,9 +1927,11 @@ var CrudBase = class {
     return new BlankReturnMessageDto2(200, "success");
   }
   async delete(id, cond = {}) {
+    const bindingEnt = await this.getBindingPartialEntity();
     let result;
     const searchCond = {
       id,
+      ...bindingEnt,
       ...cond
     };
     try {
@@ -1812,6 +1949,7 @@ var CrudBase = class {
     return new BlankReturnMessageDto2(200, "success");
   }
   async importEntities(_ents, extraChecking) {
+    const bindingEnt = await this.getBindingPartialEntity();
     const ents = _ents.map((ent) => {
       const newEnt = new this.entityClass();
       Object.assign(
@@ -1839,6 +1977,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?.()));
@@ -1859,7 +2000,11 @@ var CrudBase = class {
     );
   }
   async exists(id) {
-    const ent = await this.repo.findOne({ where: { id }, select: ["id"] });
+    const bindingEnt = await this.getBindingPartialEntity();
+    const ent = await this.repo.findOne({
+      where: { id, ...bindingEnt },
+      select: ["id"]
+    });
     return !!ent;
   }
   async _loadFullTextIndex() {
@@ -2111,7 +2256,132 @@ var _RestfulFactory = class _RestfulFactory {
       filterRelations(entityClass, options.relations);
     }
   }
-  getEntityClassName() {
+  omitInput(...fields) {
+    return new _RestfulFactory(
+      this.entityClass,
+      {
+        ...this.options,
+        fieldsToOmit: _5.uniq([...this.options.fieldsToOmit || [], ...fields])
+      },
+      this.__resolveVisited
+    );
+  }
+  omitWrite(...fields) {
+    return new _RestfulFactory(
+      this.entityClass,
+      {
+        ...this.options,
+        writeFieldsToOmit: _5.uniq([
+          ...this.options.writeFieldsToOmit || [],
+          ...fields
+        ])
+      },
+      this.__resolveVisited
+    );
+  }
+  omitCreate(...fields) {
+    return new _RestfulFactory(
+      this.entityClass,
+      {
+        ...this.options,
+        createFieldsToOmit: _5.uniq([
+          ...this.options.createFieldsToOmit || [],
+          ...fields
+        ])
+      },
+      this.__resolveVisited
+    );
+  }
+  omitUpdate(...fields) {
+    return new _RestfulFactory(
+      this.entityClass,
+      {
+        ...this.options,
+        updateFieldsToOmit: _5.uniq([
+          ...this.options.updateFieldsToOmit || [],
+          ...fields
+        ])
+      },
+      this.__resolveVisited
+    );
+  }
+  omitFindAll(...fields) {
+    return new _RestfulFactory(
+      this.entityClass,
+      {
+        ...this.options,
+        findAllFieldsToOmit: _5.uniq([
+          ...this.options.findAllFieldsToOmit || [],
+          ...fields
+        ])
+      },
+      this.__resolveVisited
+    );
+  }
+  omitOutput(...fields) {
+    return new _RestfulFactory(
+      this.entityClass,
+      {
+        ...this.options,
+        outputFieldsToOmit: _5.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() {
@@ -2135,7 +2405,7 @@ var _RestfulFactory = class _RestfulFactory {
   get createDto() {
     return RenameClass(
       OmitTypeExclude(this.entityClass, this.fieldsInCreateToOmit),
-      `Create${this.entityClass.name}Dto`
+      `Create${this.entityClassName}Dto`
     );
   }
   get fieldsInUpdateToOmit() {
@@ -2150,7 +2420,7 @@ var _RestfulFactory = class _RestfulFactory {
   get updateDto() {
     return RenameClass(
       PartialType(OmitTypeExclude(this.entityClass, this.fieldsInUpdateToOmit)),
-      `Update${this.entityClass.name}Dto`
+      `Update${this.entityClassName}Dto`
     );
   }
   get importDto() {
@@ -2168,7 +2438,12 @@ var _RestfulFactory = class _RestfulFactory {
   }
   get queryableFields() {
     return _5.difference(
-      getSpecificFields(this.entityClass, "queryCondition"),
+      [
+        ...getSpecificFields(this.entityClass, "queryCondition"),
+        "pageCount",
+        "recordsPerPage",
+        "paginationCursor"
+      ],
       this.fieldsInGetToOmit
     );
   }
@@ -2189,7 +2464,7 @@ var _RestfulFactory = class _RestfulFactory {
     if (this.options.skipNonQueryableFields) {
       cl = PickTypeExpose(cl, this.queryableFields);
     }
-    return RenameClass(cl, `Find${this.entityClass.name}Dto`);
+    return RenameClass(cl, `Find${this.entityClassName}Dto`);
   }
   get findAllCursorPaginatedDto() {
     return RenameClass(
@@ -2197,7 +2472,7 @@ var _RestfulFactory = class _RestfulFactory {
         OmitTypeExclude(this.findAllDto, ["pageCount"]),
         CursorPaginationDto
       ),
-      `Find${this.entityClass.name}CursorPaginatedDto`
+      `Find${this.entityClassName}CursorPaginatedDto`
     );
   }
   get entityResultDto() {
@@ -2240,7 +2515,7 @@ var _RestfulFactory = class _RestfulFactory {
         const relationFactory = new _RestfulFactory(
           relation.propertyClass,
           {
-            entityClassName: `${this.getEntityClassName()}${this.options.relations ? upperFirst(relation.propertyName) : relation.propertyClass.name}`,
+            entityClassName: `${this.entityClassName}${this.options.relations ? upperFirst(relation.propertyName) : relation.propertyClass.name}`,
             relations: this.options.relations && getNextLevelRelations(
               this.options.relations.map(extractRelationName),
               relation.propertyName
@@ -2271,7 +2546,7 @@ var _RestfulFactory = class _RestfulFactory {
     }
     const res = RenameClass(
       resultDto,
-      `${this.getEntityClassName()}ResultDto`
+      `${this.entityClassName}ResultDto`
     );
     const currentContainer = this.__resolveVisited.get(this.entityClass);
     if (currentContainer) {
@@ -2291,7 +2566,7 @@ var _RestfulFactory = class _RestfulFactory {
           (m) => !m.keepInCreate
         )
       ]),
-      `${this.getEntityClassName()}CreateResultDto`
+      `${this.entityClassName}CreateResultDto`
     );
   }
   get entityReturnMessageDto() {
@@ -2333,14 +2608,14 @@ var _RestfulFactory = class _RestfulFactory {
       this.usePrefix(Post),
       HttpCode(200),
       ApiOperation({
-        summary: `Create a new ${this.getEntityClassName()}`,
+        summary: `Create a new ${this.entityClassName}`,
         ...extras
       }),
       ApiBody({ type: this.createDto }),
       ApiOkResponse({ type: this.entityCreateReturnMessageDto }),
       ApiBadRequestResponse({
         type: BlankReturnMessageDto3,
-        description: `The ${this.getEntityClassName()} is not valid`
+        description: `The ${this.entityClassName} is not valid`
       })
     ]);
   }
@@ -2351,14 +2626,14 @@ var _RestfulFactory = class _RestfulFactory {
     return MergeMethodDecorators([
       this.usePrefix(Get, ":id"),
       ApiOperation({
-        summary: `Find a ${this.getEntityClassName()} by id`,
+        summary: `Find a ${this.entityClassName} by id`,
         ...extras
       }),
       ApiParam({ name: "id", type: this.idType, required: true }),
       ApiOkResponse({ type: this.entityReturnMessageDto }),
       ApiNotFoundResponse({
         type: BlankReturnMessageDto3,
-        description: `The ${this.getEntityClassName()} with the given id was not found`
+        description: `The ${this.entityClassName} with the given id was not found`
       })
     ]);
   }
@@ -2373,7 +2648,7 @@ var _RestfulFactory = class _RestfulFactory {
     return MergeMethodDecorators([
       this.usePrefix(Get),
       ApiOperation({
-        summary: `Find all ${this.getEntityClassName()}`,
+        summary: `Find all ${this.entityClassName}`,
         ...extras
       }),
       ApiOkResponse({ type: this.entityArrayReturnMessageDto })
@@ -2383,7 +2658,7 @@ var _RestfulFactory = class _RestfulFactory {
     return MergeMethodDecorators([
       this.usePrefix(Get),
       ApiOperation({
-        summary: `Find all ${this.getEntityClassName()}`,
+        summary: `Find all ${this.entityClassName}`,
         ...extras
       }),
       ApiOkResponse({ type: this.entityCursorPaginationReturnMessageDto })
@@ -2410,7 +2685,7 @@ var _RestfulFactory = class _RestfulFactory {
       this.usePrefix(Patch, ":id"),
       HttpCode(200),
       ApiOperation({
-        summary: `Update a ${this.getEntityClassName()} by id`,
+        summary: `Update a ${this.entityClassName} by id`,
         ...extras
       }),
       ApiParam({ name: "id", type: this.idType, required: true }),
@@ -2418,11 +2693,11 @@ var _RestfulFactory = class _RestfulFactory {
       ApiOkResponse({ type: BlankReturnMessageDto3 }),
       ApiNotFoundResponse({
         type: BlankReturnMessageDto3,
-        description: `The ${this.getEntityClassName()} with the given id was not found`
+        description: `The ${this.entityClassName} with the given id was not found`
       }),
       ApiBadRequestResponse({
         type: BlankReturnMessageDto3,
-        description: `The ${this.getEntityClassName()} is not valid`
+        description: `The ${this.entityClassName} is not valid`
       }),
       ApiInternalServerErrorResponse({
         type: BlankReturnMessageDto3,
@@ -2438,14 +2713,14 @@ var _RestfulFactory = class _RestfulFactory {
       this.usePrefix(Delete, ":id"),
       HttpCode(200),
       ApiOperation({
-        summary: `Delete a ${this.getEntityClassName()} by id`,
+        summary: `Delete a ${this.entityClassName} by id`,
         ...extras
       }),
       ApiParam({ name: "id", type: this.idType, required: true }),
       ApiOkResponse({ type: BlankReturnMessageDto3 }),
       ApiNotFoundResponse({
         type: BlankReturnMessageDto3,
-        description: `The ${this.getEntityClassName()} with the given id was not found`
+        description: `The ${this.entityClassName} with the given id was not found`
       }),
       ApiInternalServerErrorResponse({
         type: BlankReturnMessageDto3,
@@ -2458,7 +2733,7 @@ var _RestfulFactory = class _RestfulFactory {
       Post("import"),
       HttpCode(200),
       ApiOperation({
-        summary: `Import ${this.getEntityClassName()}`,
+        summary: `Import ${this.entityClassName}`,
         ...extras
       }),
       ApiBody({ type: this.importDto }),
@@ -2580,7 +2855,7 @@ var _RestfulFactory = class _RestfulFactory {
         Object.defineProperty(cl.prototype, method, descriptor);
       });
     }
-    return RenameClass(cl, `${this.getEntityClassName()}Controller`);
+    return RenameClass(cl, `${this.entityClassName}Controller`);
   }
   crudService(options = {}) {
     return CrudService(this.entityClass, {
@@ -2711,6 +2986,8 @@ var applyQueryMatchBooleanMySQL = createQueryCondition(
   }
 );
 export {
+  BindingColumn,
+  BindingValue,
   BlankCursorPaginationReturnMessageDto,
   BoolColumn,
   CrudBase,
@@ -2718,6 +2995,7 @@ export {
   CursorPaginationDto,
   CursorPaginationReturnMessageDto,
   DateColumn,
+  DefaultBindingKey,
   EnumColumn,
   FloatColumn,
   GenericCursorPaginationReturnMessageDto,