@mikro-orm/core 7.0.0-dev.1 → 7.0.0-dev.100

package/naming-strategy/index.d.ts

@@ -1,5 +1,5 @@
-export * from './NamingStrategy';
-export * from './AbstractNamingStrategy';
-export * from './MongoNamingStrategy';
-export * from './UnderscoreNamingStrategy';
-export * from './EntityCaseNamingStrategy';
+export * from './NamingStrategy.js';
+export * from './AbstractNamingStrategy.js';
+export * from './MongoNamingStrategy.js';
+export * from './UnderscoreNamingStrategy.js';
+export * from './EntityCaseNamingStrategy.js';

package/naming-strategy/index.js

@@ -1,21 +1,5 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __exportStar = (this && this.__exportStar) || function(m, exports) {
-    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-__exportStar(require("./NamingStrategy"), exports);
-__exportStar(require("./AbstractNamingStrategy"), exports);
-__exportStar(require("./MongoNamingStrategy"), exports);
-__exportStar(require("./UnderscoreNamingStrategy"), exports);
-__exportStar(require("./EntityCaseNamingStrategy"), exports);
+export * from './NamingStrategy.js';
+export * from './AbstractNamingStrategy.js';
+export * from './MongoNamingStrategy.js';
+export * from './UnderscoreNamingStrategy.js';
+export * from './EntityCaseNamingStrategy.js';

package/not-supported.d.ts

@@ -0,0 +1,2 @@
+export declare function discoverEntities(): void;
+export declare const fs: {};

package/not-supported.js

@@ -0,0 +1,4 @@
+export function discoverEntities() {
+    throw new Error('Folder-based discovery is not supported in this environment.');
+}
+export const fs = new Proxy({}, { get: () => { throw new Error('File system is not supported in this environment.'); } });

package/package.json

@@ -1,18 +1,18 @@
 {
   "name": "@mikro-orm/core",
-  "version": "7.0.0-dev.1",
+  "type": "module",
+  "version": "7.0.0-dev.100",
   "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",
-  "typings": "index.d.ts",
   "exports": {
     "./package.json": "./package.json",
-    ".": {
-      "import": {
-        "types": "./index.d.ts",
-        "default": "./index.mjs"
-      },
-      "require": "./index.js"
+    ".": "./index.js",
+    "./file-discovery": {
+      "node": "./metadata/discover-entities.js",
+      "browser": "./not-supported.js"
+    },
+    "./fs-utils": {
+      "node": "./utils/fs-utils.js",
+      "browser": "./not-supported.js"
     }
   },
   "repository": {
@@ -47,10 +47,10 @@
   },
   "homepage": "https://mikro-orm.io",
   "engines": {
-    "node": ">= 22.11.0"
+    "node": ">= 22.17.0"
   },
   "scripts": {
-    "build": "yarn clean && yarn compile && yarn copy && yarn run -T gen-esm-wrapper index.js index.mjs",
+    "build": "yarn clean && yarn compile && yarn copy",
     "clean": "yarn run -T rimraf ./dist",
     "compile": "yarn run -T tsc -p tsconfig.build.json",
     "copy": "node ../../scripts/copy.mjs"
@@ -58,13 +58,12 @@
   "publishConfig": {
     "access": "public"
   },
-  "dependencies": {
-    "dataloader": "2.2.3",
-    "dotenv": "16.4.7",
-    "esprima": "4.0.1",
-    "fs-extra": "11.3.0",
-    "globby": "11.1.0",
-    "mikro-orm": "7.0.0-dev.1",
-    "reflect-metadata": "0.2.2"
+  "peerDependencies": {
+    "dataloader": "2.2.3"
+  },
+  "peerDependenciesMeta": {
+    "dataloader": {
+      "optional": true
+    }
   }
 }

package/platforms/ExceptionConverter.d.ts

@@ -1,5 +1,5 @@
-import type { Dictionary } from '../typings';
-import { DriverException } from '../exceptions';
+import type { Dictionary } from '../typings.js';
+import { DriverException } from '../exceptions.js';
 export declare class ExceptionConverter {
     convertException(exception: Error & Dictionary): DriverException;
 }

package/platforms/ExceptionConverter.js

@@ -1,11 +1,7 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.ExceptionConverter = void 0;
-const exceptions_1 = require("../exceptions");
-class ExceptionConverter {
-    /* istanbul ignore next */
+import { DriverException } from '../exceptions.js';
+export class ExceptionConverter {
+    /* v8 ignore next */
     convertException(exception) {
-        return new exceptions_1.DriverException(exception);
+        return new DriverException(exception);
     }
 }
-exports.ExceptionConverter = ExceptionConverter;

package/platforms/Platform.d.ts

@@ -1,14 +1,13 @@
-import { inspect } from 'node:util';
-import { EntityRepository } from '../entity';
-import { type NamingStrategy } from '../naming-strategy';
-import type { Constructor, EntityProperty, IPrimaryKey, ISchemaGenerator, PopulateOptions, Primary, EntityMetadata, SimpleColumnMeta } from '../typings';
-import { ExceptionConverter } from './ExceptionConverter';
-import type { EntityManager } from '../EntityManager';
-import type { Configuration } from '../utils/Configuration';
-import type { IDatabaseDriver } from '../drivers/IDatabaseDriver';
-import { Type } from '../types';
-import type { MikroORM } from '../MikroORM';
-import type { TransformContext } from '../types/Type';
+import { EntityRepository } from '../entity/EntityRepository.js';
+import { type NamingStrategy } from '../naming-strategy/NamingStrategy.js';
+import type { Constructor, EntityMetadata, EntityProperty, IPrimaryKey, ISchemaGenerator, PopulateOptions, Primary, SimpleColumnMeta } from '../typings.js';
+import { ExceptionConverter } from './ExceptionConverter.js';
+import type { EntityManager } from '../EntityManager.js';
+import type { Configuration } from '../utils/Configuration.js';
+import type { IDatabaseDriver } from '../drivers/IDatabaseDriver.js';
+import { Type } from '../types/index.js';
+import type { MikroORM } from '../MikroORM.js';
+import type { TransformContext } from '../types/Type.js';
 export declare const JsonProperty: unique symbol;
 export declare abstract class Platform {
     protected readonly exceptionConverter: ExceptionConverter;
@@ -30,7 +29,6 @@ export declare abstract class Platform {
     usesEnumCheckConstraints(): boolean;
     getSchemaHelper(): unknown;
     indexForeignKeys(): boolean;
-    allowsMultiInsert(): boolean;
     /**
      * Whether or not the driver supports retuning list of created PKs back when multi-inserting
      */
@@ -48,11 +46,6 @@ export declare abstract class Platform {
      * Converts scalar primary key representation to native driver wrapper (e.g. string to mongodb's ObjectId)
      */
     denormalizePrimaryKey(data: IPrimaryKey): IPrimaryKey;
-    /**
-     * Used when serializing via toObject and toJSON methods, allows to use different PK field name (like `id` instead of `_id`)
-     */
-    getSerializedPrimaryKeyField(field: string): string;
-    usesDifferentSerializedPrimaryKey(): boolean;
     /**
      * Returns the SQL specific for the platform to get the current timestamp
      */
@@ -158,7 +151,7 @@ export declare abstract class Platform {
     getFullTextIndexExpression(indexName: string, schemaName: string | undefined, tableName: string, columns: SimpleColumnMeta[]): string;
     convertsJsonAutomatically(): boolean;
     convertJsonToDatabaseValue(value: unknown, context?: TransformContext): unknown;
-    convertJsonToJSValue(value: unknown, prop: EntityProperty): unknown;
+    convertJsonToJSValue(value: unknown, context?: TransformContext): unknown;
     convertDateToJSValue(value: string | Date): string;
     convertIntervalToJSValue(value: string): unknown;
     convertIntervalToDatabaseValue(value: unknown): unknown;
@@ -175,7 +168,9 @@ export declare abstract class Platform {
     getExtension<T>(extensionName: string, extensionKey: string, moduleName: string, em: EntityManager): T;
     getSchemaGenerator(driver: IDatabaseDriver, em?: EntityManager): ISchemaGenerator;
     processDateProperty(value: unknown): string | number | Date;
-    quoteIdentifier(id: string, quote?: string): string;
+    quoteIdentifier(id: string | {
+        toString: () => string;
+    }, quote?: string): string;
     quoteValue(value: any): string;
     escape(value: any): string;
     formatQuery(sql: string, params: readonly any[]): string;
@@ -193,7 +188,7 @@ export declare abstract class Platform {
     getDefaultPrimaryName(tableName: string, columns: string[]): string;
     supportsCustomPrimaryKeyNames(): boolean;
     isPopulated<T>(key: string, populate: readonly PopulateOptions<T>[] | boolean): boolean;
-    shouldHaveColumn<T>(prop: EntityProperty<T>, populate: readonly PopulateOptions<T>[] | boolean, exclude?: string[], includeFormulas?: boolean): boolean;
+    shouldHaveColumn<T>(prop: EntityProperty<T>, populate: readonly PopulateOptions<T>[] | boolean, exclude?: string[], includeFormulas?: boolean, ignoreInlineEmbeddables?: boolean): boolean;
     /**
      * Currently not supported due to how knex does complex sqlite diffing (always based on current schema)
      */
@@ -225,6 +220,4 @@ export declare abstract class Platform {
      * @internal
      */
     clone(): this;
-    /** @ignore */
-    [inspect.custom](): string;
 }

package/platforms/Platform.js

@@ -1,18 +1,14 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.Platform = exports.JsonProperty = void 0;
-const node_util_1 = require("node:util");
-const clone_1 = require("../utils/clone");
-const entity_1 = require("../entity");
-const naming_strategy_1 = require("../naming-strategy");
-const ExceptionConverter_1 = require("./ExceptionConverter");
-const types_1 = require("../types");
-const Utils_1 = require("../utils/Utils");
-const enums_1 = require("../enums");
-const RawQueryFragment_1 = require("../utils/RawQueryFragment");
-exports.JsonProperty = Symbol('JsonProperty');
-class Platform {
-    exceptionConverter = new ExceptionConverter_1.ExceptionConverter();
+import { clone } from '../utils/clone.js';
+import { EntityRepository } from '../entity/EntityRepository.js';
+import { UnderscoreNamingStrategy } from '../naming-strategy/UnderscoreNamingStrategy.js';
+import { ExceptionConverter } from './ExceptionConverter.js';
+import { ArrayType, BigIntType, BlobType, BooleanType, CharacterType, DateTimeType, DateType, DecimalType, DoubleType, EnumType, FloatType, IntegerType, IntervalType, JsonType, MediumIntType, SmallIntType, StringType, TextType, TimeType, TinyIntType, Type, Uint8ArrayType, UnknownType, UuidType, } from '../types/index.js';
+import { parseJsonSafe } from '../utils/Utils.js';
+import { ReferenceKind } from '../enums.js';
+import { RawQueryFragment } from '../utils/RawQueryFragment.js';
+export const JsonProperty = Symbol('JsonProperty');
+export class Platform {
+    exceptionConverter = new ExceptionConverter();
     config;
     namingStrategy;
     timezone;
@@ -26,7 +22,7 @@ class Platform {
         return true;
     }
     getNamingStrategy() {
-        return naming_strategy_1.UnderscoreNamingStrategy;
+        return UnderscoreNamingStrategy;
     }
     usesReturningStatement() {
         return false;
@@ -51,9 +47,6 @@ class Platform {
     indexForeignKeys() {
         return false;
     }
-    allowsMultiInsert() {
-        return true;
-    }
     /**
      * Whether or not the driver supports retuning list of created PKs back when multi-inserting
      */
@@ -81,15 +74,6 @@ class Platform {
     denormalizePrimaryKey(data) {
         return data;
     }
-    /**
-     * Used when serializing via toObject and toJSON methods, allows to use different PK field name (like `id` instead of `_id`)
-     */
-    getSerializedPrimaryKeyField(field) {
-        return field;
-    }
-    usesDifferentSerializedPrimaryKey() {
-        return false;
-    }
     /**
      * Returns the SQL specific for the platform to get the current timestamp
      */
@@ -136,7 +120,7 @@ class Platform {
         return true;
     }
     isBigIntProperty(prop) {
-        return prop.columnTypes && prop.columnTypes[0] === 'bigint';
+        return prop.columnTypes?.[0] === 'bigint';
     }
     getDefaultSchemaName() {
         return undefined;
@@ -172,7 +156,7 @@ class Platform {
         return `text`;
     }
     getEnumTypeDeclarationSQL(column) {
-        if (column.items?.every(item => Utils_1.Utils.isString(item))) {
+        if (column.items?.every(item => typeof item === 'string')) {
             return `enum('${column.items.join("','")}')`;
         }
         return this.getTinyIntTypeDeclarationSQL(column);
@@ -207,39 +191,39 @@ class Platform {
     }
     getDefaultMappedType(type) {
         if (type.endsWith('[]')) {
-            return types_1.Type.getType(types_1.ArrayType);
+            return Type.getType(ArrayType);
         }
         switch (this.extractSimpleType(type)) {
             case 'character':
-            case 'char': return types_1.Type.getType(types_1.CharacterType);
+            case 'char': return Type.getType(CharacterType);
             case 'string':
-            case 'varchar': return types_1.Type.getType(types_1.StringType);
-            case 'interval': return types_1.Type.getType(types_1.IntervalType);
-            case 'text': return types_1.Type.getType(types_1.TextType);
+            case 'varchar': return Type.getType(StringType);
+            case 'interval': return Type.getType(IntervalType);
+            case 'text': return Type.getType(TextType);
             case 'int':
-            case 'number': return types_1.Type.getType(types_1.IntegerType);
-            case 'bigint': return types_1.Type.getType(types_1.BigIntType);
-            case 'smallint': return types_1.Type.getType(types_1.SmallIntType);
-            case 'tinyint': return types_1.Type.getType(types_1.TinyIntType);
-            case 'mediumint': return types_1.Type.getType(types_1.MediumIntType);
-            case 'float': return types_1.Type.getType(types_1.FloatType);
-            case 'double': return types_1.Type.getType(types_1.DoubleType);
-            case 'integer': return types_1.Type.getType(types_1.IntegerType);
+            case 'number': return Type.getType(IntegerType);
+            case 'bigint': return Type.getType(BigIntType);
+            case 'smallint': return Type.getType(SmallIntType);
+            case 'tinyint': return Type.getType(TinyIntType);
+            case 'mediumint': return Type.getType(MediumIntType);
+            case 'float': return Type.getType(FloatType);
+            case 'double': return Type.getType(DoubleType);
+            case 'integer': return Type.getType(IntegerType);
             case 'decimal':
-            case 'numeric': return types_1.Type.getType(types_1.DecimalType);
-            case 'boolean': return types_1.Type.getType(types_1.BooleanType);
+            case 'numeric': return Type.getType(DecimalType);
+            case 'boolean': return Type.getType(BooleanType);
             case 'blob':
-            case 'buffer': return types_1.Type.getType(types_1.BlobType);
-            case 'uint8array': return types_1.Type.getType(types_1.Uint8ArrayType);
-            case 'uuid': return types_1.Type.getType(types_1.UuidType);
-            case 'date': return types_1.Type.getType(types_1.DateType);
+            case 'buffer': return Type.getType(BlobType);
+            case 'uint8array': return Type.getType(Uint8ArrayType);
+            case 'uuid': return Type.getType(UuidType);
+            case 'date': return Type.getType(DateType);
             case 'datetime':
-            case 'timestamp': return types_1.Type.getType(types_1.DateTimeType);
-            case 'time': return types_1.Type.getType(types_1.TimeType);
+            case 'timestamp': return Type.getType(DateTimeType);
+            case 'time': return Type.getType(TimeType);
             case 'object':
-            case 'json': return types_1.Type.getType(types_1.JsonType);
-            case 'enum': return types_1.Type.getType(types_1.EnumType);
-            default: return types_1.Type.getType(types_1.UnknownType);
+            case 'json': return Type.getType(JsonType);
+            case 'enum': return Type.getType(EnumType);
+            default: return Type.getType(UnknownType);
         }
     }
     supportsMultipleCascadePaths() {
@@ -272,7 +256,7 @@ class Platform {
     getSearchJsonPropertyKey(path, type, aliased, value) {
         return path.join('.');
     }
-    /* istanbul ignore next */
+    /* v8 ignore next */
     getJsonIndexDefinition(index) {
         return index.columnNames;
     }
@@ -291,12 +275,8 @@ class Platform {
     convertJsonToDatabaseValue(value, context) {
         return JSON.stringify(value);
     }
-    convertJsonToJSValue(value, prop) {
-        const isObjectEmbedded = prop.embedded && prop.object;
-        if ((this.convertsJsonAutomatically() || isObjectEmbedded) && ['json', 'jsonb', this.getJsonDeclarationSQL()].includes(prop.columnTypes[0])) {
-            return value;
-        }
-        return (0, Utils_1.parseJsonSafe)(value);
+    convertJsonToJSValue(value, context) {
+        return parseJsonSafe(value);
     }
     convertDateToJSValue(value) {
         return value;
@@ -309,14 +289,14 @@ class Platform {
     }
     parseDate(value) {
         const date = new Date(value);
-        /* istanbul ignore next */
+        /* v8 ignore next */
         if (isNaN(date.getTime())) {
             return value;
         }
         return date;
     }
     getRepositoryClass() {
-        return entity_1.EntityRepository;
+        return EntityRepository;
     }
     getDefaultCharset() {
         return 'utf8';
@@ -339,19 +319,10 @@ class Platform {
         if (extension) {
             return extension;
         }
-        /* istanbul ignore next */
-        const module = Utils_1.Utils.tryRequire({
-            module: moduleName,
-            warning: `Please install ${moduleName} package.`,
-        });
-        /* istanbul ignore next */
-        if (module) {
-            return this.config.getCachedService(module[extensionName], em);
-        }
-        /* istanbul ignore next */
-        throw new Error(`${extensionName} extension not registered.`);
+        /* v8 ignore next */
+        throw new Error(`${extensionName} extension not registered. Provide it in the ORM config, or use the async \`MikroORM.init()\` method to load extensions automatically.`);
     }
-    /* istanbul ignore next: kept for type inference only */
+    /* v8 ignore next: kept for type inference only */
     getSchemaGenerator(driver, em) {
         throw new Error(`${driver.constructor.name} does not support SchemaGenerator`);
     }
@@ -359,7 +330,7 @@ class Platform {
         return value;
     }
     quoteIdentifier(id, quote = '`') {
-        const raw = RawQueryFragment_1.RawQueryFragment.getKnownFragment(id);
+        const raw = RawQueryFragment.getKnownFragment(id);
         if (raw) {
             return this.formatQuery(raw.sql, raw.params);
         }
@@ -368,7 +339,7 @@ class Platform {
     quoteValue(value) {
         return value;
     }
-    /* istanbul ignore next */
+    /* v8 ignore next */
     escape(value) {
         return value;
     }
@@ -412,9 +383,9 @@ class Platform {
         return ret;
     }
     cloneEmbeddable(data) {
-        const copy = (0, clone_1.clone)(data);
+        const copy = clone(data);
         // tag the copy so we know it should be stringified when quoting (so we know how to treat JSON arrays)
-        Object.defineProperty(copy, exports.JsonProperty, { enumerable: false, value: true });
+        Object.defineProperty(copy, JsonProperty, { enumerable: false, value: true });
         return copy;
     }
     setConfig(config) {
@@ -438,7 +409,7 @@ class Platform {
         return numericMappedType || prop.type === 'number' || this.isBigIntProperty(prop);
     }
     isNumericColumn(mappedType) {
-        return [types_1.IntegerType, types_1.SmallIntType, types_1.BigIntType, types_1.TinyIntType].some(t => mappedType instanceof t);
+        return [IntegerType, SmallIntType, BigIntType, TinyIntType].some(t => mappedType instanceof t);
     }
     supportsUnsigned() {
         return false;
@@ -458,7 +429,7 @@ class Platform {
     isPopulated(key, populate) {
         return populate === true || (populate !== false && populate.some(p => p.field === key || p.all));
     }
-    shouldHaveColumn(prop, populate, exclude, includeFormulas = true) {
+    shouldHaveColumn(prop, populate, exclude, includeFormulas = true, ignoreInlineEmbeddables = true) {
         if (exclude?.includes(prop.name)) {
             return false;
         }
@@ -474,13 +445,13 @@ class Platform {
         if (prop.lazy && (populate === false || (populate !== true && !populate.some(p => p.field === prop.name)))) {
             return false;
         }
-        if ([enums_1.ReferenceKind.SCALAR, enums_1.ReferenceKind.MANY_TO_ONE].includes(prop.kind)) {
+        if ([ReferenceKind.SCALAR, ReferenceKind.MANY_TO_ONE].includes(prop.kind)) {
             return true;
         }
-        if (prop.kind === enums_1.ReferenceKind.EMBEDDED) {
-            return !!prop.object;
+        if (prop.kind === ReferenceKind.EMBEDDED) {
+            return prop.object || ignoreInlineEmbeddables;
         }
-        return prop.kind === enums_1.ReferenceKind.ONE_TO_ONE && prop.owner;
+        return prop.kind === ReferenceKind.ONE_TO_ONE && prop.owner;
     }
     /**
      * Currently not supported due to how knex does complex sqlite diffing (always based on current schema)
@@ -525,10 +496,9 @@ class Platform {
     clone() {
         return this;
     }
-    /* istanbul ignore next */
     /** @ignore */
-    [node_util_1.inspect.custom]() {
+    /* v8 ignore next */
+    [Symbol.for('nodejs.util.inspect.custom')]() {
         return `[${this.constructor.name}]`;
     }
 }
-exports.Platform = Platform;

package/platforms/index.d.ts

@@ -1,2 +1,2 @@
-export * from './Platform';
-export * from './ExceptionConverter';
+export * from './Platform.js';
+export * from './ExceptionConverter.js';

package/platforms/index.js

@@ -1,18 +1,2 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __exportStar = (this && this.__exportStar) || function(m, exports) {
-    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-__exportStar(require("./Platform"), exports);
-__exportStar(require("./ExceptionConverter"), exports);
+export * from './Platform.js';
+export * from './ExceptionConverter.js';

package/serialization/EntitySerializer.d.ts

@@ -1,5 +1,5 @@
-import type { ArrayElement, AutoPath, CleanTypeConfig, EntityDTO, FromEntityType, Loaded, TypeConfig, UnboxArray } from '../typings';
-import { type PopulatePath } from '../enums';
+import type { ArrayElement, AutoPath, CleanTypeConfig, EntityDTO, FromEntityType, Loaded, TypeConfig, UnboxArray } from '../typings.js';
+import { type PopulatePath } from '../enums.js';
 export declare class EntitySerializer {
     static serialize<T extends object, P extends string = never, E extends string = never>(entity: T, options?: SerializeOptions<T, P, E>): EntityDTO<Loaded<T, P>>;
     private static propertyName;
@@ -17,6 +17,8 @@ export interface SerializeOptions<T, P extends string = never, E extends string
     forceObject?: boolean;
     /** Ignore custom property serializers. */
     ignoreSerializers?: boolean;
+    /** Include properties marked as `hidden`. */
+    includeHidden?: boolean;
     /** Skip properties with `null` value. */
     skipNull?: boolean;
     /** Only include properties for a specific group. If a property does not specify any group, it will be included, otherwise only properties with a matching group are included. */