@mikro-orm/core 7.0.3-dev.16 → 7.0.3-dev.17

package/entity/defineEntity.d.ts

@@ -12,7 +12,7 @@ import type { Collection } from './Collection.js';
 import type { FilterOptions } from '../drivers/IDatabaseDriver.js';
 /** Union of all option keys supported across all property definition types (scalar, enum, embedded, relations). */
 export type UniversalPropertyKeys = keyof PropertyOptions<any> | keyof EnumOptions<any> | keyof EmbeddedOptions<any, any> | keyof ReferenceOptions<any, any> | keyof ManyToOneOptions<any, any> | keyof OneToManyOptions<any, any> | keyof OneToOneOptions<any, any> | keyof ManyToManyOptions<any, any>;
-type BuilderExtraKeys = '~options' | '~type' | '$type';
+type BuilderExtraKeys = '~options' | '~type' | '$type' | 'strictNullable';
 type ExcludeKeys = 'entity' | 'items';
 type BuilderKeys = Exclude<UniversalPropertyKeys, ExcludeKeys> | BuilderExtraKeys;
 type IncludeKeysForProperty = Exclude<keyof PropertyOptions<any>, ExcludeKeys> | BuilderExtraKeys;
@@ -32,6 +32,10 @@ export interface PropertyChain<Value, Options> {
     nullable(): PropertyChain<Value, Omit<Options, 'nullable'> & {
         nullable: true;
     }>;
+    strictNullable(): PropertyChain<Value, Omit<Options, 'nullable' | 'strictNullable'> & {
+        nullable: true;
+        strictNullable: true;
+    }>;
     ref(): PropertyChain<Value, Omit<Options, 'ref'> & {
         ref: true;
     }>;
@@ -281,6 +285,14 @@ export declare class UniversalPropertyOptionsBuilder<Value, Options, IncludeKeys
     nullable(): Pick<UniversalPropertyOptionsBuilder<Value, Omit<Options, 'nullable'> & {
         nullable: true;
     }, IncludeKeys>, IncludeKeys>;
+    /**
+     * Set column as nullable without adding `| undefined` to the type.
+     * Use this when the property is always explicitly set (e.g. in constructor) but can be `null`.
+     */
+    strictNullable(): Pick<UniversalPropertyOptionsBuilder<Value, Omit<Options, 'nullable' | 'strictNullable'> & {
+        nullable: true;
+        strictNullable: true;
+    }, IncludeKeys>, IncludeKeys>;
     /**
      * Set column as unsigned for {@link https://mikro-orm.io/docs/schema-generator Schema Generator}. (SQL only)
      */
@@ -673,7 +685,9 @@ type MaybeMapToPk<Value, Options> = Options extends {
 } ? Primary<Value> : Value;
 type MaybeNullable<Value, Options> = Options extends {
     nullable: true;
-} ? Value | null | undefined : Value;
+} ? Options extends {
+    strictNullable: true;
+} ? Value | null : Value | null | undefined : Value;
 type MaybeRelationRef<Value, Options> = Options extends {
     mapToPk: true;
 } ? Value : Options extends {

package/entity/defineEntity.js

@@ -145,6 +145,13 @@ export class UniversalPropertyOptionsBuilder {
     nullable() {
         return this.assignOptions({ nullable: true });
     }
+    /**
+     * Set column as nullable without adding `| undefined` to the type.
+     * Use this when the property is always explicitly set (e.g. in constructor) but can be `null`.
+     */
+    strictNullable() {
+        return this.assignOptions({ nullable: true });
+    }
     /**
      * Set column as unsigned for {@link https://mikro-orm.io/docs/schema-generator Schema Generator}. (SQL only)
      */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mikro-orm/core",
-  "version": "7.0.3-dev.16",
+  "version": "7.0.3-dev.17",
   "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

@@ -129,7 +129,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.0.3-dev.16';
+    static #ORM_VERSION = '7.0.3-dev.17';
     /**
      * Checks if the argument is instance of `Object`. Returns false for arrays.
      */