@lakutata/orm 3.0.0 → 3.1.1

package/dist/esm/exports/ORM.js

@@ -1,120 +1,117 @@
 import 'reflect-metadata';
-export * from 'typeorm/globals.js';
-export * from 'typeorm/container.js';
-export * from 'typeorm/common/EntityTarget.js';
-export * from 'typeorm/common/ObjectType.js';
-export * from 'typeorm/common/ObjectLiteral.js';
-export * from 'typeorm/common/MixedList.js';
-export * from 'typeorm/common/DeepPartial.js';
-export * from 'typeorm/common/RelationType.js';
-export * from 'typeorm/error/index.js';
-export * from 'typeorm/decorator/options/ColumnOptions.js';
-export * from 'typeorm/decorator/options/IndexOptions.js';
-export * from 'typeorm/decorator/options/JoinColumnOptions.js';
-export * from 'typeorm/decorator/options/JoinTableOptions.js';
-export * from 'typeorm/decorator/options/RelationOptions.js';
-export * from 'typeorm/decorator/options/EntityOptions.js';
-export * from 'typeorm/decorator/options/ValueTransformer.js';
-export * from 'typeorm/find-options/operator/And.js';
-export * from 'typeorm/find-options/operator/Or.js';
-export * from 'typeorm/find-options/operator/Any.js';
-export * from 'typeorm/find-options/operator/ArrayContainedBy.js';
-export * from 'typeorm/find-options/operator/ArrayContains.js';
-export * from 'typeorm/find-options/operator/ArrayOverlap.js';
-export * from 'typeorm/find-options/operator/Between.js';
-export * from 'typeorm/find-options/operator/Equal.js';
-export * from 'typeorm/find-options/operator/In.js';
-export * from 'typeorm/find-options/operator/IsNull.js';
-export * from 'typeorm/find-options/operator/LessThan.js';
-export * from 'typeorm/find-options/operator/LessThanOrEqual.js';
-export * from 'typeorm/find-options/operator/ILike.js';
-export * from 'typeorm/find-options/operator/Like.js';
-export * from 'typeorm/find-options/operator/MoreThan.js';
-export * from 'typeorm/find-options/operator/MoreThanOrEqual.js';
-export * from 'typeorm/find-options/operator/Not.js';
-export * from 'typeorm/find-options/operator/Raw.js';
-export * from 'typeorm/find-options/operator/JsonContains.js';
-export * from 'typeorm/find-options/EqualOperator.js';
-export * from 'typeorm/find-options/FindManyOptions.js';
-export * from 'typeorm/find-options/FindOneOptions.js';
-export * from 'typeorm/find-options/FindOperator.js';
-export * from 'typeorm/find-options/FindOperatorType.js';
-export * from 'typeorm/find-options/FindOptionsOrder.js';
-export * from 'typeorm/find-options/FindOptionsRelations.js';
-export * from 'typeorm/find-options/FindOptionsSelect.js';
-export * from 'typeorm/find-options/FindOptionsUtils.js';
-export * from 'typeorm/find-options/FindOptionsWhere.js';
-export * from 'typeorm/find-options/FindTreeOptions.js';
-export * from 'typeorm/find-options/JoinOptions.js';
-export * from 'typeorm/find-options/OrderByCondition.js';
-export * from 'typeorm/logger/AbstractLogger.js';
-export * from 'typeorm/logger/Logger.js';
-export * from 'typeorm/logger/LoggerOptions.js';
-export * from 'typeorm/logger/AdvancedConsoleLogger.js';
-export * from 'typeorm/logger/SimpleConsoleLogger.js';
-export * from 'typeorm/logger/FileLogger.js';
-export * from 'typeorm/metadata/EntityMetadata.js';
-export * from 'typeorm/metadata/CheckMetadata.js';
-export * from 'typeorm/metadata/ColumnMetadata.js';
-export * from 'typeorm/metadata/EmbeddedMetadata.js';
-export * from 'typeorm/metadata/EntityListenerMetadata.js';
-export * from 'typeorm/metadata/ExclusionMetadata.js';
-export * from 'typeorm/metadata/ForeignKeyMetadata.js';
-export * from 'typeorm/metadata/IndexMetadata.js';
-export * from 'typeorm/metadata/RelationMetadata.js';
-export * from 'typeorm/metadata/RelationCountMetadata.js';
-export * from 'typeorm/metadata/UniqueMetadata.js';
-export * from 'typeorm/entity-manager/EntityManager.js';
-export * from 'typeorm/repository/AbstractRepository.js';
-export * from 'typeorm/repository/Repository.js';
-export * from 'typeorm/repository/BaseEntity.js';
-export * from 'typeorm/repository/TreeRepository.js';
-export * from 'typeorm/repository/MongoRepository.js';
-export * from 'typeorm/repository/RemoveOptions.js';
-export * from 'typeorm/repository/SaveOptions.js';
-export * from 'typeorm/schema-builder/table/TableCheck.js';
-export * from 'typeorm/schema-builder/table/TableColumn.js';
-export * from 'typeorm/schema-builder/table/TableExclusion.js';
-export * from 'typeorm/schema-builder/table/TableForeignKey.js';
-export * from 'typeorm/schema-builder/table/TableIndex.js';
-export * from 'typeorm/schema-builder/table/TableUnique.js';
-export * from 'typeorm/schema-builder/table/Table.js';
-export * from 'typeorm/schema-builder/options/TableCheckOptions.js';
-export * from 'typeorm/schema-builder/options/TableColumnOptions.js';
-export * from 'typeorm/schema-builder/options/TableExclusionOptions.js';
-export * from 'typeorm/schema-builder/options/TableForeignKeyOptions.js';
-export * from 'typeorm/schema-builder/options/TableIndexOptions.js';
-export * from 'typeorm/schema-builder/options/TableOptions.js';
-export * from 'typeorm/schema-builder/options/TableUniqueOptions.js';
-export * from 'typeorm/schema-builder/options/ViewOptions.js';
-export * from 'typeorm/driver/mongodb/typings.js';
-export * from 'typeorm/driver/types/DatabaseType.js';
-export * from 'typeorm/driver/types/GeoJsonTypes.js';
-export * from 'typeorm/driver/types/ReplicationMode.js';
-export * from 'typeorm/driver/sqlserver/MssqlParameter.js';
-export { ConnectionOptionsReader } from 'typeorm/connection/ConnectionOptionsReader.js';
-export { DataSource } from 'typeorm/data-source/DataSource.js';
-export { QueryBuilder } from 'typeorm/query-builder/QueryBuilder.js';
-export { SelectQueryBuilder } from 'typeorm/query-builder/SelectQueryBuilder.js';
-export { DeleteQueryBuilder } from 'typeorm/query-builder/DeleteQueryBuilder.js';
-export { InsertQueryBuilder } from 'typeorm/query-builder/InsertQueryBuilder.js';
-export { UpdateQueryBuilder } from 'typeorm/query-builder/UpdateQueryBuilder.js';
-export { RelationQueryBuilder } from 'typeorm/query-builder/RelationQueryBuilder.js';
-export { Brackets } from 'typeorm/query-builder/Brackets.js';
-export { NotBrackets } from 'typeorm/query-builder/NotBrackets.js';
-export { InsertResult } from 'typeorm/query-builder/result/InsertResult.js';
-export { UpdateResult } from 'typeorm/query-builder/result/UpdateResult.js';
-export { DeleteResult } from 'typeorm/query-builder/result/DeleteResult.js';
-export { QueryResult } from 'typeorm/query-runner/QueryResult.js';
-export { MongoEntityManager } from 'typeorm/entity-manager/MongoEntityManager.js';
-export { Migration } from 'typeorm/migration/Migration.js';
-export { MigrationExecutor } from 'typeorm/migration/MigrationExecutor.js';
-export { DefaultNamingStrategy } from 'typeorm/naming-strategy/DefaultNamingStrategy.js';
-export { LegacyOracleNamingStrategy } from 'typeorm/naming-strategy/LegacyOracleNamingStrategy.js';
-export { EntitySchema } from 'typeorm/entity-schema/EntitySchema.js';
-export { EntitySchemaEmbeddedColumnOptions } from 'typeorm/entity-schema/EntitySchemaEmbeddedColumnOptions.js';
-export { EntitySchemaOptions } from 'typeorm/entity-schema/EntitySchemaOptions.js';
-export { InstanceChecker } from 'typeorm/util/InstanceChecker.js';
-export { TreeRepositoryUtils } from 'typeorm/util/TreeRepositoryUtils.js';
-export { getMetadataArgsStorage } from 'typeorm/globals.js';
-export { MetadataArgsStorage } from 'typeorm/metadata-args/MetadataArgsStorage.js';
+export * from '#typeorm/globals.js';
+export { ObjectId } from '#typeorm/driver/mongo-embedded/EmbeddedObjectId.js';
+export * from '#typeorm/common/EntityTarget.js';
+export * from '#typeorm/common/ObjectType.js';
+export * from '#typeorm/common/ObjectLiteral.js';
+export * from '#typeorm/common/MixedList.js';
+export * from '#typeorm/common/DeepPartial.js';
+export * from '#typeorm/common/RelationType.js';
+export * from '#typeorm/error/index.js';
+export * from '#typeorm/decorator/options/ColumnOptions.js';
+export * from '#typeorm/decorator/options/IndexOptions.js';
+export * from '#typeorm/decorator/options/JoinColumnOptions.js';
+export * from '#typeorm/decorator/options/JoinTableOptions.js';
+export * from '#typeorm/decorator/options/RelationOptions.js';
+export * from '#typeorm/decorator/options/EntityOptions.js';
+export * from '#typeorm/decorator/options/ValueTransformer.js';
+export * from '#typeorm/find-options/operator/And.js';
+export * from '#typeorm/find-options/operator/Or.js';
+export * from '#typeorm/find-options/operator/Any.js';
+export * from '#typeorm/find-options/operator/ArrayContainedBy.js';
+export * from '#typeorm/find-options/operator/ArrayContains.js';
+export * from '#typeorm/find-options/operator/ArrayOverlap.js';
+export * from '#typeorm/find-options/operator/Between.js';
+export * from '#typeorm/find-options/operator/Equal.js';
+export * from '#typeorm/find-options/operator/In.js';
+export * from '#typeorm/find-options/operator/IsNull.js';
+export * from '#typeorm/find-options/operator/LessThan.js';
+export * from '#typeorm/find-options/operator/LessThanOrEqual.js';
+export * from '#typeorm/find-options/operator/ILike.js';
+export * from '#typeorm/find-options/operator/Like.js';
+export * from '#typeorm/find-options/operator/MoreThan.js';
+export * from '#typeorm/find-options/operator/MoreThanOrEqual.js';
+export * from '#typeorm/find-options/operator/Not.js';
+export * from '#typeorm/find-options/operator/Raw.js';
+export * from '#typeorm/find-options/operator/JsonContains.js';
+export * from '#typeorm/find-options/EqualOperator.js';
+export * from '#typeorm/find-options/FindManyOptions.js';
+export * from '#typeorm/find-options/FindOneOptions.js';
+export * from '#typeorm/find-options/FindOperator.js';
+export * from '#typeorm/find-options/FindOperatorType.js';
+export * from '#typeorm/find-options/FindOptionsOrder.js';
+export * from '#typeorm/find-options/FindOptionsRelations.js';
+export * from '#typeorm/find-options/FindOptionsSelect.js';
+export * from '#typeorm/find-options/FindOptionsUtils.js';
+export * from '#typeorm/find-options/FindOptionsWhere.js';
+export * from '#typeorm/find-options/FindTreeOptions.js';
+export * from '#typeorm/find-options/OrderByCondition.js';
+export * from '#typeorm/logger/AbstractLogger.js';
+export * from '#typeorm/logger/Logger.js';
+export * from '#typeorm/logger/LoggerOptions.js';
+export * from '#typeorm/logger/AdvancedConsoleLogger.js';
+export * from '#typeorm/logger/SimpleConsoleLogger.js';
+export * from '#typeorm/logger/FileLogger.js';
+export * from '#typeorm/metadata/EntityMetadata.js';
+export * from '#typeorm/metadata/CheckMetadata.js';
+export * from '#typeorm/metadata/ColumnMetadata.js';
+export * from '#typeorm/metadata/EmbeddedMetadata.js';
+export * from '#typeorm/metadata/EntityListenerMetadata.js';
+export * from '#typeorm/metadata/ExclusionMetadata.js';
+export * from '#typeorm/metadata/ForeignKeyMetadata.js';
+export * from '#typeorm/metadata/IndexMetadata.js';
+export * from '#typeorm/metadata/RelationMetadata.js';
+export * from '#typeorm/metadata/UniqueMetadata.js';
+export * from '#typeorm/entity-manager/EntityManager.js';
+export * from '#typeorm/repository/Repository.js';
+export * from '#typeorm/repository/BaseEntity.js';
+export * from '#typeorm/repository/TreeRepository.js';
+export * from '#typeorm/repository/MongoRepository.js';
+export * from '#typeorm/repository/RemoveOptions.js';
+export * from '#typeorm/repository/SaveOptions.js';
+export * from '#typeorm/schema-builder/table/TableCheck.js';
+export * from '#typeorm/schema-builder/table/TableColumn.js';
+export * from '#typeorm/schema-builder/table/TableExclusion.js';
+export * from '#typeorm/schema-builder/table/TableForeignKey.js';
+export * from '#typeorm/schema-builder/table/TableIndex.js';
+export * from '#typeorm/schema-builder/table/TableUnique.js';
+export * from '#typeorm/schema-builder/table/Table.js';
+export * from '#typeorm/schema-builder/options/TableCheckOptions.js';
+export * from '#typeorm/schema-builder/options/TableColumnOptions.js';
+export * from '#typeorm/schema-builder/options/TableExclusionOptions.js';
+export * from '#typeorm/schema-builder/options/TableForeignKeyOptions.js';
+export * from '#typeorm/schema-builder/options/TableIndexOptions.js';
+export * from '#typeorm/schema-builder/options/TableOptions.js';
+export * from '#typeorm/schema-builder/options/TableUniqueOptions.js';
+export * from '#typeorm/schema-builder/options/ViewOptions.js';
+export * from '#typeorm/driver/mongodb/typings.js';
+export * from '#typeorm/driver/types/DatabaseType.js';
+export * from '#typeorm/driver/types/GeoJsonTypes.js';
+export * from '#typeorm/driver/types/ReplicationMode.js';
+export * from '#typeorm/driver/sqlserver/MssqlParameter.js';
+export { ConnectionOptionsReader } from '#typeorm/connection/ConnectionOptionsReader.js';
+export { DataSource } from '#typeorm/data-source/DataSource.js';
+export { QueryBuilder } from '#typeorm/query-builder/QueryBuilder.js';
+export { SelectQueryBuilder } from '#typeorm/query-builder/SelectQueryBuilder.js';
+export { DeleteQueryBuilder } from '#typeorm/query-builder/DeleteQueryBuilder.js';
+export { InsertQueryBuilder } from '#typeorm/query-builder/InsertQueryBuilder.js';
+export { UpdateQueryBuilder } from '#typeorm/query-builder/UpdateQueryBuilder.js';
+export { RelationQueryBuilder } from '#typeorm/query-builder/RelationQueryBuilder.js';
+export { Brackets } from '#typeorm/query-builder/Brackets.js';
+export { NotBrackets } from '#typeorm/query-builder/NotBrackets.js';
+export { InsertResult } from '#typeorm/query-builder/result/InsertResult.js';
+export { UpdateResult } from '#typeorm/query-builder/result/UpdateResult.js';
+export { DeleteResult } from '#typeorm/query-builder/result/DeleteResult.js';
+export { QueryResult } from '#typeorm/query-runner/QueryResult.js';
+export { MongoEntityManager } from '#typeorm/entity-manager/MongoEntityManager.js';
+export { Migration } from '#typeorm/migration/Migration.js';
+export { MigrationExecutor } from '#typeorm/migration/MigrationExecutor.js';
+export { DefaultNamingStrategy } from '#typeorm/naming-strategy/DefaultNamingStrategy.js';
+export { LegacyOracleNamingStrategy, NamingStrategyV03 } from '#typeorm/legacy-naming-strategies/index.js';
+export { EntitySchema } from '#typeorm/entity-schema/EntitySchema.js';
+export { EntitySchemaEmbeddedColumnOptions } from '#typeorm/entity-schema/EntitySchemaEmbeddedColumnOptions.js';
+export { EntitySchemaOptions } from '#typeorm/entity-schema/EntitySchemaOptions.js';
+export { InstanceChecker } from '#typeorm/util/InstanceChecker.js';
+export { TreeRepositoryUtils } from '#typeorm/util/TreeRepositoryUtils.js';
+export { getMetadataArgsStorage } from '#typeorm/globals.js';
+export { MetadataArgsStorage } from '#typeorm/metadata-args/MetadataArgsStorage.js';

package/dist/esm/lib/ConnectionOptions.js

@@ -0,0 +1,14 @@
+/**
+ * The connection options with the defaults of the framework: the null and undefined values of the where conditions
+ * ignored (the condition on the property left out), as TypeORM 0.3 did, where TypeORM 1 throws by default. Each key of
+ * the `invalidWhereValuesBehavior` of the options replaces its default (`{undefined: 'throw'}` throws on the undefined
+ * values and still ignores the null values).
+ * @param options The connection options.
+ * @returns The connection options with the defaults.
+ */
+export function connectionOptionsOf(options) {
+    return {
+        ...options,
+        invalidWhereValuesBehavior: { null: 'ignore', undefined: 'ignore', ...options.invalidWhereValuesBehavior }
+    };
+}

package/dist/esm/providers/Database.js

@@ -8,15 +8,17 @@ var __metadata = (this && this.__metadata) || function (k, v) {
     if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
 };
 import { Configurable, Transient } from '@lakutata/core/decorator/di';
-import { DataSource } from 'typeorm/data-source/DataSource.js';
+import { DataSource } from '#typeorm/data-source/DataSource.js';
 import { Provider } from '@lakutata/core';
 import { As } from '@lakutata/utils';
+import { connectionOptionsOf } from '../lib/ConnectionOptions.js';
 /**
  * Build the registration of a {@link Database} provider, for the `providers` of the application options: the provider
  * class with its TypeORM connection options. Its `entities` option, added to the entities of the connection options,
  * is set by spreading the registration: `{...buildDatabaseOptions(options), entities: [User]}`.
  * @param options The TypeORM connection options (`DataSourceOptions`): the driver `type`, the connection settings, the
- * `entities`, the `migrations`, `synchronize`, `migrationsRun`, `logging`… Passed to TypeORM as they are.
+ * `entities`, the `migrations`, `synchronize`, `migrationsRun`, `logging`… Passed to TypeORM, with the null and
+ * undefined values of the where conditions ignored unless they set `invalidWhereValuesBehavior` (see {@link Database}).
  * @returns The registration `{class: Database, options}`.
  * @example
  * ```typescript
@@ -60,7 +62,9 @@ export const buildDatabaseOptions = (options) => ({
  * which created it. It suits a short use (a job, a script, a tenant database); the requests of a busy application
  * share the `Database` component instead. A connection failure rejects its creation with the driver error.
  *
- * The entities of its `entities` option are added to the entities of its connection options.
+ * The entities of its `entities` option are added to the entities of its connection options. Its where conditions leave
+ * out their properties whose value is `null` or `undefined`, as the ones of the `Database` component (TypeORM 1 throws
+ * on them by default), unless the options set `invalidWhereValuesBehavior`.
  * @example
  * ```typescript
  * import {Application} from 'lakutata'
@@ -131,8 +135,10 @@ let Database = class Database extends Provider {
         return this.datasource.manager;
     }
     /**
-     * Replace the naming strategy of the connection, which names the tables, the columns and the constraints of the
-     * entities. Set it before the metadata is used: the names already built are not renamed.
+     * Replace the naming strategy of the connection. The names of the tables, the columns and the constraints of the
+     * entities are built when it connects, with the `namingStrategy` of the connection options: they are not renamed,
+     * only the names built afterwards (the constraints a query runner creates unnamed) use this one. To name the
+     * entities, set the `namingStrategy` option.
      * @param instance The naming strategy.
      */
     set namingStrategy(instance) {
@@ -175,12 +181,13 @@ let Database = class Database extends Provider {
      * @protected
      */
     async init() {
-        const entities = this.entities ? this.entities : [];
+        //A MixedList is an array or an object of its items (as the migration commands of the application merge them)
+        const items = (list) => Array.isArray(list) ? list : Object.values(list ?? {});
         const options = {
             ...this.options,
-            entities: [...As(this.options.entities ? this.options.entities : []), ...As(entities)]
+            entities: As([...items(this.options.entities), ...items(this.entities)])
         };
-        this.#datasource = await (new DataSource(options)).initialize();
+        this.#datasource = await (new DataSource(connectionOptionsOf(options))).initialize();
     }
     /**
      * Disconnect from the database.

package/dist/esm/providers/migration/ExecuteMigration.js

@@ -9,9 +9,10 @@ var __metadata = (this && this.__metadata) || function (k, v) {
 };
 import { Provider, DTO, Application } from '@lakutata/core';
 import { Configurable, Transient } from '@lakutata/core/decorator/di';
-import { DataSource } from 'typeorm/data-source/DataSource.js';
-import { MigrationExecutor } from 'typeorm/migration/MigrationExecutor.js';
+import { DataSource } from '#typeorm/data-source/DataSource.js';
+import { MigrationExecutor } from '#typeorm/migration/MigrationExecutor.js';
 import ansi from 'ansis';
+import { connectionOptionsOf } from '../../lib/ConnectionOptions.js';
 /**
  * The executor of the migrations, giving the migrations of the options of the database
  */
@@ -25,8 +26,9 @@ class Executor extends MigrationExecutor {
 }
 /**
  * Run, revert or show the migrations of a database of the application, with its options (MIGRATION_RUN, MIGRATION_REVERT,
- * MIGRATION_SHOW): the database is connected without synchronizing its schema nor running its migrations, the action
- * done, then the application exits (with the code 1 when the action fails)
+ * MIGRATION_SHOW): the database is connected without synchronizing its schema nor running its migrations, then the
+ * action done. Each database has its provider, in the order of the run: a failure exits the application with the code
+ * 1 (the databases after it are not reached), the last one exits it with the code 0
  */
 let ExecuteMigration = class ExecuteMigration extends Provider {
     /**
@@ -48,7 +50,7 @@ let ExecuteMigration = class ExecuteMigration extends Provider {
      */
     async init() {
         const app = await this.getObject(Application);
-        const dataSource = new DataSource({ ...this.dataSource, synchronize: false, migrationsRun: false, dropSchema: false });
+        const dataSource = new DataSource(connectionOptionsOf({ ...this.dataSource, synchronize: false, migrationsRun: false, dropSchema: false }));
         let failed = false;
         try {
             await dataSource.initialize();
@@ -88,6 +90,8 @@ let ExecuteMigration = class ExecuteMigration extends Provider {
                 return;
             }
             case 'revert': {
+                //The migration reverted, read first (undoLastMigration does not tell it): the last by its id (the
+                //migrations of MongoDB have none: the order of their reading kept)
                 const [last] = (await executor.getExecutedMigrations()).sort((a, b) => (b.id ?? 0) - (a.id ?? 0));
                 if (!last)
                     return console.log(ansi.yellow `${this.prefix}No migration to revert`);

package/dist/esm/providers/migration/GenerateMigration.js

@@ -16,33 +16,47 @@ import { Provider, DTO, Application } from '@lakutata/core';
 import { Configurable, Transient } from '@lakutata/core/decorator/di';
 import path from 'path';
 import { readFileSync } from 'fs';
-import { DataSource } from 'typeorm/data-source/DataSource.js';
+import { DataSource } from '#typeorm/data-source/DataSource.js';
 import { format } from '@sqltools/formatter/lib/sqlFormatter.js';
-import { camelCase } from 'typeorm/util/StringUtils.js';
-import { PlatformTools } from 'typeorm/platform/PlatformTools.js';
-import { CommandUtils } from 'typeorm/commands/CommandUtils.js';
+import { camelCase } from '#typeorm/util/StringUtils.js';
+import { PlatformTools } from '#typeorm/platform/PlatformTools.js';
+import { CommandUtils } from '#typeorm/commands/CommandUtils.js';
 import ansi from 'ansis';
+import { connectionOptionsOf } from '../../lib/ConnectionOptions.js';
+/**
+ * Generate the migration of the changes of the schema of a database of the application (MIGRATION_GENERATE): its
+ * entities compared with the schema of the database, the queries of the changes written to a migration file of the
+ * directory path. Each database has its provider, in the order of the run; the last one exits the application (with
+ * the code 1 when no database had a change, or on a failure)
+ */
 let GenerateMigration = class GenerateMigration extends Provider {
     static { GenerateMigration_1 = this; }
+    /**
+     * The extension of the migration file
+     */
     get extension() {
         return this.outputJs ? '.js' : '.ts';
     }
+    /**
+     * The name of the migration file: the timestamp, then the name of the database, else the base name of the
+     * directory
+     */
     get filename() {
         return this.timestamp + '-' + (this.dataSourceName ? this.dataSourceName : path.basename(this.path)) + this.extension;
     }
     #app;
     #dataSource;
-    /**
-     * Initializer
-     * @protected
-     */
     /**
      * The migrations generated by the run (its databases share the process)
      */
     static { this.generated = 0; }
+    /**
+     * Initializer: the database connected without its synchronization nor its migrations, then the migration generated
+     * @protected
+     */
     async init() {
         this.#app = await this.getObject(Application);
-        this.#dataSource = new DataSource(this.dataSource);
+        this.#dataSource = new DataSource(connectionOptionsOf(this.dataSource));
         this.#dataSource.setOptions({
             synchronize: false,
             migrationsRun: false,
@@ -61,6 +75,11 @@ let GenerateMigration = class GenerateMigration extends Provider {
         if (this.#dataSource?.isInitialized)
             await this.#dataSource.destroy();
     }
+    /**
+     * Generate the migration: the queries of the changes of the schema (logged by the schema builder, not run) written
+     * to the migration file, printed (dryRun), or failing the check (check)
+     * @protected
+     */
     async handle() {
         try {
             const upSqls = [], downSqls = [];
@@ -244,7 +263,8 @@ ${downSqls.join(`
 `;
     }
     /**
-     *
+     * Format a query of the migration, indented for its template
+     * @param query
      */
     static prettifyQuery(query) {
         const formattedQuery = format(query, { indent: '    ' });

package/dist/esm/types/LegacyConnectionOptions.js

@@ -0,0 +1 @@
+export {};

package/dist/types/components/Database.d.ts

@@ -1,28 +1,29 @@
 import { Component, Provider } from '@lakutata/core';
-import { type DataSourceOptions } from 'typeorm/data-source/DataSourceOptions.js';
-import { DataSource } from 'typeorm/data-source/DataSource.js';
-import { Driver } from 'typeorm/driver/Driver.js';
-import { EntityManager } from 'typeorm/entity-manager/EntityManager.js';
-import { NamingStrategyInterface } from 'typeorm/naming-strategy/NamingStrategyInterface.js';
-import { EntitySubscriberInterface } from 'typeorm/subscriber/EntitySubscriberInterface.js';
-import { EntityMetadata } from 'typeorm/metadata/EntityMetadata.js';
-import { EntityTarget } from 'typeorm/common/EntityTarget.js';
-import { Migration } from 'typeorm/migration/Migration.js';
-import { ObjectLiteral } from 'typeorm/common/ObjectLiteral.js';
-import { TreeRepository } from 'typeorm/repository/TreeRepository.js';
-import { Repository } from 'typeorm/repository/Repository.js';
-import { MongoRepository } from 'typeorm/repository/MongoRepository.js';
-import { QueryRunner } from 'typeorm/query-runner/QueryRunner.js';
-import { SelectQueryBuilder } from 'typeorm/query-builder/SelectQueryBuilder.js';
-import { ReplicationMode } from 'typeorm/driver/types/ReplicationMode.js';
-import { QueryResultCache } from 'typeorm/cache/QueryResultCache.js';
-import { IsolationLevel } from 'typeorm/driver/types/IsolationLevel.js';
+import { type DataSourceOptions } from '#typeorm/data-source/DataSourceOptions.js';
+import { DataSource } from '#typeorm/data-source/DataSource.js';
+import { Driver } from '#typeorm/driver/Driver.js';
+import { EntityManager } from '#typeorm/entity-manager/EntityManager.js';
+import { NamingStrategyInterface } from '#typeorm/naming-strategy/NamingStrategyInterface.js';
+import { EntitySubscriberInterface } from '#typeorm/subscriber/EntitySubscriberInterface.js';
+import { EntityMetadata } from '#typeorm/metadata/EntityMetadata.js';
+import { EntityTarget } from '#typeorm/common/EntityTarget.js';
+import { Migration } from '#typeorm/migration/Migration.js';
+import { ObjectLiteral } from '#typeorm/common/ObjectLiteral.js';
+import { TreeRepository } from '#typeorm/repository/TreeRepository.js';
+import { Repository } from '#typeorm/repository/Repository.js';
+import { MongoRepository } from '#typeorm/repository/MongoRepository.js';
+import { QueryRunner } from '#typeorm/query-runner/QueryRunner.js';
+import { SelectQueryBuilder } from '#typeorm/query-builder/SelectQueryBuilder.js';
+import { ReplicationMode } from '#typeorm/driver/types/ReplicationMode.js';
+import { QueryResultCache } from '#typeorm/cache/QueryResultCache.js';
+import { IsolationLevel } from '#typeorm/driver/types/IsolationLevel.js';
 import { type MigrationRunOptions } from '../types/MigrationRunOptions.js';
 /**
  * Build the registration of a {@link Database} component, for the `components` of the application options: the
  * component class with its TypeORM connection options.
  * @param options The TypeORM connection options (`DataSourceOptions`): the driver `type`, the connection settings, the
- * `entities`, the `migrations`, `synchronize`, `migrationsRun`, `logging`… Passed to TypeORM as they are.
+ * `entities`, the `migrations`, `synchronize`, `migrationsRun`, `logging`… Passed to TypeORM, with the null and
+ * undefined values of the where conditions ignored unless they set `invalidWhereValuesBehavior` (see {@link Database}).
  * @returns The registration `{class: Database, options}`.
  * @example
  * ```typescript
@@ -72,6 +73,11 @@ export declare const buildDatabaseOptions: (options: DataSourceOptions) => {
  * with the driver error. TypeORM applies `synchronize` and `migrationsRun` of the options while connecting. It
  * disconnects when the application stops.
  *
+ * The where conditions leave out their properties whose value is `null` or `undefined`, as TypeORM 0.3 did (TypeORM 1
+ * throws on them by default): `findOneBy({id: undefined})` finds the first row, check the values taken from the
+ * requests. The `invalidWhereValuesBehavior` of the options changes it, each key given replacing its default
+ * (`{undefined: 'throw'}` throws on the undefined values).
+ *
  * An application may register several of them (one per database), each under its own name. Their names are the ones
  * the migration commands of the application (`MIGRATION_GENERATE`, `MIGRATION_RUN`…) select with `MIGRATION_DATABASE`.
  * @example
@@ -135,7 +141,8 @@ export declare class Database extends Component {
     static migrationExecutor: () => Promise<typeof Provider>;
     /**
      * The TypeORM connection options, given by the registration (see {@link buildDatabaseOptions}). Not validated by
-     * lakutata: TypeORM checks them while connecting.
+     * lakutata: TypeORM checks them while connecting. Their `invalidWhereValuesBehavior` defaults to
+     * `{null: 'ignore', undefined: 'ignore'}`, each key given replacing its default.
      */
     protected readonly options: DataSourceOptions;
     /**
@@ -152,8 +159,10 @@ export declare class Database extends Component {
      */
     get manager(): EntityManager;
     /**
-     * Replace the naming strategy of the connection, which names the tables, the columns and the constraints of the
-     * entities. Set it before the metadata is used: the names already built are not renamed.
+     * Replace the naming strategy of the connection. The names of the tables, the columns and the constraints of the
+     * entities are built when it connects, with the `namingStrategy` of the connection options: they are not renamed,
+     * only the names built afterwards (the constraints a query runner creates unnamed) use this one. To name the
+     * entities, set the `namingStrategy` option.
      * @param instance The naming strategy.
      */
     set namingStrategy(instance: NamingStrategyInterface);

package/dist/types/decorators/orm/AfterInsert.d.ts

@@ -1 +1 @@
-export { AfterInsert } from 'typeorm/decorator/listeners/AfterInsert.js';
+export { AfterInsert } from '#typeorm/decorator/listeners/AfterInsert.js';

package/dist/types/decorators/orm/AfterLoad.d.ts

@@ -1 +1 @@
-export { AfterLoad } from 'typeorm/decorator/listeners/AfterLoad.js';
+export { AfterLoad } from '#typeorm/decorator/listeners/AfterLoad.js';

package/dist/types/decorators/orm/AfterRecover.d.ts

@@ -1 +1 @@
-export { AfterRecover } from 'typeorm/decorator/listeners/AfterRecover.js';
+export { AfterRecover } from '#typeorm/decorator/listeners/AfterRecover.js';

package/dist/types/decorators/orm/AfterRemove.d.ts

@@ -1 +1 @@
-export { AfterRemove } from 'typeorm/decorator/listeners/AfterRemove.js';
+export { AfterRemove } from '#typeorm/decorator/listeners/AfterRemove.js';

package/dist/types/decorators/orm/AfterSoftRemove.d.ts

@@ -1 +1 @@
-export { AfterSoftRemove } from 'typeorm/decorator/listeners/AfterSoftRemove.js';
+export { AfterSoftRemove } from '#typeorm/decorator/listeners/AfterSoftRemove.js';

package/dist/types/decorators/orm/AfterUpdate.d.ts

@@ -1 +1 @@
-export { AfterUpdate } from 'typeorm/decorator/listeners/AfterUpdate.js';
+export { AfterUpdate } from '#typeorm/decorator/listeners/AfterUpdate.js';

package/dist/types/decorators/orm/BeforeInsert.d.ts

@@ -1 +1 @@
-export { BeforeInsert } from 'typeorm/decorator/listeners/BeforeInsert.js';
+export { BeforeInsert } from '#typeorm/decorator/listeners/BeforeInsert.js';

package/dist/types/decorators/orm/BeforeRecover.d.ts

@@ -1 +1 @@
-export { BeforeRecover } from 'typeorm/decorator/listeners/BeforeRecover.js';
+export { BeforeRecover } from '#typeorm/decorator/listeners/BeforeRecover.js';

package/dist/types/decorators/orm/BeforeRemove.d.ts

@@ -1 +1 @@
-export { BeforeRemove } from 'typeorm/decorator/listeners/BeforeRemove.js';
+export { BeforeRemove } from '#typeorm/decorator/listeners/BeforeRemove.js';

package/dist/types/decorators/orm/BeforeSoftRemove.d.ts

@@ -1 +1 @@
-export { BeforeSoftRemove } from 'typeorm/decorator/listeners/BeforeSoftRemove.js';
+export { BeforeSoftRemove } from '#typeorm/decorator/listeners/BeforeSoftRemove.js';

package/dist/types/decorators/orm/BeforeUpdate.d.ts

@@ -1 +1 @@
-export { BeforeUpdate } from 'typeorm/decorator/listeners/BeforeUpdate.js';
+export { BeforeUpdate } from '#typeorm/decorator/listeners/BeforeUpdate.js';

package/dist/types/decorators/orm/Check.d.ts

@@ -1 +1 @@
-export { Check } from 'typeorm/decorator/Check.js';
+export { Check } from '#typeorm/decorator/Check.js';

package/dist/types/decorators/orm/ChildEntity.d.ts

@@ -1 +1 @@
-export { ChildEntity } from 'typeorm/decorator/entity/ChildEntity.js';
+export { ChildEntity } from '#typeorm/decorator/entity/ChildEntity.js';

package/dist/types/decorators/orm/Column.d.ts

@@ -1 +1 @@
-export { Column } from 'typeorm/decorator/columns/Column.js';
+export { Column } from '#typeorm/decorator/columns/Column.js';

package/dist/types/decorators/orm/CreateDateColumn.d.ts

@@ -1 +1 @@
-export { CreateDateColumn } from 'typeorm/decorator/columns/CreateDateColumn.js';
+export { CreateDateColumn } from '#typeorm/decorator/columns/CreateDateColumn.js';

package/dist/types/decorators/orm/DeleteDateColumn.d.ts

@@ -1 +1 @@
-export { DeleteDateColumn } from 'typeorm/decorator/columns/DeleteDateColumn.js';
+export { DeleteDateColumn } from '#typeorm/decorator/columns/DeleteDateColumn.js';

package/dist/types/decorators/orm/Entity.d.ts

@@ -1 +1 @@
-export { Entity } from 'typeorm/decorator/entity/Entity.js';
+export { Entity } from '#typeorm/decorator/entity/Entity.js';