taon 21.0.52 → 21.0.53

package/lib-prod/base-classes/base-repository.js

@@ -0,0 +1,589 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __decorateClass = (decorators, target, key, kind) => {
+  var result = kind > 1 ? void 0 : kind ? __getOwnPropDesc(target, key) : target;
+  for (var i = decorators.length - 1, decorator; i >= 0; i--)
+    if (decorator = decorators[i])
+      result = (kind ? decorator(target, key, result) : decorator(result)) || result;
+  if (kind && result) __defProp(target, key, result);
+  return result;
+};
+import { MySqlQuerySource } from "taon-type-sql/lib-prod";
+import { Helpers__NS__warn } from "tnp-core/lib-prod";
+import { ___NS__isObject, ___NS__isUndefined, ___NS__lowerFirst } from "tnp-core/lib-prod";
+import { TaonRepository } from "../decorators/classes/repository-decorator";
+import { ClassHelpers__NS__getName } from "../helpers/class-helpers";
+import { TaonBaseCustomRepository } from "./base-custom-repository";
+const INDEX_KEYS_NO_FOR_UPDATE = ["id"];
+let TaonBaseRepository = class extends TaonBaseCustomRepository {
+  REPOS_CACHE_KEY = Symbol("repository cache inside instance");
+  constructor(__entityClassResolveFn) {
+    super();
+    this.entityClassResolveFn = __entityClassResolveFn;
+  }
+  //#endregion
+  //#region db query
+  __dbQuery;
+  get dbQuery() {
+    if (!this.__dbQuery) {
+      if (!this.ctx) {
+        return;
+        throw new Error(
+          `[TaonBaseRepository] Context not inited for class ${ClassHelpers__NS__getName(
+            this
+          )}`
+        );
+      }
+      const connection = this.ctx?.connection;
+      if (!connection) {
+        throw new Error(
+          `[TaonBaseRepository] Database not inited for context ${this.ctx?.contextName}`
+        );
+      }
+      this.__dbQuery = new MySqlQuerySource(connection);
+    }
+    return this.__dbQuery;
+  }
+  //#endregion
+  //#region connection
+  get connection() {
+    return this.ctx?.connection;
+  }
+  //#endregion
+  //#region repository
+  get repository() {
+    if (this[this.REPOS_CACHE_KEY]) {
+      return this[this.REPOS_CACHE_KEY];
+    }
+    const resolvedRepoClass = this.entityClassResolveFn();
+    const resolvedRepoName = ClassHelpers__NS__getName(resolvedRepoClass);
+    const repo = this.ctx.repos.get(resolvedRepoName);
+    if (!repo) {
+      throw `[TaonBaseRepository] Repository for entity "${resolvedRepoName}"
+      not found in context "${this.ctx?.contextName}".
+
+      Is ${resolvedRepoName} a Taon entity class ?
+
+      OR
+
+      If ${resolvedRepoName} is a Taon Custom Repository, then use this:
+
+      ...
+       ${___NS__lowerFirst(resolvedRepoName)} = injectCustomRepository(${resolvedRepoName});
+      ...
+
+      `;
+    }
+    this[this.REPOS_CACHE_KEY] = repo;
+    return this[this.REPOS_CACHE_KEY];
+  }
+  /**
+   * target for repository
+   */
+  get target() {
+    return this?.repository?.target;
+  }
+  /**
+   * alias to repository
+   */
+  get repo() {
+    return this.repository;
+  }
+  get repositoryExists() {
+    return !!this.repository;
+  }
+  //#endregion
+  //#region crud operations / typeorm / has id
+  /**
+   * Checks if entity has an id.
+   * If entity composite compose ids, it will check them all.
+   */
+  hasId(entity) {
+    return this.repo.hasId(entity);
+  }
+  //#endregion
+  //#region crud operations / typeorm / get id
+  /**
+   * Gets entity mixed id.
+   */
+  getId(entity) {
+    return this.repo.getId(entity);
+  }
+  //#endregion
+  //#region crud operations / typeorm / create & bulk create
+  /**
+    Saves a given entity in the database.
+   * If entity does not exist in the database then inserts, otherwise updates.
+   */
+  async save(item, options) {
+    let model = await this.repo.create(item);
+    model = await this.repo.save(model, options);
+    const { id } = model;
+    model = await this.repo.findOne({
+      where: { id }
+    });
+    return model;
+  }
+  /**
+   * Creates a new entity instance or instances.
+   * Can copy properties from the given object into new entities.
+   */
+  create(plainEntityLikeOrPlainEntityLikes) {
+    return this.repo.create(plainEntityLikeOrPlainEntityLikes);
+  }
+  async bulkSave(items, options) {
+    const models = [];
+    for (let index = 0; index < items.length; index++) {
+      const item = items[index];
+      const model = await this.save(item, options);
+      models.push(model);
+    }
+    return models;
+  }
+  /**
+   * @deprecated use bulkSave instead
+   */
+  async bulkCreate(items, options) {
+    return this.bulkSave(items, options);
+  }
+  //#region old typeorm version
+  /**
+   * Saves all given entities in the database.
+   * If entities do not exist in the database then inserts, otherwise updates.
+   */
+  // save<T extends DeepPartial<Entity>>(
+  //   entities: T[],
+  //   options: SaveOptions & {
+  //     reload: false;
+  //   },
+  // ): Promise<T[]>;
+  // /**
+  //  * Saves all given entities in the database.
+  //  * If entities do not exist in the database then inserts, otherwise updates.
+  //  */
+  // save<T extends DeepPartial<Entity>>(
+  //   entities: T[],
+  //   options?: SaveOptions,
+  // ): Promise<(T & Entity)[]>;
+  // /**
+  //  * Saves a given entity in the database.
+  //  * If entity does not exist in the database then inserts, otherwise updates.
+  //  */
+  // save<T extends DeepPartial<Entity>>(
+  //   entity: T,
+  //   options: SaveOptions & {
+  //     reload: false;
+  //   },
+  // ): Promise<T>;
+  // /**
+  //  * Saves a given entity in the database.
+  //  * If entity does not exist in the database then inserts, otherwise updates.
+  //  */
+  // save<T extends DeepPartial<Entity>>(
+  //   entity: T,
+  //   options?: SaveOptions,
+  // ): Promise<T & Entity> {
+  //   return this.repo.save(entity, options);
+  // }
+  //#endregion
+  //#endregion
+  //#region crud operations / typeorm / merge
+  /**
+   * Merges multiple entities (or entity-like objects) into a given entity.
+   */
+  merge(mergeIntoEntity, ...entityLikes) {
+    return this.repo.merge(mergeIntoEntity, ...entityLikes);
+  }
+  //#endregion
+  //#region crud operations / typeorm / preload
+  /**
+   * Creates a new entity from the given plain javascript object. If entity already exist in the database, then
+   * it loads it (and everything related to it), replaces all values with the new ones from the given object
+   * and returns this new entity. This new entity is actually a loaded from the db entity with all properties
+   * replaced from the new object.
+   *
+   * Note that given entity-like object must have an entity id / primary key to find entity by.
+   * Returns undefined if entity with given id was not found.
+   */
+  preload(entityLike) {
+    return this.repo.preload(entityLike);
+  }
+  //#endregion
+  //#region crud operations / typeorm / remove (delete) & bulk remove (delete)
+  /**
+   * Removes a given entities from the database.
+   */
+  async remove(idOrEntity) {
+    if (___NS__isObject(idOrEntity)) {
+      idOrEntity = idOrEntity.id;
+    }
+    const deletedEntity = await this.repo.findOne({
+      where: { id: idOrEntity }
+    });
+    if (!deletedEntity) {
+      Helpers__NS__warn(
+        `[TaonBaseRepository] Entity "${ClassHelpers__NS__getName(
+          this.repo.target
+        )}" with id ${idOrEntity} not found, cannot remove`
+      );
+      return;
+    }
+    const idCopy = deletedEntity.id;
+    await this.repo.remove(deletedEntity);
+    deletedEntity.id = idCopy;
+    return deletedEntity;
+  }
+  /**
+   * alias to remove
+   */
+  async delete(idOrEntity) {
+    return this.remove(idOrEntity);
+  }
+  /**
+   * alias to removeById
+   */
+  async deleteById(id) {
+    return this.remove(id);
+  }
+  async bulkRemove(idsOrEntities) {
+    idsOrEntities = idsOrEntities.map((id) => {
+      return ___NS__isObject(id) ? id.id : id;
+    });
+    const models = [];
+    for (let index = 0; index < idsOrEntities.length; index++) {
+      const id = idsOrEntities[index];
+      const model = await this.remove(id);
+      models.push(model);
+    }
+    return models;
+  }
+  async bulkDelete(ids) {
+    return this.bulkRemove(ids);
+  }
+  /**
+   * Records the delete date of a given entity.
+   */
+  softRemove(entity, options) {
+    return this.repo.softRemove(entity, options);
+  }
+  /**
+   * Recovers a given entity in the database.
+   */
+  recover(entity, options) {
+    return this.repo.recover(entity, options);
+  }
+  //#endregion
+  //#region crud operations / typeorm / insert
+  /**
+   * Inserts a given entity into the database.
+   * Unlike save method executes a primitive operation without cascades, relations and other operations included.
+   * Executes fast and efficient INSERT query.
+   * Does not check if entity exist in the database, so query will fail if duplicate entity is being inserted.
+   */
+  insert(entity) {
+    return this.repo.insert(entity);
+  }
+  //#endregion
+  //#region crud operations / typeorm / update & build update
+  async update(item) {
+    const { id } = item;
+    return await this.updateById(id, item);
+  }
+  allowedTypesToUpdate = ["simple-json", "simple-array", "json"];
+  async updateById(id, item) {
+    const allowedPropsToUpdate = [];
+    for (const key in item) {
+      const metadataColumn = this.repo.metadata.ownColumns.find(
+        (c) => c.propertyName === key
+      );
+      if (___NS__isObject(item) && item.hasOwnProperty(key) && (typeof item[key] !== "object" || this.allowedTypesToUpdate.includes(metadataColumn?.type)) && !___NS__isUndefined(metadataColumn)) {
+        allowedPropsToUpdate.push(key);
+      }
+    }
+    for (let i = 0; i < allowedPropsToUpdate.length; i++) {
+      const key = allowedPropsToUpdate[i];
+      if (!INDEX_KEYS_NO_FOR_UPDATE.includes(key.toLowerCase())) {
+        const toSet = item[key];
+        await this.repo.update(
+          {
+            id
+          },
+          {
+            [key]: toSet
+          }
+        );
+      }
+    }
+    let model = await this.repo.findOne({
+      where: { id }
+    });
+    return model;
+  }
+  async bulkUpdate(items) {
+    const models = [];
+    for (let index = 0; index < items.length; index++) {
+      const item = items[index];
+      const { id } = item;
+      const model = await this.updateById(id, item);
+      models.push(model);
+    }
+    return { models };
+  }
+  //#region tpeorm update version
+  // this version suck and will not return update entity
+  // /**
+  //  * Updates entity partially. Entity can be found by a given conditions.
+  //  * Unlike save method executes a primitive operation without cascades, relations and other operations included.
+  //  * Executes fast and efficient UPDATE query.
+  //  * Does not check if entity exist in the database.
+  //  */
+  // update(
+  //   criteria:
+  //     | string
+  //     | string[]
+  //     | number
+  //     | number[]
+  //     | Date
+  //     | Date[]
+  //     | ObjectID
+  //     | ObjectID[]
+  //     | FindOptionsWhere<Entity>,
+  //   partialEntity: QueryDeepPartialEntity<Entity>,
+  // ): Promise<UpdateResult> {
+  //   return this.repo.update(criteria, partialEntity);
+  // }
+  //#endregion
+  //#endregion
+  //#region crud operations / typeorm / upsert
+  /**
+   * Inserts a given entity into the database, unless a unique constraint conflicts then updates the entity
+   * Unlike save method executes a primitive operation without cascades, relations and other operations included.
+   * Executes fast and efficient INSERT ... ON CONFLICT DO UPDATE/ON DUPLICATE KEY UPDATE query.
+   */
+  upsert(entityOrEntities, conflictPathsOrOptions) {
+    return this.repo.upsert(entityOrEntities, conflictPathsOrOptions);
+  }
+  //#endregion
+  //#region crud operations / typeorm / soft delete
+  /**
+   * Records the delete date of entities by a given criteria.
+   * Unlike save method executes a primitive operation without cascades, relations and other operations included.
+   * Executes fast and efficient SOFT-DELETE query.
+   * Does not check if entity exist in the database.
+   */
+  softDelete(criteria) {
+    return this.repo.softDelete(criteria);
+  }
+  //#endregion
+  //#region crud operations / typeorm / restore
+  /**
+   * Restores entities by a given criteria.
+   * Unlike save method executes a primitive operation without cascades, relations and other operations included.
+   * Executes fast and efficient SOFT-DELETE query.
+   * Does not check if entity exist in the database.
+   */
+  restore(criteria) {
+    return this.repo.restore(criteria);
+  }
+  //#endregion
+  //#region crud operations / typeorm / count
+  /**
+   * Counts entities that match given options.
+   * Useful for pagination.
+   */
+  count(options) {
+    return this.repo.count(options);
+  }
+  //#endregion
+  //#region crud operations / typeorm / count by
+  /**
+   * Counts entities that match given conditions.
+   * Useful for pagination.
+   */
+  countBy(where) {
+    return this.repo.countBy(where);
+  }
+  //#endregion
+  //#region crud operations / typeorm / find
+  /**
+   * Finds entities that match given find options.
+   */
+  find(options) {
+    return this.repo.find(options);
+  }
+  //#endregion
+  //#region crud operations / typeorm / find by
+  /**
+   * Finds entities that match given find options.
+   */
+  findBy(where) {
+    return this.repo.findBy(where);
+  }
+  //#endregion
+  //#region crud operations / typeorm / find and count
+  // async findAndCount(options: { take: number; skip: number }) {
+  // const { take, skip } = options;
+  // const [result, total] = await this.repo.findAndCount({
+  //   // where: { name: Like('%' + keyword + '%') },
+  //   // order: { name: "DESC" },
+  //   take: take,
+  //   skip: skip,
+  // });
+  // return { result, total };
+  // }
+  //
+  /**
+   * Finds entities that match given find options.
+   * Also counts all entities that match given conditions,
+   * but ignores pagination settings (from and take options).
+   */
+  findAndCount(options) {
+    return this.repo.findAndCount(options);
+  }
+  //#endregion
+  //#region crud operations / typeorm / find and count by
+  /**
+   * Finds entities that match given WHERE conditions.
+   * Also counts all entities that match given conditions,
+   * but ignores pagination settings (from and take options).
+   */
+  findAndCountBy(where) {
+    return this.repo.findAndCountBy(where);
+  }
+  //#endregion
+  //#region crud operations / typeorm / find by ids
+  /**
+   * Finds entities with ids.
+   * Optionally find options or conditions can be applied.
+   *
+   * @deprecated use `findBy` method instead in conjunction with `In` operator, for example:
+   *
+   * .findBy({
+   *     id: In([1, 2, 3])
+   * })
+   */
+  findByIds(ids) {
+    return this.repo.findByIds(ids);
+  }
+  //#endregion
+  //#region crud operations / typeorm / find one
+  /**
+   * Finds first entity by a given find options.
+   * If entity was not found in the database - returns null.
+   */
+  findOne(options) {
+    return this.repo.findOne(options);
+  }
+  //#endregion
+  //#region crud operations / typeorm / find one by
+  /**
+   * Finds first entity that matches given where condition.
+   * If entity was not found in the database - returns null.
+   */
+  findOneBy(where) {
+    return this.repo.findOneBy(where);
+  }
+  //#endregion
+  //#region crud operations / typeorm / find one or fail
+  /**
+   * Finds first entity that matches given id.
+   * If entity was not found in the database - returns null.
+   *
+   * @deprecated use `findOneBy` method instead in conjunction with `In` operator, for example:
+   *
+   * .findOneBy({
+   *     id: 1 // where "id" is your primary column name
+   * })
+   */
+  findOneById(id) {
+    return this.repo.findOneById(id);
+  }
+  //#endregion
+  //#region crud operations / typeorm / find one or fail
+  /**
+   * Finds first entity by a given find options.
+   * If entity was not found in the database - rejects with error.
+   */
+  findOneOrFail(options) {
+    return this.repo.findOneOrFail(options);
+  }
+  //#endregion
+  //#region crud operations / typeorm / find one by or fail
+  /**
+   * Finds first entity that matches given where condition.
+   * If entity was not found in the database - rejects with error.
+   */
+  findOneByOrFail(where) {
+    return this.repo.findOneByOrFail(where);
+  }
+  //#endregion
+  //#region crud operations / typeorm / query
+  /**
+   * Executes a raw SQL query and returns a raw database results.
+   * Raw query execution is supported only by relational databases (MongoDB is not supported).
+   */
+  query(query, parameters) {
+    return this.repo.query(query, parameters);
+  }
+  //#endregion
+  //#region crud operations / typeorm / query
+  /**
+   * Executes a raw SQL query and returns a raw database results.
+   * Raw query execution is supported only by relational databases (MongoDB is not supported).
+   */
+  createQueryBuilder(alias, queryRunner) {
+    return this.repo.createQueryBuilder(alias, queryRunner);
+  }
+  //#endregion
+  //#region crud operations / typeorm / clear
+  /**
+   * Clears all the data from the given table/collection (truncates/drops it).
+   *
+   * Note: this method uses TRUNCATE and may not work as you expect in transactions on some platforms.
+   * @see https://stackoverflow.com/a/5972738/925151
+   */
+  clear() {
+    return this.repo.clear();
+  }
+  //#endregion
+  //#region crud operations / typeorm / increment
+  /**
+   * Increments some column by provided value of the entities matched given conditions.
+   */
+  increment(conditions, propertyPath, value) {
+    return this.repo.increment(conditions, propertyPath, value);
+  }
+  //#endregion
+  //#region crud operations / typeorm / decrement
+  /**
+   * Decrements some column by provided value of the entities matched given conditions.
+   */
+  decrement(conditions, propertyPath, value) {
+    return this.repo.decrement(conditions, propertyPath, value);
+  }
+  //#endregion
+  //#region crud operations / get all
+  /**
+   * @deprecated use findAndCount instead
+   */
+  async getAll() {
+    const totalCount = await this.repo.count();
+    const models = await this.repo.find();
+    return { models, totalCount };
+  }
+  //#endregion
+  //#region crud operations / get by id
+  async getBy(id) {
+    const model = await await this.repo.findOne({
+      where: { id }
+    });
+    return model;
+  }
+  //#endregion
+};
+TaonBaseRepository = __decorateClass([
+  TaonRepository({ className: "TaonBaseRepository" })
+], TaonBaseRepository);
+export {
+  TaonBaseRepository
+};