next branch and [email protected] version. They were pending their migration from 2018. Finally, they are in the master branch and master version.target now is es2020. This requires Node.JS version 14+Connection was renamed to DataSource. Old Connection is still there, but now it's deprecated. It will be completely removed in next version. New API:new Connection(), createConnection(), getConnectionManager().create(), etc. They all deprecated in favour of new syntax you can see above.relationLoadStrategy. Relation load strategy is used on entity load and determines how relations must be loaded when you query entities and their relations from the database. Used on find* methods and QueryBuilder. Value can be set to join or query.join - loads relations using SQL JOIN expressionquery - executes separate SQL queries for each relationjoin, but default can be set in ConnectionOptions:find* methods:query strategy, because it can be a more performant approach to query relations.findOneBy, findOneByOrFail, findBy, countBy, findAndCountBy methods to BaseEntity, EntityManager and Repository:find* and count* method signatures where changed, read the "breaking changes" section for more info.select type signature in FindOptions (used in find* methods):relations type signature in FindOptions (used in find* methods):order type signature in FindOptions (used in find* methods):where type signature in FindOptions (used in find* methods) now allows to build nested statements with conditional relations, for example:FindOperator-s can be applied for relations in where statement, for example:boolean can be applied for relations in where statement, for example:14+ormconfig support. ormconfig still works if you use deprecated methods, however we do not recommend using it anymore, because it's support will be completely dropped in 0.4.0. If you want to have your connection options defined in a separate file, you can still do it like this:resolveJsonModule in tsconfig.json enabled:0.4.0 you'll only be able to specify entities / subscribers / migrations using direct references to entity classes / schemas (see "deprecations" section).ormconfig extensions (e.g. json, js, ts, yaml, xml, env).migrations:* commands was removed. Use migration:* commands instead.cli option from BaseConnectionOptions (now BaseDataSourceOptions options) was removed (since CLI commands were re-worked).migrationsRun and synchronize enabled in connection options).aurora-data-api driver now is called aurora-mysqlaurora-data-api-pg driver now is called aurora-postgresEntityManager.connection is now EntityManager.dataSourceRepository now has a constructor (breaks classes extending Repository with custom constructor)@TransactionRepository, @TransactionManager, @Transaction decorators were completely removed. These decorators do the things out of the TypeORM scope.@Entity decorator. Also, for junction table it's possible to set a custom name using @JoinTable decorator.findOne() signature without parameters was dropped. If you need a single row from the db you can use a following syntax:findOne(id) signature was dropped. Use following syntax instead:findOne, findOneOrFail, find, count, findAndCount methods now only accept FindOptions as parameter, e.g.:where conditions directly without FindOptions new methods were added: findOneBy, findOneByOrFail, findBy, countBy, findAndCountBy. Example:find* and count* methods typings, improve type safety and prevent user confusion.findByIds was deprecated, use findBy method instead in conjunction with In operator, for example:findOne and QueryBuilder.getOne() now return null instead of undefined in the case if it didn't find anything in the database. Logically it makes more sense to return null.findOne now limits returning rows to 1 at database level.FOR UPDATE locking does not work with findOne in Oracle since FOR UPDATE cannot be used with FETCH NEXT in a single query.where in FindOptions (e.g. find({ where: { ... })) is more sensitive to input criteria now.FindConditions (where in FindOptions) was renamed to FindOptionsWhere.null as value in where used in find* methods is not supported anymore. Now you must explicitly use IsNull() operator.find*'s where. Example:@Column(/*...*/) membership: MembershipKind you could have a query like:Equal operator:where signature brings.order in FindOptions (used in find* methods) doesn't support ordering by relations anymore. Define relation columns, and order by them instead.where in FindOptions (used in find* methods) previously supported ObjectLiteral and string types. Now both signatures were removed. ObjectLiteral was removed because it seriously breaks the type safety, and string doesn't make sense in the context of FindOptions. Use QueryBuilder instead.MongoRepository and MongoEntityManager now use new types called MongoFindManyOptions and MongoFindOneOptions for their find* methods.primary relation (e.g. @ManyToOne(() => User, { primary: true }) user: User) support is removed. You still have an ability to use foreign keys as your primary keys, however now you must explicitly define a column marked as primary.ormconfig anymore. You must specify a file with data source instance instead.entities, migrations, subscribers options inside DataSourceOptions accepting string directories support is deprecated. You'll be only able to pass entity references in the future versions.UseContainerOptions, ContainedType, ContainerInterface, defaultContainer, useContainer, getFromContainer) are deprecated.getCustomRepository used within transactions is deprecated. Use withRepository method instead.Connection.isConnected is deprecated. Use .isInitialized instead.select in FindOptions (used in find* methods) used as an array of property names is deprecated. Now you should use a new object-literal notation. Example:select signature brings.relations in FindOptions (used in find* methods) used as an array of relation names is deprecated. Now you should use a new object-literal notation. Example:relations signature brings.join in FindOptions (used in find* methods) is deprecated. Use QueryBuilder to build queries containing manual joins.Connection, ConnectionOptions are deprecated, new names to use are: DataSource and DataSourceOptions. To create the same connection you had before use a new syntax: new DataSource({ /*...*/ }).createConnection(), createConnections() are deprecated, since Connection is called DataSource now, to create a connection and connect to the database simply do:getConnection() is deprecated. To have a globally accessible connection, simply export your data source and use it in places you need it:getManager(), getMongoManager(), getSqljsManager(), getRepository(), getTreeRepository(), getMongoRepository(), createQueryBuilder() are all deprecated now. Use globally accessible data source instead:getConnectionManager() and ConnectionManager itself are deprecated - now Connection is called DataSource, and each data source can be defined in exported variable. If you want to have a collection of data sources, just define them in a variable, simply as:getConnectionOptions() is deprecated - in next version we are going to implement different mechanism of connection options loadingAbstractRepository is deprecated. Use new way of custom repositories creation.Connection.name and BaseConnectionOptions.name are deprecated. Connections don't need names anymore since we are going to drop all related methods relying on this property.0.4.0observers - we will consider returning them back with new API in future versionsalternative find operators - using $any, $in, $like and other operators in where condition.