taon 21.0.51 → 21.0.53

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

@@ -1,942 +0,0 @@
-//#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
-}