arkormx 1.3.4 → 2.0.0-next.0

package/dist/index.d.mts

@@ -1,19 +1,258 @@
+import { Kysely, Transaction } from "kysely";
 import { Command } from "@h3ravel/musket";
 import { Collection } from "@h3ravel/collect.js";
 import { PrismaClient } from "@prisma/client";
 
-//#region src/Attribute.d.ts
-interface AttributeOptions<TGet = unknown, TSet = unknown> {
-  get?: (value: unknown) => TGet;
-  set?: (value: TSet) => unknown;
+//#region src/types/core.d.ts
+type CastType = 'string' | 'number' | 'boolean' | 'date' | 'json' | 'array';
+interface CastHandler<T = unknown> {
+  get: (value: unknown) => T;
+  set: (value: unknown) => unknown;
 }
-declare class Attribute<TGet = unknown, TSet = unknown> {
-  readonly get?: (value: unknown) => TGet;
-  readonly set?: (value: TSet) => unknown;
-  constructor(options?: AttributeOptions<TGet, TSet>);
-  static make<TGet = unknown, TSet = unknown>(options: AttributeOptions<TGet, TSet>): Attribute<TGet, TSet>;
-  static isAttribute(value: unknown): value is Attribute;
+type CastDefinition = CastType | CastHandler;
+type CastMap = Record<string, CastDefinition>;
+type PrismaClientLike = PrismaClient | Record<string, unknown>;
+interface PrismaTransactionOptions {
+  maxWait?: number;
+  timeout?: number;
+  isolationLevel?: string;
+}
+type PrismaTransactionCallback<TResult = unknown> = (client: PrismaClientLike) => TResult | Promise<TResult>;
+interface PrismaTransactionCapableClient {
+  $transaction: <TResult>(callback: PrismaTransactionCallback<TResult>, options?: PrismaTransactionOptions) => Promise<TResult>;
+}
+type ClientResolver = PrismaClientLike | (() => PrismaClientLike);
+interface ArkormConfig {
+  /**
+   * @property prisma A Prisma client instance or a function that returns a Prisma client instance.
+   */
+  prisma: ClientResolver;
+  /**
+   * @property pagination Configuration options related to pagination behavior and URL generation.
+   */
+  pagination?: {
+    urlDriver?: PaginationURLDriverFactory;
+    resolveCurrentPage?: PaginationCurrentPageResolver;
+  };
+  /**
+   * @property paths Optional custom paths for various generated files.
+   */
+  paths?: {
+    /**
+     * @property stubs Optional custom path for stub files used in code generation.
+     */
+    stubs?: string;
+    /**
+     * @property seeders Optional custom path for seeder files.
+     */
+    seeders?: string;
+    /**
+     * @property models Optional custom path for model files.
+     */
+    models?: string;
+    /**
+     * @property migrations Optional custom path for migration files.
+     */
+    migrations?: string;
+    /**
+     * @property factories Optional custom path for factory files.
+     */
+    factories?: string;
+    /**
+     * @property buildOutput Optional custom path for the development output directory.
+     */
+    buildOutput?: string;
+  };
+  /**
+   * @property outputExt Optional file extension for generated files, either 'ts' or 'js'.
+   */
+  outputExt?: 'ts' | 'js';
 }
+interface GetUserConfig {
+  /**
+   * Get the user-provided ArkORM configuration.
+   */
+  (): Partial<ArkormConfig>;
+  /**
+   * Get a specific user configuration value
+   * @param key Optional specific configuration key to retrieve
+   */
+  <K extends keyof ArkormConfig>(key: K): Partial<ArkormConfig>[K];
+}
+interface PaginationMeta {
+  total: number;
+  perPage: number;
+  currentPage: number;
+  lastPage: number;
+  from: number | null;
+  to: number | null;
+}
+interface SimplePaginationMeta {
+  perPage: number;
+  currentPage: number;
+  from: number | null;
+  to: number | null;
+  hasMorePages: boolean;
+}
+interface PaginationOptions {
+  path?: string;
+  query?: Record<string, string | number | boolean | null | undefined>;
+  fragment?: string;
+  pageName?: string;
+}
+type PaginationCurrentPageResolver = (pageName: string, options: PaginationOptions) => number | undefined;
+interface PaginationURLDriver {
+  getPageName: () => string;
+  url: (page: number) => string;
+}
+type PaginationURLDriverFactory = (options: PaginationOptions) => PaginationURLDriver;
+interface PrismaFindManyArgsLike {
+  where?: unknown;
+  include?: unknown;
+  orderBy?: unknown;
+  select?: unknown;
+  skip?: number;
+  take?: number;
+}
+type PrismaLikeSortOrder = 'asc' | 'desc';
+interface PrismaLikeWhereInput {
+  AND?: PrismaLikeWhereInput[];
+  OR?: PrismaLikeWhereInput[];
+  NOT?: PrismaLikeWhereInput | PrismaLikeWhereInput[];
+  [key: string]: unknown;
+}
+type PrismaLikeOrderBy = Record<string, PrismaLikeSortOrder> | Record<string, PrismaLikeSortOrder>[];
+interface PrismaLikeSelect {
+  [key: string]: boolean | {
+    select?: PrismaLikeSelect;
+    include?: PrismaLikeInclude;
+  };
+}
+interface PrismaLikeInclude {
+  [key: string]: boolean | {
+    where?: PrismaLikeWhereInput;
+    orderBy?: PrismaLikeOrderBy;
+    select?: PrismaLikeSelect;
+    include?: PrismaLikeInclude;
+    skip?: number;
+    take?: number;
+  };
+}
+type EagerLoadConstraint = (query: unknown) => unknown;
+type EagerLoadMap = Record<string, EagerLoadConstraint | undefined>;
+interface SoftDeleteConfig {
+  enabled: boolean;
+  column: string;
+}
+interface PrismaDelegateLike {
+  findMany: (args?: any) => Promise<unknown[]>;
+  findFirst: (args?: any) => Promise<unknown | null>;
+  create: (args: any) => Promise<unknown>;
+  update: (args: any) => Promise<unknown>;
+  delete: (args: any) => Promise<unknown>;
+  count: (args?: any) => Promise<number>;
+}
+type FallbackIfUnknownOrNever<TValue, TFallback> = [TValue] extends [never] ? TFallback : unknown extends TValue ? TFallback : TValue;
+type DelegateFindManyArgs<TDelegate extends PrismaDelegateLike> = FallbackIfUnknownOrNever<NonNullable<Parameters<TDelegate['findMany']>[0]>, PrismaFindManyArgsLike>;
+type DelegateWhere<TDelegate extends PrismaDelegateLike> = DelegateFindManyArgs<TDelegate> extends {
+  where?: infer TWhere;
+} ? FallbackIfUnknownOrNever<TWhere, PrismaLikeWhereInput> : PrismaLikeWhereInput;
+type DelegateInclude<TDelegate extends PrismaDelegateLike> = DelegateFindManyArgs<TDelegate> extends {
+  include?: infer TInclude;
+} ? FallbackIfUnknownOrNever<TInclude, PrismaLikeInclude> : PrismaLikeInclude;
+type DelegateOrderBy<TDelegate extends PrismaDelegateLike> = DelegateFindManyArgs<TDelegate> extends {
+  orderBy?: infer TOrderBy;
+} ? FallbackIfUnknownOrNever<TOrderBy, PrismaLikeOrderBy> : PrismaLikeOrderBy;
+type DelegateSelect<TDelegate extends PrismaDelegateLike> = DelegateFindManyArgs<TDelegate> extends {
+  select?: infer TSelect;
+} ? FallbackIfUnknownOrNever<TSelect, PrismaLikeSelect> : PrismaLikeSelect;
+type DelegateCreateData<TDelegate extends PrismaDelegateLike> = Parameters<TDelegate['create']>[0] extends {
+  data: infer TData;
+} ? TData : Record<string, unknown>;
+type DelegateUpdateArgs<TDelegate extends PrismaDelegateLike> = Parameters<TDelegate['update']>[0];
+type DelegateUpdateData<TDelegate extends PrismaDelegateLike> = DelegateUpdateArgs<TDelegate> extends {
+  data: infer TData;
+} ? FallbackIfUnknownOrNever<TData, Record<string, unknown>> : Record<string, unknown>;
+type DelegateRow<TDelegate extends PrismaDelegateLike> = Exclude<Awaited<ReturnType<TDelegate['findFirst']>>, null>;
+type Serializable = Record<string, unknown>;
+//#endregion
+//#region src/types/metadata.d.ts
+type ColumnMap = Record<string, string>;
+interface ModelMetadata {
+  table: string;
+  primaryKey: string;
+  columns: ColumnMap;
+  softDelete: SoftDeleteConfig;
+}
+type RelationMetadataType = 'hasOne' | 'hasMany' | 'belongsTo' | 'belongsToMany' | 'hasOneThrough' | 'hasManyThrough' | 'morphOne' | 'morphMany' | 'morphToMany';
+interface BaseRelationMetadata {
+  type: RelationMetadataType;
+  relatedModel: RelationshipModelStatic;
+}
+interface HasOneRelationMetadata extends BaseRelationMetadata {
+  type: 'hasOne';
+  foreignKey: string;
+  localKey: string;
+}
+interface HasManyRelationMetadata extends BaseRelationMetadata {
+  type: 'hasMany';
+  foreignKey: string;
+  localKey: string;
+}
+interface BelongsToRelationMetadata extends BaseRelationMetadata {
+  type: 'belongsTo';
+  foreignKey: string;
+  ownerKey: string;
+}
+interface BelongsToManyRelationMetadata extends BaseRelationMetadata {
+  type: 'belongsToMany';
+  throughTable: string;
+  foreignPivotKey: string;
+  relatedPivotKey: string;
+  parentKey: string;
+  relatedKey: string;
+}
+interface HasOneThroughRelationMetadata extends BaseRelationMetadata {
+  type: 'hasOneThrough';
+  throughTable: string;
+  firstKey: string;
+  secondKey: string;
+  localKey: string;
+  secondLocalKey: string;
+}
+interface HasManyThroughRelationMetadata extends BaseRelationMetadata {
+  type: 'hasManyThrough';
+  throughTable: string;
+  firstKey: string;
+  secondKey: string;
+  localKey: string;
+  secondLocalKey: string;
+}
+interface MorphOneRelationMetadata extends BaseRelationMetadata {
+  type: 'morphOne';
+  morphName: string;
+  morphIdColumn: string;
+  morphTypeColumn: string;
+  localKey: string;
+}
+interface MorphManyRelationMetadata extends BaseRelationMetadata {
+  type: 'morphMany';
+  morphName: string;
+  morphIdColumn: string;
+  morphTypeColumn: string;
+  localKey: string;
+}
+interface MorphToManyRelationMetadata extends BaseRelationMetadata {
+  type: 'morphToMany';
+  throughTable: string;
+  morphName: string;
+  morphIdColumn: string;
+  morphTypeColumn: string;
+  relatedPivotKey: string;
+  parentKey: string;
+  relatedKey: string;
+}
+type RelationMetadata = HasOneRelationMetadata | HasManyRelationMetadata | BelongsToRelationMetadata | BelongsToManyRelationMetadata | HasOneThroughRelationMetadata | HasManyThroughRelationMetadata | MorphOneRelationMetadata | MorphManyRelationMetadata | MorphToManyRelationMetadata;
 //#endregion
 //#region src/types/factories.d.ts
 type FactoryAttributes = Record<string, unknown>;
@@ -119,6 +358,28 @@ declare class ArkormCollection<T = any, X = T[]> extends Collection<T, X> {}
 //#region src/types/relationship.d.ts
 type RelationConstraint<TModel> = (query: QueryBuilder<TModel>) => QueryBuilder<TModel> | void;
 type RelationDefaultValue<TParent, TRelated> = Partial<ModelAttributes<TRelated>> | TRelated | ((parent: TParent) => Partial<ModelAttributes<TRelated>> | TRelated);
+interface RelationTableLookupSpec {
+  table: string;
+  where?: QueryCondition;
+  columns?: QuerySelectColumn[];
+  orderBy?: QueryOrderBy[];
+  limit?: number;
+  offset?: number;
+}
+interface RelationColumnLookupSpec {
+  lookup: RelationTableLookupSpec;
+  column: string;
+}
+//#endregion
+//#region src/relationship/RelationTableLoader.d.ts
+declare class RelationTableLoader {
+  private readonly adapter;
+  constructor(adapter: DatabaseAdapter);
+  selectRows(spec: RelationTableLookupSpec): Promise<DatabaseRow[]>;
+  selectRow(spec: RelationTableLookupSpec): Promise<DatabaseRow | null>;
+  selectColumnValues(spec: RelationColumnLookupSpec): Promise<unknown[]>;
+  selectColumnValue(spec: RelationColumnLookupSpec): Promise<unknown | null>;
+}
 //#endregion
 //#region src/relationship/Relation.d.ts
 /**
@@ -129,6 +390,12 @@ type RelationDefaultValue<TParent, TRelated> = Partial<ModelAttributes<TRelated>
  */
 declare abstract class Relation<TModel> {
   protected constraint: RelationConstraint<TModel> | null;
+  protected getRelationAdapter(): DatabaseAdapter;
+  protected getRelatedModel(): {
+    getAdapter: () => DatabaseAdapter | undefined;
+    query: () => QueryBuilder<TModel>;
+  };
+  protected createRelationTableLoader(): RelationTableLoader;
   /**
    * Apply a constraint to the relationship query.
    *
@@ -235,6 +502,7 @@ declare abstract class Relation<TModel> {
    * @returns The query builder instance with the constraint applied, if any.
    */
   protected applyConstraint(query: QueryBuilder<TModel>): QueryBuilder<TModel>;
+  abstract getMetadata(): RelationMetadata;
   /**
    * Build the underlying query for the relationship.
    *
@@ -303,6 +571,7 @@ declare class BelongsToManyRelation<TParent, TRelated> extends Relation<TRelated
    * @returns
    */
   getQuery(): Promise<QueryBuilder<TRelated>>;
+  getMetadata(): BelongsToManyRelationMetadata;
   /**
    * Fetches the related models for this relationship.
    *
@@ -354,6 +623,7 @@ declare class BelongsToRelation<TParent, TRelated> extends SingleResultRelation<
    * @returns
    */
   getQuery(): Promise<QueryBuilder<TRelated>>;
+  getMetadata(): BelongsToRelationMetadata;
   /**
    * Fetches the related models for this relationship.
    *
@@ -383,6 +653,7 @@ declare class HasManyRelation<TParent, TRelated> extends Relation<TRelated> {
    * @returns
    */
   getQuery(): Promise<QueryBuilder<TRelated>>;
+  getMetadata(): HasManyRelationMetadata;
   /**
    * Fetches the related models for this relationship.
    *
@@ -416,6 +687,7 @@ declare class HasManyThroughRelation<TParent, TRelated> extends Relation<TRelate
    * @returns
    */
   getQuery(): Promise<QueryBuilder<TRelated>>;
+  getMetadata(): HasManyThroughRelationMetadata;
   /**
    * Fetches the related models for this relationship.
    *
@@ -445,6 +717,7 @@ declare class HasOneRelation<TParent, TRelated> extends SingleResultRelation<TPa
    * @returns
    */
   getQuery(): Promise<QueryBuilder<TRelated>>;
+  getMetadata(): HasOneRelationMetadata;
   /**
    * Fetches the related models for this relationship.
    *
@@ -478,6 +751,7 @@ declare class HasOneThroughRelation<TParent, TRelated> extends SingleResultRelat
    * @returns
    */
   getQuery(): Promise<QueryBuilder<TRelated>>;
+  getMetadata(): HasOneThroughRelationMetadata;
   /**
    * Fetches the related models for this relationship.
    *
@@ -507,6 +781,7 @@ declare class MorphManyRelation<TParent, TRelated> extends Relation<TRelated> {
    * @returns
    */
   getQuery(): Promise<QueryBuilder<TRelated>>;
+  getMetadata(): MorphManyRelationMetadata;
   /**
    * Fetches the related models for this relationship.
    *
@@ -536,6 +811,7 @@ declare class MorphOneRelation<TParent, TRelated> extends SingleResultRelation<T
    * @returns
    */
   getQuery(): Promise<QueryBuilder<TRelated>>;
+  getMetadata(): MorphOneRelationMetadata;
   /**
    * Fetches the related models for this relationship.
    *
@@ -568,6 +844,7 @@ declare class MorphToManyRelation<TParent, TRelated> extends Relation<TRelated>
    * @returns
    */
   getQuery(): Promise<QueryBuilder<TRelated>>;
+  getMetadata(): MorphToManyRelationMetadata;
   /**
    * Fetches the related models for this relationship.
    *
@@ -685,8 +962,12 @@ declare abstract class Model<TSchema extends PrismaDelegateLike | Record<string,
   private static readonly lifecycleStates;
   private static eventsSuppressed;
   protected static factoryClass?: new () => ModelFactory<any, any>;
+  protected static adapter?: DatabaseAdapter;
   protected static client: Record<string, unknown>;
   protected static delegate: string;
+  protected static table?: string;
+  protected static primaryKey: string;
+  protected static columns: Record<string, string>;
   protected static softDeletes: boolean;
   protected static deletedAtColumn: string;
   protected static globalScopes: Record<string, GlobalScope>;
@@ -707,6 +988,13 @@ declare abstract class Model<TSchema extends PrismaDelegateLike | Record<string,
    * @param client
    */
   protected static setClient(client: Record<string, unknown>): void;
+  static setAdapter(adapter?: DatabaseAdapter): void;
+  static getTable(): string;
+  static getPrimaryKey(): string;
+  static getColumnMap(): Record<string, string>;
+  static getColumnName(attribute: string): string;
+  static getModelMetadata(): ModelMetadata;
+  static getRelationMetadata(name: string): RelationMetadata | null;
   static setFactory<TFactory extends ModelFactory<any, any>>(factoryClass: new () => TFactory): void;
   static factory<TFactory extends ModelFactory<any, any>>(count?: number): TFactory;
   /**
@@ -797,6 +1085,7 @@ declare abstract class Model<TSchema extends PrismaDelegateLike | Record<string,
    * @returns
    */
   static getDelegate<TDelegate extends PrismaDelegateLike = PrismaDelegateLike>(delegate?: string): TDelegate;
+  static getAdapter(): DatabaseAdapter | undefined;
   /**
    * Get a new query builder instance for the model.
    *
@@ -1362,9 +1651,15 @@ declare class Paginator<T> {
  * @since 0.1.0
  */
 declare class QueryBuilder<TModel, TDelegate extends PrismaDelegateLike = PrismaDelegateLike> {
-  private readonly delegate;
   private readonly model;
-  private readonly args;
+  private readonly adapter?;
+  private queryWhere?;
+  private legacyWhere?;
+  private queryRelationLoads?;
+  private queryOrderBy?;
+  private querySelect?;
+  private offsetValue?;
+  private limitValue?;
   private readonly eagerLoads;
   private includeTrashed;
   private onlyTrashedRecords;
@@ -1374,10 +1669,9 @@ declare class QueryBuilder<TModel, TDelegate extends PrismaDelegateLike = Prisma
   /**
    * Creates a new QueryBuilder instance.
    *
-   * @param delegate
    * @param model
    */
-  constructor(delegate: TDelegate, model: ModelStatic<TModel, TDelegate>);
+  constructor(model: ModelStatic<TModel, TDelegate>, adapter?: DatabaseAdapter | undefined);
   private resolvePaginationPage;
   /**
    * Adds a where clause to the query. Multiple calls to where will combine
@@ -1951,6 +2245,12 @@ declare class QueryBuilder<TModel, TDelegate extends PrismaDelegateLike = Prisma
    * @returns
    */
   delete(): Promise<TModel>;
+  private tryBuildInsertSpec;
+  private tryBuildInsertManySpec;
+  private tryBuildInsertOrIgnoreManySpec;
+  private tryBuildUpdateSpec;
+  private tryBuildUpdateManySpec;
+  private tryBuildDeleteSpec;
   /**
    * Counts the number of records matching the current query constraints.
    *
@@ -2062,6 +2362,34 @@ declare class QueryBuilder<TModel, TDelegate extends PrismaDelegateLike = Prisma
    * @returns
    */
   private normalizeWith;
+  private buildQueryTarget;
+  private hasBaseWhereConstraints;
+  private normalizeQuerySelect;
+  private normalizeQueryOrderBy;
+  private cloneRelationLoads;
+  private normalizeRelationLoadSelect;
+  private normalizeRelationLoadOrderBy;
+  private normalizeRelationLoads;
+  private appendQueryCondition;
+  private toDelegateWhere;
+  private buildSoftDeleteQueryCondition;
+  private buildQueryWhereCondition;
+  private tryBuildQuerySelectColumns;
+  private tryBuildQueryOrderBy;
+  private tryBuildFieldCondition;
+  private tryBuildQueryCondition;
+  private tryBuildSelectSpec;
+  private tryBuildAggregateSpec;
+  private requireAdapter;
+  private executeReadRows;
+  private executeReadRow;
+  private executeReadCount;
+  private executeReadExists;
+  private executeInsertRow;
+  private executeInsertManyRows;
+  private executeUpdateRow;
+  private executeUpdateManyRows;
+  private executeDeleteRow;
   /**
    * Builds the where clause for the query, taking into account soft delete
    * settings if applicable.
@@ -2074,7 +2402,6 @@ declare class QueryBuilder<TModel, TDelegate extends PrismaDelegateLike = Prisma
    *
    * @returns
    */
-  private buildFindArgs;
   /**
    * Resolves a unique where clause for update and delete operations.
    *
@@ -2113,188 +2440,266 @@ interface ModelStatic<TModel, TDelegate extends PrismaDelegateLike = PrismaDeleg
   hydrateMany: (attributes: (DelegateRow<TDelegate> extends Record<string, unknown> ? DelegateRow<TDelegate> : Record<string, unknown>)[]) => TModel[];
   hydrateRetrieved: (attributes: DelegateRow<TDelegate> extends Record<string, unknown> ? DelegateRow<TDelegate> : Record<string, unknown>) => Promise<TModel>;
   hydrateManyRetrieved: (attributes: (DelegateRow<TDelegate> extends Record<string, unknown> ? DelegateRow<TDelegate> : Record<string, unknown>)[]) => Promise<TModel[]>;
+  getAdapter: () => DatabaseAdapter | undefined;
+  getColumnMap: () => Record<string, string>;
+  getColumnName: (attribute: string) => string;
   getDelegate: (delegate?: string) => TDelegate;
+  getModelMetadata: () => ModelMetadata;
+  getPrimaryKey: () => string;
+  getRelationMetadata: (name: string) => RelationMetadata | null;
+  setAdapter: (adapter?: DatabaseAdapter) => void;
   getSoftDeleteConfig: () => SoftDeleteConfig;
+  getTable: () => string;
 }
 interface RelationshipModelStatic {
   new (attributes?: Record<string, unknown>): any;
   query: () => QueryBuilder<any, any>;
   hydrate: (attributes: Record<string, unknown>) => any;
+  getAdapter: () => DatabaseAdapter | undefined;
+  getColumnMap: () => Record<string, string>;
+  getColumnName: (attribute: string) => string;
   getDelegate: (delegate?: string) => PrismaDelegateLike;
+  getModelMetadata: () => ModelMetadata;
+  getPrimaryKey: () => string;
+  getRelationMetadata: (name: string) => RelationMetadata | null;
+  getTable: () => string;
 }
 //#endregion
-//#region src/types/core.d.ts
-type CastType = 'string' | 'number' | 'boolean' | 'date' | 'json' | 'array';
-interface CastHandler<T = unknown> {
-  get: (value: unknown) => T;
-  set: (value: unknown) => unknown;
+//#region src/types/adapter.d.ts
+type DatabasePrimitive = string | number | boolean | bigint | Date | null;
+type DatabaseValue = DatabasePrimitive | DatabaseRow | DatabaseValue[];
+type DatabaseRow = Record<string, unknown>;
+type DatabaseRows = DatabaseRow[];
+type AdapterCapability = 'transactions' | 'returning' | 'insertMany' | 'updateMany' | 'deleteMany' | 'exists' | 'relationLoads' | 'relationAggregates' | 'relationFilters' | 'rawWhere';
+type AdapterCapabilities = Partial<Record<AdapterCapability, boolean>>;
+type QueryLogicalOperator = 'and' | 'or';
+type QueryComparisonOperator = '=' | '!=' | '>' | '>=' | '<' | '<=' | 'in' | 'not-in' | 'contains' | 'starts-with' | 'ends-with' | 'is-null' | 'is-not-null';
+type SortDirection = 'asc' | 'desc';
+type AggregateOperation = 'count' | 'exists' | 'sum' | 'avg' | 'min' | 'max';
+type SoftDeleteQueryMode = 'exclude' | 'include' | 'only';
+interface QueryTarget<TModel = unknown> {
+  model?: ModelStatic<TModel, any>;
+  modelName?: string;
+  table?: string;
+  primaryKey?: string;
+  columns?: Record<string, string>;
+  softDelete?: SoftDeleteConfig;
+  alias?: string;
 }
-type CastDefinition = CastType | CastHandler;
-type CastMap = Record<string, CastDefinition>;
-type PrismaClientLike = PrismaClient | Record<string, unknown>;
-interface PrismaTransactionOptions {
-  maxWait?: number;
-  timeout?: number;
-  isolationLevel?: string;
+interface QuerySelectColumn {
+  column: string;
+  alias?: string;
 }
-type PrismaTransactionCallback<TResult = unknown> = (client: PrismaClientLike) => TResult | Promise<TResult>;
-interface PrismaTransactionCapableClient {
-  $transaction: <TResult>(callback: PrismaTransactionCallback<TResult>, options?: PrismaTransactionOptions) => Promise<TResult>;
+interface QueryOrderBy {
+  column: string;
+  direction: SortDirection;
 }
-type ClientResolver = PrismaClientLike | (() => PrismaClientLike);
-interface ArkormConfig {
-  /**
-   * @property prisma A Prisma client instance or a function that returns a Prisma client instance.
-   */
-  prisma: ClientResolver;
-  /**
-   * @property pagination Configuration options related to pagination behavior and URL generation.
-   */
-  pagination?: {
-    urlDriver?: PaginationURLDriverFactory;
-    resolveCurrentPage?: PaginationCurrentPageResolver;
-  };
-  /**
-   * @property paths Optional custom paths for various generated files.
-   */
-  paths?: {
-    /**
-     * @property stubs Optional custom path for stub files used in code generation.
-     */
-    stubs?: string;
-    /**
-     * @property seeders Optional custom path for seeder files.
-     */
-    seeders?: string;
-    /**
-     * @property models Optional custom path for model files.
-     */
-    models?: string;
-    /**
-     * @property migrations Optional custom path for migration files.
-     */
-    migrations?: string;
-    /**
-     * @property factories Optional custom path for factory files.
-     */
-    factories?: string;
-    /**
-     * @property buildOutput Optional custom path for the development output directory.
-     */
-    buildOutput?: string;
-  };
-  /**
-   * @property outputExt Optional file extension for generated files, either 'ts' or 'js'.
-   */
-  outputExt?: 'ts' | 'js';
+interface QueryComparisonCondition {
+  type: 'comparison';
+  column: string;
+  operator: QueryComparisonOperator;
+  value?: DatabaseValue | DatabaseValue[];
 }
-interface GetUserConfig {
-  /**
-   * Get the user-provided ArkORM configuration.
-   */
-  (): Partial<ArkormConfig>;
-  /**
-   * Get a specific user configuration value
-   * @param key Optional specific configuration key to retrieve
-   */
-  <K extends keyof ArkormConfig>(key: K): Partial<ArkormConfig>[K];
+interface QueryGroupCondition {
+  type: 'group';
+  operator: QueryLogicalOperator;
+  conditions: QueryCondition[];
 }
-interface PaginationMeta {
-  total: number;
-  perPage: number;
-  currentPage: number;
-  lastPage: number;
-  from: number | null;
-  to: number | null;
+interface QueryNotCondition {
+  type: 'not';
+  condition: QueryCondition;
 }
-interface SimplePaginationMeta {
-  perPage: number;
-  currentPage: number;
-  from: number | null;
-  to: number | null;
-  hasMorePages: boolean;
+interface QueryRawCondition {
+  type: 'raw';
+  sql: string;
+  bindings?: DatabaseValue[];
 }
-interface PaginationOptions {
-  path?: string;
-  query?: Record<string, string | number | boolean | null | undefined>;
-  fragment?: string;
-  pageName?: string;
+type QueryCondition = QueryComparisonCondition | QueryGroupCondition | QueryNotCondition | QueryRawCondition;
+interface AggregateSelection {
+  type: AggregateOperation;
+  column?: string;
+  alias?: string;
 }
-type PaginationCurrentPageResolver = (pageName: string, options: PaginationOptions) => number | undefined;
-interface PaginationURLDriver {
-  getPageName: () => string;
-  url: (page: number) => string;
+interface RelationAggregateSpec {
+  relation: string;
+  type: AggregateOperation;
+  column?: string;
+  alias?: string;
+  where?: QueryCondition;
 }
-type PaginationURLDriverFactory = (options: PaginationOptions) => PaginationURLDriver;
-interface PrismaFindManyArgsLike {
-  where?: unknown;
-  include?: unknown;
-  orderBy?: unknown;
-  select?: unknown;
-  skip?: number;
-  take?: number;
+interface RelationFilterSpec {
+  relation: string;
+  operator: '>=' | '>' | '=' | '!=' | '<=' | '<';
+  count: number;
+  boolean?: 'AND' | 'OR';
+  where?: QueryCondition;
 }
-type PrismaLikeSortOrder = 'asc' | 'desc';
-interface PrismaLikeWhereInput {
-  AND?: PrismaLikeWhereInput[];
-  OR?: PrismaLikeWhereInput[];
-  NOT?: PrismaLikeWhereInput | PrismaLikeWhereInput[];
-  [key: string]: unknown;
+interface RelationLoadPlan {
+  relation: string;
+  constraint?: QueryCondition;
+  orderBy?: QueryOrderBy[];
+  limit?: number;
+  offset?: number;
+  columns?: QuerySelectColumn[];
+  relationLoads?: RelationLoadPlan[];
 }
-type PrismaLikeOrderBy = Record<string, PrismaLikeSortOrder> | Record<string, PrismaLikeSortOrder>[];
-interface PrismaLikeSelect {
-  [key: string]: boolean | {
-    select?: PrismaLikeSelect;
-    include?: PrismaLikeInclude;
-  };
+interface SelectSpec<TModel = unknown> {
+  target: QueryTarget<TModel>;
+  columns?: QuerySelectColumn[];
+  where?: QueryCondition;
+  orderBy?: QueryOrderBy[];
+  limit?: number;
+  offset?: number;
+  softDeleteMode?: SoftDeleteQueryMode;
+  relationLoads?: RelationLoadPlan[];
+  relationAggregates?: RelationAggregateSpec[];
+  relationFilters?: RelationFilterSpec[];
+  aggregates?: AggregateSelection[];
 }
-interface PrismaLikeInclude {
-  [key: string]: boolean | {
-    where?: PrismaLikeWhereInput;
-    orderBy?: PrismaLikeOrderBy;
-    select?: PrismaLikeSelect;
-    include?: PrismaLikeInclude;
-    skip?: number;
-    take?: number;
-  };
+interface InsertSpec<TModel = unknown> {
+  target: QueryTarget<TModel>;
+  values: DatabaseRow;
+  returning?: QuerySelectColumn[];
 }
-type EagerLoadConstraint = (query: unknown) => unknown;
-type EagerLoadMap = Record<string, EagerLoadConstraint | undefined>;
-interface SoftDeleteConfig {
-  enabled: boolean;
-  column: string;
+interface InsertManySpec<TModel = unknown> {
+  target: QueryTarget<TModel>;
+  values: DatabaseRow[];
+  ignoreDuplicates?: boolean;
 }
-interface PrismaDelegateLike {
-  findMany: (args?: any) => Promise<unknown[]>;
-  findFirst: (args?: any) => Promise<unknown | null>;
-  create: (args: any) => Promise<unknown>;
-  update: (args: any) => Promise<unknown>;
-  delete: (args: any) => Promise<unknown>;
-  count: (args?: any) => Promise<number>;
+interface UpdateSpec<TModel = unknown> {
+  target: QueryTarget<TModel>;
+  where: QueryCondition;
+  values: DatabaseRow;
+  returning?: QuerySelectColumn[];
+}
+interface UpdateManySpec<TModel = unknown> {
+  target: QueryTarget<TModel>;
+  where?: QueryCondition;
+  values: DatabaseRow;
+}
+interface DeleteSpec<TModel = unknown> {
+  target: QueryTarget<TModel>;
+  where: QueryCondition;
+  returning?: QuerySelectColumn[];
+}
+interface DeleteManySpec<TModel = unknown> {
+  target: QueryTarget<TModel>;
+  where?: QueryCondition;
+}
+interface AggregateSpec<TModel = unknown> {
+  target: QueryTarget<TModel>;
+  where?: QueryCondition;
+  aggregate: AggregateSelection;
+  softDeleteMode?: SoftDeleteQueryMode;
+}
+interface RelationLoadSpec<TModel = unknown> {
+  target: QueryTarget<TModel>;
+  models: TModel[];
+  relations: RelationLoadPlan[];
+}
+interface AdapterTransactionContext {
+  isolationLevel?: string;
+  readOnly?: boolean;
+  maxWait?: number;
+  timeout?: number;
+}
+interface DatabaseAdapter {
+  readonly capabilities?: AdapterCapabilities;
+  select: <TModel = unknown>(spec: SelectSpec<TModel>) => Promise<DatabaseRows>;
+  selectOne: <TModel = unknown>(spec: SelectSpec<TModel>) => Promise<DatabaseRow | null>;
+  insert: <TModel = unknown>(spec: InsertSpec<TModel>) => Promise<DatabaseRow>;
+  insertMany?: <TModel = unknown>(spec: InsertManySpec<TModel>) => Promise<number>;
+  update: <TModel = unknown>(spec: UpdateSpec<TModel>) => Promise<DatabaseRow | null>;
+  updateMany?: <TModel = unknown>(spec: UpdateManySpec<TModel>) => Promise<number>;
+  delete: <TModel = unknown>(spec: DeleteSpec<TModel>) => Promise<DatabaseRow | null>;
+  deleteMany?: <TModel = unknown>(spec: DeleteManySpec<TModel>) => Promise<number>;
+  count: <TModel = unknown>(spec: AggregateSpec<TModel>) => Promise<number>;
+  exists?: <TModel = unknown>(spec: SelectSpec<TModel>) => Promise<boolean>;
+  loadRelations?: <TModel = unknown>(spec: RelationLoadSpec<TModel>) => Promise<void>;
+  transaction: <TResult = unknown>(callback: (adapter: DatabaseAdapter) => TResult | Promise<TResult>, context?: AdapterTransactionContext) => Promise<TResult>;
+}
+//#endregion
+//#region src/adapters/KyselyDatabaseAdapter.d.ts
+type KyselyExecutor = Kysely<any> | Transaction<any>;
+declare class KyselyDatabaseAdapter implements DatabaseAdapter {
+  private readonly db;
+  readonly capabilities: AdapterCapabilities;
+  constructor(db: KyselyExecutor);
+  private resolveTable;
+  private resolvePrimaryKey;
+  private mapColumn;
+  private reverseColumnMap;
+  private mapRow;
+  private mapRows;
+  private mapValues;
+  private buildSelectList;
+  private buildOrderBy;
+  private buildConditionValueList;
+  private buildComparisonCondition;
+  private buildWhereCondition;
+  private buildWhereClause;
+  private buildPaginationClause;
+  private assertNoRelationLoads;
+  select<TModel = unknown>(spec: SelectSpec<TModel>): Promise<DatabaseRow[]>;
+  selectOne<TModel = unknown>(spec: SelectSpec<TModel>): Promise<DatabaseRow | null>;
+  insert<TModel = unknown>(spec: InsertSpec<TModel>): Promise<DatabaseRow>;
+  insertMany<TModel = unknown>(spec: InsertManySpec<TModel>): Promise<number>;
+  update<TModel = unknown>(spec: UpdateSpec<TModel>): Promise<DatabaseRow | null>;
+  updateMany<TModel = unknown>(spec: UpdateManySpec<TModel>): Promise<number>;
+  delete<TModel = unknown>(spec: DeleteSpec<TModel>): Promise<DatabaseRow | null>;
+  deleteMany<TModel = unknown>(spec: DeleteManySpec<TModel>): Promise<number>;
+  count<TModel = unknown>(spec: AggregateSpec<TModel>): Promise<number>;
+  exists<TModel = unknown>(spec: SelectSpec<TModel>): Promise<boolean>;
+  transaction<TResult = unknown>(callback: (adapter: DatabaseAdapter) => TResult | Promise<TResult>, context?: AdapterTransactionContext): Promise<TResult>;
+}
+declare const createKyselyAdapter: (db: KyselyExecutor) => KyselyDatabaseAdapter;
+//#endregion
+//#region src/adapters/PrismaDatabaseAdapter.d.ts
+type PrismaDelegateNameMapping = Record<string, string>;
+declare class PrismaDatabaseAdapter implements DatabaseAdapter {
+  private readonly prisma;
+  private readonly mapping;
+  readonly capabilities: AdapterCapabilities;
+  private readonly delegates;
+  constructor(prisma: PrismaClientLike, mapping?: PrismaDelegateNameMapping);
+  private hasTransactionSupport;
+  private normalizeCandidate;
+  private unique;
+  private toQuerySelect;
+  private toQueryOrderBy;
+  private toComparisonWhere;
+  private toQueryWhere;
+  private buildFindArgs;
+  private toQueryInclude;
+  private resolveDelegate;
+  select<TModel = unknown>(spec: SelectSpec<TModel>): Promise<DatabaseRow[]>;
+  selectOne<TModel = unknown>(spec: SelectSpec<TModel>): Promise<DatabaseRow | null>;
+  insert<TModel = unknown>(spec: InsertSpec<TModel>): Promise<DatabaseRow>;
+  insertMany<TModel = unknown>(spec: InsertManySpec<TModel>): Promise<number>;
+  update<TModel = unknown>(spec: UpdateSpec<TModel>): Promise<DatabaseRow | null>;
+  updateMany<TModel = unknown>(spec: UpdateManySpec<TModel>): Promise<number>;
+  delete<TModel = unknown>(spec: DeleteSpec<TModel>): Promise<DatabaseRow | null>;
+  deleteMany<TModel = unknown>(spec: DeleteManySpec<TModel>): Promise<number>;
+  count<TModel = unknown>(spec: AggregateSpec<TModel>): Promise<number>;
+  exists<TModel = unknown>(spec: SelectSpec<TModel>): Promise<boolean>;
+  loadRelations<TModel = unknown>(_spec: RelationLoadSpec<TModel>): Promise<void>;
+  transaction<TResult = unknown>(callback: (adapter: DatabaseAdapter) => TResult | Promise<TResult>, context?: AdapterTransactionContext): Promise<TResult>;
+}
+declare const createPrismaDatabaseAdapter: (prisma: PrismaClientLike, mapping?: PrismaDelegateNameMapping) => PrismaDatabaseAdapter;
+declare const createPrismaCompatibilityAdapter: (prisma: PrismaClientLike, mapping?: PrismaDelegateNameMapping) => PrismaDatabaseAdapter;
+//#endregion
+//#region src/Attribute.d.ts
+interface AttributeOptions<TGet = unknown, TSet = unknown> {
+  get?: (value: unknown) => TGet;
+  set?: (value: TSet) => unknown;
+}
+declare class Attribute<TGet = unknown, TSet = unknown> {
+  readonly get?: (value: unknown) => TGet;
+  readonly set?: (value: TSet) => unknown;
+  constructor(options?: AttributeOptions<TGet, TSet>);
+  static make<TGet = unknown, TSet = unknown>(options: AttributeOptions<TGet, TSet>): Attribute<TGet, TSet>;
+  static isAttribute(value: unknown): value is Attribute;
 }
-type FallbackIfUnknownOrNever<TValue, TFallback> = [TValue] extends [never] ? TFallback : unknown extends TValue ? TFallback : TValue;
-type DelegateFindManyArgs<TDelegate extends PrismaDelegateLike> = FallbackIfUnknownOrNever<NonNullable<Parameters<TDelegate['findMany']>[0]>, PrismaFindManyArgsLike>;
-type DelegateWhere<TDelegate extends PrismaDelegateLike> = DelegateFindManyArgs<TDelegate> extends {
-  where?: infer TWhere;
-} ? FallbackIfUnknownOrNever<TWhere, PrismaLikeWhereInput> : PrismaLikeWhereInput;
-type DelegateInclude<TDelegate extends PrismaDelegateLike> = DelegateFindManyArgs<TDelegate> extends {
-  include?: infer TInclude;
-} ? FallbackIfUnknownOrNever<TInclude, PrismaLikeInclude> : PrismaLikeInclude;
-type DelegateOrderBy<TDelegate extends PrismaDelegateLike> = DelegateFindManyArgs<TDelegate> extends {
-  orderBy?: infer TOrderBy;
-} ? FallbackIfUnknownOrNever<TOrderBy, PrismaLikeOrderBy> : PrismaLikeOrderBy;
-type DelegateSelect<TDelegate extends PrismaDelegateLike> = DelegateFindManyArgs<TDelegate> extends {
-  select?: infer TSelect;
-} ? FallbackIfUnknownOrNever<TSelect, PrismaLikeSelect> : PrismaLikeSelect;
-type DelegateCreateData<TDelegate extends PrismaDelegateLike> = Parameters<TDelegate['create']>[0] extends {
-  data: infer TData;
-} ? TData : Record<string, unknown>;
-type DelegateUpdateArgs<TDelegate extends PrismaDelegateLike> = Parameters<TDelegate['update']>[0];
-type DelegateUpdateData<TDelegate extends PrismaDelegateLike> = DelegateUpdateArgs<TDelegate> extends {
-  data: infer TData;
-} ? FallbackIfUnknownOrNever<TData, Record<string, unknown>> : Record<string, unknown>;
-type DelegateRow<TDelegate extends PrismaDelegateLike> = Exclude<Awaited<ReturnType<TDelegate['findFirst']>>, null>;
-type Serializable = Record<string, unknown>;
 //#endregion
 //#region src/casts.d.ts
 declare function resolveCast(definition: CastDefinition): CastHandler;
@@ -3703,7 +4108,7 @@ declare function createPrismaAdapter(prisma: PrismaClientLike): Record<string, P
  * @param mapping Optional mapping of Arkormˣ delegate names to Prisma delegate names.
  * @returns A delegate map keyed by Arkormˣ delegate names.
  */
-declare function createPrismaDelegateMap(prisma: PrismaClientLike): Record<string, PrismaDelegateLike>;
+declare function createPrismaDelegateMap(prisma: PrismaClientLike, mapping?: PrismaDelegateNameMapping): Record<string, PrismaDelegateLike>;
 /**
  * Infer the Prisma delegate name for a given model name using a simple convention.
  *
@@ -3735,4 +4140,4 @@ declare class URLDriver {
   url(page: number): string;
 }
 //#endregion
-export { ArkormCollection, ArkormErrorContext, ArkormException, Attribute, AttributeOptions, CliApp, EnumBuilder, ForeignKeyBuilder, InitCommand, InlineFactory, LengthAwarePaginator, MIGRATION_BRAND, MakeFactoryCommand, MakeMigrationCommand, MakeModelCommand, MakeSeederCommand, MigrateCommand, MigrateRollbackCommand, Migration, MigrationHistoryCommand, MissingDelegateException, Model, ModelFactory, ModelNotFoundException, ModelsSyncCommand, PRISMA_ENUM_MEMBER_REGEX, PRISMA_ENUM_REGEX, PRISMA_MODEL_REGEX, Paginator, PrismaDelegateMap, QueryBuilder, QueryConstraintException, RelationResolutionException, RuntimeModuleLoader, SEEDER_BRAND, SchemaBuilder, ScopeNotDefinedException, SeedCommand, Seeder, SeederCallArgument, SeederConstructor, SeederInput, TableBuilder, URLDriver, UniqueConstraintResolutionException, UnsupportedAdapterFeatureException, applyAlterTableOperation, applyCreateTableOperation, applyDropTableOperation, applyMigrationRollbackToPrismaSchema, applyMigrationToPrismaSchema, applyOperationsToPrismaSchema, buildEnumBlock, buildFieldLine, buildIndexLine, buildInverseRelationLine, buildMigrationIdentity, buildMigrationRunId, buildMigrationSource, buildModelBlock, buildRelationLine, computeMigrationChecksum, configureArkormRuntime, createMigrationTimestamp, createPrismaAdapter, createPrismaDelegateMap, defineConfig, defineFactory, deriveCollectionFieldName, deriveInverseRelationAlias, deriveRelationAlias, deriveRelationFieldName, deriveSingularFieldName, ensureArkormConfigLoading, escapeRegex, findAppliedMigration, findEnumBlock, findModelBlock, formatDefaultValue, formatEnumDefaultValue, formatRelationAction, generateMigrationFile, getActiveTransactionClient, getDefaultStubsPath, getLastMigrationRun, getLatestAppliedMigrations, getMigrationPlan, getRuntimePaginationCurrentPageResolver, getRuntimePaginationURLDriverFactory, getRuntimePrismaClient, getUserConfig, inferDelegateName, isDelegateLike, isMigrationApplied, isTransactionCapableClient, loadArkormConfig, markMigrationApplied, markMigrationRun, pad, readAppliedMigrationsState, removeAppliedMigration, resetArkormRuntimeForTests, resolveCast, resolveEnumName, resolveMigrationClassName, resolveMigrationStateFilePath, resolvePrismaType, runArkormTransaction, runMigrationWithPrisma, runPrismaCommand, toMigrationFileSlug, toModelName, writeAppliedMigrationsState };
+export { ArkormCollection, ArkormErrorContext, ArkormException, Attribute, AttributeOptions, CliApp, EnumBuilder, ForeignKeyBuilder, InitCommand, InlineFactory, KyselyDatabaseAdapter, LengthAwarePaginator, MIGRATION_BRAND, MakeFactoryCommand, MakeMigrationCommand, MakeModelCommand, MakeSeederCommand, MigrateCommand, MigrateRollbackCommand, Migration, MigrationHistoryCommand, MissingDelegateException, Model, ModelFactory, ModelNotFoundException, ModelsSyncCommand, PRISMA_ENUM_MEMBER_REGEX, PRISMA_ENUM_REGEX, PRISMA_MODEL_REGEX, Paginator, PrismaDatabaseAdapter, PrismaDelegateMap, PrismaDelegateNameMapping, QueryBuilder, QueryConstraintException, RelationResolutionException, RuntimeModuleLoader, SEEDER_BRAND, SchemaBuilder, ScopeNotDefinedException, SeedCommand, Seeder, SeederCallArgument, SeederConstructor, SeederInput, TableBuilder, URLDriver, UniqueConstraintResolutionException, UnsupportedAdapterFeatureException, applyAlterTableOperation, applyCreateTableOperation, applyDropTableOperation, applyMigrationRollbackToPrismaSchema, applyMigrationToPrismaSchema, applyOperationsToPrismaSchema, buildEnumBlock, buildFieldLine, buildIndexLine, buildInverseRelationLine, buildMigrationIdentity, buildMigrationRunId, buildMigrationSource, buildModelBlock, buildRelationLine, computeMigrationChecksum, configureArkormRuntime, createKyselyAdapter, createMigrationTimestamp, createPrismaAdapter, createPrismaCompatibilityAdapter, createPrismaDatabaseAdapter, createPrismaDelegateMap, defineConfig, defineFactory, deriveCollectionFieldName, deriveInverseRelationAlias, deriveRelationAlias, deriveRelationFieldName, deriveSingularFieldName, ensureArkormConfigLoading, escapeRegex, findAppliedMigration, findEnumBlock, findModelBlock, formatDefaultValue, formatEnumDefaultValue, formatRelationAction, generateMigrationFile, getActiveTransactionClient, getDefaultStubsPath, getLastMigrationRun, getLatestAppliedMigrations, getMigrationPlan, getRuntimePaginationCurrentPageResolver, getRuntimePaginationURLDriverFactory, getRuntimePrismaClient, getUserConfig, inferDelegateName, isDelegateLike, isMigrationApplied, isTransactionCapableClient, loadArkormConfig, markMigrationApplied, markMigrationRun, pad, readAppliedMigrationsState, removeAppliedMigration, resetArkormRuntimeForTests, resolveCast, resolveEnumName, resolveMigrationClassName, resolveMigrationStateFilePath, resolvePrismaType, runArkormTransaction, runMigrationWithPrisma, runPrismaCommand, toMigrationFileSlug, toModelName, writeAppliedMigrationsState };