forge-sql-orm 1.0.23 → 1.0.25

package/dist/ForgeSQLORM.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"ForgeSQLORM.mjs","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\nexport const transformValue = (value: {\n  type: keyof typeof types | AnyString;\n  value: unknown;\n}): unknown => {\n  switch (value.type) {\n    case \"text\":\n    case \"string\":\n      return `'${value.value}'`;\n    case \"datetime\":\n      return `'${moment(value.value as Date).format(\"YYYY-MM-DDTHH:mm:ss.SSS\")}'`;\n    case \"date\":\n      return `'${moment(value.value as Date).format(\"YYYY-MM-DD\")}'`;\n    case \"time\":\n      return `'${moment(value.value as Date).format(\"HH:mm:ss.SSS\")}'`;\n    default:\n      return value.value;\n  }\n};\nexport const parseDateTime = (value: string, format: string): Date => {\n  return moment(value, format).toDate();\n};\n","import { UpdateQueryResponse, sql } 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\";\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 query with values.\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, fields, 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    fields: string[];\n    values: { type: keyof typeof types; value: unknown }[];\n  }> {\n    const fieldNames: Set<string> = new Set();\n    const fieldValueMaps: Record<string, { type: keyof typeof types; value: unknown }>[] = [];\n\n    models.forEach((model) => {\n      const fieldValueMap: Record<string, { type: keyof typeof types; value: unknown }> = {};\n      schema.meta.props.forEach((p) => {\n        const modelValue = model[p.name];\n        if (p.kind === \"scalar\" && modelValue !== undefined) {\n          fieldNames.add(p.fieldNames[0] || p.name);\n          fieldValueMap[p.fieldNames[0]] = {\n            type: p.type as keyof typeof types,\n            value: modelValue,\n          };\n        }\n      });\n      fieldValueMaps.push(fieldValueMap);\n    });\n\n    const fields = Array.from(fieldNames);\n    const values = fieldValueMaps.flatMap((fieldValueMap) =>\n      fields.map(\n        (f) =>\n          fieldValueMap[f] || {\n            type: \"string\",\n            value: null,\n          },\n      ),\n    );\n\n    return {\n      sql: `INSERT INTO ${schema.meta.collection} (${fields.join(\",\")}) VALUES ${fieldValueMaps\n        .map(\n          (fieldValueMap) =>\n            `(${fields\n              .map((f) =>\n                transformValue(\n                  fieldValueMap[f] || {\n                    type: \"string\",\n                    value: null,\n                  },\n                ),\n              )\n              .join(\",\")})`,\n        )\n        .join(\n          \", \",\n        )} ${updateIfExists ? `ON DUPLICATE KEY UPDATE ${fields.map((f) => `${f} = VALUES(${f})`).join(\",\")}` : \"\"}`,\n      fields,\n      values,\n    };\n  }\n\n  /**\n   * Inserts records into the database.\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.sql);\n    }\n    const sqlStatement = sql.prepare<UpdateQueryResponse>(query.sql);\n    const updateQueryResponseResult = await sqlStatement.execute();\n    return updateQueryResponseResult.rows.insertId;\n  }\n\n  /**\n   * Retrieves the primary keys for the given entity schema.\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((p) => p.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 ID.\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: \" + query);\n    }\n    const sqlStatement = sql.prepare<UpdateQueryResponse>(query);\n    const updateQueryResponseResult = await sqlStatement.execute();\n    return updateQueryResponseResult.rows.affectedRows;\n  }\n\n  /**\n   * Updates a record by its ID.\n   * @param entity - The entity with updated values.\n   * @param schema - The entity schema.\n   * @throws If the primary key value is missing in the entity.\n   */\n  async updateById<T extends object>(entity: T, schema: EntitySchema<T>): Promise<void> {\n    const primaryKeys = this.getPrimaryKeys(schema);\n    const queryBuilder = this.forgeOperations.createQueryBuilder(schema.meta.class).update(entity);\n\n    primaryKeys.forEach((pk) => {\n      const value = entity[pk.name];\n      if (value === null || value === undefined) {\n        throw new Error(`Primary Key ${pk.name} must exist in the model`);\n      }\n      queryBuilder.andWhere({ [pk.name]: { $eq: value } });\n    });\n    const query = queryBuilder.getFormattedQuery();\n    if (this.options?.logRawSqlQuery) {\n      console.debug(\"UPDATE SQL: \" + query);\n    }\n    await this.forgeOperations.fetch().executeRawUpdateSQL(query);\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\";\n\nexport class ForgeSQLSelectOperations implements SchemaSqlForgeSql {\n  private readonly options: ForgeSqlOrmOptions;\n\n  constructor(options: ForgeSqlOrmOptions) {\n    this.options = options;\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   * @returns The update response containing affected rows.\n   */\n  async executeRawUpdateSQL(query: string): Promise<UpdateQueryResponse> {\n    if (this.options.logRawSqlQuery) {\n      console.debug(\"Executing update SQL: \" + query);\n    }\n    const sqlStatement = sql.prepare<UpdateQueryResponse>(query);\n    const updateQueryResponseResults = await sqlStatement.execute();\n    return updateQueryResponseResults.rows;\n  }\n}\n","import type { EntityName, LoggingOptions } from \"@mikro-orm/core\";\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 };\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   * @returns The singleton instance of ForgeSQLORMImpl.\n   */\n  static getInstance(\n    entities: (EntityClass<AnyEntity> | EntityClassGroup<AnyEntity> | EntitySchema)[],\n  ): ForgeSqlOperation {\n    if (!ForgeSQLORMImpl.instance) {\n      ForgeSQLORMImpl.instance = new ForgeSQLORMImpl(entities);\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 executing raw queries and 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(entities: (EntityClass<AnyEntity> | EntityClassGroup<AnyEntity> | EntitySchema)[]) {\n    this.ormInstance = ForgeSQLORMImpl.getInstance(entities);\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":[],"mappings":"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"}
+{"version":3,"file":"ForgeSQLORM.mjs","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 \"@mikro-orm/core\";\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 \"@mikro-orm/core\";\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":[],"mappings":"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"}

package/dist/core/ForgeSQLCrudOperations.d.ts

@@ -1,19 +1,24 @@
-import { EntitySchema, ForgeSqlOrmOptions } from "..";
+import { EntityProperty, EntitySchema, ForgeSqlOrmOptions } from "..";
 import { CRUDForgeSQL, ForgeSqlOperation } from "./ForgeSQLQueryBuilder";
+import { EntityKey, QBFilterQuery } from "@mikro-orm/core";
 export declare class ForgeSQLCrudOperations implements CRUDForgeSQL {
     private readonly forgeOperations;
     private readonly options;
     constructor(forgeSqlOperations: ForgeSqlOperation, options: ForgeSqlOrmOptions);
     /**
-     * Generates an SQL insert query with values.
+     * Generates an SQL INSERT statement for the provided models.
+     * If a version field exists in the schema, its value is set accordingly.
+     *
      * @param schema - The entity schema.
      * @param models - The list of entities to insert.
      * @param updateIfExists - Whether to update the row if it already exists.
-     * @returns An object containing the SQL query, fields, and values.
+     * @returns An object containing the SQL query, column names, and values.
      */
     private generateInsertScript;
     /**
      * Inserts records into the database.
+     * If a version field exists in the schema, versioning is applied.
+     *
      * @param schema - The entity schema.
      * @param models - The list of entities to insert.
      * @param updateIfExists - Whether to update the row if it already exists.
@@ -21,14 +26,16 @@ export declare class ForgeSQLCrudOperations implements CRUDForgeSQL {
      */
     insert<T extends object>(schema: EntitySchema<T>, models: T[], updateIfExists?: boolean): Promise<number>;
     /**
-     * Retrieves the primary keys for the given entity schema.
+     * Retrieves the primary key properties from the entity schema.
+     *
      * @param schema - The entity schema.
      * @returns An array of primary key properties.
      * @throws If no primary keys are found.
      */
     private getPrimaryKeys;
     /**
-     * Deletes a record by its ID.
+     * Deletes a record by its primary key.
+     *
      * @param id - The ID of the record to delete.
      * @param schema - The entity schema.
      * @returns The number of rows affected.
@@ -36,11 +43,115 @@ export declare class ForgeSQLCrudOperations implements CRUDForgeSQL {
      */
     deleteById<T extends object>(id: unknown, schema: EntitySchema<T>): Promise<number>;
     /**
-     * Updates a record by its ID.
+     * Retrieves the version field from the entity schema.
+     * The version field must be of type datetime, integer, or decimal, not a primary key, and not nullable.
+     *
+     * @param schema - The entity schema.
+     * @returns The version field property if it exists.
+     */
+    getVersionField<T>(schema: EntitySchema<T>): EntityProperty<T, any> | undefined;
+    /**
+     * Increments the version field of an entity.
+     * For datetime types, sets the current date; for numeric types, increments by 1.
+     *
+     * @param versionField - The version field property.
+     * @param updateModel - The entity to update.
+     */
+    incrementVersionField<T>(versionField: EntityProperty<T, any>, updateModel: T): void;
+    /**
+     * Creates the initial version field value for an entity.
+     * For datetime types, returns the current date; for numeric types, returns 0.
+     *
+     * @param versionField - The version field property.
+     */
+    createVersionField<T>(versionField: EntityProperty<T>): unknown;
+    /**
+     * Updates a record by its primary key using the provided entity data.
+     *
+     * @param entity - The entity with updated values.
+     * @param schema - The entity schema.
+     */
+    updateById<T extends object>(entity: Partial<T>, schema: EntitySchema<T>): Promise<void>;
+    /**
+     * Updates specified fields of records based on provided conditions.
+     * If the "where" parameter is not provided, the WHERE clause is built from the entity fields
+     * that are not included in the list of fields to update.
+     *
+     * @param entity - The object containing values to update and potential criteria for filtering.
+     * @param fields - Array of field names to update.
+     * @param schema - The entity schema.
+     * @param where - Optional filtering conditions for the WHERE clause.
+     * @returns The number of affected rows.
+     * @throws If no filtering criteria are provided (either via "where" or from the remaining entity fields).
+     */
+    updateFields<T extends object>(entity: Partial<T>, fields: EntityKey<T>[], schema: EntitySchema<T>, where?: QBFilterQuery<T>): Promise<number>;
+    /**
+     * Updates specific fields of a record identified by its primary key.
+     * If a version field exists in the schema, versioning is applied.
+     *
      * @param entity - The entity with updated values.
+     * @param fields - The list of field names to update.
      * @param schema - The entity schema.
-     * @throws If the primary key value is missing in the entity.
+     * @throws If the primary key is not included in the update fields.
+     */
+    updateFieldById<T extends object>(entity: T, fields: EntityKey<T>[], schema: EntitySchema<T>): Promise<void>;
+    /**
+     * Constructs an optional WHERE clause for the version field.
+     *
+     * @param updateModel - The model containing the current version field value.
+     * @param versionField - The version field property.
+     * @returns A filter query for the version field.
+     */
+    private optWhere;
+    /**
+     * Retrieves the current state of a record from the database.
+     *
+     * @param primaryKeys - The primary key properties.
+     * @param entity - The entity with updated values.
+     * @param schema - The entity schema.
+     * @param versionField - The version field property.
+     * @returns The existing record from the database.
+     * @throws If the record does not exist or if multiple records are found.
+     */
+    private getOldModel;
+    /**
+     * Adds primary key conditions to the query builder.
+     *
+     * @param queryBuilder - The Knex query builder instance.
+     * @param primaryKeys - The primary key properties.
+     * @param entity - The entity containing primary key values.
+     * @throws If any primary key value is missing.
+     */
+    private addPrimaryWhere;
+    /**
+     * Filters the entity to include only the specified fields.
+     *
+     * @param entity - The original entity.
+     * @param fields - The list of fields to retain.
+     * @returns A partial entity object containing only the specified fields.
+     */
+    filterEntityFields: <T extends object>(entity: T, fields: (keyof T)[]) => Partial<T>;
+    /**
+     * Transforms and modifies the updated entity model based on the schema.
+     *
+     * @param updatedEntity - The updated entity.
+     * @param schema - The entity schema.
+     * @returns The modified entity.
+     */
+    private modifyModel;
+    /**
+     * Returns the real field name from the entity property based on the schema.
+     *
+     * @param p - The entity property.
+     * @returns The real field name.
+     */
+    private getRealFieldNameFromSchema;
+    /**
+     * Validates the provided value.
+     *
+     * @param value - The value to validate.
+     * @returns True if the value is valid, false otherwise.
      */
-    updateById<T extends object>(entity: T, schema: EntitySchema<T>): Promise<void>;
+    isValid(value: any): boolean;
 }
 //# sourceMappingURL=ForgeSQLCrudOperations.d.ts.map

package/dist/core/ForgeSQLCrudOperations.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ForgeSQLCrudOperations.d.ts","sourceRoot":"","sources":["../../src/core/ForgeSQLCrudOperations.ts"],"names":[],"mappings":"AACA,OAAO,EAAkB,YAAY,EAAE,kBAAkB,EAAE,MAAM,IAAI,CAAC;AAGtE,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAEzE,qBAAa,sBAAuB,YAAW,YAAY;IACzD,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAoB;IACpD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAqB;gBAEjC,kBAAkB,EAAE,iBAAiB,EAAE,OAAO,EAAE,kBAAkB;IAK9E;;;;;;OAMG;YACW,oBAAoB;IA6DlC;;;;;;OAMG;IACG,MAAM,CAAC,CAAC,SAAS,MAAM,EAC3B,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC,EACvB,MAAM,EAAE,CAAC,EAAE,EACX,cAAc,GAAE,OAAe,GAC9B,OAAO,CAAC,MAAM,CAAC;IAYlB;;;;;OAKG;IACH,OAAO,CAAC,cAAc;IAQtB;;;;;;OAMG;IACG,UAAU,CAAC,CAAC,SAAS,MAAM,EAAE,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC;IAmBzF;;;;;OAKG;IACG,UAAU,CAAC,CAAC,SAAS,MAAM,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;CAiBtF"}
+{"version":3,"file":"ForgeSQLCrudOperations.d.ts","sourceRoot":"","sources":["../../src/core/ForgeSQLCrudOperations.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,IAAI,CAAC;AAGtE,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AACzE,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAG3D,qBAAa,sBAAuB,YAAW,YAAY;IACzD,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAoB;IACpD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAqB;gBAEjC,kBAAkB,EAAE,iBAAiB,EAAE,OAAO,EAAE,kBAAkB;IAK9E;;;;;;;;OAQG;YACW,oBAAoB;IAqGlC;;;;;;;;OAQG;IACG,MAAM,CAAC,CAAC,SAAS,MAAM,EACzB,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC,EACvB,MAAM,EAAE,CAAC,EAAE,EACX,cAAc,GAAE,OAAe,GAChC,OAAO,CAAC,MAAM,CAAC;IAYlB;;;;;;OAMG;IACH,OAAO,CAAC,cAAc;IAQtB;;;;;;;OAOG;IACG,UAAU,CAAC,CAAC,SAAS,MAAM,EAAE,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC;IAmBzF;;;;;;OAMG;IACH,eAAe,CAAC,CAAC,EAAE,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC;IAoC1C;;;;;;OAMG;IACH,qBAAqB,CAAC,CAAC,EAAE,YAAY,EAAE,cAAc,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,WAAW,EAAE,CAAC,GAAG,IAAI;IAiBpF;;;;;OAKG;IACH,kBAAkB,CAAC,CAAC,EAAE,YAAY,EAAE,cAAc,CAAC,CAAC,CAAC,GAAG,OAAO;IAc/D;;;;;OAKG;IACG,UAAU,CAAC,CAAC,SAAS,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAO9F;;;;;;;;;;;OAWG;IACG,YAAY,CAAC,CAAC,SAAS,MAAM,EAC/B,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,EAClB,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC,EAAE,EACtB,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC,EACvB,KAAK,CAAC,EAAE,aAAa,CAAC,CAAC,CAAC,GACzB,OAAO,CAAC,MAAM,CAAC;IA+ClB;;;;;;;;OAQG;IACG,eAAe,CAAC,CAAC,SAAS,MAAM,EAClC,MAAM,EAAE,CAAC,EACT,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC,EAAE,EACtB,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC,GACxB,OAAO,CAAC,IAAI,CAAC;IAuDhB;;;;;;OAMG;IACH,OAAO,CAAC,QAAQ;IAWhB;;;;;;;;;OASG;YACW,WAAW;IA0BzB;;;;;;;OAOG;IACH,OAAO,CAAC,eAAe;IAevB;;;;;;OAMG;IACH,kBAAkB,GAAI,CAAC,SAAS,MAAM,EAAE,QAAQ,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC,EAAE,KAAG,OAAO,CAAC,CAAC,CAAC,CAM1D;IAEzB;;;;;;OAMG;IACH,OAAO,CAAC,WAAW;IAcnB;;;;;OAKG;IACH,OAAO,CAAC,0BAA0B;IAMlC;;;;;OAKG;IACH,OAAO,CAAC,KAAK,EAAE,GAAG,GAAG,OAAO;CAM7B"}

package/dist/core/ForgeSQLORM.d.ts

@@ -2,14 +2,14 @@ import type { EntityName, LoggingOptions } from "@mikro-orm/core";
 import type { EntitySchema } from "@mikro-orm/core/metadata/EntitySchema";
 import type { AnyEntity, EntityClass, EntityClassGroup } from "@mikro-orm/core/typings";
 import type { QueryBuilder } from "@mikro-orm/knex/query";
-import { CRUDForgeSQL, SchemaSqlForgeSql } from "./ForgeSQLQueryBuilder";
+import { CRUDForgeSQL, ForgeSqlOrmOptions, SchemaSqlForgeSql } from "./ForgeSQLQueryBuilder";
 import type { Knex } from "knex";
 /**
  * Public class that acts as a wrapper around the private ForgeSQLORMImpl.
  */
 declare class ForgeSQLORM {
     private readonly ormInstance;
-    constructor(entities: (EntityClass<AnyEntity> | EntityClassGroup<AnyEntity> | EntitySchema)[]);
+    constructor(entities: (EntityClass<AnyEntity> | EntityClassGroup<AnyEntity> | EntitySchema)[], options?: ForgeSqlOrmOptions);
     /**
      * Proxies the `crud` method from `ForgeSQLORMImpl`.
      * @returns CRUD operations.

package/dist/core/ForgeSQLORM.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ForgeSQLORM.d.ts","sourceRoot":"","sources":["../../src/core/ForgeSQLORM.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAClE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uCAAuC,CAAC;AAC1E,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AACxF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAG1D,OAAO,EACL,YAAY,EAGZ,iBAAiB,EAClB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AA0GjC;;GAEG;AACH,cAAM,WAAW;IACf,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAoB;gBAEpC,QAAQ,EAAE,CAAC,WAAW,CAAC,SAAS,CAAC,GAAG,gBAAgB,CAAC,SAAS,CAAC,GAAG,YAAY,CAAC,EAAE;IAI7F;;;OAGG;IACH,IAAI,IAAI,YAAY;IAIpB;;;OAGG;IACH,KAAK,IAAI,iBAAiB;IAI1B,OAAO,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,CAAC;IAI3B;;;OAGG;IACH,kBAAkB,CAAC,MAAM,SAAS,MAAM,EAAE,SAAS,SAAS,MAAM,GAAG,KAAK,EACxE,UAAU,EAAE,UAAU,CAAC,MAAM,CAAC,GAAG,YAAY,CAAC,MAAM,CAAC,EACrD,KAAK,CAAC,EAAE,SAAS,EACjB,aAAa,CAAC,EAAE,cAAc,GAC7B,YAAY,CAAC,MAAM,EAAE,SAAS,CAAC;CAGnC;AAED,eAAe,WAAW,CAAC"}
+{"version":3,"file":"ForgeSQLORM.d.ts","sourceRoot":"","sources":["../../src/core/ForgeSQLORM.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAClE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uCAAuC,CAAC;AAC1E,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AACxF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAG1D,OAAO,EACL,YAAY,EAEZ,kBAAkB,EAClB,iBAAiB,EAClB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AA4GjC;;GAEG;AACH,cAAM,WAAW;IACf,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAoB;gBAG9C,QAAQ,EAAE,CAAC,WAAW,CAAC,SAAS,CAAC,GAAG,gBAAgB,CAAC,SAAS,CAAC,GAAG,YAAY,CAAC,EAAE,EACjF,OAAO,CAAC,EAAE,kBAAkB;IAK9B;;;OAGG;IACH,IAAI,IAAI,YAAY;IAIpB;;;OAGG;IACH,KAAK,IAAI,iBAAiB;IAI1B,OAAO,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,CAAC;IAI3B;;;OAGG;IACH,kBAAkB,CAAC,MAAM,SAAS,MAAM,EAAE,SAAS,SAAS,MAAM,GAAG,KAAK,EACxE,UAAU,EAAE,UAAU,CAAC,MAAM,CAAC,GAAG,YAAY,CAAC,MAAM,CAAC,EACrD,KAAK,CAAC,EAAE,SAAS,EACjB,aAAa,CAAC,EAAE,cAAc,GAC7B,YAAY,CAAC,MAAM,EAAE,SAAS,CAAC;CAGnC;AAED,eAAe,WAAW,CAAC"}

package/dist/core/ForgeSQLQueryBuilder.d.ts

@@ -1,8 +1,10 @@
 import { UpdateQueryResponse } from "@forge/sql";
-import type { EntityName, LoggingOptions } from "..";
+import type { EntityName, LoggingOptions, QBFilterQuery } from "..";
 import type { EntitySchema } from "@mikro-orm/core/metadata/EntitySchema";
 import type { QueryBuilder } from "@mikro-orm/knex/query";
 import type { Knex } from "knex";
+import { EntityKey } from "@mikro-orm/core";
+import { SqlParameters } from "@forge/sql/out/sql-statement";
 /**
  * Interface representing the main ForgeSQL operations.
  */
@@ -24,6 +26,10 @@ export interface ForgeSqlOrmOptions {
      * Enables logging of raw SQL queries in the Atlassian Forge Developer Console.
      */
     logRawSqlQuery?: boolean;
+    /**
+     * Disable optimistic locking
+     */
+    disableOptimisticLocking?: boolean;
 }
 /**
  * Interface for schema-level SQL operations.
@@ -36,6 +42,13 @@ export interface SchemaSqlForgeSql {
      * @returns A list of mapped entity objects.
      */
     executeSchemaSQL<T extends object>(query: string, schema: EntitySchema<T>): Promise<T[]>;
+    /**
+     * Executes a schema-bound SQL query and maps the only one result to the specified entity schema.
+     * @param query - The SQL query to execute.
+     * @param schema - The entity schema.
+     * @returns A list of mapped entity objects.
+     */
+    executeSchemaSQLOnlyOne<T extends object>(query: string, schema: EntitySchema<T>): Promise<T | undefined>;
     /**
      * Executes a raw SQL query and returns the results.
      * @param query - The raw SQL query.
@@ -45,9 +58,10 @@ export interface SchemaSqlForgeSql {
     /**
      * Executes a raw SQL update query.
      * @param query - The raw SQL update query.
+     * @param params - Sql parameters.
      * @returns The update response containing affected rows.
      */
-    executeRawUpdateSQL(query: string): Promise<UpdateQueryResponse>;
+    executeRawUpdateSQL(query: string, params?: SqlParameters[]): Promise<UpdateQueryResponse>;
 }
 /**
  * Interface for CRUD (Create, Read, Update, Delete) operations.
@@ -70,10 +84,41 @@ export interface CRUDForgeSQL {
     deleteById<T extends object>(id: unknown, schema: EntitySchema<T>): Promise<number>;
     /**
      * Updates a record by its ID.
+     *   * If a version field is defined in the schema, versioning is applied:
+     *    * the current record version is retrieved, checked for concurrent modifications,
+     *    * and then incremented.
+     *    *
+     *    * @param entity - The entity with updated values.
+     *    * @param schema - The entity schema.
+     *    * @throws If the primary key is not included in the update fields.
+     *    */
+    updateById<T extends object>(entity: Partial<T>, schema: EntitySchema<T>): Promise<void>;
+    /**
+     * Updates specified fields of records based on provided conditions.
+     * If the "where" parameter is not provided, the WHERE clause is built from the entity fields
+     * that are not included in the list of fields to update.
+     *
+     * @param entity - The object containing values to update and potential criteria for filtering.
+     * @param fields - Array of field names to update.
+     * @param schema - The entity schema.
+     * @param where - Optional filtering conditions for the WHERE clause.
+     * @returns The number of affected rows.
+     * @throws If no filtering criteria are provided (either via "where" or from the remaining entity fields).
+     */
+    updateFields<T extends object>(entity: Partial<T>, fields: EntityKey<T>[], schema: EntitySchema<T>, where?: QBFilterQuery<T>): Promise<number>;
+    /**
+     * Updates specific fields of a record identified by its primary key.
+     *
+     * If a version field is defined in the schema, versioning is applied:
+     * the current record version is retrieved, checked for concurrent modifications,
+     * and then incremented.
+     *
      * @param entity - The entity with updated values.
+     * @param fields - The list of field names to update.
      * @param schema - The entity schema.
+     * @throws If the primary key is not included in the update fields.
      */
-    updateById<T extends object>(entity: T, schema: EntitySchema<T>): Promise<void>;
+    updateFieldById<T extends object>(entity: T, fields: EntityKey<T>[], schema: EntitySchema<T>): Promise<void>;
 }
 /**
  * Interface for Query Builder operations.
@@ -88,7 +133,7 @@ export interface QueryBuilderForgeSql {
      */
     createQueryBuilder<Entity extends object, RootAlias extends string = never>(entityName: EntityName<Entity> | QueryBuilder<Entity>, alias?: RootAlias, loggerContext?: LoggingOptions): QueryBuilder<Entity, RootAlias>;
     /**
-     * Provides access to the underlying Knex instance for executing raw queries and building complex query parts.
+     * Provides access to the underlying Knex instance for building complex query parts.
      * enabling advanced query customization and performance tuning.
      * @returns The Knex instance, which can be used for query building.
      */

package/dist/core/ForgeSQLQueryBuilder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ForgeSQLQueryBuilder.d.ts","sourceRoot":"","sources":["../../src/core/ForgeSQLQueryBuilder.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,IAAI,CAAC;AACrD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uCAAuC,CAAC;AAC1E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAEjC;;GAEG;AACH,MAAM,WAAW,iBAAkB,SAAQ,oBAAoB;IAC7D;;OAEG;IACH,IAAI,IAAI,YAAY,CAAC;IAErB;;OAEG;IACH,KAAK,IAAI,iBAAiB,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC;;OAEG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC;;;;;OAKG;IACH,gBAAgB,CAAC,CAAC,SAAS,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC;IAEzF;;;;OAIG;IACH,aAAa,CAAC,CAAC,SAAS,MAAM,GAAG,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC;IAEvE;;;;OAIG;IACH,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC;CAClE;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B;;;;;;OAMG;IACH,MAAM,CAAC,CAAC,SAAS,MAAM,EACrB,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC,EACvB,MAAM,EAAE,CAAC,EAAE,EACX,cAAc,CAAC,EAAE,OAAO,GACvB,OAAO,CAAC,MAAM,CAAC,CAAC;IAEnB;;;;;OAKG;IACH,UAAU,CAAC,CAAC,SAAS,MAAM,EAAE,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAEpF;;;;OAIG;IACH,UAAU,CAAC,CAAC,SAAS,MAAM,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACjF;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC;;;;;;OAMG;IACH,kBAAkB,CAAC,MAAM,SAAS,MAAM,EAAE,SAAS,SAAS,MAAM,GAAG,KAAK,EACxE,UAAU,EAAE,UAAU,CAAC,MAAM,CAAC,GAAG,YAAY,CAAC,MAAM,CAAC,EACrD,KAAK,CAAC,EAAE,SAAS,EACjB,aAAa,CAAC,EAAE,cAAc,GAC7B,YAAY,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IAEnC;;;;OAIG;IACH,OAAO,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC;CAC7B"}
+{"version":3,"file":"ForgeSQLQueryBuilder.d.ts","sourceRoot":"","sources":["../../src/core/ForgeSQLQueryBuilder.ts"],"names":[],"mappings":"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"}

package/dist/core/ForgeSQLSelectOperations.d.ts

@@ -1,9 +1,11 @@
 import { UpdateQueryResponse } from "@forge/sql";
 import type { EntitySchema } from "@mikro-orm/core/metadata/EntitySchema";
 import { ForgeSqlOrmOptions, SchemaSqlForgeSql } from "./ForgeSQLQueryBuilder";
+import { SqlParameters } from "@forge/sql/out/sql-statement";
 export declare class ForgeSQLSelectOperations implements SchemaSqlForgeSql {
     private readonly options;
     constructor(options: ForgeSqlOrmOptions);
+    executeSchemaSQLOnlyOne<T extends object>(query: string, schema: EntitySchema<T>): Promise<T | undefined>;
     /**
      * Executes a schema-based SQL query and maps the result to the entity schema.
      * @param query - The SQL query to execute.
@@ -20,8 +22,9 @@ export declare class ForgeSQLSelectOperations implements SchemaSqlForgeSql {
     /**
      * Executes a raw SQL update query.
      * @param query - The raw SQL update query.
+     * @param params - sql parameters.
      * @returns The update response containing affected rows.
      */
-    executeRawUpdateSQL(query: string): Promise<UpdateQueryResponse>;
+    executeRawUpdateSQL(query: string, params?: SqlParameters[]): Promise<UpdateQueryResponse>;
 }
 //# sourceMappingURL=ForgeSQLSelectOperations.d.ts.map

package/dist/core/ForgeSQLSelectOperations.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ForgeSQLSelectOperations.d.ts","sourceRoot":"","sources":["../../src/core/ForgeSQLSelectOperations.ts"],"names":[],"mappings":"AAAA,OAAO,EAAO,mBAAmB,EAAE,MAAM,YAAY,CAAC;AACtD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uCAAuC,CAAC;AAE1E,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAE/E,qBAAa,wBAAyB,YAAW,iBAAiB;IAChE,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAqB;gBAEjC,OAAO,EAAE,kBAAkB;IAIvC;;;;;OAKG;IACG,gBAAgB,CAAC,CAAC,SAAS,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC;IAoC9F;;;;OAIG;IACG,aAAa,CAAC,CAAC,SAAS,MAAM,GAAG,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC;IAQ5E;;;;OAIG;IACG,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC;CAQvE"}
+{"version":3,"file":"ForgeSQLSelectOperations.d.ts","sourceRoot":"","sources":["../../src/core/ForgeSQLSelectOperations.ts"],"names":[],"mappings":"AAAA,OAAO,EAAO,mBAAmB,EAAE,MAAM,YAAY,CAAC;AACtD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uCAAuC,CAAC;AAE1E,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC/E,OAAO,EAAC,aAAa,EAAC,MAAM,8BAA8B,CAAC;AAE3D,qBAAa,wBAAyB,YAAW,iBAAiB;IAChE,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAqB;gBAEjC,OAAO,EAAE,kBAAkB;IAIjC,uBAAuB,CAAC,CAAC,SAAS,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,GAAC,SAAS,CAAC;IAW7G;;;;;OAKG;IACG,gBAAgB,CAAC,CAAC,SAAS,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC;IAoC9F;;;;OAIG;IACG,aAAa,CAAC,CAAC,SAAS,MAAM,GAAG,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC;IAQ5E;;;;;OAKG;IACG,mBAAmB,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,aAAa,EAAE,GAAG,OAAO,CAAC,mBAAmB,CAAC;CAQjG"}

package/dist/utils/sqlUtils.d.ts

@@ -1,8 +1,8 @@
 import { types } from "@mikro-orm/core/types";
 import { AnyString } from "@mikro-orm/core/typings";
-export declare const transformValue: (value: {
+export declare const transformValue: <U>(value: {
     type: keyof typeof types | AnyString;
-    value: unknown;
-}) => unknown;
+    value: U;
+}, wrapValue?: boolean) => U;
 export declare const parseDateTime: (value: string, format: string) => Date;
 //# sourceMappingURL=sqlUtils.d.ts.map

package/dist/utils/sqlUtils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sqlUtils.d.ts","sourceRoot":"","sources":["../../src/utils/sqlUtils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAC;AAE9C,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAEpD,eAAO,MAAM,cAAc,GAAI,OAAO;IACpC,IAAI,EAAE,MAAM,OAAO,KAAK,GAAG,SAAS,CAAC;IACrC,KAAK,EAAE,OAAO,CAAC;CAChB,KAAG,OAcH,CAAC;AACF,eAAO,MAAM,aAAa,GAAI,OAAO,MAAM,EAAE,QAAQ,MAAM,KAAG,IAE7D,CAAC"}
+{"version":3,"file":"sqlUtils.d.ts","sourceRoot":"","sources":["../../src/utils/sqlUtils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAC;AAE9C,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAMpD,eAAO,MAAM,cAAc,GAAI,CAAC,EAAE,OAAO;IACvC,IAAI,EAAE,MAAM,OAAO,KAAK,GAAG,SAAS,CAAC;IACrC,KAAK,EAAE,CAAC,CAAC;CACV,EAAE,YAAW,OAAe,KAAG,CAc/B,CAAC;AAEF,eAAO,MAAM,aAAa,GAAI,OAAO,MAAM,EAAE,QAAQ,MAAM,KAAG,IAM7D,CAAC"}