@mikro-orm/core 7.1.0-dev.2 → 7.1.0-dev.3

package/EntityManager.d.ts

@@ -307,6 +307,25 @@ export declare class EntityManager<Driver extends IDatabaseDriver = IDatabaseDri
      * Fires native insert query. Calling this has no side effects on the context (identity map).
      */
     insert<Entity extends object>(entityNameOrEntity: EntityName<Entity> | Entity, data?: RequiredEntityData<Entity> | Entity, options?: NativeInsertUpdateOptions<Entity>): Promise<Primary<Entity>>;
+    /**
+     * Clones rows matching the condition at the database level via INSERT...SELECT.
+     * Automatically excludes auto-increment PKs, generated columns, and resets version properties.
+     * Returns the cloned entity, registered in the identity map.
+     *
+     * @example
+     * ```ts
+     * // Clone by entity class + where + overrides
+     * const cloned = await em.clone(Author, { id: 1 }, { email: 'new@email.com' });
+     *
+     * // Pure clone (all non-PK fields copied)
+     * const cloned = await em.clone(Author, { id: 1 });
+     *
+     * // Clone a loaded entity
+     * const author = await em.findOneOrFail(Author, 1);
+     * const cloned = await em.clone(author, { email: 'new@email.com' });
+     * ```
+     */
+    clone<Entity extends object>(entityNameOrEntity: EntityName<Entity> | Entity, whereOrOverrides?: FilterQuery<NoInfer<Entity>> | EntityData<Entity>, overridesOrOptions?: EntityData<Entity> | NativeInsertUpdateOptions<Entity>, options?: NativeInsertUpdateOptions<Entity>): Promise<Entity>;
     /**
      * Fires native multi-insert query. Calling this has no side effects on the context (identity map).
      */

package/EntityManager.js

@@ -1211,6 +1211,54 @@ export class EntityManager {
         });
         return res.insertId;
     }
+    /**
+     * Clones rows matching the condition at the database level via INSERT...SELECT.
+     * Automatically excludes auto-increment PKs, generated columns, and resets version properties.
+     * Returns the cloned entity, registered in the identity map.
+     *
+     * @example
+     * ```ts
+     * // Clone by entity class + where + overrides
+     * const cloned = await em.clone(Author, { id: 1 }, { email: 'new@email.com' });
+     *
+     * // Pure clone (all non-PK fields copied)
+     * const cloned = await em.clone(Author, { id: 1 });
+     *
+     * // Clone a loaded entity
+     * const author = await em.findOneOrFail(Author, 1);
+     * const cloned = await em.clone(author, { email: 'new@email.com' });
+     * ```
+     */
+    async clone(entityNameOrEntity, whereOrOverrides, overridesOrOptions, options) {
+        const em = this.getContext(false);
+        let entityName;
+        let where;
+        let overrides;
+        if (Utils.isEntity(entityNameOrEntity)) {
+            // clone(entity, overrides?, options?)
+            entityName = entityNameOrEntity.constructor;
+            where = helper(entityNameOrEntity).getPrimaryKey();
+            overrides = whereOrOverrides;
+            options = overridesOrOptions;
+        }
+        else {
+            // clone(EntityClass, where, overrides?, options?)
+            entityName = entityNameOrEntity;
+            where = whereOrOverrides;
+            overrides = overridesOrOptions;
+        }
+        options ??= {};
+        em.prepareOptions(options);
+        const meta = em.metadata.get(entityName);
+        const res = await em.driver.nativeClone(entityName, where, overrides, {
+            ctx: em.#transactionContext,
+            ...options,
+        });
+        const pk = res.insertId ?? res.row?.[meta.primaryKeys[0]];
+        return em.findOneOrFail(entityName, pk, {
+            schema: options.schema,
+        });
+    }
     /**
      * Fires native multi-insert query. Calling this has no side effects on the context (identity map).
      */

package/drivers/DatabaseDriver.d.ts

@@ -28,6 +28,7 @@ export declare abstract class DatabaseDriver<C extends Connection> implements ID
     abstract nativeUpdate<T extends object>(entityName: EntityName<T>, where: FilterQuery<T>, data: EntityDictionary<T>, options?: NativeInsertUpdateOptions<T>): Promise<QueryResult<T>>;
     nativeUpdateMany<T extends object>(entityName: EntityName<T>, where: FilterQuery<T>[], data: EntityDictionary<T>[], options?: NativeInsertUpdateManyOptions<T>): Promise<QueryResult<T>>;
     abstract nativeDelete<T extends object>(entityName: EntityName<T>, where: FilterQuery<T>, options?: DeleteOptions<T>): Promise<QueryResult<T>>;
+    nativeClone<T extends object>(entityName: EntityName<T>, where: FilterQuery<T>, overrides?: EntityData<T>, options?: NativeInsertUpdateOptions<T>): Promise<QueryResult<T>>;
     abstract count<T extends object, P extends string = never>(entityName: EntityName<T>, where: FilterQuery<T>, options?: CountOptions<T, P>): Promise<number>;
     /** Creates a new EntityManager instance bound to this driver. */
     createEntityManager(useContext?: boolean): this[typeof EntityManagerType];

package/drivers/DatabaseDriver.js

@@ -27,6 +27,9 @@ export class DatabaseDriver {
     async nativeUpdateMany(entityName, where, data, options) {
         throw new Error(`Batch updates are not supported by ${this.constructor.name} driver`);
     }
+    async nativeClone(entityName, where, overrides, options) {
+        throw new Error(`${this.constructor.name} does not support nativeClone`);
+    }
     /** Creates a new EntityManager instance bound to this driver. */
     createEntityManager(useContext) {
         const EntityManagerClass = this.config.get('entityManager', EntityManager);

package/drivers/IDatabaseDriver.d.ts

@@ -52,6 +52,11 @@ export interface IDatabaseDriver<C extends Connection = Connection> {
     nativeUpdateMany<T extends object>(entityName: EntityName<T>, where: FilterQuery<T>[], data: EntityDictionary<T>[], options?: NativeInsertUpdateManyOptions<T>): Promise<QueryResult<T>>;
     /** Deletes rows matching the given condition. */
     nativeDelete<T extends object>(entityName: EntityName<T>, where: FilterQuery<T>, options?: NativeDeleteOptions<T>): Promise<QueryResult<T>>;
+    /**
+     * Clones rows matching the condition at the database level via INSERT...SELECT.
+     * Automatically excludes auto-increment PKs, generated columns, and resets version properties.
+     */
+    nativeClone<T extends object>(entityName: EntityName<T>, where: FilterQuery<T>, overrides?: EntityData<T>, options?: NativeInsertUpdateOptions<T>): Promise<QueryResult<T>>;
     /** Persists changes to M:N collections (inserts/deletes pivot table rows). */
     syncCollections<T extends object, O extends object>(collections: Iterable<Collection<T, O>>, options?: DriverMethodOptions): Promise<void>;
     /** Counts entities matching the given condition. */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mikro-orm/core",
-  "version": "7.1.0-dev.2",
+  "version": "7.1.0-dev.3",
   "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.",
   "keywords": [
     "data-mapper",

package/utils/Utils.js

@@ -141,7 +141,7 @@ export function parseJsonSafe(value) {
 /** Collection of general-purpose utility methods used throughout the ORM. */
 export class Utils {
     static PK_SEPARATOR = '~~~';
-    static #ORM_VERSION = '7.1.0-dev.2';
+    static #ORM_VERSION = '7.1.0-dev.3';
     /**
      * Checks if the argument is instance of `Object`. Returns false for arrays.
      */