taon 19.0.86 → 21.0.6

package/browser/index.d.ts

@@ -1,6 +0,0 @@
-// @ts-nocheck
-/**
- * Generated bundle index. Do not edit.
- */
-/// <amd-module name="taon" />
-export * from './public-api';

package/browser/lib/base-classes/base-abstract-entity.d.ts

@@ -1,8 +0,0 @@
-// @ts-nocheck
-import { TaonBaseEntity } from './base-entity';
-import type { TaonBaseClass } from './base-class';
-export declare abstract class TaonBaseAbstractEntity<CloneT extends TaonBaseClass = any> extends TaonBaseEntity<CloneT> {
-    id: string;
-    version: number;
-}
-export type AbstractEntityOmitKeys<ENTITY> = Omit<ENTITY, 'id' | 'version' | '_' | 'clone'>;

package/browser/lib/base-classes/base-angular-service.d.ts

@@ -1,34 +0,0 @@
-// @ts-nocheck
-import { TaonContext } from '../create-context';
-import * as i0 from "@angular/core";
-/**
- * TODO prevent calling methods when not initialized
- * with init(ctx)
- */
-export declare abstract class BaseAngularsService {
-    protected readonly currentContext: TaonContext;
-    /**
-     * @deprecated
-     * current context host backend port (for localhost backend)
-     */
-    protected readonly CURRENT_HOST_BACKEND_PORT: number | undefined;
-    /**
-     * @deprecated
-     * current context host URL (for localhost backend)
-     */
-    protected readonly CURRENT_HOST_URL: string | undefined;
-    constructor();
-    /**
-     * @deprecated
-     * Returns the host URL for the backend service
-     * that is running on localhost (normal NodeJS/ExpressJS mode).
-     */
-    get host(): string;
-    injectController<T>(ctor: new (...args: any[]) => T, 
-    /**
-     * optional override context
-     */
-    overrideCurrentContext?: TaonContext): T;
-    static ɵfac: i0.ɵɵFactoryDeclaration<BaseAngularsService, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<BaseAngularsService>;
-}

package/browser/lib/base-classes/base-class.d.ts

@@ -1,16 +0,0 @@
-// @ts-nocheck
-export declare class TaonBaseClass<CloneT extends TaonBaseClass = any> {
-    /**
-     * class initialization hook
-     * taon after class instance creation
-     */
-    _(): Promise<void>;
-    /**
-     *
-     * @param overrideObjOrFn if object is provided it will override values in cloned object,
-     * if function is provided it will be called with old cloned values and should return
-     * object with values to override
-     * @returns cloned instance of the class
-     */
-    clone(overrideObjOrFn?: Partial<CloneT> | ((oldValues: Partial<CloneT>) => Partial<CloneT>)): CloneT;
-}

package/browser/lib/base-classes/base-context.d.ts

@@ -1,21 +0,0 @@
-// @ts-nocheck
-declare const TaonBaseContext: {
-    readonly contextName: string;
-    readonly appId: string;
-    cloneAsRemote: (cloneOpt?: {
-        overrideRemoteHost?: string;
-    }) => /*elided*/ any;
-    cloneAsNormal: (cloneOpt?: {
-        overrideHost?: string;
-    }) => /*elided*/ any;
-    __ref(): Promise<import("taon/browser").EndpointContext>;
-    readonly __refSync: import("taon/browser").EndpointContext;
-    getClassInstance<T>(ctor: new (...args: any[]) => T): T;
-    getClass<T>(ctor: new (...args: any[]) => T): new (...args: any[]) => T;
-    initialize: (overrideOptions?: import("taon/browser").Models.TaonInitializeParams) => Promise<import("taon/browser").EndpointContext>;
-    readonly realtime: {
-        readonly client: import("../realtime/realtime-client").RealtimeClient;
-        readonly server: import("../realtime/realtime-server").RealtimeServer;
-    };
-};
-export { TaonBaseContext };

package/browser/lib/base-classes/base-controller.d.ts

@@ -1,83 +0,0 @@
-// @ts-nocheck
-import { RestErrorResponseWrapper, HttpResponseError } from 'ng2-rest/browser';
-import type { ContextsEndpointStorage } from '../endpoint-context-storage';
-import type { Models } from '../models';
-import { TaonBaseInjector } from './base-injector';
-export interface MulterFileUploadResponse {
-    ok: boolean;
-    originalName: string;
-    /**
-     * name change to this to avoid confusion with originalname
-     * (similar to originalname with added uniq part)
-     */
-    savedAs: string;
-    size: number;
-    mimetype: string;
-}
-export declare class TaonBaseController<UPLOAD_FILE_QUERY_PARAMS = {}> extends TaonBaseInjector {
-    /**
-     * Hook that is called when taon app is inited
-     * (all contexts are created and inited)
-     */
-    afterAllCtxInited(options: {
-        ctxStorage: ContextsEndpointStorage;
-    }): Promise<void>;
-    uploadFormDataToServer(formData: FormData, queryParams?: UPLOAD_FILE_QUERY_PARAMS): Models.Http.Response<MulterFileUploadResponse[]>;
-    /**
-     * Hook after file is uploaded
-     * through `uploadFormDataToServer` or `uploadLocalFileToServer`
-     */
-    protected afterFileUploadAction(file?: MulterFileUploadResponse, queryParams?: UPLOAD_FILE_QUERY_PARAMS): void | Promise<void>;
-    uploadLocalFileToServer(absFilePath: string, options?: Pick<Models.Http.Rest.Ng2RestAxiosRequestConfig, 'onUploadProgress'>, queryParams?: UPLOAD_FILE_QUERY_PARAMS): Promise<MulterFileUploadResponse[]>;
-    /**
-     * Easy way to wait for status change with http (1s default) pooling.
-     *
-     * example (in sub class):
-     * ```ts
-        async check() {
-            await this.waitForProperStatusChange({
-              request: () => this.uploadFormDataToServer(void 0, void 0).request(),
-              statusCheck: resp => resp.body.json[0].ok,
-            });
-          }
-     * ```
-     */
-    _waitForProperStatusChange<T>(options: {
-        actionName: string;
-        /**
-         * Request for pooling
-         */
-        request: (opt?: {
-            /**
-             * optional index number to identify request in logs
-             * (starts from 0 and increments by 1 on each try)
-             */
-            reqIndexNum?: number;
-            httpErrorsCount?: number;
-        }) => ReturnType<Models.Http.Response<T>['request']>;
-        poolingInterval?: number;
-        /**
-         * default infinite tries
-         */
-        maxTries?: number;
-        /**
-         * default infiniti allowed http errors
-         */
-        allowedHttpErrors?: number;
-        /**
-         * condition to be met
-         */
-        statusCheck?: (response: Awaited<ReturnType<typeof options.request>>) => boolean;
-        /**
-         * if return true.. loop will continue
-         * if false .. will exit the loop
-         */
-        loopRequestsOnBackendError?: (opt: {
-            unknownError: Error;
-            unknownHttpError: HttpResponseError<any>;
-            taonError: HttpResponseError<RestErrorResponseWrapper>;
-            reqIndexNum?: number;
-            httpErrorsCount?: number;
-        }) => boolean | Promise<boolean>;
-    }): Promise<void>;
-}

package/browser/lib/base-classes/base-crud-controller.d.ts

@@ -1,29 +0,0 @@
-// @ts-nocheck
-import { Models } from '../models';
-import { TaonBaseController } from './base-controller';
-import { TaonBaseRepository } from './base-repository';
-/**
- * Please override property entityClassFn with entity class.
- */
-export declare abstract class TaonBaseCrudController<Entity, UPLOAD_FILE_QUERY_PARAMS = {}> extends TaonBaseController<UPLOAD_FILE_QUERY_PARAMS> {
-    protected db: TaonBaseRepository<Entity>;
-    /**
-     * Please provide entity as class property entityClassFn:
-     * @returns class function
-     *
-     */
-    abstract entityClassResolveFn: () => any;
-    _(): Promise<void>;
-    bufforedChanges(id: number | string, property: string, alreadyLength?: number): Models.Http.Response<string | any[]>;
-    pagination(pageNumber?: number, pageSize?: number, search?: string): Models.Http.Response<Entity[]>;
-    getAll(): Models.Http.Response<Entity[]>;
-    getBy(id: number | string): Models.Http.Response<Entity>;
-    updateById(id: number | string, item: Entity): Models.Http.Response<Entity>;
-    patchById(id: number | string, item: Entity): Models.Http.Response<Entity>;
-    bulkUpdate(items: Entity[]): Models.Http.Response<Entity[]>;
-    deleteById(id: number | string): Models.Http.Response<Entity>;
-    bulkDelete(ids: (number | string)[]): Models.Http.Response<(number | string | Entity)[]>;
-    clearTable(): Models.Http.Response<void>;
-    save(item: Entity): Models.Http.Response<Entity>;
-    bulkCreate(items: Entity): Models.Http.Response<Entity[]>;
-}

package/browser/lib/base-classes/base-custom-repository.d.ts

@@ -1,4 +0,0 @@
-// @ts-nocheck
-import { TaonBaseInjector } from './base-injector';
-export declare abstract class TaonBaseCustomRepository extends TaonBaseInjector {
-}

package/browser/lib/base-classes/base-entity.d.ts

@@ -1,17 +0,0 @@
-// @ts-nocheck
-import { RelationPath } from 'taon-typeorm/browser';
-import { TaonBaseClass } from './base-class';
-export declare abstract class TaonBaseEntity<
-/**
- * type for cloning
- */
-CloneT extends TaonBaseClass = any> extends TaonBaseClass<CloneT> {
-    /**
-     * simple check if relation is ok
-     */
-    relation(relationName: RelationPath<CloneT>): string;
-    /**
-     * simple check if relation is ok
-     */
-    relations(relationNames: RelationPath<CloneT>[]): string[];
-}

package/browser/lib/base-classes/base-file-upload.middleware.d.ts

@@ -1,15 +0,0 @@
-// @ts-nocheck
-import express from 'express';
-import * as multer from 'multer';
-import { TaonServerMiddlewareInterceptOptions } from 'ng2-rest/browser';
-import { TaonBaseMiddleware, TaonAdditionalMiddlewareMethodInfo } from './base-middleware';
-/**
- * Configurable file upload middleware (multer based)
- */
-export declare class TaonBaseFileUploadMiddleware extends TaonBaseMiddleware {
-    interceptServerMethod({ req, res, next }: TaonServerMiddlewareInterceptOptions, { methodName, expressPath }: TaonAdditionalMiddlewareMethodInfo): Promise<void>;
-    uploadDir(): string;
-    storage(): multer.StorageEngine;
-    upload(): multer.Multer;
-    middleware(): express.RequestHandler;
-}

package/browser/lib/base-classes/base-injector.d.ts

@@ -1,68 +0,0 @@
-// @ts-nocheck
-import { EndpointContext } from '../endpoint-context';
-import { TaonBaseCustomRepository } from './base-custom-repository';
-import type { TaonBaseRepository } from './base-repository';
-export declare class TaonBaseInjector {
-    /**
-     * for proxy purposes
-     */
-    getOriginalPrototype: () => any;
-    /**
-     * for proxy purposes
-     */
-    getOriginalConstructor: () => any;
-    /**
-     * class initialization hook
-     * taon after class instace creation
-     */
-    _(): Promise<void>;
-    /**
-     * @deprecated use ctx instead
-     * Current endpoint context
-     */
-    get __endpoint_context__(): EndpointContext;
-    /**
-     * get  current endpoint context
-     */
-    get ctx(): EndpointContext;
-    /**
-     * inject crud repo for entity
-     */
-    injectRepo<T>(entityForCrud: new (...args: any[]) => T): TaonBaseRepository<T>;
-    injectCustomRepository<T extends TaonBaseCustomRepository>(cutomRepositoryClass: new (...args: any[]) => T): T;
-    /**
-     * aliast to this.injectRepository()
-     */
-    injectCustomRepo<T extends TaonBaseCustomRepository>(cutomRepositoryClass: new (...args: any[]) => T): T;
-    /**
-     * example usage:
-     * ...
-     * exampleController = this.injectController(ExampleController);
-     * ...
-     */
-    injectController<T>(ctor: new (...args: any[]) => T): T;
-    /**
-     * example usage:
-     * ...
-     * exampleSubscriber = this.injectSubscriber(ExampleSubscriber)
-     * ...
-     */
-    injectSubscriber<T>(ctor: new (...args: any[]) => T): T;
-    /**
-     * aliast to .injectController()
-     */
-    injectCtrl<T>(ctor: new (...args: any[]) => T): T;
-    /**
-     * inject middleware for context
-     */
-    injectMiddleware<T>(ctor: new (...args: any[]) => T): T;
-    /**
-     * inject provider for context
-     */
-    injectProvider<T>(ctor: new (...args: any[]) => T): T;
-    /**
-     * Inject: Controllers, Providers, Repositories, Services, etc.
-     * TODO  addd nest js injecting
-     */
-    private __inject;
-}

package/browser/lib/base-classes/base-middleware.d.ts

@@ -1,39 +0,0 @@
-// @ts-nocheck
-import type { AxiosResponse } from 'axios';
-import { TaonClientMiddlewareInterceptOptions, TaonServerMiddlewareInterceptOptions } from 'ng2-rest/browser';
-import { Observable } from 'rxjs';
-import { CoreModels } from 'tnp-core/browser';
-import { TaonBaseInjector } from './base-injector';
-/**
- * TODO
- * - global provider available in all contexts
- * - provider available in own context
- */
-export declare abstract class TaonBaseMiddleware extends TaonBaseInjector {
-}
-export interface TaonAdditionalMiddlewareMethodInfo {
-    methodName: string;
-    expressPath: string;
-    httpRequestType: CoreModels.HttpMethod;
-}
-export interface TaonBaseMiddleware {
-    /**
-     * Global interceptor for whole context
-     * backend request
-     */
-    interceptServer({ req, res, next, }: TaonServerMiddlewareInterceptOptions): Promise<void> | void;
-    /**
-     * Global interceptor for whole context
-     * client requests
-     */
-    interceptClient({ req, next, }: TaonClientMiddlewareInterceptOptions): Observable<AxiosResponse<any>>;
-    /**
-     * Specyfic controller method interceptor
-     */
-    interceptServerMethod({ req, res, next }: TaonServerMiddlewareInterceptOptions, { methodName, expressPath, httpRequestType, }: TaonAdditionalMiddlewareMethodInfo): Promise<void> | void;
-    /**
-     * Controller method frontned interceptor
-     * TODO not needed ?
-     */
-    interceptClientMethod({ req, next }: TaonClientMiddlewareInterceptOptions, { methodName, expressPath, httpRequestType, }: TaonAdditionalMiddlewareMethodInfo): Observable<AxiosResponse<any>>;
-}

package/browser/lib/base-classes/base-migration.d.ts

@@ -1,12 +0,0 @@
-// @ts-nocheck
-import { MigrationInterface, QueryRunner } from 'taon-typeorm/browser';
-import { TaonBaseInjector } from './base-injector';
-export declare class TaonBaseMigration extends TaonBaseInjector implements MigrationInterface {
-    /**
-     * by default is READY to run
-     */
-    isReadyToRun(): boolean;
-    getDescription(): string;
-    up(queryRunner: QueryRunner): Promise<any>;
-    down(queryRunner: QueryRunner): Promise<any>;
-}

package/browser/lib/base-classes/base-provider.d.ts

@@ -1,9 +0,0 @@
-// @ts-nocheck
-import { TaonBaseInjector } from './base-injector';
-/**
- * TODO
- * - global provider available in all contexts
- * - provider available in own context
- */
-export declare class TaonBaseProvider extends TaonBaseInjector {
-}

package/browser/lib/base-classes/base-repository.d.ts

@@ -1,267 +0,0 @@
-// @ts-nocheck
-import { type DeepPartial, type FindManyOptions, type FindOneOptions, type FindOptionsWhere, type InsertResult, type Repository, type SaveOptions, type UpdateResult } from 'taon-typeorm/browser';
-import type { QueryDeepPartialEntity } from 'taon-typeorm/browser';
-import type { UpsertOptions } from 'taon-typeorm/browser';
-import type { DataSource as DataSourceType, QueryRunner, SelectQueryBuilder } from 'taon-typeorm/browser';
-import { MySqlQuerySource } from 'taon-type-sql/browser';
-import { TaonBaseCustomRepository } from './base-custom-repository';
-export declare abstract class TaonBaseRepository<Entity extends {
-    id?: any;
-}> extends TaonBaseCustomRepository {
-    abstract entityClassResolveFn: () => any;
-    constructor(__entityClassResolveFn: () => any);
-    private __dbQuery;
-    get dbQuery(): MySqlQuerySource;
-    get connection(): DataSourceType;
-    protected get repository(): Repository<Entity>;
-    /**
-     * target for repository
-     */
-    get target(): Function;
-    /**
-     * alias to repository
-     */
-    protected get repo(): Repository<Entity>;
-    get repositoryExists(): boolean;
-    /**
-     * Checks if entity has an id.
-     * If entity composite compose ids, it will check them all.
-     */
-    hasId(entity: Entity): boolean;
-    /**
-     * Gets entity mixed id.
-     */
-    getId(entity: Entity): any;
-    /**
-      Saves a given entity in the database.
-     * If entity does not exist in the database then inserts, otherwise updates.
-     */
-    save(item: Entity, options?: SaveOptions & {
-        reload: false;
-    }): Promise<Entity>;
-    /**
-     * 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;
-    bulkSave(items: Entity[], options?: SaveOptions & {
-        reload: false;
-    }): Promise<Entity[]>;
-    /**
-     * @deprecated use bulkSave instead
-     */
-    bulkCreate(items: Entity[], options?: SaveOptions & {
-        reload: false;
-    }): Promise<Entity[]>;
-    /**
-     * Saves all given entities in the database.
-     * If entities do not exist in the database then inserts, otherwise updates.
-     */
-    /**
-     * Merges multiple entities (or entity-like objects) into a given entity.
-     */
-    merge(mergeIntoEntity: Entity, ...entityLikes: Entity[]): Entity;
-    /**
-     * 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>;
-    /**
-     * Removes a given entities from the database.
-     */
-    remove(idOrEntity: number | string | Entity): Promise<Entity>;
-    /**
-     * alias to remove
-     */
-    delete(idOrEntity: number | string | Partial<Entity>): Promise<Entity>;
-    /**
-     * alias to removeById
-     */
-    deleteById(id: number | string): Promise<Entity>;
-    bulkRemove(idsOrEntities: (number | string | Entity)[]): Promise<Entity[]>;
-    bulkDelete(ids: (number | string | Entity)[]): Promise<Entity[]>;
-    /**
-     * 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>;
-    /**
-     * 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>;
-    /**
-     * 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>;
-    update(item: Entity): Promise<any>;
-    private allowedTypesToUpdate;
-    updateById<ENTITY = Entity>(id: number | string, item: Entity): Promise<ENTITY>;
-    bulkUpdate(items: Entity[]): Promise<any>;
-    /**
-     * 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>;
-    /**
-     * 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[] | FindOptionsWhere<Entity>): Promise<UpdateResult>;
-    /**
-     * 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[] | FindOptionsWhere<Entity>): Promise<UpdateResult>;
-    /**
-     * Counts entities that match given options.
-     * Useful for pagination.
-     */
-    count(options?: FindManyOptions<Entity>): Promise<number>;
-    /**
-     * Counts entities that match given conditions.
-     * Useful for pagination.
-     */
-    countBy(where: FindOptionsWhere<Entity> | FindOptionsWhere<Entity>[]): Promise<number>;
-    /**
-     * Finds entities that match given find options.
-     */
-    find(options?: FindManyOptions<Entity>): Promise<Entity[]>;
-    /**
-     * Finds entities that match given find options.
-     */
-    findBy(where: FindOptionsWhere<Entity> | FindOptionsWhere<Entity>[]): Promise<Entity[]>;
-    /**
-     * 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]>;
-    /**
-     * 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]>;
-    /**
-     * 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[]>;
-    /**
-     * 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>;
-    /**
-     * 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>;
-    /**
-     * 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): Promise<Entity | null>;
-    /**
-     * 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>;
-    /**
-     * 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>;
-    /**
-     * 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>;
-    /**
-     * 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>;
-    /**
-     * 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>;
-    /**
-     * Increments some column by provided value of the entities matched given conditions.
-     */
-    increment(conditions: FindOptionsWhere<Entity>, propertyPath: string, value: number | string): Promise<UpdateResult>;
-    /**
-     * Decrements some column by provided value of the entities matched given conditions.
-     */
-    decrement(conditions: FindOptionsWhere<Entity>, propertyPath: string, value: number | string): Promise<UpdateResult>;
-    /**
-     * @deprecated use findAndCount instead
-     */
-    getAll(): Promise<any>;
-    getBy(id: number | string): Promise<Entity>;
-}