@mikro-orm/core 7.0.0-dev.167 → 7.0.0-dev.168

package/metadata/MetadataDiscovery.js

@@ -454,6 +454,16 @@ export class MetadataDiscovery {
         if (!prop.referencedColumnNames) {
             prop.referencedColumnNames = fieldNames;
         }
+        // Relations to composite PK targets need cascade update by default,
+        // since composite PKs are more likely to have mutable components
+        if (meta2.compositePK) {
+            prop.updateRule ??= 'cascade';
+        }
+        // Nullable relations default to 'set null' on delete - when the referenced
+        // entity is deleted, set the FK to null rather than failing
+        if (prop.nullable) {
+            prop.deleteRule ??= 'set null';
+        }
     }
     initOneToManyFields(prop) {
         const meta2 = prop.targetMeta;
@@ -469,9 +479,14 @@ export class MetadataDiscovery {
         const pks = Object.values(meta.properties).filter(prop => prop.primary);
         meta.primaryKeys = pks.map(prop => prop.name);
         meta.compositePK = pks.length > 1;
-        // FK used as PK, we need to cascade
-        if (pks.length === 1 && pks[0].kind !== ReferenceKind.SCALAR) {
-            pks[0].deleteRule ??= 'cascade';
+        // FK used as PK, we need to cascade - applies to both single FK-as-PK
+        // and composite PKs where all PKs are FKs (e.g., pivot-like entities)
+        const fkPks = pks.filter(pk => pk.kind !== ReferenceKind.SCALAR);
+        if (fkPks.length > 0 && fkPks.length === pks.length) {
+            for (const pk of fkPks) {
+                pk.deleteRule ??= 'cascade';
+                pk.updateRule ??= 'cascade';
+            }
         }
         meta.forceConstructor ??= this.shouldForceConstructorUsage(meta);
         this.validator.validateEntityDefinition(this.metadata, meta.class, this.config.get('discovery'));
@@ -655,10 +670,9 @@ export class MetadataDiscovery {
             deleteRule: prop.deleteRule,
             createForeignKeyConstraint: prop.createForeignKeyConstraint,
         };
-        if (selfReferencing && !this.platform.supportsMultipleCascadePaths()) {
-            ret.updateRule ??= 'no action';
-            ret.deleteRule ??= 'no action';
-        }
+        const defaultRule = selfReferencing && !this.platform.supportsMultipleCascadePaths() ? 'no action' : 'cascade';
+        ret.updateRule ??= defaultRule;
+        ret.deleteRule ??= defaultRule;
         const meta = this.metadata.get(type);
         ret.targetMeta = meta;
         ret.joinColumns = [];

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@mikro-orm/core",
   "type": "module",
-  "version": "7.0.0-dev.167",
+  "version": "7.0.0-dev.168",
   "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.",
   "exports": {
     "./package.json": "./package.json",

package/utils/Configuration.d.ts

@@ -844,6 +844,16 @@ export interface Options<Driver extends IDatabaseDriver = IDatabaseDriver, EM ex
          * Database name to use for management operations (e.g., creating/dropping databases).
          */
         managementDbName?: string;
+        /**
+         * Default ON UPDATE rule for foreign keys.
+         * When not set, no rule is emitted and the database uses its native default (NO ACTION/RESTRICT).
+         */
+        defaultUpdateRule?: 'cascade' | 'no action' | 'set null' | 'set default' | 'restrict';
+        /**
+         * Default ON DELETE rule for foreign keys.
+         * When not set, no rule is emitted and the database uses its native default (NO ACTION/RESTRICT).
+         */
+        defaultDeleteRule?: 'cascade' | 'no action' | 'set null' | 'set default' | 'restrict';
     };
     /**
      * Embeddable entity configuration options.

package/utils/Utils.js

@@ -123,7 +123,7 @@ export function parseJsonSafe(value) {
 }
 export class Utils {
     static PK_SEPARATOR = '~~~';
-    static #ORM_VERSION = '7.0.0-dev.167';
+    static #ORM_VERSION = '7.0.0-dev.168';
     /**
      * Checks if the argument is instance of `Object`. Returns false for arrays.
      */