import { Connection } from "../connection/Connection"; import { FindManyOptions } from "../find-options/FindManyOptions"; import { ObjectType } from "../common/ObjectType"; import { FindOneOptions } from "../find-options/FindOneOptions"; import { DeepPartial } from "../common/DeepPartial"; import { RemoveOptions } from "../repository/RemoveOptions"; import { SaveOptions } from "../repository/SaveOptions"; import { MongoRepository } from "../repository/MongoRepository"; import { TreeRepository } from "../repository/TreeRepository"; import { Repository } from "../repository/Repository"; import { QueryRunner } from "../query-runner/QueryRunner"; import { SelectQueryBuilder } from "../query-builder/SelectQueryBuilder"; /** * Entity manager supposed to work with any entity, automatically find its repository and call its methods, * whatever entity type are you passing. */ export declare class EntityManager { /** * Connection used by this entity manager. */ readonly connection: Connection; /** * Custom query runner to be used for operations in this entity manager. * Used only in non-global entity manager. */ readonly queryRunner?: QueryRunner; /** * Once created and then reused by en repositories. */ protected repositories: Repository[]; constructor(connection: Connection, queryRunner?: QueryRunner); /** * Wraps given function execution (and all operations made there) in a transaction. * All database operations must be executed using provided entity manager. */ transaction(runInTransaction: (entityManger: EntityManager) => Promise): Promise; /** * Executes raw SQL query and returns raw database results. */ query(query: string, parameters?: any[]): Promise; /** * Creates a new query builder that can be used to build a sql query. */ createQueryBuilder(entityClass: ObjectType | Function | string, alias: string, queryRunner?: QueryRunner): SelectQueryBuilder; /** * Creates a new query builder that can be used to build a sql query. */ createQueryBuilder(queryRunner?: QueryRunner): SelectQueryBuilder; /** * Checks if entity has an id. */ hasId(entity: any): boolean; /** * Checks if entity of given schema name has an id. */ hasId(target: Function | string, entity: any): boolean; /** * Gets entity mixed id. */ getId(entity: any): any; /** * Gets entity mixed id. */ getId(target: Function | string, entity: any): any; /** * Creates a new entity instance. */ create(entityClass: ObjectType): 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 present in entity schema. */ create(entityClass: ObjectType | string, plainObject: DeepPartial): Entity; /** * Creates a new entities and copies all entity properties from given objects into their new entities. * Note that it copies only properties that present in entity schema. */ create(entityClass: ObjectType | string, plainObjects: DeepPartial[]): Entity[]; /** * Merges two entities into one new entity. */ merge(entityClass: ObjectType | string, mergeIntoEntity: Entity, ...entityLikes: DeepPartial[]): Entity; /** * Creates a new entity from the given plan 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. */ preload(entityClass: ObjectType | string, entityLike: DeepPartial): Promise; /** * Saves all given entities in the database. * If entities do not exist in the database then inserts, otherwise updates. */ save(entity: Entity, options?: SaveOptions): Promise; /** * Saves all given entities in the database. * If entities do not exist in the database then inserts, otherwise updates. */ save(targetOrEntity: Function | string, entity: Entity, options?: SaveOptions): Promise; /** * Saves all given entities in the database. * If entities do not exist in the database then inserts, otherwise updates. */ save(entities: Entity[], options?: SaveOptions): Promise; /** * Saves all given entities in the database. * If entities do not exist in the database then inserts, otherwise updates. */ save(targetOrEntity: Function | string, entities: Entity[], options?: SaveOptions): Promise; /** * Persists (saves) all given entities in the database. * If entities do not exist in the database then inserts, otherwise updates. * * @deprecated */ persist(entity: Entity, options?: SaveOptions): Promise; /** * Persists (saves) all given entities in the database. * If entities do not exist in the database then inserts, otherwise updates. * * @deprecated */ persist(targetOrEntity: Function, entity: Entity, options?: SaveOptions): Promise; /** * Persists (saves) all given entities in the database. * If entities do not exist in the database then inserts, otherwise updates. * * @deprecated */ persist(targetOrEntity: string, entity: Entity, options?: SaveOptions): Promise; /** * Persists (saves) all given entities in the database. * If entities do not exist in the database then inserts, otherwise updates. * * @deprecated */ persist(entities: Entity[], options?: SaveOptions): Promise; /** * Persists (saves) all given entities in the database. * If entities do not exist in the database then inserts, otherwise updates. * * @deprecated */ persist(targetOrEntity: Function, entities: Entity[], options?: SaveOptions): Promise; /** * Persists (saves) all given entities in the database. * If entities do not exist in the database then inserts, otherwise updates. * * @deprecated */ persist(targetOrEntity: string, entities: Entity[], options?: SaveOptions): Promise; /** * Updates entity partially. Entity can be found by a given conditions. */ update(target: ObjectType | string, conditions: Partial, partialEntity: DeepPartial, options?: SaveOptions): Promise; /** * Updates entity partially. Entity can be found by a given find options. */ update(target: ObjectType | string, findOptions: FindOneOptions, partialEntity: DeepPartial, options?: SaveOptions): Promise; /** * Updates entity partially. Entity will be found by a given id. */ updateById(target: ObjectType | string, id: any, partialEntity: DeepPartial, options?: SaveOptions): Promise; /** * Removes a given entity from the database. */ remove(entity: Entity): Promise; /** * Removes a given entity from the database. */ remove(targetOrEntity: ObjectType | string, entity: Entity, options?: RemoveOptions): Promise; /** * Removes a given entity from the database. */ remove(entity: Entity[], options?: RemoveOptions): Promise; /** * Removes a given entity from the database. */ remove(targetOrEntity: ObjectType | string, entity: Entity[], options?: RemoveOptions): Promise; /** * Removes entity by a given entity id. */ removeById(targetOrEntity: ObjectType | string, id: any, options?: RemoveOptions): Promise; /** * Removes entity by a given entity ids. */ removeByIds(targetOrEntity: ObjectType | string, ids: any[], options?: RemoveOptions): Promise; /** * Counts entities that match given options. * Useful for pagination. */ count(entityClass: ObjectType | string, options?: FindManyOptions): Promise; /** * Counts entities that match given conditions. * Useful for pagination. */ count(entityClass: ObjectType | string, conditions?: Partial): Promise; /** * Finds entities that match given options. */ find(entityClass: ObjectType | string, options?: FindManyOptions): Promise; /** * Finds entities that match given conditions. */ find(entityClass: ObjectType | string, conditions?: Partial): Promise; /** * Finds entities that match given find options. * Also counts all entities that match given conditions, * but ignores pagination settings (from and take options). */ findAndCount(entityClass: ObjectType | string, options?: FindManyOptions): Promise<[Entity[], number]>; /** * Finds entities that match given conditions. * Also counts all entities that match given conditions, * but ignores pagination settings (from and take options). */ findAndCount(entityClass: ObjectType | string, conditions?: Partial): Promise<[Entity[], number]>; /** * Finds entities with ids. * Optionally find options can be applied. */ findByIds(entityClass: ObjectType | string, ids: any[], options?: FindManyOptions): Promise; /** * Finds entities with ids. * Optionally conditions can be applied. */ findByIds(entityClass: ObjectType | string, ids: any[], conditions?: Partial): Promise; /** * Finds first entity that matches given find options. */ findOne(entityClass: ObjectType | string, options?: FindOneOptions): Promise; /** * Finds first entity that matches given conditions. */ findOne(entityClass: ObjectType | string, conditions?: Partial): Promise; /** * Finds entity with given id. * Optionally find options can be applied. */ findOneById(entityClass: ObjectType | string, id: any, options?: FindOneOptions): Promise; /** * Finds entity with given id. * Optionally conditions can be applied. */ findOneById(entityClass: ObjectType | string, id: any, conditions?: Partial): Promise; /** * Clears all the data from the given table (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(entityClass: ObjectType | string): Promise; /** * Gets repository for the given entity class or name. * If single database connection mode is used, then repository is obtained from the * repository aggregator, where each repository is individually created for this entity manager. * When single database connection is not used, repository is being obtained from the connection. */ getRepository(target: ObjectType | string): Repository; /** * Gets tree repository for the given entity class or name. * If single database connection mode is used, then repository is obtained from the * repository aggregator, where each repository is individually created for this entity manager. * When single database connection is not used, repository is being obtained from the connection. */ getTreeRepository(target: ObjectType | string): TreeRepository; /** * Gets mongodb repository for the given entity class. */ getMongoRepository(entityClass: ObjectType): MongoRepository; /** * Gets mongodb repository for the given entity name. */ getMongoRepository(entityName: string): MongoRepository; /** * Gets custom entity repository marked with @EntityRepository decorator. */ getCustomRepository(customRepository: ObjectType): T; /** * Releases all resources used by entity manager. * This is used when entity manager is created with a single query runner, * and this single query runner needs to be released after job with entity manager is done. */ release(): Promise; }