arkormx 1.2.0 → 1.2.2

package/dist/index.d.cts

@@ -118,6 +118,7 @@ declare class ArkormCollection<T = any, X = T[]> extends Collection<T, X> {}
 //#endregion
 //#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);
 //#endregion
 //#region src/relationship/Relation.d.ts
 /**
@@ -234,6 +235,12 @@ declare abstract class Relation<TModel> {
    * @returns The query builder instance with the constraint applied, if any.
    */
   protected applyConstraint(query: QueryBuilder<TModel>): QueryBuilder<TModel>;
+  /**
+   * Build the underlying query for the relationship.
+   *
+   * @returns
+   */
+  abstract getQuery(): Promise<QueryBuilder<TModel>>;
   /**
    * Execute the relationship query and return relation results.
    *
@@ -246,6 +253,24 @@ declare abstract class Relation<TModel> {
    * @returns
    */
   first(): Promise<TModel | null>;
+  /**
+   * Count records that match the relationship query.
+   *
+   * @returns
+   */
+  count(): Promise<number>;
+  /**
+   * Determine whether the relationship query has any matching records.
+   *
+   * @returns
+   */
+  exists(): Promise<boolean>;
+  /**
+   * Determine whether the relationship query has no matching records.
+   *
+   * @returns
+   */
+  doesntExist(): Promise<boolean>;
   /**
    * Get the results of the relationship query.
    *
@@ -272,6 +297,12 @@ declare class BelongsToManyRelation<TParent, TRelated> extends Relation<TRelated
   constructor(parent: TParent & {
     getAttribute: (key: string) => unknown;
   }, related: RelationshipModelStatic, throughDelegate: string, foreignPivotKey: string, relatedPivotKey: string, parentKey: string, relatedKey: string);
+  /**
+   * Build the relationship query.
+   *
+   * @returns
+   */
+  getQuery(): Promise<QueryBuilder<TRelated>>;
   /**
    * Fetches the related models for this relationship.
    *
@@ -280,6 +311,28 @@ declare class BelongsToManyRelation<TParent, TRelated> extends Relation<TRelated
   getResults(): Promise<ArkormCollection<TRelated>>;
 }
 //#endregion
+//#region src/relationship/SingleResultRelation.d.ts
+/**
+ * Base class for relationships that resolve to a single related model.
+ *
+ * @author Legacy (3m1n3nc3)
+ * @since 1.3.0
+ */
+declare abstract class SingleResultRelation<TParent, TRelated> extends Relation<TRelated> {
+  protected readonly parent: TParent;
+  protected readonly related: RelatedModelClass<TRelated>;
+  protected defaultValue: RelationDefaultValue<object, TRelated> | undefined;
+  protected constructor(parent: TParent, related: RelatedModelClass<TRelated>);
+  /**
+   * Defines a default value to return when the relationship does not find a related model.
+   *
+   * @param value     The default value or a callback that returns the default value.
+   * @returns         The current instance for method chaining.
+   */
+  withDefault(value?: RelationDefaultValue<TParent, TRelated>): this;
+  protected resolveDefaultResult(): TRelated | null;
+}
+//#endregion
 //#region src/relationship/BelongsToRelation.d.ts
 /**
  * Defines an inverse one-to-one or many relationship.
@@ -287,14 +340,20 @@ declare class BelongsToManyRelation<TParent, TRelated> extends Relation<TRelated
  * @author Legacy (3m1n3nc3)
  * @since 0.1.0
  */
-declare class BelongsToRelation<TParent, TRelated> extends Relation<TRelated> {
-  private readonly parent;
-  private readonly related;
+declare class BelongsToRelation<TParent, TRelated> extends SingleResultRelation<TParent & {
+  getAttribute: (key: string) => unknown;
+}, TRelated> {
   private readonly foreignKey;
   private readonly ownerKey;
   constructor(parent: TParent & {
     getAttribute: (key: string) => unknown;
-  }, related: RelationshipModelStatic, foreignKey: string, ownerKey: string);
+  }, related: RelatedModelClass<TRelated>, foreignKey: string, ownerKey: string);
+  /**
+   * Build the relationship query.
+   *
+   * @returns
+   */
+  getQuery(): Promise<QueryBuilder<TRelated>>;
   /**
    * Fetches the related models for this relationship.
    *
@@ -318,6 +377,12 @@ declare class HasManyRelation<TParent, TRelated> extends Relation<TRelated> {
   constructor(parent: TParent & {
     getAttribute: (key: string) => unknown;
   }, related: RelationshipModelStatic, foreignKey: string, localKey: string);
+  /**
+   * Build the relationship query.
+   *
+   * @returns
+   */
+  getQuery(): Promise<QueryBuilder<TRelated>>;
   /**
    * Fetches the related models for this relationship.
    *
@@ -345,6 +410,12 @@ declare class HasManyThroughRelation<TParent, TRelated> extends Relation<TRelate
   constructor(parent: TParent & {
     getAttribute: (key: string) => unknown;
   }, related: RelationshipModelStatic, throughDelegate: string, firstKey: string, secondKey: string, localKey: string, secondLocalKey: string);
+  /**
+   * Build the relationship query.
+   *
+   * @returns
+   */
+  getQuery(): Promise<QueryBuilder<TRelated>>;
   /**
    * Fetches the related models for this relationship.
    *
@@ -360,14 +431,20 @@ declare class HasManyThroughRelation<TParent, TRelated> extends Relation<TRelate
  * @author Legacy (3m1n3nc3)
  * @since 0.1.0
  */
-declare class HasOneRelation<TParent, TRelated> extends Relation<TRelated> {
-  private readonly parent;
-  private readonly related;
+declare class HasOneRelation<TParent, TRelated> extends SingleResultRelation<TParent & {
+  getAttribute: (key: string) => unknown;
+}, TRelated> {
   private readonly foreignKey;
   private readonly localKey;
   constructor(parent: TParent & {
     getAttribute: (key: string) => unknown;
-  }, related: RelationshipModelStatic, foreignKey: string, localKey: string);
+  }, related: RelatedModelClass<TRelated>, foreignKey: string, localKey: string);
+  /**
+   * Build the relationship query.
+   *
+   * @returns
+   */
+  getQuery(): Promise<QueryBuilder<TRelated>>;
   /**
    * Fetches the related models for this relationship.
    *
@@ -384,9 +461,9 @@ declare class HasOneRelation<TParent, TRelated> extends Relation<TRelated> {
  * @author Legacy (3m1n3nc3)
  * @since 0.1.0
  */
-declare class HasOneThroughRelation<TParent, TRelated> extends Relation<TRelated> {
-  private readonly parent;
-  private readonly related;
+declare class HasOneThroughRelation<TParent, TRelated> extends SingleResultRelation<TParent & {
+  getAttribute: (key: string) => unknown;
+}, TRelated> {
   private readonly throughDelegate;
   private readonly firstKey;
   private readonly secondKey;
@@ -394,7 +471,13 @@ declare class HasOneThroughRelation<TParent, TRelated> extends Relation<TRelated
   private readonly secondLocalKey;
   constructor(parent: TParent & {
     getAttribute: (key: string) => unknown;
-  }, related: RelationshipModelStatic, throughDelegate: string, firstKey: string, secondKey: string, localKey: string, secondLocalKey: string);
+  }, related: RelatedModelClass<TRelated>, throughDelegate: string, firstKey: string, secondKey: string, localKey: string, secondLocalKey: string);
+  /**
+   * Build the relationship query.
+   *
+   * @returns
+   */
+  getQuery(): Promise<QueryBuilder<TRelated>>;
   /**
    * Fetches the related models for this relationship.
    *
@@ -418,6 +501,12 @@ declare class MorphManyRelation<TParent, TRelated> extends Relation<TRelated> {
   constructor(parent: TParent & {
     getAttribute: (key: string) => unknown;
   }, related: RelationshipModelStatic, morphName: string, localKey: string);
+  /**
+   * Build the relationship query.
+   *
+   * @returns
+   */
+  getQuery(): Promise<QueryBuilder<TRelated>>;
   /**
    * Fetches the related models for this relationship.
    *
@@ -433,14 +522,20 @@ declare class MorphManyRelation<TParent, TRelated> extends Relation<TRelated> {
  * @author Legacy (3m1n3nc3)
  * @since 0.1.0
  */
-declare class MorphOneRelation<TParent, TRelated> extends Relation<TRelated> {
-  private readonly parent;
-  private readonly related;
+declare class MorphOneRelation<TParent, TRelated> extends SingleResultRelation<TParent & {
+  getAttribute: (key: string) => unknown;
+}, TRelated> {
   private readonly morphName;
   private readonly localKey;
   constructor(parent: TParent & {
     getAttribute: (key: string) => unknown;
-  }, related: RelationshipModelStatic, morphName: string, localKey: string);
+  }, related: RelatedModelClass<TRelated>, morphName: string, localKey: string);
+  /**
+   * Build the relationship query.
+   *
+   * @returns
+   */
+  getQuery(): Promise<QueryBuilder<TRelated>>;
   /**
    * Fetches the related models for this relationship.
    *
@@ -467,6 +562,12 @@ declare class MorphToManyRelation<TParent, TRelated> extends Relation<TRelated>
   constructor(parent: TParent & {
     getAttribute: (key: string) => unknown;
   }, related: RelationshipModelStatic, throughDelegate: string, morphName: string, relatedPivotKey: string, parentKey: string, relatedKey: string);
+  /**
+   * Build the relationship query.
+   *
+   * @returns
+   */
+  getQuery(): Promise<QueryBuilder<TRelated>>;
   /**
    * Fetches the related models for this relationship.
    *
@@ -2016,7 +2117,9 @@ interface ModelStatic<TModel, TDelegate extends PrismaDelegateLike = PrismaDeleg
   getSoftDeleteConfig: () => SoftDeleteConfig;
 }
 interface RelationshipModelStatic {
+  new (attributes?: Record<string, unknown>): any;
   query: () => QueryBuilder<any, any>;
+  hydrate: (attributes: Record<string, unknown>) => any;
   getDelegate: (delegate?: string) => PrismaDelegateLike;
 }
 //#endregion
@@ -3281,17 +3384,18 @@ declare const buildIndexLine: (index: SchemaIndex) => string;
  */
 declare const deriveRelationFieldName: (columnName: string) => string;
 /**
- * Derive a relation name for the inverse side of a relation based on the
+ * Derive a relation name for both sides of a relation based on the
  * source and target model names, using an explicit alias if provided or a
- * convention of combining the target model name with the last segment of
- * the source model name.
+ * convention of combining the full source model name with the target model name.
  *
  * @param sourceModelName    The name of the source model in the relation.
  * @param targetModelName    The name of the target model in the relation.
- * @param explicitAlias      An optional explicit alias for the inverse relation.
- * @returns                  The derived or explicit inverse relation alias.
+ * @param explicitAlias      An optional explicit alias for the relation.
+ * @returns                  The derived or explicit relation alias.
  */
+declare const deriveRelationAlias: (sourceModelName: string, targetModelName: string, explicitAlias?: string) => string;
 declare const deriveInverseRelationAlias: (sourceModelName: string, targetModelName: string, explicitAlias?: string) => string;
+declare const deriveSingularFieldName: (modelName: string) => string;
 declare const deriveCollectionFieldName: (modelName: string) => string;
 /**
  * Format a SchemaForeignKeyAction value as a Prisma onDelete action string.
@@ -3307,7 +3411,7 @@ declare const formatRelationAction: (action: SchemaForeignKeyAction) => string;
  * @param foreignKey    The foreign key definition to convert to a relation line.
  * @returns             The corresponding Prisma schema line for the relation field.
  */
-declare const buildRelationLine: (foreignKey: SchemaForeignKey) => string;
+declare const buildRelationLine: (sourceModelName: string, foreignKey: SchemaForeignKey, columns?: SchemaColumn[]) => string;
 /**
  * Build a Prisma relation field line for the inverse side of a relation, based
  * on the source and target model names and the foreign key definition, using
@@ -3318,7 +3422,7 @@ declare const buildRelationLine: (foreignKey: SchemaForeignKey) => string;
  * @param foreignKey        The foreign key definition for the relation.
  * @returns                 The Prisma schema line for the inverse relation field.
  */
-declare const buildInverseRelationLine: (sourceModelName: string, targetModelName: string, foreignKey: SchemaForeignKey) => string;
+declare const buildInverseRelationLine: (sourceModelName: string, targetModelName: string, foreignKey: SchemaForeignKey, columns?: SchemaColumn[]) => string;
 /**
  * Build a Prisma model block string based on a SchemaTableCreateOperation, including
  * all fields and any necessary mapping.
@@ -3598,4 +3702,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, 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, deriveRelationFieldName, 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, 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, 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 };

package/dist/index.d.mts

@@ -118,6 +118,7 @@ declare class ArkormCollection<T = any, X = T[]> extends Collection<T, X> {}
 //#endregion
 //#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);
 //#endregion
 //#region src/relationship/Relation.d.ts
 /**
@@ -234,6 +235,12 @@ declare abstract class Relation<TModel> {
    * @returns The query builder instance with the constraint applied, if any.
    */
   protected applyConstraint(query: QueryBuilder<TModel>): QueryBuilder<TModel>;
+  /**
+   * Build the underlying query for the relationship.
+   *
+   * @returns
+   */
+  abstract getQuery(): Promise<QueryBuilder<TModel>>;
   /**
    * Execute the relationship query and return relation results.
    *
@@ -246,6 +253,24 @@ declare abstract class Relation<TModel> {
    * @returns
    */
   first(): Promise<TModel | null>;
+  /**
+   * Count records that match the relationship query.
+   *
+   * @returns
+   */
+  count(): Promise<number>;
+  /**
+   * Determine whether the relationship query has any matching records.
+   *
+   * @returns
+   */
+  exists(): Promise<boolean>;
+  /**
+   * Determine whether the relationship query has no matching records.
+   *
+   * @returns
+   */
+  doesntExist(): Promise<boolean>;
   /**
    * Get the results of the relationship query.
    *
@@ -272,6 +297,12 @@ declare class BelongsToManyRelation<TParent, TRelated> extends Relation<TRelated
   constructor(parent: TParent & {
     getAttribute: (key: string) => unknown;
   }, related: RelationshipModelStatic, throughDelegate: string, foreignPivotKey: string, relatedPivotKey: string, parentKey: string, relatedKey: string);
+  /**
+   * Build the relationship query.
+   *
+   * @returns
+   */
+  getQuery(): Promise<QueryBuilder<TRelated>>;
   /**
    * Fetches the related models for this relationship.
    *
@@ -280,6 +311,28 @@ declare class BelongsToManyRelation<TParent, TRelated> extends Relation<TRelated
   getResults(): Promise<ArkormCollection<TRelated>>;
 }
 //#endregion
+//#region src/relationship/SingleResultRelation.d.ts
+/**
+ * Base class for relationships that resolve to a single related model.
+ *
+ * @author Legacy (3m1n3nc3)
+ * @since 1.3.0
+ */
+declare abstract class SingleResultRelation<TParent, TRelated> extends Relation<TRelated> {
+  protected readonly parent: TParent;
+  protected readonly related: RelatedModelClass<TRelated>;
+  protected defaultValue: RelationDefaultValue<object, TRelated> | undefined;
+  protected constructor(parent: TParent, related: RelatedModelClass<TRelated>);
+  /**
+   * Defines a default value to return when the relationship does not find a related model.
+   *
+   * @param value     The default value or a callback that returns the default value.
+   * @returns         The current instance for method chaining.
+   */
+  withDefault(value?: RelationDefaultValue<TParent, TRelated>): this;
+  protected resolveDefaultResult(): TRelated | null;
+}
+//#endregion
 //#region src/relationship/BelongsToRelation.d.ts
 /**
  * Defines an inverse one-to-one or many relationship.
@@ -287,14 +340,20 @@ declare class BelongsToManyRelation<TParent, TRelated> extends Relation<TRelated
  * @author Legacy (3m1n3nc3)
  * @since 0.1.0
  */
-declare class BelongsToRelation<TParent, TRelated> extends Relation<TRelated> {
-  private readonly parent;
-  private readonly related;
+declare class BelongsToRelation<TParent, TRelated> extends SingleResultRelation<TParent & {
+  getAttribute: (key: string) => unknown;
+}, TRelated> {
   private readonly foreignKey;
   private readonly ownerKey;
   constructor(parent: TParent & {
     getAttribute: (key: string) => unknown;
-  }, related: RelationshipModelStatic, foreignKey: string, ownerKey: string);
+  }, related: RelatedModelClass<TRelated>, foreignKey: string, ownerKey: string);
+  /**
+   * Build the relationship query.
+   *
+   * @returns
+   */
+  getQuery(): Promise<QueryBuilder<TRelated>>;
   /**
    * Fetches the related models for this relationship.
    *
@@ -318,6 +377,12 @@ declare class HasManyRelation<TParent, TRelated> extends Relation<TRelated> {
   constructor(parent: TParent & {
     getAttribute: (key: string) => unknown;
   }, related: RelationshipModelStatic, foreignKey: string, localKey: string);
+  /**
+   * Build the relationship query.
+   *
+   * @returns
+   */
+  getQuery(): Promise<QueryBuilder<TRelated>>;
   /**
    * Fetches the related models for this relationship.
    *
@@ -345,6 +410,12 @@ declare class HasManyThroughRelation<TParent, TRelated> extends Relation<TRelate
   constructor(parent: TParent & {
     getAttribute: (key: string) => unknown;
   }, related: RelationshipModelStatic, throughDelegate: string, firstKey: string, secondKey: string, localKey: string, secondLocalKey: string);
+  /**
+   * Build the relationship query.
+   *
+   * @returns
+   */
+  getQuery(): Promise<QueryBuilder<TRelated>>;
   /**
    * Fetches the related models for this relationship.
    *
@@ -360,14 +431,20 @@ declare class HasManyThroughRelation<TParent, TRelated> extends Relation<TRelate
  * @author Legacy (3m1n3nc3)
  * @since 0.1.0
  */
-declare class HasOneRelation<TParent, TRelated> extends Relation<TRelated> {
-  private readonly parent;
-  private readonly related;
+declare class HasOneRelation<TParent, TRelated> extends SingleResultRelation<TParent & {
+  getAttribute: (key: string) => unknown;
+}, TRelated> {
   private readonly foreignKey;
   private readonly localKey;
   constructor(parent: TParent & {
     getAttribute: (key: string) => unknown;
-  }, related: RelationshipModelStatic, foreignKey: string, localKey: string);
+  }, related: RelatedModelClass<TRelated>, foreignKey: string, localKey: string);
+  /**
+   * Build the relationship query.
+   *
+   * @returns
+   */
+  getQuery(): Promise<QueryBuilder<TRelated>>;
   /**
    * Fetches the related models for this relationship.
    *
@@ -384,9 +461,9 @@ declare class HasOneRelation<TParent, TRelated> extends Relation<TRelated> {
  * @author Legacy (3m1n3nc3)
  * @since 0.1.0
  */
-declare class HasOneThroughRelation<TParent, TRelated> extends Relation<TRelated> {
-  private readonly parent;
-  private readonly related;
+declare class HasOneThroughRelation<TParent, TRelated> extends SingleResultRelation<TParent & {
+  getAttribute: (key: string) => unknown;
+}, TRelated> {
   private readonly throughDelegate;
   private readonly firstKey;
   private readonly secondKey;
@@ -394,7 +471,13 @@ declare class HasOneThroughRelation<TParent, TRelated> extends Relation<TRelated
   private readonly secondLocalKey;
   constructor(parent: TParent & {
     getAttribute: (key: string) => unknown;
-  }, related: RelationshipModelStatic, throughDelegate: string, firstKey: string, secondKey: string, localKey: string, secondLocalKey: string);
+  }, related: RelatedModelClass<TRelated>, throughDelegate: string, firstKey: string, secondKey: string, localKey: string, secondLocalKey: string);
+  /**
+   * Build the relationship query.
+   *
+   * @returns
+   */
+  getQuery(): Promise<QueryBuilder<TRelated>>;
   /**
    * Fetches the related models for this relationship.
    *
@@ -418,6 +501,12 @@ declare class MorphManyRelation<TParent, TRelated> extends Relation<TRelated> {
   constructor(parent: TParent & {
     getAttribute: (key: string) => unknown;
   }, related: RelationshipModelStatic, morphName: string, localKey: string);
+  /**
+   * Build the relationship query.
+   *
+   * @returns
+   */
+  getQuery(): Promise<QueryBuilder<TRelated>>;
   /**
    * Fetches the related models for this relationship.
    *
@@ -433,14 +522,20 @@ declare class MorphManyRelation<TParent, TRelated> extends Relation<TRelated> {
  * @author Legacy (3m1n3nc3)
  * @since 0.1.0
  */
-declare class MorphOneRelation<TParent, TRelated> extends Relation<TRelated> {
-  private readonly parent;
-  private readonly related;
+declare class MorphOneRelation<TParent, TRelated> extends SingleResultRelation<TParent & {
+  getAttribute: (key: string) => unknown;
+}, TRelated> {
   private readonly morphName;
   private readonly localKey;
   constructor(parent: TParent & {
     getAttribute: (key: string) => unknown;
-  }, related: RelationshipModelStatic, morphName: string, localKey: string);
+  }, related: RelatedModelClass<TRelated>, morphName: string, localKey: string);
+  /**
+   * Build the relationship query.
+   *
+   * @returns
+   */
+  getQuery(): Promise<QueryBuilder<TRelated>>;
   /**
    * Fetches the related models for this relationship.
    *
@@ -467,6 +562,12 @@ declare class MorphToManyRelation<TParent, TRelated> extends Relation<TRelated>
   constructor(parent: TParent & {
     getAttribute: (key: string) => unknown;
   }, related: RelationshipModelStatic, throughDelegate: string, morphName: string, relatedPivotKey: string, parentKey: string, relatedKey: string);
+  /**
+   * Build the relationship query.
+   *
+   * @returns
+   */
+  getQuery(): Promise<QueryBuilder<TRelated>>;
   /**
    * Fetches the related models for this relationship.
    *
@@ -2016,7 +2117,9 @@ interface ModelStatic<TModel, TDelegate extends PrismaDelegateLike = PrismaDeleg
   getSoftDeleteConfig: () => SoftDeleteConfig;
 }
 interface RelationshipModelStatic {
+  new (attributes?: Record<string, unknown>): any;
   query: () => QueryBuilder<any, any>;
+  hydrate: (attributes: Record<string, unknown>) => any;
   getDelegate: (delegate?: string) => PrismaDelegateLike;
 }
 //#endregion
@@ -3281,17 +3384,18 @@ declare const buildIndexLine: (index: SchemaIndex) => string;
  */
 declare const deriveRelationFieldName: (columnName: string) => string;
 /**
- * Derive a relation name for the inverse side of a relation based on the
+ * Derive a relation name for both sides of a relation based on the
  * source and target model names, using an explicit alias if provided or a
- * convention of combining the target model name with the last segment of
- * the source model name.
+ * convention of combining the full source model name with the target model name.
  *
  * @param sourceModelName    The name of the source model in the relation.
  * @param targetModelName    The name of the target model in the relation.
- * @param explicitAlias      An optional explicit alias for the inverse relation.
- * @returns                  The derived or explicit inverse relation alias.
+ * @param explicitAlias      An optional explicit alias for the relation.
+ * @returns                  The derived or explicit relation alias.
  */
+declare const deriveRelationAlias: (sourceModelName: string, targetModelName: string, explicitAlias?: string) => string;
 declare const deriveInverseRelationAlias: (sourceModelName: string, targetModelName: string, explicitAlias?: string) => string;
+declare const deriveSingularFieldName: (modelName: string) => string;
 declare const deriveCollectionFieldName: (modelName: string) => string;
 /**
  * Format a SchemaForeignKeyAction value as a Prisma onDelete action string.
@@ -3307,7 +3411,7 @@ declare const formatRelationAction: (action: SchemaForeignKeyAction) => string;
  * @param foreignKey    The foreign key definition to convert to a relation line.
  * @returns             The corresponding Prisma schema line for the relation field.
  */
-declare const buildRelationLine: (foreignKey: SchemaForeignKey) => string;
+declare const buildRelationLine: (sourceModelName: string, foreignKey: SchemaForeignKey, columns?: SchemaColumn[]) => string;
 /**
  * Build a Prisma relation field line for the inverse side of a relation, based
  * on the source and target model names and the foreign key definition, using
@@ -3318,7 +3422,7 @@ declare const buildRelationLine: (foreignKey: SchemaForeignKey) => string;
  * @param foreignKey        The foreign key definition for the relation.
  * @returns                 The Prisma schema line for the inverse relation field.
  */
-declare const buildInverseRelationLine: (sourceModelName: string, targetModelName: string, foreignKey: SchemaForeignKey) => string;
+declare const buildInverseRelationLine: (sourceModelName: string, targetModelName: string, foreignKey: SchemaForeignKey, columns?: SchemaColumn[]) => string;
 /**
  * Build a Prisma model block string based on a SchemaTableCreateOperation, including
  * all fields and any necessary mapping.
@@ -3598,4 +3702,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, 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, deriveRelationFieldName, 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, 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, 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 };