@mikro-orm/core 6.3.3 → 6.3.4-dev.1

package/EntityManager.d.ts

@@ -308,7 +308,7 @@ export declare class EntityManager<Driver extends IDatabaseDriver = IDatabaseDri
     merge<Entity extends object>(entityName: EntityName<Entity>, data: EntityData<Entity> | EntityDTO<Entity>, options?: MergeOptions): Entity;
     /**
      * Creates new instance of given entity and populates it with given data.
-     * The entity constructor will be used unless you provide `{ managed: true }` in the options parameter.
+     * The entity constructor will be used unless you provide `{ managed: true }` in the `options` parameter.
      * The constructor will be given parameters based on the defined constructor of the entity. If the constructor
      * parameter matches a property name, its value will be extracted from `data`. If no matching property exists,
      * the whole `data` parameter will be passed. This means we can also define `constructor(data: Partial<T>)` and
@@ -317,11 +317,14 @@ export declare class EntityManager<Driver extends IDatabaseDriver = IDatabaseDri
      * The parameters are strictly checked, you need to provide all required properties. You can use `OptionalProps`
      * symbol to omit some properties from this check without making them optional. Alternatively, use `partial: true`
      * in the options to disable the strict checks for required properties. This option has no effect on runtime.
+     *
+     * The newly created entity will be automatically marked for persistence via `em.persist` unless you disable this
+     * behavior, either locally via `persist: false` option, or globally via `persistOnCreate` ORM config option.
      */
     create<Entity extends object, Convert extends boolean = false>(entityName: EntityName<Entity>, data: RequiredEntityData<Entity, never, Convert>, options?: CreateOptions<Convert>): Entity;
     /**
      * Creates new instance of given entity and populates it with given data.
-     * The entity constructor will be used unless you provide `{ managed: true }` in the options parameter.
+     * The entity constructor will be used unless you provide `{ managed: true }` in the `options` parameter.
      * The constructor will be given parameters based on the defined constructor of the entity. If the constructor
      * parameter matches a property name, its value will be extracted from `data`. If no matching property exists,
      * the whole `data` parameter will be passed. This means we can also define `constructor(data: Partial<T>)` and
@@ -330,6 +333,9 @@ export declare class EntityManager<Driver extends IDatabaseDriver = IDatabaseDri
      * The parameters are strictly checked, you need to provide all required properties. You can use `OptionalProps`
      * symbol to omit some properties from this check without making them optional. Alternatively, use `partial: true`
      * in the options to disable the strict checks for required properties. This option has no effect on runtime.
+     *
+     * The newly created entity will be automatically marked for persistence via `em.persist` unless you disable this
+     * behavior, either locally via `persist: false` option, or globally via `persistOnCreate` ORM config option.
      */
     create<Entity extends object, Convert extends boolean = false>(entityName: EntityName<Entity>, data: EntityData<Entity, Convert>, options: CreateOptions<Convert> & {
         partial: true;

package/EntityManager.js

@@ -1158,15 +1158,18 @@ class EntityManager {
     }
     /**
      * Creates new instance of given entity and populates it with given data.
-     * The entity constructor will be used unless you provide `{ managed: true }` in the options parameter.
+     * The entity constructor will be used unless you provide `{ managed: true }` in the `options` parameter.
      * The constructor will be given parameters based on the defined constructor of the entity. If the constructor
      * parameter matches a property name, its value will be extracted from `data`. If no matching property exists,
      * the whole `data` parameter will be passed. This means we can also define `constructor(data: Partial<T>)` and
      * `em.create()` will pass the data into it (unless we have a property named `data` too).
      *
-     The parameters are strictly checked, you need to provide all required properties. You can use `OptionalProps`
-     symbol to omit some properties from this check without making them optional. Alternatively, use `partial: true`
-     in the options to disable the strict checks for required properties. This option has no effect on runtime.
+     * The parameters are strictly checked, you need to provide all required properties. You can use `OptionalProps`
+     * symbol to omit some properties from this check without making them optional. Alternatively, use `partial: true`
+     * in the options to disable the strict checks for required properties. This option has no effect on runtime.
+     *
+     * The newly created entity will be automatically marked for persistence via `em.persist` unless you disable this
+     * behavior, either locally via `persist: false` option, or globally via `persistOnCreate` ORM config option.
      */
     create(entityName, data, options = {}) {
         const em = this.getContext();

package/README.md

@@ -8,7 +8,7 @@ TypeScript ORM for Node.js based on Data Mapper, [Unit of Work](https://mikro-or
 
 [![NPM version](https://img.shields.io/npm/v/@mikro-orm/core.svg)](https://www.npmjs.com/package/@mikro-orm/core)
 [![NPM dev version](https://img.shields.io/npm/v/@mikro-orm/core/next.svg)](https://www.npmjs.com/package/@mikro-orm/core)
-[![Chat on discord](https://img.shields.io/badge/chat-on%20discord-blue.svg)](https://discord.gg/w8bjxFHS7X)
+[![Chat on discord](https://img.shields.io/discord/1214904142443839538?label=discord&color=blue)](https://discord.gg/w8bjxFHS7X)
 [![Downloads](https://img.shields.io/npm/dm/@mikro-orm/core.svg)](https://www.npmjs.com/package/@mikro-orm/core)
 [![Coverage Status](https://img.shields.io/coveralls/mikro-orm/mikro-orm.svg)](https://coveralls.io/r/mikro-orm/mikro-orm?branch=master)
 [![Maintainability](https://api.codeclimate.com/v1/badges/27999651d3adc47cfa40/maintainability)](https://codeclimate.com/github/mikro-orm/mikro-orm/maintainability)

package/entity/EntityRepository.d.ts

@@ -132,14 +132,15 @@ export declare class EntityRepository<Entity extends object> {
      */
     populate<Ent extends Entity | Entity[], Hint extends string = never, Naked extends FromEntityType<Entity> = FromEntityType<Entity>, Fields extends string = '*', Excludes extends string = never>(entities: Ent, populate: AutoPath<Naked, Hint, PopulatePath.ALL>[] | false, options?: EntityLoaderOptions<Naked, Fields, Excludes>): Promise<Ent extends object[] ? MergeLoaded<ArrayElement<Ent>, Naked, Hint, Fields, Excludes>[] : MergeLoaded<Ent, Naked, Hint, Fields, Excludes>>;
     /**
-     * Creates new instance of given entity and populates it with given data.
-     * The entity constructor will be used unless you provide `{ managed: true }` in the `options` parameter.
-     * The constructor will be given parameters based on the defined constructor of the entity. If the constructor
-     * parameter matches a property name, its value will be extracted from `data`. If no matching property exists,
-     * the whole `data` parameter will be passed. This means we can also define `constructor(data: Partial<Entity>)` and
-     * `em.create()` will pass the data into it (unless we have a property named `data` too).
+     * @inheritDoc EntityManager.create
      */
     create<Convert extends boolean = false>(data: RequiredEntityData<Entity, never, Convert>, options?: CreateOptions<Convert>): Entity;
+    /**
+     * @inheritDoc EntityManager.create
+     */
+    create<Convert extends boolean = false>(data: EntityData<Entity, Convert>, options: CreateOptions<Convert> & {
+        partial: true;
+    }): Entity;
     /**
      * Shortcut for `wrap(entity).assign(data, { em })`
      */

package/entity/EntityRepository.js

@@ -153,12 +153,7 @@ class EntityRepository {
         return this.getEntityManager().populate(entities, populate, options);
     }
     /**
-     * Creates new instance of given entity and populates it with given data.
-     * The entity constructor will be used unless you provide `{ managed: true }` in the `options` parameter.
-     * The constructor will be given parameters based on the defined constructor of the entity. If the constructor
-     * parameter matches a property name, its value will be extracted from `data`. If no matching property exists,
-     * the whole `data` parameter will be passed. This means we can also define `constructor(data: Partial<Entity>)` and
-     * `em.create()` will pass the data into it (unless we have a property named `data` too).
+     * @inheritDoc EntityManager.create
      */
     create(data, options) {
         return this.getEntityManager().create(this.entityName, data, options);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mikro-orm/core",
-  "version": "6.3.3",
+  "version": "6.3.4-dev.1",
   "description": "TypeScript ORM for Node.js based on Data Mapper, Unit of Work and Identity Map patterns. Supports MongoDB, MySQL, PostgreSQL and SQLite databases as well as usage with vanilla JavaScript.",
   "main": "index.js",
   "module": "index.mjs",
@@ -64,7 +64,7 @@
     "esprima": "4.0.1",
     "fs-extra": "11.2.0",
     "globby": "11.1.0",
-    "mikro-orm": "6.3.3",
+    "mikro-orm": "6.3.4-dev.1",
     "reflect-metadata": "0.2.2"
   }
 }