forge-sql-orm 1.0.31 → 2.0.0

package/dist/core/ForgeSQLQueryBuilder.d.ts

@@ -1,164 +1,328 @@
 import { UpdateQueryResponse } from "@forge/sql";
-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, EntityProperty } from "@mikro-orm/core";
 import { SqlParameters } from "@forge/sql/out/sql-statement";
-import { DynamicEntity } from "./ComplexQuerySchemaBuilder";
+import { MySql2Database } from "drizzle-orm/mysql2/driver";
+import { AnyMySqlSelectQueryBuilder, AnyMySqlTable } from "drizzle-orm/mysql-core";
+import { MySqlSelectDynamic } from "drizzle-orm/mysql-core/query-builders/select.types";
+import { InferInsertModel, SQL } from "drizzle-orm";
 /**
  * Interface representing the main ForgeSQL operations.
+ * Provides access to CRUD operations and schema-level SQL operations.
  */
 export interface ForgeSqlOperation extends QueryBuilderForgeSql {
     /**
-     * Provides CRUD operations.
+     * Provides CRUD (Create, Read, Update, Delete) operations.
+     * @returns {CRUDForgeSQL} Interface for performing CRUD operations
      */
     crud(): CRUDForgeSQL;
     /**
      * Provides schema-level SQL fetch operations.
+     * @returns {SchemaSqlForgeSql} Interface for executing schema-bound SQL queries
      */
     fetch(): SchemaSqlForgeSql;
 }
 /**
- * Options for configuring ForgeSQL ORM behavior.
+ * Interface for Query Builder operations.
+ * Provides access to the underlying Drizzle ORM query builder.
  */
-export interface ForgeSqlOrmOptions {
-    /**
-     * Enables logging of raw SQL queries in the Atlassian Forge Developer Console.
-     */
-    logRawSqlQuery?: boolean;
+export interface QueryBuilderForgeSql {
     /**
-     * Disable optimistic locking
+     * Creates a new query builder for the given entity.
+     * @returns {MySql2Database<Record<string, unknown>>} The Drizzle database instance for building queries
      */
-    disableOptimisticLocking?: boolean;
+    getDrizzleQueryBuilder(): MySql2Database<Record<string, unknown>>;
 }
 /**
- * Interface for schema-level SQL operations.
+ * Interface for CRUD (Create, Read, Update, Delete) operations.
+ * Provides methods for basic database operations with support for optimistic locking.
  */
-export interface SchemaSqlForgeSql {
-    /**
-     * Executes a schema-bound SQL query and maps the 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.
-     */
-    executeSchemaSQL<T extends object>(query: string, schema: EntitySchema<T>): Promise<T[]>;
+export interface CRUDForgeSQL {
     /**
-     * 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.
+     * Inserts multiple records into the database.
+     * @template T - The type of the table schema
+     * @param {T} schema - The entity schema
+     * @param {Partial<InferInsertModel<T>>[]} models - The list of entities to insert
+     * @param {boolean} [updateIfExists] - Whether to update the row if it already exists (default: false)
+     * @returns {Promise<number>} The number of inserted rows
+     * @throws {Error} If the insert operation fails
      */
-    executeSchemaSQLOnlyOne<T extends object>(query: string, schema: EntitySchema<T>): Promise<T | undefined>;
+    insert<T extends AnyMySqlTable>(schema: T, models: Partial<InferInsertModel<T>>[], updateIfExists?: boolean): Promise<number>;
     /**
-     * Executes a raw SQL query and returns the results.
-     * @param query - The raw SQL query.
-     * @returns A list of results as objects.
+     * Deletes a record by its ID.
+     * @template T - The type of the table schema
+     * @param {unknown} id - The ID of the record to delete
+     * @param {T} schema - The entity schema
+     * @returns {Promise<number>} The number of rows affected
+     * @throws {Error} If the delete operation fails
      */
-    executeRawSQL<T extends object | unknown>(query: string): Promise<T[]>;
+    deleteById<T extends AnyMySqlTable>(id: unknown, schema: T): Promise<number>;
     /**
-     * Executes a raw SQL update query.
-     * @param query - The raw SQL update query.
-     * @param params - Sql parameters.
-     * @returns The update response containing affected rows.
+     * Updates a record by its ID with optimistic locking support.
+     * 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
+     *
+     * @template T - The type of the table schema
+     * @param {Partial<InferInsertModel<T>>} entity - The entity with updated values
+     * @param {T} schema - The entity schema
+     * @returns {Promise<number>} The number of rows affected
+     * @throws {Error} If the primary key is not included in the update fields
+     * @throws {Error} If optimistic locking check fails
      */
-    executeRawUpdateSQL(query: string, params?: SqlParameters[]): Promise<UpdateQueryResponse>;
+    updateById<T extends AnyMySqlTable>(entity: Partial<InferInsertModel<T>>, schema: T): Promise<number>;
     /**
-     * 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.
+     * 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.
+     *
+     * @template T - The type of the table schema
+     * @param {Partial<InferInsertModel<T>>} updateData - The object containing values to update
+     * @param {T} schema - The entity schema
+     * @param {SQL<unknown>} [where] - Optional filtering conditions for the WHERE clause
+     * @returns {Promise<number>} The number of affected rows
+     * @throws {Error} If no filtering criteria are provided
+     * @throws {Error} If the update operation fails
      */
-    createComplexQuerySchema(): ComplexQuerySchemaBuilder<DynamicEntity>;
+    updateFields<T extends AnyMySqlTable>(updateData: Partial<InferInsertModel<T>>, schema: T, where?: SQL<unknown>): Promise<number>;
 }
 /**
- * Interface for CRUD (Create, Read, Update, Delete) operations.
+ * Interface for schema-level SQL operations.
+ * Provides methods for executing SQL queries with schema binding and type safety.
  */
-export interface CRUDForgeSQL {
+export interface SchemaSqlForgeSql {
     /**
-     * Inserts multiple records into the database.
-     * @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 The number of inserted rows.
+     * Executes a Drizzle query and returns the result.
+     * @template T - The type of the query builder
+     * @param {T} query - The Drizzle query to execute
+     * @returns {Promise<Awaited<T>>} The query result
+     * @throws {Error} If the query execution fails
      */
-    insert<T extends object>(schema: EntitySchema<T>, models: T[], updateIfExists?: boolean): Promise<number>;
+    executeQuery<T extends MySqlSelectDynamic<AnyMySqlSelectQueryBuilder>>(query: T): Promise<Awaited<T>>;
     /**
-     * Deletes a record by its ID.
-     * @param id - The ID of the record to delete.
-     * @param schema - The entity schema.
-     * @returns The number of rows affected.
+     * Executes a Drizzle query and returns a single result.
+     * @template T - The type of the query builder
+     * @param {T} query - The Drizzle query to execute
+     * @returns {Promise<Awaited<T> extends Array<any> ? Awaited<T>[number] | undefined : Awaited<T> | undefined>} A single result object or undefined
+     * @throws {Error} If more than one record is returned
+     * @throws {Error} If the query execution fails
      */
-    deleteById<T extends object>(id: unknown, schema: EntitySchema<T>): Promise<number>;
+    executeQueryOnlyOne<T extends MySqlSelectDynamic<AnyMySqlSelectQueryBuilder>>(query: T): Promise<Awaited<T> extends Array<any> ? Awaited<T>[number] | undefined : Awaited<T> | undefined>;
     /**
-     * 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).
+     * Executes a raw SQL query and returns the results.
+     * @template T - The type of the result objects
+     * @param {string} query - The raw SQL query
+     * @param {SqlParameters[]} [params] - Optional SQL parameters
+     * @returns {Promise<T[]>} A list of results as objects
+     * @throws {Error} If the query execution fails
      */
-    updateFields<T extends object>(entity: Partial<T>, fields: EntityKey<T>[], schema: EntitySchema<T>, where?: QBFilterQuery<T>): Promise<number>;
+    executeRawSQL<T extends object | unknown>(query: string, params?: SqlParameters[]): Promise<T[]>;
     /**
-     * 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.
+     * Executes a raw SQL update query.
+     * @param {string} query - The raw SQL update query
+     * @param {SqlParameters[]} [params] - Optional SQL parameters
+     * @returns {Promise<UpdateQueryResponse>} The update response containing affected rows
+     * @throws {Error} If the update operation fails
      */
-    updateFieldById<T extends object>(entity: T, fields: EntityKey<T>[], schema: EntitySchema<T>): Promise<void>;
+    executeRawUpdateSQL(query: string, params?: unknown[]): Promise<UpdateQueryResponse>;
 }
 /**
- * Interface for Query Builder operations.
+ * Interface for version field metadata.
+ * Defines the configuration for optimistic locking version fields.
  */
-export interface QueryBuilderForgeSql {
+export interface VersionFieldMetadata {
+    /** Name of the version field */
+    fieldName: string;
+}
+/**
+ * Interface for table metadata.
+ * Defines the configuration for a specific table.
+ */
+export interface TableMetadata {
+    /** Name of the table */
+    tableName: string;
+    /** Version field configuration for optimistic locking */
+    versionField: VersionFieldMetadata;
+}
+/**
+ * Type for additional metadata configuration.
+ * Maps table names to their metadata configuration.
+ */
+export type AdditionalMetadata = Record<string, TableMetadata>;
+/**
+ * Options for configuring ForgeSQL ORM behavior.
+ */
+export interface ForgeSqlOrmOptions {
     /**
-     * Creates a new query builder for the given entity.
-     * @param entityName - The entity name or an existing query builder.
-     * @param alias - The alias for the entity.
-     * @param loggerContext - Logging options.
-     * @returns The query builder instance.
+     * Enables logging of raw SQL queries in the Atlassian Forge Developer Console.
+     * Useful for debugging and monitoring SQL operations.
+     * @default false
      */
-    createQueryBuilder<Entity extends object, RootAlias extends string = never>(entityName: EntityName<Entity> | QueryBuilder<Entity>, alias?: RootAlias, loggerContext?: LoggingOptions): QueryBuilder<Entity, RootAlias>;
+    logRawSqlQuery?: boolean;
     /**
-     * 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.
+     * Enables logging of raw SQL queries in the Atlassian Forge Developer Console.
+     * Useful for debugging and monitoring SQL operations.
+     * @default false
      */
-    getKnex(): Knex<any, any[]>;
-}
-export interface ComplexQuerySchemaBuilder<T> {
+    logRawSqlQueryParams?: boolean;
     /**
-     * Adds a field from an entity schema to the builder.
-     * @param field - The entity property to be added.
-     * @param alias - (Optional) Alias for the field name.
-     * @returns The updated instance of the builder.
+     * Disables optimistic locking for all operations.
+     * When enabled, version checks are skipped during updates.
+     * @default false
      */
-    addField<K>(field: Partial<EntityProperty<K>>, alias?: string): this;
+    disableOptimisticLocking?: boolean;
     /**
-     * Creates and returns a new entity schema based on the added fields.
-     * @returns A new EntitySchema<T> instance.
+     * Additional metadata for table configuration.
+     * Allows specifying table-specific settings and behaviors.
+     * @example
+     * ```typescript
+     * {
+     *   users: {
+     *     tableName: "users",
+     *     versionField: {
+     *       fieldName: "updatedAt",
+     *       type: "datetime",
+     *       nullable: false
+     *     }
+     *   }
+     * }
+     * ```
      */
-    createSchema(): EntitySchema<T>;
+    additionalMetadata?: AdditionalMetadata;
 }
+/**
+ * Custom type for MySQL datetime fields.
+ * Handles conversion between JavaScript Date objects and MySQL datetime strings.
+ */
+export declare const mySqlDateTimeString: {
+    (): import("drizzle-orm/mysql-core").MySqlCustomColumnBuilder<{
+        name: "";
+        dataType: "custom";
+        columnType: "MySqlCustomColumn";
+        data: Date;
+        driverParam: unknown;
+        enumValues: undefined;
+    }>;
+    <TConfig extends Record<string, any> & {
+        format?: string;
+    }>(fieldConfig?: TConfig | undefined): import("drizzle-orm/mysql-core").MySqlCustomColumnBuilder<{
+        name: "";
+        dataType: "custom";
+        columnType: "MySqlCustomColumn";
+        data: Date;
+        driverParam: unknown;
+        enumValues: undefined;
+    }>;
+    <TName extends string>(dbName: TName, fieldConfig?: {
+        format?: string;
+    } | undefined): import("drizzle-orm/mysql-core").MySqlCustomColumnBuilder<{
+        name: TName;
+        dataType: "custom";
+        columnType: "MySqlCustomColumn";
+        data: Date;
+        driverParam: unknown;
+        enumValues: undefined;
+    }>;
+};
+/**
+ * Custom type for MySQL timestamp fields.
+ * Handles conversion between JavaScript Date objects and MySQL timestamp strings.
+ */
+export declare const mySqlTimestampString: {
+    (): import("drizzle-orm/mysql-core").MySqlCustomColumnBuilder<{
+        name: "";
+        dataType: "custom";
+        columnType: "MySqlCustomColumn";
+        data: Date;
+        driverParam: unknown;
+        enumValues: undefined;
+    }>;
+    <TConfig extends Record<string, any> & {
+        format?: string;
+    }>(fieldConfig?: TConfig | undefined): import("drizzle-orm/mysql-core").MySqlCustomColumnBuilder<{
+        name: "";
+        dataType: "custom";
+        columnType: "MySqlCustomColumn";
+        data: Date;
+        driverParam: unknown;
+        enumValues: undefined;
+    }>;
+    <TName extends string>(dbName: TName, fieldConfig?: {
+        format?: string;
+    } | undefined): import("drizzle-orm/mysql-core").MySqlCustomColumnBuilder<{
+        name: TName;
+        dataType: "custom";
+        columnType: "MySqlCustomColumn";
+        data: Date;
+        driverParam: unknown;
+        enumValues: undefined;
+    }>;
+};
+/**
+ * Custom type for MySQL date fields.
+ * Handles conversion between JavaScript Date objects and MySQL date strings.
+ */
+export declare const mySqlDateString: {
+    (): import("drizzle-orm/mysql-core").MySqlCustomColumnBuilder<{
+        name: "";
+        dataType: "custom";
+        columnType: "MySqlCustomColumn";
+        data: Date;
+        driverParam: unknown;
+        enumValues: undefined;
+    }>;
+    <TConfig extends Record<string, any> & {
+        format?: string;
+    }>(fieldConfig?: TConfig | undefined): import("drizzle-orm/mysql-core").MySqlCustomColumnBuilder<{
+        name: "";
+        dataType: "custom";
+        columnType: "MySqlCustomColumn";
+        data: Date;
+        driverParam: unknown;
+        enumValues: undefined;
+    }>;
+    <TName extends string>(dbName: TName, fieldConfig?: {
+        format?: string;
+    } | undefined): import("drizzle-orm/mysql-core").MySqlCustomColumnBuilder<{
+        name: TName;
+        dataType: "custom";
+        columnType: "MySqlCustomColumn";
+        data: Date;
+        driverParam: unknown;
+        enumValues: undefined;
+    }>;
+};
+/**
+ * Custom type for MySQL time fields.
+ * Handles conversion between JavaScript Date objects and MySQL time strings.
+ */
+export declare const mySqlTimeString: {
+    (): import("drizzle-orm/mysql-core").MySqlCustomColumnBuilder<{
+        name: "";
+        dataType: "custom";
+        columnType: "MySqlCustomColumn";
+        data: Date;
+        driverParam: unknown;
+        enumValues: undefined;
+    }>;
+    <TConfig extends Record<string, any> & {
+        format?: string;
+    }>(fieldConfig?: TConfig | undefined): import("drizzle-orm/mysql-core").MySqlCustomColumnBuilder<{
+        name: "";
+        dataType: "custom";
+        columnType: "MySqlCustomColumn";
+        data: Date;
+        driverParam: unknown;
+        enumValues: undefined;
+    }>;
+    <TName extends string>(dbName: TName, fieldConfig?: {
+        format?: string;
+    } | undefined): import("drizzle-orm/mysql-core").MySqlCustomColumnBuilder<{
+        name: TName;
+        dataType: "custom";
+        columnType: "MySqlCustomColumn";
+        data: Date;
+        driverParam: unknown;
+        enumValues: undefined;
+    }>;
+};
 //# sourceMappingURL=ForgeSQLQueryBuilder.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"ForgeSQLQueryBuilder.d.ts","sourceRoot":"","sources":["../../src/core/ForgeSQLQueryBuilder.ts"],"names":[],"mappings":"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"}
+{"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,38 +1,81 @@
 import { UpdateQueryResponse } from "@forge/sql";
-import type { EntitySchema } from "@mikro-orm/core/metadata/EntitySchema";
-import { ComplexQuerySchemaBuilder, ForgeSqlOrmOptions, SchemaSqlForgeSql } from "./ForgeSQLQueryBuilder";
-import { SqlParameters } from "@forge/sql/out/sql-statement";
-import { DynamicEntity } from "./ComplexQuerySchemaBuilder";
+import { ForgeSqlOrmOptions, SchemaSqlForgeSql } from "./ForgeSQLQueryBuilder";
+import { AnyMySqlSelectQueryBuilder, MySqlSelectDynamic } from "drizzle-orm/mysql-core/query-builders/select.types";
+/**
+ * Class implementing SQL select operations for ForgeSQL ORM.
+ * Provides methods for executing queries and mapping results to entity types.
+ */
 export declare class ForgeSQLSelectOperations implements SchemaSqlForgeSql {
     private readonly options;
+    /**
+     * Creates a new instance of ForgeSQLSelectOperations.
+     * @param {ForgeSqlOrmOptions} options - Configuration options for the ORM
+     */
     constructor(options: ForgeSqlOrmOptions);
     /**
-     * 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.
+     * Executes a Drizzle query and returns the results.
+     * Maps the raw database results to the appropriate entity types.
+     *
+     * @template T - The type of the query builder
+     * @param {T} query - The Drizzle query to execute
+     * @returns {Promise<Awaited<T>>} The query results mapped to entity types
+     */
+    executeQuery<T extends MySqlSelectDynamic<AnyMySqlSelectQueryBuilder>>(query: T): Promise<Awaited<T>>;
+    /**
+     * Extracts column information and alias name from a column definition.
+     * @param {any} column - The column definition from Drizzle
+     * @returns {Object} Object containing the real column and its alias name
+     */
+    private extractColumnInfo;
+    /**
+     * Finds the alias chunk in SQL query chunks.
+     * @param {SQL} realColumnSql - The SQL query chunks
+     * @returns {StringChunk | undefined} The string chunk containing the alias or undefined
+     */
+    private findAliasChunk;
+    /**
+     * Resolves the alias name from the string chunk or column.
+     * @param {StringChunk | undefined} stringChunk - The string chunk containing the alias
+     * @param {Column | undefined} realColumn - The real column definition
+     * @param {boolean} withoutAlias - Whether the column has no alias
+     * @returns {string} The resolved alias name
+     */
+    private resolveAliasName;
+    /**
+     * Parses a column value based on its SQL type.
+     * Handles datetime, date, and time types with appropriate formatting.
+     *
+     * @param {Column} column - The column definition
+     * @param {unknown} value - The raw value to parse
+     * @returns {unknown} The parsed value
      */
-    createComplexQuerySchema(): ComplexQuerySchemaBuilder<DynamicEntity>;
-    executeSchemaSQLOnlyOne<T extends object>(query: string, schema: EntitySchema<T>): Promise<T | undefined>;
+    private parseColumnValue;
     /**
-     * Executes a schema-based SQL query and maps the result to the entity schema.
-     * @param query - The SQL query to execute.
-     * @param schema - The entity schema defining the structure.
-     * @returns A list of mapped entity objects.
+     * Executes a Drizzle query and returns a single result.
+     * Throws an error if more than one record is returned.
+     *
+     * @template T - The type of the query builder
+     * @param {T} query - The Drizzle query to execute
+     * @returns {Promise<Awaited<T> extends Array<any> ? Awaited<T>[number] | undefined : Awaited<T> | undefined>} A single result object or undefined
+     * @throws {Error} If more than one record is returned
      */
-    executeSchemaSQL<T extends object>(query: string, schema: EntitySchema<T>): Promise<T[]>;
+    executeQueryOnlyOne<T extends MySqlSelectDynamic<AnyMySqlSelectQueryBuilder>>(query: T): Promise<Awaited<T> extends Array<any> ? Awaited<T>[number] | undefined : Awaited<T> | undefined>;
     /**
      * Executes a raw SQL query and returns the results.
-     * @param query - The raw SQL query to execute.
-     * @returns A list of results as objects.
+     * Logs the query if logging is enabled.
+     *
+     * @template T - The type of the result objects
+     * @param {string} query - The raw SQL query to execute
+     * @param {SqlParameters[]} [params] - Optional SQL parameters
+     * @returns {Promise<T[]>} A list of results as objects
      */
-    executeRawSQL<T extends object | unknown>(query: string): Promise<T[]>;
+    executeRawSQL<T extends object | unknown>(query: string, params?: unknown[]): Promise<T[]>;
     /**
      * Executes a raw SQL update query.
-     * @param query - The raw SQL update query.
-     * @param params - sql parameters.
-     * @returns The update response containing affected rows.
+     * @param {string} query - The raw SQL update query
+     * @param {SqlParameters[]} [params] - Optional SQL parameters
+     * @returns {Promise<UpdateQueryResponse>} The update response containing affected rows
      */
-    executeRawUpdateSQL(query: string, params?: SqlParameters[]): Promise<UpdateQueryResponse>;
+    executeRawUpdateSQL(query: string, params?: unknown[]): 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,yBAAyB,EAAE,kBAAkB,EAAE,iBAAiB,EAAC,MAAM,wBAAwB,CAAC;AACzG,OAAO,EAAC,aAAa,EAAC,MAAM,8BAA8B,CAAC;AAC3D,OAAO,EAAC,aAAa,EAA6B,MAAM,6BAA6B,CAAC;AAGtF,qBAAa,wBAAyB,YAAW,iBAAiB;IAC9D,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAqB;gBAEjC,OAAO,EAAE,kBAAkB;IAIvC;;;;;OAKG;IACH,wBAAwB,IAAI,yBAAyB,CAAC,aAAa,CAAC;IAIhE,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;IAmC9F;;;;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"}
+{"version":3,"file":"ForgeSQLSelectOperations.d.ts","sourceRoot":"","sources":["../../src/core/ForgeSQLSelectOperations.ts"],"names":[],"mappings":"AAAA,OAAO,EAAO,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEtD,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAE/E,OAAO,EACL,0BAA0B,EAC1B,kBAAkB,EACnB,MAAM,oDAAoD,CAAC;AAG5D;;;GAGG;AACH,qBAAa,wBAAyB,YAAW,iBAAiB;IAChE,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAqB;IAE7C;;;OAGG;gBACS,OAAO,EAAE,kBAAkB;IAIvC;;;;;;;OAOG;IACG,YAAY,CAAC,CAAC,SAAS,kBAAkB,CAAC,0BAA0B,CAAC,EACzE,KAAK,EAAE,CAAC,GACP,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;IA8BtB;;;;OAIG;IACH,OAAO,CAAC,iBAAiB;IAyBzB;;;;OAIG;IACH,OAAO,CAAC,cAAc;IAQtB;;;;;;OAMG;IACH,OAAO,CAAC,gBAAgB;IAexB;;;;;;;OAOG;IACH,OAAO,CAAC,gBAAgB;IAexB;;;;;;;;OAQG;IACG,mBAAmB,CAAC,CAAC,SAAS,kBAAkB,CAAC,0BAA0B,CAAC,EAChF,KAAK,EAAE,CAAC,GACP,OAAO,CACR,OAAO,CAAC,CAAC,CAAC,SAAS,KAAK,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,SAAS,GAAG,OAAO,CAAC,CAAC,CAAC,GAAG,SAAS,CACxF;IAaD;;;;;;;;OAQG;IACG,aAAa,CAAC,CAAC,SAAS,MAAM,GAAG,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC;IAehG;;;;;OAKG;IACG,mBAAmB,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,mBAAmB,CAAC;CAQ3F"}

package/dist/core/SystemTables.d.ts

@@ -0,0 +1,59 @@
+export declare const migrations: import("drizzle-orm/mysql-core/table").MySqlTableWithColumns<{
+    name: "__migrations";
+    schema: undefined;
+    columns: {
+        id: import("drizzle-orm/mysql-core/index").MySqlColumn<{
+            name: "id";
+            tableName: "__migrations";
+            dataType: "number";
+            columnType: "MySqlInt";
+            data: number;
+            driverParam: string | number;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: true;
+            isAutoincrement: true;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        name: import("drizzle-orm/mysql-core/index").MySqlColumn<{
+            name: "name";
+            tableName: "__migrations";
+            dataType: "string";
+            columnType: "MySqlVarChar";
+            data: string;
+            driverParam: string | number;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        created_at: import("drizzle-orm/mysql-core/index").MySqlColumn<{
+            name: "created_at";
+            tableName: "__migrations";
+            dataType: "date";
+            columnType: "MySqlTimestamp";
+            data: Date;
+            driverParam: string | number;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+    };
+    dialect: "mysql";
+}>;
+//# sourceMappingURL=SystemTables.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"SystemTables.d.ts","sourceRoot":"","sources":["../../src/core/SystemTables.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAIrB,CAAC"}