taon 21.0.42 → 21.0.45

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

@@ -0,0 +1,942 @@
+//#region imports
+import { MySqlQuerySource } from 'taon-type-sql/lib-prod';
+import {
+  type DataSource,
+  type DeepPartial,
+  type DeleteResult,
+  type FindManyOptions,
+  type FindOneOptions,
+  type FindOptionsWhere,
+  type InsertResult,
+  // ObjectID // TODO why is this not in taon-typeorm,
+  type RemoveOptions,
+  type Repository,
+  type SaveOptions,
+  type UpdateResult,
+} from 'taon-typeorm/lib-prod';
+import type { QueryDeepPartialEntity } from 'taon-typeorm/lib-prod';
+import type { UpsertOptions } from 'taon-typeorm/lib-prod';
+import type {
+  DataSource as DataSourceType,
+  QueryRunner,
+  SelectQueryBuilder,
+} from 'taon-typeorm/lib-prod';
+import { Helpers__NS___fixCommand, Helpers__NS__bigMaxBuffer, Helpers__NS__checkProcess, Helpers__NS__cleanExit, Helpers__NS__clearConsole, Helpers__NS__command, Helpers__NS__commandOutputAsString, Helpers__NS__commandOutputAsStringAsync, Helpers__NS__compilationWrapper, Helpers__NS__contain, Helpers__NS__createFolder, Helpers__NS__createSymLink, Helpers__NS__error, Helpers__NS__execute, Helpers__NS__exists, Helpers__NS__filesFrom, Helpers__NS__foldersFrom, Helpers__NS__getFilesFrom, Helpers__NS__getFoldersFrom, Helpers__NS__getIsBrowser, Helpers__NS__getIsElectron, Helpers__NS__getIsNode, Helpers__NS__getIsRunningInGitBash, Helpers__NS__getIsSupportedTaonTerminal, Helpers__NS__getIsVerboseMode, Helpers__NS__getIsWebSQL, Helpers__NS__getIsWsl, Helpers__NS__getStdio, Helpers__NS__hideNodeWarnings, Helpers__NS__info, Helpers__NS__isBlob, Helpers__NS__isBuffer, Helpers__NS__isClass, Helpers__NS__isExistedSymlink, Helpers__NS__isFile, Helpers__NS__isFolder, Helpers__NS__isRunningInDocker, Helpers__NS__isRunningInLinuxGraphicsCapableEnvironment, Helpers__NS__isSymlinkFileExitedOrUnexisted, Helpers__NS__isSymlinkThatMatchesUrl, Helpers__NS__isUnexistedLink, Helpers__NS__killOnPort, Helpers__NS__killProcess, Helpers__NS__killProcessByPort, Helpers__NS__linksToFolderFrom, Helpers__NS__linksToFoldersFrom, Helpers__NS__log, Helpers__NS__logError, Helpers__NS__logInfo, Helpers__NS__logProc, Helpers__NS__logSuccess, Helpers__NS__logWarn, Helpers__NS__mediaTypeFromSrc, Helpers__NS__mkdirp, Helpers__NS__modifyLineByLine, Helpers__NS__msgCacheClear, Helpers__NS__openFolderInFileExplorer, Helpers__NS__parse, Helpers__NS__pathContainLink, Helpers__NS__questionYesNo, Helpers__NS__readFile, Helpers__NS__readJson, Helpers__NS__readJson5, Helpers__NS__readJsonC, Helpers__NS__relative, Helpers__NS__remove, Helpers__NS__removeEmptyLineFromString, Helpers__NS__removeFileIfExists, Helpers__NS__removeFolderIfExists, Helpers__NS__removeIfExists, Helpers__NS__removeSlashAtBegin, Helpers__NS__removeSlashAtEnd, Helpers__NS__removeSymlinks, Helpers__NS__renderError, Helpers__NS__replaceLinesInFile, Helpers__NS__run, Helpers__NS__runAsyncIn, Helpers__NS__runSyncIn, Helpers__NS__runSyncOrAsync, Helpers__NS__sleep, Helpers__NS__stopApplication, Helpers__NS__stringify, Helpers__NS__success, Helpers__NS__taskDone, Helpers__NS__taskStarted, Helpers__NS__throwError, Helpers__NS__timeout, Helpers__NS__tryCatchError, Helpers__NS__tryReadFile, Helpers__NS__tryRemoveDir, Helpers__NS__values, Helpers__NS__wait, Helpers__NS__warn, Helpers__NS__writeFile, Helpers__NS__writeJson, Helpers__NS__writeJson5, Helpers__NS__writeJsonC } from 'tnp-core/lib-prod';
+import { ___NS__add, ___NS__after, ___NS__ary, ___NS__assign, ___NS__assignIn, ___NS__assignInWith, ___NS__assignWith, ___NS__at, ___NS__attempt, ___NS__before, ___NS__bind, ___NS__bindAll, ___NS__bindKey, ___NS__camelCase, ___NS__capitalize, ___NS__castArray, ___NS__ceil, ___NS__chain, ___NS__chunk, ___NS__clamp, ___NS__clone, ___NS__cloneDeep, ___NS__cloneDeepWith, ___NS__cloneWith, ___NS__compact, ___NS__concat, ___NS__cond, ___NS__conforms, ___NS__conformsTo, ___NS__constant, ___NS__countBy, ___NS__create, ___NS__curry, ___NS__curryRight, ___NS__debounce, ___NS__deburr, ___NS__defaults, ___NS__defaultsDeep, ___NS__defaultTo, ___NS__defer, ___NS__delay, ___NS__difference, ___NS__differenceBy, ___NS__differenceWith, ___NS__divide, ___NS__drop, ___NS__dropRight, ___NS__dropRightWhile, ___NS__dropWhile, ___NS__each, ___NS__eachRight, ___NS__endsWith, ___NS__entries, ___NS__entriesIn, ___NS__eq, ___NS__escape, ___NS__escapeRegExp, ___NS__every, ___NS__extend, ___NS__extendWith, ___NS__fill, ___NS__filter, ___NS__find, ___NS__findIndex, ___NS__findKey, ___NS__findLast, ___NS__findLastIndex, ___NS__findLastKey, ___NS__first, ___NS__flatMap, ___NS__flatMapDeep, ___NS__flatMapDepth, ___NS__flatten, ___NS__flattenDeep, ___NS__flattenDepth, ___NS__flip, ___NS__floor, ___NS__flow, ___NS__flowRight, ___NS__forEach, ___NS__forEachRight, ___NS__forIn, ___NS__forInRight, ___NS__forOwn, ___NS__forOwnRight, ___NS__fromPairs, ___NS__functions, ___NS__functionsIn, ___NS__get, ___NS__groupBy, ___NS__gt, ___NS__gte, ___NS__has, ___NS__hasIn, ___NS__head, ___NS__identity, ___NS__includes, ___NS__indexOf, ___NS__initial, ___NS__inRange, ___NS__intersection, ___NS__intersectionBy, ___NS__intersectionWith, ___NS__invert, ___NS__invertBy, ___NS__invoke, ___NS__invokeMap, ___NS__isArguments, ___NS__isArray, ___NS__isArrayBuffer, ___NS__isArrayLike, ___NS__isArrayLikeObject, ___NS__isBoolean, ___NS__isBuffer, ___NS__isDate, ___NS__isElement, ___NS__isEmpty, ___NS__isEqual, ___NS__isEqualWith, ___NS__isError, ___NS__isFinite, ___NS__isFunction, ___NS__isInteger, ___NS__isLength, ___NS__isMap, ___NS__isMatch, ___NS__isMatchWith, ___NS__isNaN, ___NS__isNative, ___NS__isNil, ___NS__isNull, ___NS__isNumber, ___NS__isObject, ___NS__isObjectLike, ___NS__isPlainObject, ___NS__isRegExp, ___NS__isSafeInteger, ___NS__isSet, ___NS__isString, ___NS__isSymbol, ___NS__isTypedArray, ___NS__isUndefined, ___NS__isWeakMap, ___NS__isWeakSet, ___NS__iteratee, ___NS__join, ___NS__kebabCase, ___NS__keyBy, ___NS__keys, ___NS__keysIn, ___NS__last, ___NS__lastIndexOf, ___NS__lowerCase, ___NS__lowerFirst, ___NS__lt, ___NS__lte, ___NS__map, ___NS__mapKeys, ___NS__mapValues, ___NS__matches, ___NS__matchesProperty, ___NS__max, ___NS__maxBy, ___NS__mean, ___NS__meanBy, ___NS__memoize, ___NS__merge, ___NS__mergeWith, ___NS__method, ___NS__methodOf, ___NS__min, ___NS__minBy, ___NS__mixin, ___NS__multiply, ___NS__negate, ___NS__noop, ___NS__now, ___NS__nth, ___NS__nthArg, ___NS__omit, ___NS__omitBy, ___NS__once, ___NS__orderBy, ___NS__over, ___NS__overArgs, ___NS__overEvery, ___NS__overSome, ___NS__pad, ___NS__padEnd, ___NS__padStart, ___NS__parseInt, ___NS__partial, ___NS__partialRight, ___NS__partition, ___NS__pick, ___NS__pickBy, ___NS__property, ___NS__propertyOf, ___NS__pull, ___NS__pullAll, ___NS__pullAllBy, ___NS__pullAllWith, ___NS__pullAt, ___NS__random, ___NS__range, ___NS__rangeRight, ___NS__rearg, ___NS__reduce, ___NS__reduceRight, ___NS__reject, ___NS__remove, ___NS__repeat, ___NS__replace, ___NS__rest, ___NS__result, ___NS__reverse, ___NS__round, ___NS__sample, ___NS__sampleSize, ___NS__set, ___NS__setWith, ___NS__shuffle, ___NS__size, ___NS__slice, ___NS__snakeCase, ___NS__some, ___NS__sortBy, ___NS__sortedIndex, ___NS__sortedIndexBy, ___NS__sortedIndexOf, ___NS__sortedLastIndex, ___NS__sortedLastIndexBy, ___NS__sortedLastIndexOf, ___NS__sortedUniq, ___NS__sortedUniqBy, ___NS__split, ___NS__spread, ___NS__startCase, ___NS__startsWith, ___NS__stubArray, ___NS__stubFalse, ___NS__stubObject, ___NS__stubString, ___NS__stubTrue, ___NS__subtract, ___NS__sum, ___NS__sumBy, ___NS__tail, ___NS__take, ___NS__takeRight, ___NS__takeRightWhile, ___NS__takeWhile, ___NS__tap, ___NS__template, ___NS__templateSettings, ___NS__throttle, ___NS__thru, ___NS__times, ___NS__toArray, ___NS__toFinite, ___NS__toInteger, ___NS__toLength, ___NS__toLower, ___NS__toNumber, ___NS__toPairs, ___NS__toPairsIn, ___NS__toPath, ___NS__toPlainObject, ___NS__toSafeInteger, ___NS__toString, ___NS__toUpper, ___NS__transform, ___NS__trim, ___NS__trimEnd, ___NS__trimStart, ___NS__truncate, ___NS__unary, ___NS__unescape, ___NS__union, ___NS__unionBy, ___NS__unionWith, ___NS__uniq, ___NS__uniqBy, ___NS__uniqueId, ___NS__uniqWith, ___NS__unset, ___NS__unzip, ___NS__unzipWith, ___NS__update, ___NS__updateWith, ___NS__upperCase, ___NS__upperFirst, ___NS__values, ___NS__valuesIn, ___NS__without, ___NS__words, ___NS__wrap, ___NS__xor, ___NS__xorBy, ___NS__xorWith, ___NS__zip, ___NS__zipObject, ___NS__zipObjectDeep, ___NS__zipWith } from 'tnp-core/lib-prod';
+
+import { TaonRepository } from '../decorators/classes/repository-decorator';
+import { ClassHelpers__NS__asyncHandler, ClassHelpers__NS__ensureClassConfig, ClassHelpers__NS__ensureMethodConfig, ClassHelpers__NS__getClassConfig, ClassHelpers__NS__getClassFnFromObject, ClassHelpers__NS__getControllerConfigs, ClassHelpers__NS__getFullInternalName, ClassHelpers__NS__getMethodsNames, ClassHelpers__NS__getName, ClassHelpers__NS__getOrginalClass, ClassHelpers__NS__getUniqueKey, ClassHelpers__NS__hasParentClassWithName, ClassHelpers__NS__isContextClassObject, ClassHelpers__NS__setName } from '../helpers/class-helpers';
+
+import { TaonBaseCustomRepository } from './base-custom-repository';
+
+//#endregion
+
+const INDEX_KEYS_NO_FOR_UPDATE = ['id'];
+
+@TaonRepository({ className: 'TaonBaseRepository' })
+export abstract class TaonBaseRepository<
+  Entity extends { id?: any },
+> extends TaonBaseCustomRepository {
+  private REPOS_CACHE_KEY = Symbol('repository cache inside instance');
+  //#region dummy fields
+  // static ids:number  = 0;
+  // id:number  = TaonBaseRepository.ids++;
+  //#endregion
+
+  //#region constructor & resolve entity
+  abstract entityClassResolveFn: () => any;
+
+  constructor(
+    // Injected through TaonBaseCrudController
+    __entityClassResolveFn: () => any,
+  ) {
+    super();
+    // @ts-ignore
+    this.entityClassResolveFn = __entityClassResolveFn;
+  }
+  //#endregion
+
+  //#region db query
+  private __dbQuery: MySqlQuerySource;
+
+  public get dbQuery(): MySqlQuerySource {
+    //#region @websqlFunc
+    if (!this.__dbQuery) {
+      if (!this.ctx) {
+        return; // TODO
+        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
+  }
+  //#endregion
+
+  //#region connection
+  public get connection(): DataSourceType {
+    //#region @websqlFunc
+    return this.ctx?.connection;
+    //#endregion
+  }
+  //#endregion
+
+  //#region repository
+  protected get repository(): Repository<Entity> {
+    //#region @websqlFunc
+    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) as Repository<Entity>;
+
+    // TODO better recognize what is class in context
+    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];
+    //#endregion
+  }
+
+  /**
+   * target for repository
+   */
+  public get target(): Function {
+    //#region @websqlFunc
+    return this?.repository?.target as any;
+    //#endregion
+  }
+
+  /**
+   * alias to repository
+   */
+  protected get repo(): Repository<Entity> {
+    //#region @websqlFunc
+    return this.repository;
+    //#endregion
+  }
+
+  public get repositoryExists(): boolean {
+    //#region @websqlFunc
+    return !!this.repository;
+    //#endregion
+  }
+
+  //#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: Entity): boolean {
+    return this.repo.hasId(entity);
+  }
+  //#endregion
+
+  //#region crud operations / typeorm / get id
+  /**
+   * Gets entity mixed id.
+   */
+  getId(entity: Entity): any {
+    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: Entity,
+    options?: SaveOptions & {
+      reload: false;
+    },
+  ): Promise<Entity> {
+    //#region @websqlFunc
+    // if (!this.repo) {
+    //   debugger;
+    // }
+    let model = await this.repo.create(item);
+
+    model = await this.repo.save(model, options);
+    const { id } = model as any;
+
+    model = await this.repo.findOne({
+      where: { id } as any,
+    });
+
+    return model;
+    //#endregion
+  }
+
+  /**
+   * alias to save
+   * -> it will actuall create new entity in db
+   * in oposite to typeorm create method
+   */
+  /**
+   * Creates a new entity instance.
+   */
+  create(): Entity;
+
+  /**
+   * Creates new entities and copies all entity properties from given objects into their new entities.
+   * Note that it copies only properties that are present in entity schema.
+   */
+  create(entityLikeArray: DeepPartial<Entity>[]): Entity[];
+
+  /**
+   * Creates a new entity instance and copies all entity properties from this object into a new entity.
+   * Note that it copies only properties that are present in entity schema.
+   */
+  create(entityLike: DeepPartial<Entity>): Entity;
+
+  /**
+   * Creates a new entity instance or instances.
+   * Can copy properties from the given object into new entities.
+   */
+  create(
+    plainEntityLikeOrPlainEntityLikes?:
+      | DeepPartial<Entity>
+      | DeepPartial<Entity>[],
+  ): Entity | Entity[] {
+    return this.repo.create(plainEntityLikeOrPlainEntityLikes as any);
+  }
+
+  async bulkSave(
+    items: Entity[],
+    options?: SaveOptions & {
+      reload: false;
+    },
+  ): Promise<Entity[]> {
+    //#region @websqlFunc
+    const models = [];
+    for (let index = 0; index < items.length; index++) {
+      const item = items[index];
+      // TODO FIX THIS / REFACTOR
+      const model = await this.save(item, options);
+      models.push(model);
+    }
+    return models;
+    //#endregion
+  }
+
+  /**
+   * @deprecated use bulkSave instead
+   */
+  async bulkCreate(
+    items: Entity[],
+    options?: SaveOptions & {
+      reload: false;
+    },
+  ): Promise<Entity[]> {
+    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: Entity, ...entityLikes: Entity[]): Entity {
+    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: Entity): Promise<Entity | undefined> {
+    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: number | string | Entity): Promise<Entity> {
+    //#region @websqlFunc
+    if (___NS__isObject(idOrEntity)) {
+      idOrEntity = (idOrEntity as Entity).id;
+    }
+    const deletedEntity = await this.repo.findOne({
+      where: { id: idOrEntity } as any,
+    });
+
+    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;
+    //#endregion
+  }
+
+  /**
+   * alias to remove
+   */
+  async delete(idOrEntity: number | string | Partial<Entity>): Promise<Entity> {
+    return this.remove(idOrEntity as any);
+  }
+
+  /**
+   * alias to removeById
+   */
+  async deleteById(id: number | string): Promise<Entity> {
+    return this.remove(id);
+  }
+
+  async bulkRemove(
+    idsOrEntities: (number | string | Entity)[],
+  ): Promise<Entity[]> {
+    //#region @websqlFunc
+    idsOrEntities = idsOrEntities.map(id => {
+      return ___NS__isObject(id) ? (id as Entity).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;
+    //#endregion
+  }
+
+  async bulkDelete(ids: (number | string | Entity)[]): Promise<Entity[]> {
+    return this.bulkRemove(ids);
+  }
+
+  //#region old typeorm version
+  // /**
+  //  * Deletes entities by a given criteria.
+  //  * Unlike save method executes a primitive operation without cascades, relations and other operations included.
+  //  * Executes fast and efficient DELETE query.
+  //  * Does not check if entity exist in the database.
+  //  */
+  // delete(
+  //   criteria:
+  //     | string
+  //     | string[]
+  //     | number
+  //     | number[]
+  //     | Date
+  //     | Date[]
+  //     | ObjectID
+  //     | ObjectID[]
+  //     | FindOptionsWhere<Entity>,
+  // ): Promise<DeleteResult> {
+  //   return this.repo.delete(criteria);
+  // }
+
+  // /**
+  //  * Removes a given entities from the database.
+  //  */
+  // remove(entities: Entity[], options?: RemoveOptions): Promise<Entity[]>;
+  // /**
+  //  * Removes a given entity from the database.
+  //  */
+  // remove(entity: Entity, options?: RemoveOptions): Promise<Entity> {
+  //   return this.repo.remove(entity, options);
+  // }
+
+  //#endregion
+  //#endregion
+
+  //#region crud operations / typeorm / soft remove
+  /**
+   * Records the delete date of all given entities.
+   */
+  softRemove<T extends Entity>(
+    entities: T[],
+    options: SaveOptions & {
+      reload: false;
+    },
+  ): Promise<T[]>;
+
+  /**
+   * Records the delete date of all given entities.
+   */
+  softRemove<T extends Entity>(
+    entities: T[],
+    options?: SaveOptions,
+  ): Promise<(T & Entity)[]>;
+
+  /**
+   * Records the delete date of a given entity.
+   */
+  softRemove<T extends Entity>(
+    entity: T,
+    options: SaveOptions & {
+      reload: false;
+    },
+  ): Promise<T>;
+
+  /**
+   * Records the delete date of a given entity.
+   */
+  softRemove<T extends Entity>(
+    entity: T,
+    options?: SaveOptions,
+  ): Promise<T & Entity> {
+    return this.repo.softRemove(entity, options);
+  }
+  //#endregion
+
+  //#region crud operations / typeorm / recover
+  /**
+   * Recovers all given entities in the database.
+   */
+  recover<T extends Entity>(
+    entities: T[],
+    options: SaveOptions & {
+      reload: false;
+    },
+  ): Promise<T[]>;
+
+  /**
+   * Recovers all given entities in the database.
+   */
+  recover<T extends Entity>(
+    entities: T[],
+    options?: SaveOptions,
+  ): Promise<(T & Entity)[]>;
+
+  /**
+   * Recovers a given entity in the database.
+   */
+  recover<T extends Entity>(
+    entity: T,
+    options: SaveOptions & {
+      reload: false;
+    },
+  ): Promise<T>;
+
+  /**
+   * Recovers a given entity in the database.
+   */
+  recover<T extends Entity>(
+    entity: T,
+    options?: SaveOptions,
+  ): Promise<T & Entity> {
+    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: QueryDeepPartialEntity<Entity> | QueryDeepPartialEntity<Entity>[],
+  ): Promise<InsertResult> {
+    // debugger;
+    return this.repo.insert(entity);
+  }
+  //#endregion
+
+  //#region crud operations / typeorm / update & build update
+  async update(item: Entity) {
+    //#region @websqlFunc
+    const { id } = item as any;
+    return await this.updateById<Entity>(id, item);
+    //#endregion
+  }
+
+  private allowedTypesToUpdate = ['simple-json', 'simple-array', 'json'];
+
+  async updateById<ENTITY = Entity>(
+    id: number | string,
+    item: Entity,
+  ): Promise<ENTITY> {
+    //#region @websqlFunc
+    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 as any)) &&
+        !___NS__isUndefined(metadataColumn)
+      ) {
+        allowedPropsToUpdate.push(key);
+      }
+    }
+
+    for (let i = 0; i < allowedPropsToUpdate.length; i++) {
+      const key: string = allowedPropsToUpdate[i];
+      if (!INDEX_KEYS_NO_FOR_UPDATE.includes(key.toLowerCase())) {
+        // const raw = ___NS__isBoolean(item[key]) || ___NS__isNumber(item[key]) || ___NS__isNull(item[key]); // TODO does this make any sense ?
+        const toSet = item[key];
+        // const tableName = tableNameFrom(this.entity as any);
+
+        await this.repo.update(
+          {
+            id,
+          } as any,
+          {
+            [key]: toSet,
+          } as any,
+        );
+        //         await this.repo.query(
+        //           `UPDATE '${tableName}' as ${table}
+        // SET ${key}=${toSet}
+        // WHERE ${table}.id='${id}'
+        // `);
+      }
+    }
+    let model = await this.repo.findOne({
+      where: { id } as any,
+    });
+
+    return model as any as ENTITY;
+    //#endregion
+  }
+
+  async bulkUpdate(items: Entity[]) {
+    //#region @websqlFunc
+    const models = [];
+    for (let index = 0; index < items.length; index++) {
+      const item = items[index];
+      const { id } = item as any; // TOOD
+      const model = await this.updateById(id, item);
+      models.push(model);
+    }
+    return { models };
+    //#endregion
+  }
+
+  //#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:
+      | QueryDeepPartialEntity<Entity>
+      | QueryDeepPartialEntity<Entity>[],
+    conflictPathsOrOptions: string[] | UpsertOptions<Entity>,
+  ): Promise<InsertResult> {
+    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:
+      | string
+      | string[]
+      | number
+      | number[]
+      | Date
+      | Date[]
+      // | ObjectID
+      // | ObjectID[]
+      | FindOptionsWhere<Entity>,
+  ): Promise<UpdateResult> {
+    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:
+      | string
+      | string[]
+      | number
+      | number[]
+      | Date
+      | Date[]
+      // | ObjectID
+      // | ObjectID[]
+      | FindOptionsWhere<Entity>,
+  ): Promise<UpdateResult> {
+    return this.repo.restore(criteria);
+  }
+  //#endregion
+
+  //#region crud operations / typeorm / count
+  /**
+   * Counts entities that match given options.
+   * Useful for pagination.
+   */
+  count(options?: FindManyOptions<Entity>): Promise<number> {
+    return this.repo.count(options);
+  }
+  //#endregion
+
+  //#region crud operations / typeorm / count by
+  /**
+   * Counts entities that match given conditions.
+   * Useful for pagination.
+   */
+  countBy(
+    where: FindOptionsWhere<Entity> | FindOptionsWhere<Entity>[],
+  ): Promise<number> {
+    return this.repo.countBy(where);
+  }
+  //#endregion
+
+  //#region crud operations / typeorm / find
+  /**
+   * Finds entities that match given find options.
+   */
+  find(options?: FindManyOptions<Entity>): Promise<Entity[]> {
+    return this.repo.find(options);
+  }
+  //#endregion
+
+  //#region crud operations / typeorm / find by
+  /**
+   * Finds entities that match given find options.
+   */
+  findBy(
+    where: FindOptionsWhere<Entity> | FindOptionsWhere<Entity>[],
+  ): Promise<Entity[]> {
+    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?: FindManyOptions<Entity>): Promise<[Entity[], number]> {
+    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: FindOptionsWhere<Entity> | FindOptionsWhere<Entity>[],
+  ): Promise<[Entity[], number]> {
+    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: any[]): Promise<Entity[]> {
+    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: FindOneOptions<Entity>): Promise<Entity | null> {
+    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: FindOptionsWhere<Entity> | FindOptionsWhere<Entity>[],
+  ): Promise<Entity | null> {
+    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: number | string | Date,
+    // | ObjectID
+  ): Promise<Entity | null> {
+    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: FindOneOptions<Entity>): Promise<Entity> {
+    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: FindOptionsWhere<Entity> | FindOptionsWhere<Entity>[],
+  ): Promise<Entity> {
+    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: string, parameters?: any[]): Promise<any> {
+    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?: string,
+    queryRunner?: QueryRunner,
+  ): SelectQueryBuilder<Entity> {
+    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(): Promise<void> {
+    return this.repo.clear();
+  }
+  //#endregion
+
+  //#region crud operations / typeorm / increment
+  /**
+   * Increments some column by provided value of the entities matched given conditions.
+   */
+  increment(
+    conditions: FindOptionsWhere<Entity>,
+    propertyPath: string,
+    value: number | string,
+  ): Promise<UpdateResult> {
+    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: FindOptionsWhere<Entity>,
+    propertyPath: string,
+    value: number | string,
+  ): Promise<UpdateResult> {
+    return this.repo.decrement(conditions, propertyPath, value);
+  }
+  //#endregion
+
+  //#region crud operations / get all
+  /**
+   * @deprecated use findAndCount instead
+   */
+  async getAll() {
+    //#region @websqlFunc
+    // console.log('repo', this.__repository);
+    // console.log(
+    //   `repo taget name "${ClassHelpers__NS__getName(this.__repository.target)}"`,
+    // );
+    // debugger;
+    const totalCount = await this.repo.count();
+    const models = await this.repo.find();
+    // console.log('models', models);
+    // console.log('totalCount', totalCount);
+    return { models, totalCount };
+    //#endregion
+  }
+  //#endregion
+
+  //#region crud operations / get by id
+  async getBy(id: number | string): Promise<Entity> {
+    //#region @websqlFunc
+    const model = await await this.repo.findOne({
+      where: { id } as any,
+    });
+
+    return model;
+    //#endregion
+  }
+  //#endregion
+}