forge-sql-orm 1.0.29 → 1.0.31

package/README.md

@@ -5,21 +5,14 @@
 **Forge-SQL-ORM** is an ORM designed for working with [@forge/sql](https://developer.atlassian.com/platform/forge/storage-reference/sql-tutorial/) in **Atlassian Forge**. It is built on top of [MikroORM](https://mikro-orm.io/docs/query-builder) and provides advanced capabilities for working with relational databases inside Forge.
 
 ## Key Features
-
-- ✅ **Supports foreign keys** at the entity level.
 - ✅ **Supports complex SQL queries** with joins and filtering.
 - ✅ **Batch insert support** with duplicate key handling.
 - ✅ **Schema migration support**, allowing automatic schema evolution.
 - ✅ **Automatic entity generation** from MySQL/tidb databases.
 - ✅ **Automatic migration generation** from MySQL/tidb databases.
+- ✅ **Drop Migrations** Generate a migration to drop all tables and clear migrations history for subsequent schema recreation
 - ✅ **Optimistic Locking** Ensures data consistency by preventing conflicts when multiple users update the same record.
 
-🚀 **Development in Progress** 🚀
-I am currently working on implementing the following features:
-- 🗑️ **Soft Deletion Support** – Allows marking records as deleted without actually removing them from the database, enabling easy recovery.
-- 🏗️ **Complex Query Handling** _(JOIN, GROUP BY, etc.) without requiring an EntitySchema_ – Simplifies the execution of advanced SQL queries without the need to define additional schemas.
----
-
 ## Installation
 
 Forge-SQL-ORM is designed to work with @forge/sql and requires some additional setup to ensure compatibility within Atlassian Forge.
@@ -157,19 +150,9 @@ const users = (await forgeSQL.fetch().executeRawSQL) < Users > "SELECT * FROM us
 
 ```js
 // Define schema for join result
-class InnerJoinResult {
-    name!: string;
-    product!: string;
-}
-
-export const innerJoinSchema = new EntitySchema<InnerJoinResult>({
-    class: InnerJoinResult,
-    properties: {
-        name: { type: "string", fieldName: "name" },
-        product: { type: "string", fieldName: "product" }
-    },
-});
-innerJoinSchema.init();
+const innerJoinSchema = forgeSQL.fetch().createComplexQuerySchema();
+schemaBuilder.addField(Users.meta.properties.name);
+schemaBuilder.addField(Orders.meta.properties.product);
 
 // Execute query
 const query = forgeSQL.createQueryBuilder(Orders, "order")
@@ -182,11 +165,7 @@ const results = await forgeSQL.fetch().executeSchemaSQL(query, innerJoinSchema);
 console.log(results);
 ```
 
-Below is an example of how you can extend your README's CRUD Operations section with information and examples for both `updateFieldById` and `updateFields` methods:
-
----
-
-🛠 **CRUD Operations**
+## CRUD Operations
 
 - **Insert Data**
 
@@ -491,8 +470,73 @@ export const UsersSchema = new EntitySchema({
   },
 });
 
+```
+---
+
+## Drop Migrations
+
+The Drop Migrations feature allows you to completely reset your database schema in Atlassian Forge SQL. This is useful when you need to:
+- Start fresh with a new schema
+- Reset all tables and their data
+- Clear migration history
+- Ensure your local models match the deployed database
+
+### Important Requirements
+
+Before using Drop Migrations, ensure that:
+1. Your local entity models exactly match the current database schema deployed in Atlassian Forge SQL
+2. You have a backup of your data if needed
+3. You understand that this operation will delete all tables and data
+
+### Usage
+
+1. First, ensure your local models match the deployed database:
+   ```bash
+   npx forge-sql-orm generate:model --output ./database/entities
+   ```
+
+2. Generate the drop migration:
+   ```bash
+   npx forge-sql-orm migrations:drop --entitiesPath ./database/entities --output ./database/migration
+   ```
+
+3. Deploy and run the migration in your Forge app:
+   ```js
+   import migrationRunner from "./database/migration";
+   import { MigrationRunner } from "@forge/sql/out/migration";
+
+   const runner = new MigrationRunner();
+   await migrationRunner(runner);
+   await runner.run();
+   ```
+
+4. After dropping all tables, you can create a new migration to recreate the schema:
+   ```bash
+   npx forge-sql-orm migrations:create --entitiesPath ./database/entities --output ./database/migration --force
+   ```
+   The `--force` parameter is required here because we're creating a new migration after dropping all tables.
+
+### Example Migration Output
+
+The generated drop migration will look like this:
+```js
+import { MigrationRunner } from "@forge/sql/out/migration";
+
+export default (migrationRunner: MigrationRunner): MigrationRunner => {
+    return migrationRunner
+        .enqueue("v1_MIGRATION0", "DROP TABLE IF EXISTS `users`")
+        .enqueue("v1_MIGRATION1", "DROP TABLE IF EXISTS `orders`")
+        .enqueue("MIGRATION_V1_1234567890", "DELETE FROM __migrations");
+};
 ```
 
+### ⚠️ Important Notes
+
+- This operation is **irreversible** - all data will be lost
+- Make sure your local models are up-to-date with the deployed database
+- Consider backing up your data before running drop migrations
+- The migration will clear the `__migrations` table to allow for fresh migration history
+
 ---
 
 ## Complex Queries
@@ -616,10 +660,6 @@ const duplicateResult = await forgeSQL
 
 ---
 
-Below is the plain text version of the additional section for Optimistic Locking. You can copy and paste it directly into your README:
-
----
-
 ## Optimistic Locking
 
 Optimistic locking is a concurrency control mechanism that prevents data conflicts when multiple transactions attempt to update the same record concurrently. Instead of using locks, this technique relies on a version field in your entity models. Each time an update occurs, the current version is checked, and if it doesn't match the stored version, the update is rejected. This ensures data consistency and helps avoid accidental overwrites.
@@ -641,7 +681,7 @@ Optimistic locking is a concurrency control mechanism that prevents data conflic
 
 ### Example
 
-Here’s how you can define an entity with optimistic locking using MikroORM:
+Here's how you can define an entity with optimistic locking using MikroORM:
 
 ```js
 export class TestEntityVersion {

package/dist/ForgeSQLORM.js

@@ -463,11 +463,74 @@ class ForgeSQLCrudOperations {
     return true;
   }
 }
+class DynamicEntity {
+  /**
+   * Retrieves a schema field by its original entity property.
+   * @param field - The entity property to search for.
+   * @returns The corresponding schema field or undefined if not found.
+   */
+  getSchemaBySchemaField(field) {
+    return this[field.name];
+  }
+  /**
+   * Retrieves a schema field by its alias.
+   * @param alias - The alias of the field.
+   * @returns The corresponding schema field or undefined if not found.
+   */
+  getSchemaByAliasField(alias) {
+    return this[alias];
+  }
+}
+class EntitySchemaBuilder {
+  constructor(entityClass) {
+    this.entityClass = entityClass;
+  }
+  properties = {};
+  /**
+   * Adds a field to the schema definition.
+   * @param field - The entity property to add.
+   * @param alias - (Optional) Custom alias for the field name.
+   * @returns The current instance of EntitySchemaBuilder for method chaining.
+   */
+  addField(field, alias) {
+    const fieldName = alias || field.name;
+    const fieldNameType = fieldName;
+    this.properties[fieldNameType] = { ...field, name: fieldNameType };
+    return this;
+  }
+  /**
+   * Creates and initializes a new EntitySchema based on the added fields.
+   * @returns A new EntitySchema<T> instance.
+   */
+  createSchema() {
+    const es = new mysql.EntitySchema({
+      class: this.entityClass,
+      // @ts-ignore
+      properties: this.properties
+    });
+    es.init();
+    return es;
+  }
+}
+class DynamicEntitySchemaBuilder extends EntitySchemaBuilder {
+  constructor() {
+    super(DynamicEntity);
+  }
+}
 class ForgeSQLSelectOperations {
   options;
   constructor(options) {
     this.options = options;
   }
+  /**
+   * Creates a builder for constructing complex query schemas dynamically.
+   * This method is useful when working with dynamic entity structures where fields
+   * may not be known at compile time.
+   * @returns An instance of ComplexQuerySchemaBuilder configured for dynamic entities.
+   */
+  createComplexQuerySchema() {
+    return new DynamicEntitySchemaBuilder();
+  }
   async executeSchemaSQLOnlyOne(query, schema) {
     const results = await this.executeSchemaSQL(query, schema);
     if (!results || results.length === 0) {
@@ -489,7 +552,7 @@ class ForgeSQLSelectOperations {
     if (!datas.length) return [];
     return datas.map((r) => {
       const rawModel = r;
-      const newModel = {};
+      const newModel = Object.create(schema.meta.prototype);
       schema.meta.props.filter((p) => p.kind === "scalar").forEach((p) => {
         const fieldName = p.name;
         const fieldNames = p.fieldNames;
@@ -552,8 +615,11 @@ class ForgeSQLORMImpl {
    * @param options - Options for configuring ForgeSQL ORM behavior.
    */
   constructor(entities, options) {
-    console.debug("Initializing ForgeSQLORM...");
     try {
+      const newOptions = options ?? { logRawSqlQuery: false, disableOptimisticLocking: false };
+      if (newOptions.logRawSqlQuery) {
+        console.debug("Initializing ForgeSQLORM...");
+      }
       this.mikroORM = mysql.MikroORM.initSync({
         dbName: "inmemory",
         schemaGenerator: {
@@ -573,7 +639,6 @@ class ForgeSQLORMImpl {
         preferTs: false,
         debug: false
       });
-      const newOptions = options ?? { logRawSqlQuery: false, disableOptimisticLocking: false };
       this.crudOperations = new ForgeSQLCrudOperations(this, newOptions);
       this.fetchOperations = new ForgeSQLSelectOperations(newOptions);
     } catch (error) {

package/dist/ForgeSQLORM.js.map

@@ -1 +1 @@
-{"version":3,"file":"ForgeSQLORM.js","sources":["../src/utils/sqlUtils.ts","../src/core/ForgeSQLCrudOperations.ts","../src/core/ForgeSQLSelectOperations.ts","../src/core/ForgeSQLORM.ts"],"sourcesContent":["import { types } from \"@mikro-orm/core/types\";\nimport moment from \"moment\";\nimport { AnyString } from \"@mikro-orm/core/typings\";\n\nconst wrapIfNeeded=(data:string, wrap:boolean):string => {\n  return wrap?`'${data}'`:data;\n}\n\nexport const transformValue = <U>(value: {\n  type: keyof typeof types | AnyString;\n  value: U;\n}, wrapValue: boolean = false): U => {\n  switch (value.type) {\n    case \"text\":\n    case \"string\":\n      return <U>wrapIfNeeded(`${value.value}`,wrapValue);\n    case \"datetime\":\n      return <U>wrapIfNeeded(`${moment(value.value as Date).format(\"YYYY-MM-DDTHH:mm:ss.SSS\")}`,wrapValue);\n    case \"date\":\n      return <U>wrapIfNeeded(`${moment(value.value as Date).format(\"YYYY-MM-DD\")}`, wrapValue);\n    case \"time\":\n      return <U>wrapIfNeeded(`${moment(value.value as Date).format(\"HH:mm:ss.SSS\")}`,wrapValue);\n    default:\n      return value.value;\n  }\n};\n\nexport const parseDateTime = (value: string, format: string): Date => {\n  const m = moment(value, format, true);\n  if (!m.isValid()) {\n    return moment(value).toDate();\n  }\n  return m.toDate();\n};\n","import { sql, UpdateQueryResponse } from \"@forge/sql\";\nimport { EntityProperty, EntitySchema, ForgeSqlOrmOptions } from \"..\";\nimport type { types } from \"@mikro-orm/core/types\";\nimport { transformValue } from \"../utils/sqlUtils\";\nimport { CRUDForgeSQL, ForgeSqlOperation } from \"./ForgeSQLQueryBuilder\";\nimport { EntityKey, QBFilterQuery } from \"..\";\nimport Knex from \"../knex\";\n\nexport class ForgeSQLCrudOperations implements CRUDForgeSQL {\n  private readonly forgeOperations: ForgeSqlOperation;\n  private readonly options: ForgeSqlOrmOptions;\n\n  constructor(forgeSqlOperations: ForgeSqlOperation, options: ForgeSqlOrmOptions) {\n    this.forgeOperations = forgeSqlOperations;\n    this.options = options;\n  }\n\n  /**\n   * Generates an SQL INSERT statement for the provided models.\n   * If a version field exists in the schema, its value is set accordingly.\n   *\n   * @param schema - The entity schema.\n   * @param models - The list of entities to insert.\n   * @param updateIfExists - Whether to update the row if it already exists.\n   * @returns An object containing the SQL query, column names, and values.\n   */\n  private async generateInsertScript<T extends object>(\n      schema: EntitySchema<T>,\n      models: T[],\n      updateIfExists: boolean,\n  ): Promise<{\n    sql: string;\n    query: string;\n    fields: string[];\n    values: { type: keyof typeof types; value: unknown }[];\n  }> {\n    const columnNames = new Set<string>();\n    const modelFieldValues: Record<string, { type: keyof typeof types; value: unknown }>[] = [];\n\n    // Build field values for each model.\n    models.forEach((model) => {\n      const fieldValues: Record<string, { type: keyof typeof types; value: unknown }> = {};\n      schema.meta.props.forEach((prop) => {\n        const value = model[prop.name];\n        if (prop.kind === \"scalar\" && value !== undefined) {\n          const columnName = this.getRealFieldNameFromSchema(prop);\n          columnNames.add(columnName);\n          fieldValues[columnName] = { type: prop.type as keyof typeof types, value };\n        }\n      });\n      modelFieldValues.push(fieldValues);\n    });\n\n    // If a version field exists, set or update its value.\n    const versionField = this.getVersionField(schema);\n    if (versionField) {\n      modelFieldValues.forEach((mv) => {\n        const versionRealName = this.getRealFieldNameFromSchema(versionField);\n        if (mv[versionRealName]) {\n          mv[versionRealName].value = transformValue(\n              { value: this.createVersionField(versionField), type: versionField.name },\n              true,\n          );\n        } else {\n          mv[versionRealName] = {\n            type: versionField.type as keyof typeof types,\n            value: transformValue(\n                { value: this.createVersionField(versionField), type: versionField.name },\n                true,\n            ),\n          };\n          columnNames.add(versionField.name);\n        }\n      });\n    }\n\n    const columns = Array.from(columnNames);\n\n    // Flatten values for each row in the order of columns.\n    const values = modelFieldValues.flatMap((fieldValueMap) =>\n        columns.map(\n            (column) =>\n                fieldValueMap[column] || {\n                  type: \"string\",\n                  value: null,\n                },\n        ),\n    );\n\n    // Build the VALUES clause.\n    const insertValues = modelFieldValues\n        .map((fieldValueMap) => {\n          const rowValues = columns\n              .map((column) =>\n                  transformValue(\n                      fieldValueMap[column] || { type: \"string\", value: null },\n                      true,\n                  ),\n              )\n              .join(\",\");\n          return `(${rowValues})`;\n        })\n        .join(\", \");\n    // Build the VALUES ? clause.\n    const insertEmptyValues = modelFieldValues\n        .map(() => {\n          const rowValues = columns\n              .map(() =>\n                  '?',\n              )\n              .join(\",\");\n          return `(${rowValues})`;\n        })\n        .join(\", \");\n\n    const updateClause = updateIfExists\n        ? ` ON DUPLICATE KEY UPDATE ${columns.map((col) => `${col} = VALUES(${col})`).join(\",\")}`\n        : \"\";\n\n    return {\n      sql: `INSERT INTO ${schema.meta.collection} (${columns.join(\",\")}) VALUES ${insertValues}${updateClause}`,\n      query: `INSERT INTO ${schema.meta.collection} (${columns.join(\",\")}) VALUES ${insertEmptyValues}${updateClause}`,\n      fields: columns,\n      values,\n    };\n  }\n\n  /**\n   * Inserts records into the database.\n   * If a version field exists in the schema, versioning is applied.\n   *\n   * @param schema - The entity schema.\n   * @param models - The list of entities to insert.\n   * @param updateIfExists - Whether to update the row if it already exists.\n   * @returns The ID of the inserted row.\n   */\n  async insert<T extends object>(\n      schema: EntitySchema<T>,\n      models: T[],\n      updateIfExists: boolean = false,\n  ): Promise<number> {\n    if (!models || models.length === 0) return 0;\n\n    const query = await this.generateInsertScript(schema, models, updateIfExists);\n    if (this.options?.logRawSqlQuery) {\n      console.debug(\"INSERT SQL: \" + query.query);\n    }\n    const sqlStatement = sql.prepare<UpdateQueryResponse>(query.sql);\n    const result = await sqlStatement.execute();\n    return result.rows.insertId;\n  }\n\n  /**\n   * Retrieves the primary key properties from the entity schema.\n   *\n   * @param schema - The entity schema.\n   * @returns An array of primary key properties.\n   * @throws If no primary keys are found.\n   */\n  private getPrimaryKeys<T extends object>(schema: EntitySchema<T>): EntityProperty<T, unknown>[] {\n    const primaryKeys = schema.meta.props.filter((prop) => prop.primary);\n    if (!primaryKeys.length) {\n      throw new Error(`No primary keys found for schema: ${schema.meta.className}`);\n    }\n    return primaryKeys;\n  }\n\n  /**\n   * Deletes a record by its primary key.\n   *\n   * @param id - The ID of the record to delete.\n   * @param schema - The entity schema.\n   * @returns The number of rows affected.\n   * @throws If the entity has more than one primary key.\n   */\n  async deleteById<T extends object>(id: unknown, schema: EntitySchema<T>): Promise<number> {\n    const primaryKeys = this.getPrimaryKeys(schema);\n    if (primaryKeys.length > 1) {\n      throw new Error(\"Only one primary key is supported\");\n    }\n\n    const primaryKey = primaryKeys[0];\n    const queryBuilder = this.forgeOperations.createQueryBuilder(schema.meta.class).delete();\n    queryBuilder.andWhere({ [primaryKey.name]: { $eq: id } });\n\n    const query = queryBuilder.getFormattedQuery();\n    if (this.options?.logRawSqlQuery) {\n      console.debug(\"DELETE SQL: \" + queryBuilder.getQuery());\n    }\n    const sqlStatement = sql.prepare<UpdateQueryResponse>(query);\n    const result = await sqlStatement.execute();\n    return result.rows.affectedRows;\n  }\n\n  /**\n   * Retrieves the version field from the entity schema.\n   * The version field must be of type datetime, integer, or decimal, not a primary key, and not nullable.\n   *\n   * @param schema - The entity schema.\n   * @returns The version field property if it exists.\n   */\n  getVersionField<T>(schema: EntitySchema<T>) {\n    if (this.options.disableOptimisticLocking){\n      return undefined;\n    }\n    return schema.meta.props\n        .filter((prop) => prop.version)\n        .filter((prop) => {\n          const validType =\n              prop.type === \"datetime\" || prop.type === \"integer\" || prop.type === \"decimal\";\n          if (!validType) {\n            console.warn(\n                `Version field \"${prop.name}\" in table ${schema.meta.tableName} must be datetime, integer, or decimal, but is \"${prop.type}\"`,\n            );\n          }\n          return validType;\n        })\n        .filter((prop) => {\n          if (prop.primary) {\n            console.warn(\n                `Version field \"${prop.name}\" in table ${schema.meta.tableName} cannot be a primary key`,\n            );\n            return false;\n          }\n          return true;\n        })\n        .find((prop) => {\n          if (prop.nullable) {\n            console.warn(\n                `Version field \"${prop.name}\" in table ${schema.meta.tableName} should not be nullable`,\n            );\n            return false;\n          }\n          return true;\n        });\n  }\n\n  /**\n   * Increments the version field of an entity.\n   * For datetime types, sets the current date; for numeric types, increments by 1.\n   *\n   * @param versionField - The version field property.\n   * @param updateModel - The entity to update.\n   */\n  incrementVersionField<T>(versionField: EntityProperty<T, any>, updateModel: T): void {\n    const key = versionField.name as keyof T;\n    switch (versionField.type) {\n      case \"datetime\": {\n        updateModel[key] = new Date() as unknown as T[keyof T];\n        break;\n      }\n      case \"decimal\":\n      case \"integer\": {\n        updateModel[key] = ((updateModel[key] as number) + 1) as unknown as T[keyof T];\n        break;\n      }\n      default:\n        throw new Error(`Unsupported version field type: ${versionField.type}`);\n    }\n  }\n\n  /**\n   * Creates the initial version field value for an entity.\n   * For datetime types, returns the current date; for numeric types, returns 0.\n   *\n   * @param versionField - The version field property.\n   */\n  createVersionField<T>(versionField: EntityProperty<T>): unknown {\n    switch (versionField.type) {\n      case \"datetime\": {\n        return new Date() as unknown as T[keyof T];\n      }\n      case \"decimal\":\n      case \"integer\": {\n        return 0;\n      }\n      default:\n        throw new Error(`Unsupported version field type: ${versionField.type}`);\n    }\n  }\n\n  /**\n   * Updates a record by its primary key using the provided entity data.\n   *\n   * @param entity - The entity with updated values.\n   * @param schema - The entity schema.\n   */\n  async updateById<T extends object>(entity: Partial<T>, schema: EntitySchema<T>): Promise<void> {\n    const fields = schema.meta.props\n        .filter((prop) => prop.kind === \"scalar\")\n        .map((prop) => prop.name);\n    await this.updateFieldById(entity as T, fields, schema);\n  }\n\n  /**\n   * Updates specified fields of records based on provided conditions.\n   * If the \"where\" parameter is not provided, the WHERE clause is built from the entity fields\n   * that are not included in the list of fields to update.\n   *\n   * @param entity - The object containing values to update and potential criteria for filtering.\n   * @param fields - Array of field names to update.\n   * @param schema - The entity schema.\n   * @param where - Optional filtering conditions for the WHERE clause.\n   * @returns The number of affected rows.\n   * @throws If no filtering criteria are provided (either via \"where\" or from the remaining entity fields).\n   */\n  async updateFields<T extends object>(\n      entity: Partial<T>,\n      fields: EntityKey<T>[],\n      schema: EntitySchema<T>,\n      where?: QBFilterQuery<T>,\n  ): Promise<number> {\n    // Extract update data from the entity based on the provided fields.\n    const updateData = this.filterEntityFields(entity, fields);\n    const updateModel = this.modifyModel(updateData as T, schema);\n\n    // Create the query builder for the entity.\n    let queryBuilder = this.forgeOperations\n        .createQueryBuilder(schema.meta.class)\n        .getKnexQuery();\n\n    // Set the update data.\n    queryBuilder.update(updateModel as T);\n\n    // Use the provided \"where\" conditions if available; otherwise, build conditions from the remaining entity fields.\n    if (where) {\n      queryBuilder.where(where);\n    } else {\n      const filterCriteria = (Object.keys(entity) as Array<keyof T>)\n          .filter((key: keyof T) => !fields.includes(key as EntityKey<T>))\n          .reduce((criteria, key) => {\n            if (entity[key] !== undefined) {\n              // Cast key to string to use it as an object key.\n              criteria[key as string] = entity[key];\n            }\n            return criteria;\n          }, {} as Record<string, unknown>);\n\n\n      if (Object.keys(filterCriteria).length === 0) {\n        throw new Error(\n            \"Filtering criteria (WHERE clause) must be provided either via the 'where' parameter or through non-updated entity fields\"\n        );\n      }\n      queryBuilder.where(filterCriteria);\n    }\n\n    if (this.options?.logRawSqlQuery) {\n      console.debug(\"UPDATE SQL (updateFields): \" + queryBuilder.toSQL().sql);\n    }\n\n    // Execute the update query.\n    const sqlQuery = queryBuilder.toQuery();\n    const updateQueryResponse = await this.forgeOperations.fetch().executeRawUpdateSQL(sqlQuery);\n    return updateQueryResponse.affectedRows;\n  }\n\n\n  /**\n   * Updates specific fields of a record identified by its primary key.\n   * If a version field exists in the schema, versioning is applied.\n   *\n   * @param entity - The entity with updated values.\n   * @param fields - The list of field names to update.\n   * @param schema - The entity schema.\n   * @throws If the primary key is not included in the update fields.\n   */\n  async updateFieldById<T extends object>(\n      entity: T,\n      fields: EntityKey<T>[],\n      schema: EntitySchema<T>,\n  ): Promise<void> {\n    const primaryKeys = this.getPrimaryKeys(schema);\n    primaryKeys.forEach((pk) => {\n      if (!fields.includes(pk.name)) {\n        throw new Error(\"Update fields must include primary key: \" + pk.name);\n      }\n    });\n\n    // Prepare updated entity and query builder.\n    const updatedEntity = this.filterEntityFields(entity, fields);\n    let queryBuilder = this.forgeOperations.createQueryBuilder(schema.meta.class).getKnexQuery();\n    const versionField = this.getVersionField(schema);\n    const useVersion = Boolean(versionField);\n    let updateModel = { ...updatedEntity };\n\n    if (useVersion && versionField) {\n      // If the version field is missing from the entity, load the old record.\n      let oldModel = entity;\n      if (entity[versionField.name] === undefined || entity[versionField.name] === null) {\n        oldModel = await this.getOldModel(primaryKeys, entity, schema, versionField);\n      }\n      const primaryFieldNames = primaryKeys.map((pk) => pk.name);\n      const fieldsToRetain = primaryFieldNames.concat(versionField.name);\n      const fromEntries = Object.fromEntries(fieldsToRetain.map((key) => [key, oldModel[key]]));\n      updateModel = { ...updatedEntity, ...fromEntries };\n\n      // Increment the version field.\n      this.incrementVersionField(versionField, updateModel as T);\n\n      updateModel = this.modifyModel(updateModel as T, schema);\n      queryBuilder.update(updateModel as T);\n      if (oldModel[versionField.name]!==undefined || oldModel[versionField.name]!==null && this.isValid(oldModel[versionField.name])) {\n        queryBuilder.andWhere(this.optWhere(oldModel, versionField));\n      }\n    } else {\n      updateModel = this.modifyModel(updatedEntity as T, schema);\n      queryBuilder.update(updateModel as T);\n    }\n\n    this.addPrimaryWhere(queryBuilder as unknown as Knex.QueryBuilder<any, any>, primaryKeys, updateModel as T);\n    const sqlQuery = queryBuilder.toQuery();\n\n    if (this.options?.logRawSqlQuery) {\n      console.debug(\"UPDATE SQL: \" + queryBuilder.toSQL().sql);\n    }\n    const updateQueryResponse = await this.forgeOperations.fetch().executeRawUpdateSQL(sqlQuery);\n    if (versionField && !updateQueryResponse.affectedRows) {\n      throw new Error(\n          \"Optimistic locking failed: the record with primary key(s) \" +\n          primaryKeys.map((p) => updateModel[p.name]).join(\", \") +\n          \" has been modified by another process.\",\n      );\n    }\n  }\n\n  /**\n   * Constructs an optional WHERE clause for the version field.\n   *\n   * @param updateModel - The model containing the current version field value.\n   * @param versionField - The version field property.\n   * @returns A filter query for the version field.\n   */\n  private optWhere<T>(\n      updateModel: T,\n      versionField: EntityProperty<T>,\n  ): QBFilterQuery<unknown> {\n    const currentVersionValue = transformValue(\n        { value: updateModel[versionField.name], type: versionField.type },\n        false,\n    );\n    return { [versionField.name]: currentVersionValue };\n  }\n\n  /**\n   * Retrieves the current state of a record from the database.\n   *\n   * @param primaryKeys - The primary key properties.\n   * @param entity - The entity with updated values.\n   * @param schema - The entity schema.\n   * @param versionField - The version field property.\n   * @returns The existing record from the database.\n   * @throws If the record does not exist or if multiple records are found.\n   */\n  private async getOldModel<T>(\n      primaryKeys: EntityProperty<T, unknown>[],\n      entity: T,\n      schema: EntitySchema<T>,\n      versionField: EntityProperty<T>,\n  ): Promise<T> {\n    const primaryFieldNames = primaryKeys.map((pk) => pk.name);\n    const fieldsToSelect = primaryFieldNames.concat(versionField.name);\n    const queryBuilder = this.forgeOperations\n        .createQueryBuilder(schema as EntitySchema)\n        .select(fieldsToSelect);\n    this.addPrimaryWhere(queryBuilder, primaryKeys, entity);\n    const formattedQuery = queryBuilder.getFormattedQuery();\n    const models: T[] = await this.forgeOperations.fetch().executeSchemaSQL(formattedQuery, schema as EntitySchema);\n\n    if (!models || models.length === 0) {\n      throw new Error(`Cannot modify record because it does not exist in table ${schema.meta.tableName}`);\n    }\n    if (models.length > 1) {\n      throw new Error(\n          `Cannot modify record because multiple rows with the same ID were found in table ${schema.meta.tableName}. Please verify the table metadata.`,\n      );\n    }\n    return models[0];\n  }\n\n  /**\n   * Adds primary key conditions to the query builder.\n   *\n   * @param queryBuilder - The Knex query builder instance.\n   * @param primaryKeys - The primary key properties.\n   * @param entity - The entity containing primary key values.\n   * @throws If any primary key value is missing.\n   */\n  private addPrimaryWhere<T>(\n      queryBuilder: Knex.QueryBuilder<any, any>,\n      primaryKeys: EntityProperty<T, unknown>[],\n      entity: T,\n  ) {\n    primaryKeys.forEach((pk) => {\n      const fieldName = this.getRealFieldNameFromSchema(pk);\n      const value = entity[fieldName];\n      if (value === null || value === undefined) {\n        throw new Error(`Primary key ${fieldName} must exist in the model`);\n      }\n      queryBuilder.andWhere({ [fieldName]: value });\n    });\n  }\n\n  /**\n   * Filters the entity to include only the specified fields.\n   *\n   * @param entity - The original entity.\n   * @param fields - The list of fields to retain.\n   * @returns A partial entity object containing only the specified fields.\n   */\n  filterEntityFields = <T extends object>(entity: T, fields: (keyof T)[]): Partial<T> =>\n      fields.reduce((result, field) => {\n        if (field in entity) {\n          result[field] = entity[field];\n        }\n        return result;\n      }, {} as Partial<T>);\n\n  /**\n   * Transforms and modifies the updated entity model based on the schema.\n   *\n   * @param updatedEntity - The updated entity.\n   * @param schema - The entity schema.\n   * @returns The modified entity.\n   */\n  private modifyModel<T>(updatedEntity: T, schema: EntitySchema<T>): T {\n    const modifiedModel: Record<string, any> = {};\n    schema.meta.props\n        .filter((p) => p.kind === \"scalar\")\n        .forEach((p) => {\n          const value = updatedEntity[p.name];\n          if (value !== undefined && value !== null) {\n            const fieldName = this.getRealFieldNameFromSchema(p);\n            modifiedModel[fieldName] = transformValue({ value, type: p.type }, false);\n          }\n        });\n    return modifiedModel as T;\n  }\n\n  /**\n   * Returns the real field name from the entity property based on the schema.\n   *\n   * @param p - The entity property.\n   * @returns The real field name.\n   */\n  private getRealFieldNameFromSchema<T>(p: EntityProperty<T>): EntityKey<T> {\n    return p.fieldNames && p.fieldNames.length\n        ? (p.fieldNames[0] as EntityKey<T>)\n        : p.name;\n  }\n\n  /**\n   * Validates the provided value.\n   *\n   * @param value - The value to validate.\n   * @returns True if the value is valid, false otherwise.\n   */\n  isValid(value: any): boolean {\n    if (value instanceof Date) {\n      return !isNaN(value.getTime());\n    }\n    return true;\n  }\n}\n","import { sql, UpdateQueryResponse } from \"@forge/sql\";\nimport type { EntitySchema } from \"@mikro-orm/core/metadata/EntitySchema\";\nimport { parseDateTime } from \"../utils/sqlUtils\";\nimport { ForgeSqlOrmOptions, SchemaSqlForgeSql } from \"./ForgeSQLQueryBuilder\";\nimport {SqlParameters} from \"@forge/sql/out/sql-statement\";\n\nexport class ForgeSQLSelectOperations implements SchemaSqlForgeSql {\n  private readonly options: ForgeSqlOrmOptions;\n\n  constructor(options: ForgeSqlOrmOptions) {\n    this.options = options;\n  }\n\n  async executeSchemaSQLOnlyOne<T extends object>(query: string, schema: EntitySchema<T>): Promise<T|undefined> {\n        const results = await this.executeSchemaSQL(query, schema);\n        if (!results || results.length === 0){\n          return undefined;\n        }\n        if (results.length>1){\n          throw new Error('Expected 1 record but returned '+results.length)\n        }\n        return results[0];\n    }\n\n  /**\n   * Executes a schema-based SQL query and maps the result to the entity schema.\n   * @param query - The SQL query to execute.\n   * @param schema - The entity schema defining the structure.\n   * @returns A list of mapped entity objects.\n   */\n  async executeSchemaSQL<T extends object>(query: string, schema: EntitySchema<T>): Promise<T[]> {\n    const datas = await this.executeRawSQL<unknown>(query);\n    if (!datas.length) return [];\n\n    return datas.map((r) => {\n      const rawModel = r as Record<string, unknown>;\n      const newModel: Record<string, unknown> = {};\n\n      schema.meta.props\n        .filter((p) => p.kind === \"scalar\")\n        .forEach((p) => {\n          const fieldName = p.name;\n          const fieldNames = p.fieldNames;\n          const rawFieldName = fieldNames && Array.isArray(fieldNames) ? fieldNames[0] : p.name;\n\n          switch (p.type) {\n            case \"datetime\":\n                newModel[fieldName] = parseDateTime(\n                    rawModel[rawFieldName] as string,\n                    \"YYYY-MM-DDTHH:mm:ss.SSS\",\n                );\n              break;\n            case \"date\":\n              newModel[fieldName] = parseDateTime(rawModel[rawFieldName] as string, \"YYYY-MM-DD\");\n              break;\n            case \"time\":\n              newModel[fieldName] = parseDateTime(rawModel[rawFieldName] as string, \"HH:mm:ss.SSS\");\n              break;\n            default:\n              newModel[fieldName] = rawModel[rawFieldName];\n          }\n        });\n      return newModel as T;\n    });\n  }\n\n  /**\n   * Executes a raw SQL query and returns the results.\n   * @param query - The raw SQL query to execute.\n   * @returns A list of results as objects.\n   */\n  async executeRawSQL<T extends object | unknown>(query: string): Promise<T[]> {\n    if (this.options.logRawSqlQuery) {\n      console.debug(\"Executing raw SQL: \" + query);\n    }\n    const sqlStatement = await sql.prepare<T>(query).execute();\n    return sqlStatement.rows as T[];\n  }\n\n  /**\n   * Executes a raw SQL update query.\n   * @param query - The raw SQL update query.\n   * @param params - sql parameters.\n   * @returns The update response containing affected rows.\n   */\n  async executeRawUpdateSQL(query: string, params?: SqlParameters[]): Promise<UpdateQueryResponse> {\n    const sqlStatement = sql.prepare<UpdateQueryResponse>(query);\n    if (params) {\n      sqlStatement.bindParams(params);\n    }\n    const updateQueryResponseResults = await sqlStatement.execute();\n    return updateQueryResponseResults.rows;\n  }\n}\n","import type { EntityName, LoggingOptions } from \"..\";\nimport type { EntitySchema } from \"@mikro-orm/core/metadata/EntitySchema\";\nimport type { AnyEntity, EntityClass, EntityClassGroup } from \"@mikro-orm/core/typings\";\nimport type { QueryBuilder } from \"@mikro-orm/knex/query\";\nimport { MemoryCacheAdapter, MikroORM, NullCacheAdapter } from \"@mikro-orm/mysql\";\nimport { ForgeSQLCrudOperations } from \"./ForgeSQLCrudOperations\";\nimport {\n  CRUDForgeSQL,\n  ForgeSqlOperation,\n  ForgeSqlOrmOptions,\n  SchemaSqlForgeSql,\n} from \"./ForgeSQLQueryBuilder\";\nimport { ForgeSQLSelectOperations } from \"./ForgeSQLSelectOperations\";\nimport type { Knex } from \"knex\";\n\n/**\n * Implementation of ForgeSQLORM that interacts with MikroORM.\n */\nclass ForgeSQLORMImpl implements ForgeSqlOperation {\n  private static instance: ForgeSQLORMImpl | null = null;\n  private readonly mikroORM: MikroORM;\n  private readonly crudOperations: CRUDForgeSQL;\n  private readonly fetchOperations: SchemaSqlForgeSql;\n\n  /**\n   * Private constructor to enforce singleton behavior.\n   * @param entities - The list of entities for ORM initialization.\n   * @param options - Options for configuring ForgeSQL ORM behavior.\n   */\n  private constructor(\n    entities: (EntityClass<AnyEntity> | EntityClassGroup<AnyEntity> | EntitySchema)[],\n    options?: ForgeSqlOrmOptions,\n  ) {\n    console.debug(\"Initializing ForgeSQLORM...\");\n\n    try {\n      this.mikroORM = MikroORM.initSync({\n        dbName: \"inmemory\",\n        schemaGenerator: {\n          disableForeignKeys: false,\n        },\n        discovery: {\n          warnWhenNoEntities: true,\n        },\n        resultCache: {\n          adapter: NullCacheAdapter,\n        },\n        metadataCache: {\n          enabled: false,\n          adapter: MemoryCacheAdapter,\n        },\n        entities: entities,\n        preferTs: false,\n        debug: false,\n      });\n      const newOptions: ForgeSqlOrmOptions = options ?? { logRawSqlQuery: false, disableOptimisticLocking: false };\n      this.crudOperations = new ForgeSQLCrudOperations(this, newOptions);\n      this.fetchOperations = new ForgeSQLSelectOperations(newOptions);\n    } catch (error) {\n      console.error(\"ForgeSQLORM initialization failed:\", error);\n      throw error; // Prevents inconsistent state\n    }\n  }\n\n  /**\n   * Returns the singleton instance of ForgeSQLORMImpl.\n   * @param entities - List of entities (required only on first initialization).\n   * @param options - Options for configuring ForgeSQL ORM behavior.\n   * @returns The singleton instance of ForgeSQLORMImpl.\n   */\n  static getInstance(\n    entities: (EntityClass<AnyEntity> | EntityClassGroup<AnyEntity> | EntitySchema)[],\n    options?: ForgeSqlOrmOptions,\n  ): ForgeSqlOperation {\n    if (!ForgeSQLORMImpl.instance) {\n      ForgeSQLORMImpl.instance = new ForgeSQLORMImpl(entities, options);\n    }\n    return ForgeSQLORMImpl.instance;\n  }\n\n  /**\n   * Retrieves the CRUD operations instance.\n   * @returns CRUD operations.\n   */\n  crud(): CRUDForgeSQL {\n    return this.crudOperations;\n  }\n\n  /**\n   * Retrieves the fetch operations instance.\n   * @returns Fetch operations.\n   */\n  fetch(): SchemaSqlForgeSql {\n    return this.fetchOperations;\n  }\n\n  /**\n   * Creates a new query builder for the given entity.\n   * @param entityName - The entity name or an existing query builder.\n   * @param alias - The alias for the entity.\n   * @param loggerContext - Logging options.\n   * @returns The query builder instance.\n   */\n  createQueryBuilder<Entity extends object, RootAlias extends string = never>(\n    entityName: EntityName<Entity> | QueryBuilder<Entity>,\n    alias?: RootAlias,\n    loggerContext?: LoggingOptions,\n  ): QueryBuilder<Entity, RootAlias> {\n    return this.mikroORM.em.createQueryBuilder(entityName, alias, undefined, loggerContext);\n  }\n\n  /**\n   * Provides access to the underlying Knex instance for building complex query parts.\n   * enabling advanced query customization and performance tuning.\n   * @returns The Knex instance, which can be used for query building.\n   */\n  getKnex(): Knex<any, any[]> {\n    return this.mikroORM.em.getKnex();\n  }\n}\n\n/**\n * Public class that acts as a wrapper around the private ForgeSQLORMImpl.\n */\nclass ForgeSQLORM {\n  private readonly ormInstance: ForgeSqlOperation;\n\n  constructor(\n    entities: (EntityClass<AnyEntity> | EntityClassGroup<AnyEntity> | EntitySchema)[],\n    options?: ForgeSqlOrmOptions,\n  ) {\n    this.ormInstance = ForgeSQLORMImpl.getInstance(entities, options);\n  }\n\n  /**\n   * Proxies the `crud` method from `ForgeSQLORMImpl`.\n   * @returns CRUD operations.\n   */\n  crud(): CRUDForgeSQL {\n    return this.ormInstance.crud();\n  }\n\n  /**\n   * Proxies the `fetch` method from `ForgeSQLORMImpl`.\n   * @returns Fetch operations.\n   */\n  fetch(): SchemaSqlForgeSql {\n    return this.ormInstance.fetch();\n  }\n\n  getKnex(): Knex<any, any[]> {\n    return this.ormInstance.getKnex();\n  }\n\n  /**\n   * Proxies the `createQueryBuilder` method from `ForgeSQLORMImpl`.\n   * @returns A new query builder instance.\n   */\n  createQueryBuilder<Entity extends object, RootAlias extends string = never>(\n    entityName: EntityName<Entity> | QueryBuilder<Entity>,\n    alias?: RootAlias,\n    loggerContext?: LoggingOptions,\n  ): QueryBuilder<Entity, RootAlias> {\n    return this.ormInstance.createQueryBuilder(entityName, alias, loggerContext);\n  }\n}\n\nexport default ForgeSQLORM;\n"],"names":["sql","MikroORM","NullCacheAdapter","MemoryCacheAdapter"],"mappings":"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"}
+{"version":3,"file":"ForgeSQLORM.js","sources":["../src/utils/sqlUtils.ts","../src/core/ForgeSQLCrudOperations.ts","../src/core/ComplexQuerySchemaBuilder.ts","../src/core/ForgeSQLSelectOperations.ts","../src/core/ForgeSQLORM.ts"],"sourcesContent":["import moment from \"moment\";\nimport { AnyString } from \"@mikro-orm/core/typings\";\nimport {types} from \"..\";\n\nconst wrapIfNeeded=(data:string, wrap:boolean):string => {\n  return wrap?`'${data}'`:data;\n}\n\nexport const transformValue = <U>(value: {\n  type: keyof typeof types | AnyString;\n  value: U;\n}, wrapValue: boolean = false): U => {\n  switch (value.type) {\n    case \"text\":\n    case \"string\":\n      return <U>wrapIfNeeded(`${value.value}`,wrapValue);\n    case \"datetime\":\n      return <U>wrapIfNeeded(`${moment(value.value as Date).format(\"YYYY-MM-DDTHH:mm:ss.SSS\")}`,wrapValue);\n    case \"date\":\n      return <U>wrapIfNeeded(`${moment(value.value as Date).format(\"YYYY-MM-DD\")}`, wrapValue);\n    case \"time\":\n      return <U>wrapIfNeeded(`${moment(value.value as Date).format(\"HH:mm:ss.SSS\")}`,wrapValue);\n    default:\n      return value.value;\n  }\n};\n\nexport const parseDateTime = (value: string, format: string): Date => {\n  const m = moment(value, format, true);\n  if (!m.isValid()) {\n    return moment(value).toDate();\n  }\n  return m.toDate();\n};\n","import { sql, UpdateQueryResponse } from \"@forge/sql\";\nimport { EntityProperty, EntitySchema, ForgeSqlOrmOptions } from \"..\";\nimport type { types } from \"@mikro-orm/core/types\";\nimport { transformValue } from \"../utils/sqlUtils\";\nimport { CRUDForgeSQL, ForgeSqlOperation } from \"./ForgeSQLQueryBuilder\";\nimport { EntityKey, QBFilterQuery } from \"..\";\nimport Knex from \"../knex\";\n\nexport class ForgeSQLCrudOperations implements CRUDForgeSQL {\n  private readonly forgeOperations: ForgeSqlOperation;\n  private readonly options: ForgeSqlOrmOptions;\n\n  constructor(forgeSqlOperations: ForgeSqlOperation, options: ForgeSqlOrmOptions) {\n    this.forgeOperations = forgeSqlOperations;\n    this.options = options;\n  }\n\n  /**\n   * Generates an SQL INSERT statement for the provided models.\n   * If a version field exists in the schema, its value is set accordingly.\n   *\n   * @param schema - The entity schema.\n   * @param models - The list of entities to insert.\n   * @param updateIfExists - Whether to update the row if it already exists.\n   * @returns An object containing the SQL query, column names, and values.\n   */\n  private async generateInsertScript<T extends object>(\n      schema: EntitySchema<T>,\n      models: T[],\n      updateIfExists: boolean,\n  ): Promise<{\n    sql: string;\n    query: string;\n    fields: string[];\n    values: { type: keyof typeof types; value: unknown }[];\n  }> {\n    const columnNames = new Set<string>();\n    const modelFieldValues: Record<string, { type: keyof typeof types; value: unknown }>[] = [];\n\n    // Build field values for each model.\n    models.forEach((model) => {\n      const fieldValues: Record<string, { type: keyof typeof types; value: unknown }> = {};\n      schema.meta.props.forEach((prop) => {\n        const value = model[prop.name];\n        if (prop.kind === \"scalar\" && value !== undefined) {\n          const columnName = this.getRealFieldNameFromSchema(prop);\n          columnNames.add(columnName);\n          fieldValues[columnName] = { type: prop.type as keyof typeof types, value };\n        }\n      });\n      modelFieldValues.push(fieldValues);\n    });\n\n    // If a version field exists, set or update its value.\n    const versionField = this.getVersionField(schema);\n    if (versionField) {\n      modelFieldValues.forEach((mv) => {\n        const versionRealName = this.getRealFieldNameFromSchema(versionField);\n        if (mv[versionRealName]) {\n          mv[versionRealName].value = transformValue(\n              { value: this.createVersionField(versionField), type: versionField.name },\n              true,\n          );\n        } else {\n          mv[versionRealName] = {\n            type: versionField.type as keyof typeof types,\n            value: transformValue(\n                { value: this.createVersionField(versionField), type: versionField.name },\n                true,\n            ),\n          };\n          columnNames.add(versionField.name);\n        }\n      });\n    }\n\n    const columns = Array.from(columnNames);\n\n    // Flatten values for each row in the order of columns.\n    const values = modelFieldValues.flatMap((fieldValueMap) =>\n        columns.map(\n            (column) =>\n                fieldValueMap[column] || {\n                  type: \"string\",\n                  value: null,\n                },\n        ),\n    );\n\n    // Build the VALUES clause.\n    const insertValues = modelFieldValues\n        .map((fieldValueMap) => {\n          const rowValues = columns\n              .map((column) =>\n                  transformValue(\n                      fieldValueMap[column] || { type: \"string\", value: null },\n                      true,\n                  ),\n              )\n              .join(\",\");\n          return `(${rowValues})`;\n        })\n        .join(\", \");\n    // Build the VALUES ? clause.\n    const insertEmptyValues = modelFieldValues\n        .map(() => {\n          const rowValues = columns\n              .map(() =>\n                  '?',\n              )\n              .join(\",\");\n          return `(${rowValues})`;\n        })\n        .join(\", \");\n\n    const updateClause = updateIfExists\n        ? ` ON DUPLICATE KEY UPDATE ${columns.map((col) => `${col} = VALUES(${col})`).join(\",\")}`\n        : \"\";\n\n    return {\n      sql: `INSERT INTO ${schema.meta.collection} (${columns.join(\",\")}) VALUES ${insertValues}${updateClause}`,\n      query: `INSERT INTO ${schema.meta.collection} (${columns.join(\",\")}) VALUES ${insertEmptyValues}${updateClause}`,\n      fields: columns,\n      values,\n    };\n  }\n\n  /**\n   * Inserts records into the database.\n   * If a version field exists in the schema, versioning is applied.\n   *\n   * @param schema - The entity schema.\n   * @param models - The list of entities to insert.\n   * @param updateIfExists - Whether to update the row if it already exists.\n   * @returns The ID of the inserted row.\n   */\n  async insert<T extends object>(\n      schema: EntitySchema<T>,\n      models: T[],\n      updateIfExists: boolean = false,\n  ): Promise<number> {\n    if (!models || models.length === 0) return 0;\n\n    const query = await this.generateInsertScript(schema, models, updateIfExists);\n    if (this.options?.logRawSqlQuery) {\n      console.debug(\"INSERT SQL: \" + query.query);\n    }\n    const sqlStatement = sql.prepare<UpdateQueryResponse>(query.sql);\n    const result = await sqlStatement.execute();\n    return result.rows.insertId;\n  }\n\n  /**\n   * Retrieves the primary key properties from the entity schema.\n   *\n   * @param schema - The entity schema.\n   * @returns An array of primary key properties.\n   * @throws If no primary keys are found.\n   */\n  private getPrimaryKeys<T extends object>(schema: EntitySchema<T>): EntityProperty<T, unknown>[] {\n    const primaryKeys = schema.meta.props.filter((prop) => prop.primary);\n    if (!primaryKeys.length) {\n      throw new Error(`No primary keys found for schema: ${schema.meta.className}`);\n    }\n    return primaryKeys;\n  }\n\n  /**\n   * Deletes a record by its primary key.\n   *\n   * @param id - The ID of the record to delete.\n   * @param schema - The entity schema.\n   * @returns The number of rows affected.\n   * @throws If the entity has more than one primary key.\n   */\n  async deleteById<T extends object>(id: unknown, schema: EntitySchema<T>): Promise<number> {\n    const primaryKeys = this.getPrimaryKeys(schema);\n    if (primaryKeys.length > 1) {\n      throw new Error(\"Only one primary key is supported\");\n    }\n\n    const primaryKey = primaryKeys[0];\n    const queryBuilder = this.forgeOperations.createQueryBuilder(schema.meta.class).delete();\n    queryBuilder.andWhere({ [primaryKey.name]: { $eq: id } });\n\n    const query = queryBuilder.getFormattedQuery();\n    if (this.options?.logRawSqlQuery) {\n      console.debug(\"DELETE SQL: \" + queryBuilder.getQuery());\n    }\n    const sqlStatement = sql.prepare<UpdateQueryResponse>(query);\n    const result = await sqlStatement.execute();\n    return result.rows.affectedRows;\n  }\n\n  /**\n   * Retrieves the version field from the entity schema.\n   * The version field must be of type datetime, integer, or decimal, not a primary key, and not nullable.\n   *\n   * @param schema - The entity schema.\n   * @returns The version field property if it exists.\n   */\n  getVersionField<T>(schema: EntitySchema<T>) {\n    if (this.options.disableOptimisticLocking){\n      return undefined;\n    }\n    return schema.meta.props\n        .filter((prop) => prop.version)\n        .filter((prop) => {\n          const validType =\n              prop.type === \"datetime\" || prop.type === \"integer\" || prop.type === \"decimal\";\n          if (!validType) {\n            console.warn(\n                `Version field \"${prop.name}\" in table ${schema.meta.tableName} must be datetime, integer, or decimal, but is \"${prop.type}\"`,\n            );\n          }\n          return validType;\n        })\n        .filter((prop) => {\n          if (prop.primary) {\n            console.warn(\n                `Version field \"${prop.name}\" in table ${schema.meta.tableName} cannot be a primary key`,\n            );\n            return false;\n          }\n          return true;\n        })\n        .find((prop) => {\n          if (prop.nullable) {\n            console.warn(\n                `Version field \"${prop.name}\" in table ${schema.meta.tableName} should not be nullable`,\n            );\n            return false;\n          }\n          return true;\n        });\n  }\n\n  /**\n   * Increments the version field of an entity.\n   * For datetime types, sets the current date; for numeric types, increments by 1.\n   *\n   * @param versionField - The version field property.\n   * @param updateModel - The entity to update.\n   */\n  incrementVersionField<T>(versionField: EntityProperty<T, any>, updateModel: T): void {\n    const key = versionField.name as keyof T;\n    switch (versionField.type) {\n      case \"datetime\": {\n        updateModel[key] = new Date() as unknown as T[keyof T];\n        break;\n      }\n      case \"decimal\":\n      case \"integer\": {\n        updateModel[key] = ((updateModel[key] as number) + 1) as unknown as T[keyof T];\n        break;\n      }\n      default:\n        throw new Error(`Unsupported version field type: ${versionField.type}`);\n    }\n  }\n\n  /**\n   * Creates the initial version field value for an entity.\n   * For datetime types, returns the current date; for numeric types, returns 0.\n   *\n   * @param versionField - The version field property.\n   */\n  createVersionField<T>(versionField: EntityProperty<T>): unknown {\n    switch (versionField.type) {\n      case \"datetime\": {\n        return new Date() as unknown as T[keyof T];\n      }\n      case \"decimal\":\n      case \"integer\": {\n        return 0;\n      }\n      default:\n        throw new Error(`Unsupported version field type: ${versionField.type}`);\n    }\n  }\n\n  /**\n   * Updates a record by its primary key using the provided entity data.\n   *\n   * @param entity - The entity with updated values.\n   * @param schema - The entity schema.\n   */\n  async updateById<T extends object>(entity: Partial<T>, schema: EntitySchema<T>): Promise<void> {\n    const fields = schema.meta.props\n        .filter((prop) => prop.kind === \"scalar\")\n        .map((prop) => prop.name);\n    await this.updateFieldById(entity as T, fields, schema);\n  }\n\n  /**\n   * Updates specified fields of records based on provided conditions.\n   * If the \"where\" parameter is not provided, the WHERE clause is built from the entity fields\n   * that are not included in the list of fields to update.\n   *\n   * @param entity - The object containing values to update and potential criteria for filtering.\n   * @param fields - Array of field names to update.\n   * @param schema - The entity schema.\n   * @param where - Optional filtering conditions for the WHERE clause.\n   * @returns The number of affected rows.\n   * @throws If no filtering criteria are provided (either via \"where\" or from the remaining entity fields).\n   */\n  async updateFields<T extends object>(\n      entity: Partial<T>,\n      fields: EntityKey<T>[],\n      schema: EntitySchema<T>,\n      where?: QBFilterQuery<T>,\n  ): Promise<number> {\n    // Extract update data from the entity based on the provided fields.\n    const updateData = this.filterEntityFields(entity, fields);\n    const updateModel = this.modifyModel(updateData as T, schema);\n\n    // Create the query builder for the entity.\n    let queryBuilder = this.forgeOperations\n        .createQueryBuilder(schema.meta.class)\n        .getKnexQuery();\n\n    // Set the update data.\n    queryBuilder.update(updateModel as T);\n\n    // Use the provided \"where\" conditions if available; otherwise, build conditions from the remaining entity fields.\n    if (where) {\n      queryBuilder.where(where);\n    } else {\n      const filterCriteria = (Object.keys(entity) as Array<keyof T>)\n          .filter((key: keyof T) => !fields.includes(key as EntityKey<T>))\n          .reduce((criteria, key) => {\n            if (entity[key] !== undefined) {\n              // Cast key to string to use it as an object key.\n              criteria[key as string] = entity[key];\n            }\n            return criteria;\n          }, {} as Record<string, unknown>);\n\n\n      if (Object.keys(filterCriteria).length === 0) {\n        throw new Error(\n            \"Filtering criteria (WHERE clause) must be provided either via the 'where' parameter or through non-updated entity fields\"\n        );\n      }\n      queryBuilder.where(filterCriteria);\n    }\n\n    if (this.options?.logRawSqlQuery) {\n      console.debug(\"UPDATE SQL (updateFields): \" + queryBuilder.toSQL().sql);\n    }\n\n    // Execute the update query.\n    const sqlQuery = queryBuilder.toQuery();\n    const updateQueryResponse = await this.forgeOperations.fetch().executeRawUpdateSQL(sqlQuery);\n    return updateQueryResponse.affectedRows;\n  }\n\n\n  /**\n   * Updates specific fields of a record identified by its primary key.\n   * If a version field exists in the schema, versioning is applied.\n   *\n   * @param entity - The entity with updated values.\n   * @param fields - The list of field names to update.\n   * @param schema - The entity schema.\n   * @throws If the primary key is not included in the update fields.\n   */\n  async updateFieldById<T extends object>(\n      entity: T,\n      fields: EntityKey<T>[],\n      schema: EntitySchema<T>,\n  ): Promise<void> {\n    const primaryKeys = this.getPrimaryKeys(schema);\n    primaryKeys.forEach((pk) => {\n      if (!fields.includes(pk.name)) {\n        throw new Error(\"Update fields must include primary key: \" + pk.name);\n      }\n    });\n\n    // Prepare updated entity and query builder.\n    const updatedEntity = this.filterEntityFields(entity, fields);\n    let queryBuilder = this.forgeOperations.createQueryBuilder(schema.meta.class).getKnexQuery();\n    const versionField = this.getVersionField(schema);\n    const useVersion = Boolean(versionField);\n    let updateModel = { ...updatedEntity };\n\n    if (useVersion && versionField) {\n      // If the version field is missing from the entity, load the old record.\n      let oldModel = entity;\n      if (entity[versionField.name] === undefined || entity[versionField.name] === null) {\n        oldModel = await this.getOldModel(primaryKeys, entity, schema, versionField);\n      }\n      const primaryFieldNames = primaryKeys.map((pk) => pk.name);\n      const fieldsToRetain = primaryFieldNames.concat(versionField.name);\n      const fromEntries = Object.fromEntries(fieldsToRetain.map((key) => [key, oldModel[key]]));\n      updateModel = { ...updatedEntity, ...fromEntries };\n\n      // Increment the version field.\n      this.incrementVersionField(versionField, updateModel as T);\n\n      updateModel = this.modifyModel(updateModel as T, schema);\n      queryBuilder.update(updateModel as T);\n      if (oldModel[versionField.name]!==undefined || oldModel[versionField.name]!==null && this.isValid(oldModel[versionField.name])) {\n        queryBuilder.andWhere(this.optWhere(oldModel, versionField));\n      }\n    } else {\n      updateModel = this.modifyModel(updatedEntity as T, schema);\n      queryBuilder.update(updateModel as T);\n    }\n\n    this.addPrimaryWhere(queryBuilder as unknown as Knex.QueryBuilder<any, any>, primaryKeys, updateModel as T);\n    const sqlQuery = queryBuilder.toQuery();\n\n    if (this.options?.logRawSqlQuery) {\n      console.debug(\"UPDATE SQL: \" + queryBuilder.toSQL().sql);\n    }\n    const updateQueryResponse = await this.forgeOperations.fetch().executeRawUpdateSQL(sqlQuery);\n    if (versionField && !updateQueryResponse.affectedRows) {\n      throw new Error(\n          \"Optimistic locking failed: the record with primary key(s) \" +\n          primaryKeys.map((p) => updateModel[p.name]).join(\", \") +\n          \" has been modified by another process.\",\n      );\n    }\n  }\n\n  /**\n   * Constructs an optional WHERE clause for the version field.\n   *\n   * @param updateModel - The model containing the current version field value.\n   * @param versionField - The version field property.\n   * @returns A filter query for the version field.\n   */\n  private optWhere<T>(\n      updateModel: T,\n      versionField: EntityProperty<T>,\n  ): QBFilterQuery<unknown> {\n    const currentVersionValue = transformValue(\n        { value: updateModel[versionField.name], type: versionField.type },\n        false,\n    );\n    return { [versionField.name]: currentVersionValue };\n  }\n\n  /**\n   * Retrieves the current state of a record from the database.\n   *\n   * @param primaryKeys - The primary key properties.\n   * @param entity - The entity with updated values.\n   * @param schema - The entity schema.\n   * @param versionField - The version field property.\n   * @returns The existing record from the database.\n   * @throws If the record does not exist or if multiple records are found.\n   */\n  private async getOldModel<T>(\n      primaryKeys: EntityProperty<T, unknown>[],\n      entity: T,\n      schema: EntitySchema<T>,\n      versionField: EntityProperty<T>,\n  ): Promise<T> {\n    const primaryFieldNames = primaryKeys.map((pk) => pk.name);\n    const fieldsToSelect = primaryFieldNames.concat(versionField.name);\n    const queryBuilder = this.forgeOperations\n        .createQueryBuilder(schema as EntitySchema)\n        .select(fieldsToSelect);\n    this.addPrimaryWhere(queryBuilder, primaryKeys, entity);\n    const formattedQuery = queryBuilder.getFormattedQuery();\n    const models: T[] = await this.forgeOperations.fetch().executeSchemaSQL(formattedQuery, schema as EntitySchema);\n\n    if (!models || models.length === 0) {\n      throw new Error(`Cannot modify record because it does not exist in table ${schema.meta.tableName}`);\n    }\n    if (models.length > 1) {\n      throw new Error(\n          `Cannot modify record because multiple rows with the same ID were found in table ${schema.meta.tableName}. Please verify the table metadata.`,\n      );\n    }\n    return models[0];\n  }\n\n  /**\n   * Adds primary key conditions to the query builder.\n   *\n   * @param queryBuilder - The Knex query builder instance.\n   * @param primaryKeys - The primary key properties.\n   * @param entity - The entity containing primary key values.\n   * @throws If any primary key value is missing.\n   */\n  private addPrimaryWhere<T>(\n      queryBuilder: Knex.QueryBuilder<any, any>,\n      primaryKeys: EntityProperty<T, unknown>[],\n      entity: T,\n  ) {\n    primaryKeys.forEach((pk) => {\n      const fieldName = this.getRealFieldNameFromSchema(pk);\n      const value = entity[fieldName];\n      if (value === null || value === undefined) {\n        throw new Error(`Primary key ${fieldName} must exist in the model`);\n      }\n      queryBuilder.andWhere({ [fieldName]: value });\n    });\n  }\n\n  /**\n   * Filters the entity to include only the specified fields.\n   *\n   * @param entity - The original entity.\n   * @param fields - The list of fields to retain.\n   * @returns A partial entity object containing only the specified fields.\n   */\n  filterEntityFields = <T extends object>(entity: T, fields: (keyof T)[]): Partial<T> =>\n      fields.reduce((result, field) => {\n        if (field in entity) {\n          result[field] = entity[field];\n        }\n        return result;\n      }, {} as Partial<T>);\n\n  /**\n   * Transforms and modifies the updated entity model based on the schema.\n   *\n   * @param updatedEntity - The updated entity.\n   * @param schema - The entity schema.\n   * @returns The modified entity.\n   */\n  private modifyModel<T>(updatedEntity: T, schema: EntitySchema<T>): T {\n    const modifiedModel: Record<string, any> = {};\n    schema.meta.props\n        .filter((p) => p.kind === \"scalar\")\n        .forEach((p) => {\n          const value = updatedEntity[p.name];\n          if (value !== undefined && value !== null) {\n            const fieldName = this.getRealFieldNameFromSchema(p);\n            modifiedModel[fieldName] = transformValue({ value, type: p.type }, false);\n          }\n        });\n    return modifiedModel as T;\n  }\n\n  /**\n   * Returns the real field name from the entity property based on the schema.\n   *\n   * @param p - The entity property.\n   * @returns The real field name.\n   */\n  private getRealFieldNameFromSchema<T>(p: EntityProperty<T>): EntityKey<T> {\n    return p.fieldNames && p.fieldNames.length\n        ? (p.fieldNames[0] as EntityKey<T>)\n        : p.name;\n  }\n\n  /**\n   * Validates the provided value.\n   *\n   * @param value - The value to validate.\n   * @returns True if the value is valid, false otherwise.\n   */\n  isValid(value: any): boolean {\n    if (value instanceof Date) {\n      return !isNaN(value.getTime());\n    }\n    return true;\n  }\n}\n","import { EntitySchema, EntityProperty, EntityKey } from \"..\";\nimport {ComplexQuerySchemaBuilder} from \"./ForgeSQLQueryBuilder\";\n\nexport class DynamicEntity {\n    [key: string]: unknown;\n\n    /**\n     * Retrieves a schema field by its original entity property.\n     * @param field - The entity property to search for.\n     * @returns The corresponding schema field or undefined if not found.\n     */\n    getSchemaBySchemaField<TYPE>(field: EntityProperty): TYPE | undefined {\n        return this[field.name] as TYPE | undefined;\n    }\n\n    /**\n     * Retrieves a schema field by its alias.\n     * @param alias - The alias of the field.\n     * @returns The corresponding schema field or undefined if not found.\n     */\n    getSchemaByAliasField<TYPE>(alias: string): TYPE | undefined {\n        return this[alias] as TYPE | undefined;\n    }\n}\n\nexport class EntitySchemaBuilder<T> implements ComplexQuerySchemaBuilder<T> {\n    private properties: Record<string, EntityProperty<T>> = {};\n\n    constructor(private entityClass: new () => T) {}\n\n    /**\n     * Adds a field to the schema definition.\n     * @param field - The entity property to add.\n     * @param alias - (Optional) Custom alias for the field name.\n     * @returns The current instance of EntitySchemaBuilder for method chaining.\n     */\n    addField<K>(field: Partial<EntityProperty<K>>, alias?: string): this {\n        const fieldName = alias || field.name;\n        const fieldNameType = fieldName as unknown as EntityKey<T>;\n        this.properties[fieldNameType] = { ...field, name: fieldNameType } as unknown as EntityProperty<T>;\n        return this;\n    }\n\n    /**\n     * Creates and initializes a new EntitySchema based on the added fields.\n     * @returns A new EntitySchema<T> instance.\n     */\n    createSchema(): EntitySchema<T> {\n        const es = new EntitySchema<T>({\n            class: this.entityClass,\n            // @ts-ignore\n            properties: this.properties,\n        });\n        es.init();\n        return es;\n    }\n}\n\nexport class DynamicEntitySchemaBuilder extends EntitySchemaBuilder<DynamicEntity> {\n    constructor() {\n        super(DynamicEntity);\n    }\n}\n","import { sql, UpdateQueryResponse } from \"@forge/sql\";\nimport type { EntitySchema } from \"@mikro-orm/core/metadata/EntitySchema\";\nimport { parseDateTime } from \"../utils/sqlUtils\";\nimport { ComplexQuerySchemaBuilder, ForgeSqlOrmOptions, SchemaSqlForgeSql} from \"./ForgeSQLQueryBuilder\";\nimport {SqlParameters} from \"@forge/sql/out/sql-statement\";\nimport {DynamicEntity, DynamicEntitySchemaBuilder} from \"./ComplexQuerySchemaBuilder\";\nimport {EntityKey} from \"@mikro-orm/core\";\n\nexport class ForgeSQLSelectOperations implements SchemaSqlForgeSql {\n    private readonly options: ForgeSqlOrmOptions;\n\n    constructor(options: ForgeSqlOrmOptions) {\n        this.options = options;\n    }\n\n    /**\n     * Creates a builder for constructing complex query schemas dynamically.\n     * This method is useful when working with dynamic entity structures where fields\n     * may not be known at compile time.\n     * @returns An instance of ComplexQuerySchemaBuilder configured for dynamic entities.\n     */\n    createComplexQuerySchema(): ComplexQuerySchemaBuilder<DynamicEntity> {\n        return new DynamicEntitySchemaBuilder();\n    }\n\n  async executeSchemaSQLOnlyOne<T extends object>(query: string, schema: EntitySchema<T>): Promise<T|undefined> {\n        const results = await this.executeSchemaSQL(query, schema);\n        if (!results || results.length === 0){\n          return undefined;\n        }\n        if (results.length>1){\n          throw new Error('Expected 1 record but returned '+results.length)\n        }\n        return results[0];\n    }\n\n  /**\n   * Executes a schema-based SQL query and maps the result to the entity schema.\n   * @param query - The SQL query to execute.\n   * @param schema - The entity schema defining the structure.\n   * @returns A list of mapped entity objects.\n   */\n  async executeSchemaSQL<T extends object>(query: string, schema: EntitySchema<T>): Promise<T[]> {\n    const datas = await this.executeRawSQL<unknown>(query);\n    if (!datas.length) return [];\n\n    return datas.map((r) => {\n      const rawModel = r as Record<string, unknown>;\n        const newModel = Object.create(schema.meta.prototype) as T;\n\n      schema.meta.props\n        .filter((p) => p.kind === \"scalar\")\n        .forEach((p) => {\n          const fieldName = p.name;\n          const fieldNames = p.fieldNames;\n          const rawFieldName = fieldNames && Array.isArray(fieldNames) ? fieldNames[0] : p.name;\n          switch (p.type) {\n            case \"datetime\":\n                newModel[fieldName] = parseDateTime(\n                    rawModel[rawFieldName] as string,\n                    \"YYYY-MM-DDTHH:mm:ss.SSS\",\n                )  as unknown as T[EntityKey<T>];\n              break;\n            case \"date\":\n              newModel[fieldName] = parseDateTime(rawModel[rawFieldName] as string, \"YYYY-MM-DD\")  as unknown as T[EntityKey<T>];\n              break;\n            case \"time\":\n              newModel[fieldName] = parseDateTime(rawModel[rawFieldName] as string, \"HH:mm:ss.SSS\")  as unknown as T[EntityKey<T>];\n              break;\n            default:\n              newModel[fieldName] = rawModel[rawFieldName]  as unknown as T[EntityKey<T>];\n          }\n        });\n      return newModel as T;\n    });\n  }\n\n  /**\n   * Executes a raw SQL query and returns the results.\n   * @param query - The raw SQL query to execute.\n   * @returns A list of results as objects.\n   */\n  async executeRawSQL<T extends object | unknown>(query: string): Promise<T[]> {\n    if (this.options.logRawSqlQuery) {\n      console.debug(\"Executing raw SQL: \" + query);\n    }\n    const sqlStatement = await sql.prepare<T>(query).execute();\n    return sqlStatement.rows as T[];\n  }\n\n  /**\n   * Executes a raw SQL update query.\n   * @param query - The raw SQL update query.\n   * @param params - sql parameters.\n   * @returns The update response containing affected rows.\n   */\n  async executeRawUpdateSQL(query: string, params?: SqlParameters[]): Promise<UpdateQueryResponse> {\n    const sqlStatement = sql.prepare<UpdateQueryResponse>(query);\n    if (params) {\n      sqlStatement.bindParams(params);\n    }\n    const updateQueryResponseResults = await sqlStatement.execute();\n    return updateQueryResponseResults.rows;\n  }\n}\n","import type { EntityName, LoggingOptions } from \"..\";\nimport type { EntitySchema } from \"@mikro-orm/core/metadata/EntitySchema\";\nimport type { AnyEntity, EntityClass, EntityClassGroup } from \"@mikro-orm/core/typings\";\nimport type { QueryBuilder } from \"@mikro-orm/knex/query\";\nimport { MemoryCacheAdapter, MikroORM, NullCacheAdapter } from \"@mikro-orm/mysql\";\nimport { ForgeSQLCrudOperations } from \"./ForgeSQLCrudOperations\";\nimport {\n  CRUDForgeSQL,\n  ForgeSqlOperation,\n  ForgeSqlOrmOptions,\n  SchemaSqlForgeSql,\n} from \"./ForgeSQLQueryBuilder\";\nimport { ForgeSQLSelectOperations } from \"./ForgeSQLSelectOperations\";\nimport type { Knex } from \"knex\";\n\n/**\n * Implementation of ForgeSQLORM that interacts with MikroORM.\n */\nclass ForgeSQLORMImpl implements ForgeSqlOperation {\n  private static instance: ForgeSQLORMImpl | null = null;\n  private readonly mikroORM: MikroORM;\n  private readonly crudOperations: CRUDForgeSQL;\n  private readonly fetchOperations: SchemaSqlForgeSql;\n\n  /**\n   * Private constructor to enforce singleton behavior.\n   * @param entities - The list of entities for ORM initialization.\n   * @param options - Options for configuring ForgeSQL ORM behavior.\n   */\n  private constructor(\n    entities: (EntityClass<AnyEntity> | EntityClassGroup<AnyEntity> | EntitySchema)[],\n    options?: ForgeSqlOrmOptions,\n  ) {\n\n    try {\n      const newOptions: ForgeSqlOrmOptions = options ?? { logRawSqlQuery: false, disableOptimisticLocking: false };\n      if (newOptions.logRawSqlQuery){\n        console.debug(\"Initializing ForgeSQLORM...\");\n      }\n      this.mikroORM = MikroORM.initSync({\n        dbName: \"inmemory\",\n        schemaGenerator: {\n          disableForeignKeys: false,\n        },\n        discovery: {\n          warnWhenNoEntities: true,\n        },\n        resultCache: {\n          adapter: NullCacheAdapter,\n        },\n        metadataCache: {\n          enabled: false,\n          adapter: MemoryCacheAdapter,\n        },\n        entities: entities,\n        preferTs: false,\n        debug: false,\n      });\n\n      this.crudOperations = new ForgeSQLCrudOperations(this, newOptions);\n      this.fetchOperations = new ForgeSQLSelectOperations(newOptions);\n    } catch (error) {\n      console.error(\"ForgeSQLORM initialization failed:\", error);\n      throw error; // Prevents inconsistent state\n    }\n  }\n\n  /**\n   * Returns the singleton instance of ForgeSQLORMImpl.\n   * @param entities - List of entities (required only on first initialization).\n   * @param options - Options for configuring ForgeSQL ORM behavior.\n   * @returns The singleton instance of ForgeSQLORMImpl.\n   */\n  static getInstance(\n    entities: (EntityClass<AnyEntity> | EntityClassGroup<AnyEntity> | EntitySchema)[],\n    options?: ForgeSqlOrmOptions,\n  ): ForgeSqlOperation {\n    if (!ForgeSQLORMImpl.instance) {\n      ForgeSQLORMImpl.instance = new ForgeSQLORMImpl(entities, options);\n    }\n    return ForgeSQLORMImpl.instance;\n  }\n\n  /**\n   * Retrieves the CRUD operations instance.\n   * @returns CRUD operations.\n   */\n  crud(): CRUDForgeSQL {\n    return this.crudOperations;\n  }\n\n  /**\n   * Retrieves the fetch operations instance.\n   * @returns Fetch operations.\n   */\n  fetch(): SchemaSqlForgeSql {\n    return this.fetchOperations;\n  }\n\n  /**\n   * Creates a new query builder for the given entity.\n   * @param entityName - The entity name or an existing query builder.\n   * @param alias - The alias for the entity.\n   * @param loggerContext - Logging options.\n   * @returns The query builder instance.\n   */\n  createQueryBuilder<Entity extends object, RootAlias extends string = never>(\n    entityName: EntityName<Entity> | QueryBuilder<Entity>,\n    alias?: RootAlias,\n    loggerContext?: LoggingOptions,\n  ): QueryBuilder<Entity, RootAlias> {\n    return this.mikroORM.em.createQueryBuilder(entityName, alias, undefined, loggerContext);\n  }\n\n  /**\n   * Provides access to the underlying Knex instance for building complex query parts.\n   * enabling advanced query customization and performance tuning.\n   * @returns The Knex instance, which can be used for query building.\n   */\n  getKnex(): Knex<any, any[]> {\n    return this.mikroORM.em.getKnex();\n  }\n}\n\n/**\n * Public class that acts as a wrapper around the private ForgeSQLORMImpl.\n */\nclass ForgeSQLORM {\n  private readonly ormInstance: ForgeSqlOperation;\n\n  constructor(\n    entities: (EntityClass<AnyEntity> | EntityClassGroup<AnyEntity> | EntitySchema)[],\n    options?: ForgeSqlOrmOptions,\n  ) {\n    this.ormInstance = ForgeSQLORMImpl.getInstance(entities, options);\n  }\n\n  /**\n   * Proxies the `crud` method from `ForgeSQLORMImpl`.\n   * @returns CRUD operations.\n   */\n  crud(): CRUDForgeSQL {\n    return this.ormInstance.crud();\n  }\n\n  /**\n   * Proxies the `fetch` method from `ForgeSQLORMImpl`.\n   * @returns Fetch operations.\n   */\n  fetch(): SchemaSqlForgeSql {\n    return this.ormInstance.fetch();\n  }\n\n  getKnex(): Knex<any, any[]> {\n    return this.ormInstance.getKnex();\n  }\n\n  /**\n   * Proxies the `createQueryBuilder` method from `ForgeSQLORMImpl`.\n   * @returns A new query builder instance.\n   */\n  createQueryBuilder<Entity extends object, RootAlias extends string = never>(\n    entityName: EntityName<Entity> | QueryBuilder<Entity>,\n    alias?: RootAlias,\n    loggerContext?: LoggingOptions,\n  ): QueryBuilder<Entity, RootAlias> {\n    return this.ormInstance.createQueryBuilder(entityName, alias, loggerContext);\n  }\n}\n\nexport default ForgeSQLORM;\n"],"names":["sql","EntitySchema","MikroORM","NullCacheAdapter","MemoryCacheAdapter"],"mappings":"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"}

package/dist/ForgeSQLORM.mjs

@@ -1,4 +1,4 @@
-import { MikroORM, MemoryCacheAdapter, NullCacheAdapter } from "@mikro-orm/mysql";
+import { EntitySchema, MikroORM, MemoryCacheAdapter, NullCacheAdapter } from "@mikro-orm/mysql";
 export * from "@mikro-orm/mysql";
 import { sql } from "@forge/sql";
 import moment from "moment";
@@ -462,11 +462,74 @@ class ForgeSQLCrudOperations {
     return true;
   }
 }
+class DynamicEntity {
+  /**
+   * Retrieves a schema field by its original entity property.
+   * @param field - The entity property to search for.
+   * @returns The corresponding schema field or undefined if not found.
+   */
+  getSchemaBySchemaField(field) {
+    return this[field.name];
+  }
+  /**
+   * Retrieves a schema field by its alias.
+   * @param alias - The alias of the field.
+   * @returns The corresponding schema field or undefined if not found.
+   */
+  getSchemaByAliasField(alias) {
+    return this[alias];
+  }
+}
+class EntitySchemaBuilder {
+  constructor(entityClass) {
+    this.entityClass = entityClass;
+  }
+  properties = {};
+  /**
+   * Adds a field to the schema definition.
+   * @param field - The entity property to add.
+   * @param alias - (Optional) Custom alias for the field name.
+   * @returns The current instance of EntitySchemaBuilder for method chaining.
+   */
+  addField(field, alias) {
+    const fieldName = alias || field.name;
+    const fieldNameType = fieldName;
+    this.properties[fieldNameType] = { ...field, name: fieldNameType };
+    return this;
+  }
+  /**
+   * Creates and initializes a new EntitySchema based on the added fields.
+   * @returns A new EntitySchema<T> instance.
+   */
+  createSchema() {
+    const es = new EntitySchema({
+      class: this.entityClass,
+      // @ts-ignore
+      properties: this.properties
+    });
+    es.init();
+    return es;
+  }
+}
+class DynamicEntitySchemaBuilder extends EntitySchemaBuilder {
+  constructor() {
+    super(DynamicEntity);
+  }
+}
 class ForgeSQLSelectOperations {
   options;
   constructor(options) {
     this.options = options;
   }
+  /**
+   * Creates a builder for constructing complex query schemas dynamically.
+   * This method is useful when working with dynamic entity structures where fields
+   * may not be known at compile time.
+   * @returns An instance of ComplexQuerySchemaBuilder configured for dynamic entities.
+   */
+  createComplexQuerySchema() {
+    return new DynamicEntitySchemaBuilder();
+  }
   async executeSchemaSQLOnlyOne(query, schema) {
     const results = await this.executeSchemaSQL(query, schema);
     if (!results || results.length === 0) {
@@ -488,7 +551,7 @@ class ForgeSQLSelectOperations {
     if (!datas.length) return [];
     return datas.map((r) => {
       const rawModel = r;
-      const newModel = {};
+      const newModel = Object.create(schema.meta.prototype);
       schema.meta.props.filter((p) => p.kind === "scalar").forEach((p) => {
         const fieldName = p.name;
         const fieldNames = p.fieldNames;
@@ -551,8 +614,11 @@ class ForgeSQLORMImpl {
    * @param options - Options for configuring ForgeSQL ORM behavior.
    */
   constructor(entities, options) {
-    console.debug("Initializing ForgeSQLORM...");
     try {
+      const newOptions = options ?? { logRawSqlQuery: false, disableOptimisticLocking: false };
+      if (newOptions.logRawSqlQuery) {
+        console.debug("Initializing ForgeSQLORM...");
+      }
       this.mikroORM = MikroORM.initSync({
         dbName: "inmemory",
         schemaGenerator: {
@@ -572,7 +638,6 @@ class ForgeSQLORMImpl {
         preferTs: false,
         debug: false
       });
-      const newOptions = options ?? { logRawSqlQuery: false, disableOptimisticLocking: false };
       this.crudOperations = new ForgeSQLCrudOperations(this, newOptions);
       this.fetchOperations = new ForgeSQLSelectOperations(newOptions);
     } catch (error) {