@rvoh/dream 0.45.0 → 0.45.1

package/dist/cjs/src/Dream.js

@@ -1148,38 +1148,31 @@ class Dream {
      * await User.preload('posts', 'comments', 'replies').all()
      *
      * // Automatically preload everything needed for serialization:
-     * await User.preloadForSerialization({ serializerKey: 'summary' }).all()
+     * await User.preloadFor('summary').all()
      *
      * // Add where conditions to specific associations during preloading:
-     * await User.preloadForSerialization({
-     *   serializerKey: 'detailed',
-     *   modifierFn: (dreamClass, associationName) => {
-     *     if (dreamClass.typeof(Post) && associationName === 'comments') {
-     *       return { and: { published: true } }
-     *     }
+     * await User.preloadFor('default', (dreamClass, associationName) => {
+     *   if (dreamClass.typeof(Post) && associationName === 'comments') {
+     *     return { and: { published: true } }
      *   }
      * }).all()
      *
      * // Skip preloading specific associations to handle them manually:
-     * await User.preloadForSerialization({
-     *   serializerKey: 'summary',
-     *   modifierFn: (dreamClass, associationName) => {
-     *     if (dreamClass.typeof(User) && associationName === 'posts') {
-     *       return 'omit' // Handle posts preloading separately with custom logic
-     *     }
+     * await User.preloadFor('summary', (dreamClass, associationName) => {
+     *   if (dreamClass.typeof(User) && associationName === 'posts') {
+     *     return 'omit' // Handle posts preloading separately with custom logic
      *   }
      * })
      * .preload('posts', { and: { featured: true } }) // Custom preloading
      * .all()
      * ```
      *
-     * @param opts - Configuration options for serialization preloading
-     * @param opts.serializerKey - The serializer key to use for determining which associations to preload. Defaults to 'default'
-     * @param opts.modifierFn - Optional callback function to modify or omit specific associations during preloading. Called for each association with the Dream class and association name. Return an object with `and`, `andAny`, or `andNot` properties to add where conditions, return 'omit' to skip preloading that association (useful when you want to handle it manually), or return undefined to use default preloading
+     * @param serializerKey - The serializer key to use for determining which associations to preload.
+     * @param modifierFn - Optional callback function to modify or omit specific associations during preloading. Called for each association with the Dream class and association name. Return an object with `and`, `andAny`, or `andNot` properties to add where conditions, return 'omit' to skip preloading that association (useful when you want to handle it manually), or return undefined to use default preloading
      * @returns A Query with all serialization associations preloaded
      */
-    static preloadForSerialization(opts = {}) {
-        return this.query().preloadForSerialization(opts);
+    static preloadFor(serializerKey, modifierFn) {
+        return this.query().preloadFor(serializerKey, modifierFn);
     }
     /**
      * Recursively preloads all Dream associations referenced by `rendersOne` and `rendersMany`
@@ -1205,38 +1198,31 @@ class Dream {
      * await User.leftJoinPreload('posts', 'comments', 'replies').all()
      *
      * // Automatically left join preload everything needed for serialization:
-     * await User.leftJoinPreloadForSerialization({ serializerKey: 'summary' }).all()
+     * await User.leftJoinPreloadFor('summary').all()
      *
      * // Add where conditions to specific associations during left join preloading:
-     * await User.leftJoinPreloadForSerialization({
-     *   serializerKey: 'detailed',
-     *   modifierFn: (dreamClass, associationName) => {
-     *     if (dreamClass.typeof(Post) && associationName === 'comments') {
-     *       return { and: { published: true } }
-     *     }
+     * await User.leftJoinPreloadFor('detailed', (dreamClass, associationName) => {
+     *   if (dreamClass.typeof(Post) && associationName === 'comments') {
+     *     return { and: { published: true } }
      *   }
      * }).all()
      *
      * // Skip left join preloading specific associations to handle them manually:
-     * await User.leftJoinPreloadForSerialization({
-     *   serializerKey: 'summary',
-     *   modifierFn: (dreamClass, associationName) => {
-     *     if (dreamClass.typeof(User) && associationName === 'posts') {
-     *       return 'omit' // Handle posts preloading separately with custom logic
-     *     }
+     * await User.leftJoinPreloadFor('summary', (dreamClass, associationName) => {
+     *   if (dreamClass.typeof(User) && associationName === 'posts') {
+     *     return 'omit' // Handle posts preloading separately with custom logic
      *   }
      * })
      * .preload('posts', { and: { featured: true } }) // Custom preloading instead
      * .all()
      * ```
      *
-     * @param opts - Configuration options for serialization preloading
-     * @param opts.serializerKey - The serializer key to use for determining which associations to preload. Defaults to 'default'
-     * @param opts.modifierFn - Optional callback function to modify or omit specific associations during preloading. Called for each association with the Dream class and association name. Return an object with `and`, `andAny`, or `andNot` properties to add where conditions, return 'omit' to skip preloading that association (useful when you want to handle it manually), or return undefined to use default preloading
+     * @param serializerKey - The serializer key to use for determining which associations to preload.
+     * @param modifierFn - Optional callback function to modify or omit specific associations during preloading. Called for each association with the Dream class and association name. Return an object with `and`, `andAny`, or `andNot` properties to add where conditions, return 'omit' to skip preloading that association (useful when you want to handle it manually), or return undefined to use default preloading
      * @returns A Query with all serialization associations left join preloaded
      */
-    static leftJoinPreloadForSerialization(opts = {}) {
-        return this.query().leftJoinPreloadForSerialization(opts);
+    static leftJoinPreloadFor(serializerKey, modifierFn) {
+        return this.query().leftJoinPreloadFor(serializerKey, modifierFn);
     }
     /**
      * Returns a new Query instance with the provided
@@ -3083,6 +3069,54 @@ class Dream {
     load(...args) {
         return new LoadBuilder_js_1.default(this).load(...args);
     }
+    /**
+     * Recursively loads all Dream associations referenced by `rendersOne` and `rendersMany`
+     * in a DreamSerializer. This traverses the entire content tree of serializers to automatically
+     * load all necessary associations, eliminating N+1 query problems and removing the need to
+     * manually remember which associations to preload for serialization.
+     *
+     * This method decouples data loading code from data rendering code by having the serializer
+     * (rendering code) inform the query (loading code) about which associations are needed.
+     * As serializers evolve over time - adding new `rendersOne` and `rendersMany` calls or
+     * modifying existing ones - the loading code automatically adapts without requiring
+     * corresponding modifications to preload statements.
+     *
+     * This method analyzes the serializer (specified by `serializerKey` or 'default') and
+     * automatically preloads all associations that will be needed during serialization.
+     *
+     * ```ts
+     * // Instead of manually specifying all associations:
+     * await User.preload('posts', 'comments', 'replies').all()
+     *
+     * // Automatically preload everything needed for serialization:
+     * await user.loadFor('summary').execute()
+     *
+     * // Add where conditions to specific associations during preloading:
+     * await user.loadFor('detailed', (dreamClass, associationName) => {
+     *   if (dreamClass.typeof(Post) && associationName === 'comments') {
+     *     return { and: { published: true } }
+     *   }
+     * })
+     *    .execute()
+     *
+     * // Skip preloading specific associations to handle them manually:
+     * await user
+     *   .loadFor('summary', (dreamClass, associationName) => {
+     *     if (dreamClass.typeof(User) && associationName === 'posts') {
+     *       return 'omit' // Handle posts preloading separately with custom logic
+     *     }
+     *   })
+     *     .load('posts', { and: { featured: true } }) // Custom preloading
+     *     .execute()
+     * ```
+     *
+     * @param serializerKey - The serializer key to use for determining which associations to preload.
+     * @param modifierFn - Optional callback function to modify or omit specific associations during preloading. Called for each association with the Dream class and association name. Return an object with `and`, `andAny`, or `andNot` properties to add where conditions, return 'omit' to skip preloading that association (useful when you want to handle it manually), or return undefined to use default preloading
+     * @returns A Query with all serialization associations preloaded
+     */
+    loadFor(serializerKey, modifierFn) {
+        return new LoadBuilder_js_1.default(this)['loadFor'](serializerKey, modifierFn);
+    }
     /**
      * Load each specified association using a single SQL query.
      * See {@link Dream.load} for loading in separate queries.
@@ -3117,6 +3151,54 @@ class Dream {
     leftJoinLoad(...args) {
         return new LeftJoinLoadBuilder_js_1.default(this).leftJoinLoad(...args);
     }
+    /**
+     * Recursively loads all Dream associations referenced by `rendersOne` and `rendersMany`
+     * in a DreamSerializer. This traverses the entire content tree of serializers to automatically
+     * load all necessary associations, eliminating N+1 query problems and removing the need to
+     * manually remember which associations to preload for serialization.
+     *
+     * This method decouples data loading code from data rendering code by having the serializer
+     * (rendering code) inform the query (loading code) about which associations are needed.
+     * As serializers evolve over time - adding new `rendersOne` and `rendersMany` calls or
+     * modifying existing ones - the loading code automatically adapts without requiring
+     * corresponding modifications to preload statements.
+     *
+     * This method analyzes the serializer (specified by `serializerKey` or 'default') and
+     * automatically preloads all associations that will be needed during serialization.
+     *
+     * ```ts
+     * // Instead of manually specifying all associations:
+     * await User.preload('posts', 'comments', 'replies').all()
+     *
+     * // Automatically preload everything needed for serialization:
+     * await user.leftJoinLoadFor('summary').execute()
+     *
+     * // Add where conditions to specific associations during preloading:
+     * await user.leftJoinLoadFor('detailed', (dreamClass, associationName) => {
+     *   if (dreamClass.typeof(Post) && associationName === 'comments') {
+     *     return { and: { published: true } }
+     *   }
+     * })
+     *    .execute()
+     *
+     * // Skip preloading specific associations to handle them manually:
+     * await user
+     *   .loadFor('summary', (dreamClass, associationName) => {
+     *     if (dreamClass.typeof(User) && associationName === 'posts') {
+     *       return 'omit' // Handle posts preloading separately with custom logic
+     *     }
+     *   })
+     *     .load('posts', { and: { featured: true } }) // Custom preloading
+     *     .execute()
+     * ```
+     *
+     * @param serializerKey - The serializer key to use for determining which associations to preload.
+     * @param modifierFn - Optional callback function to modify or omit specific associations during preloading. Called for each association with the Dream class and association name. Return an object with `and`, `andAny`, or `andNot` properties to add where conditions, return 'omit' to skip preloading that association (useful when you want to handle it manually), or return undefined to use default preloading
+     * @returns A Query with all serialization associations preloaded
+     */
+    leftJoinLoadFor(serializerKey, modifierFn) {
+        return new LeftJoinLoadBuilder_js_1.default(this)['leftJoinLoadFor'](serializerKey, modifierFn);
+    }
     /**
      * Returns true if the association specified has
      * been loaded on this instance

package/dist/cjs/src/dream/DreamClassTransactionBuilder.js

@@ -370,6 +370,52 @@ class DreamClassTransactionBuilder {
     leftJoinPreload(...args) {
         return this.queryInstance().leftJoinPreload(...args);
     }
+    /**
+     * Recursively left-join-preloads all Dream associations referenced by `rendersOne` and `rendersMany`
+     * in a DreamSerializer. This traverses the entire content tree of serializers to automatically
+     * load all necessary associations, eliminating N+1 query problems and removing the need to
+     * manually remember which associations to preload for serialization.
+     *
+     * This method decouples data loading code from data rendering code by having the serializer
+     * (rendering code) inform the query (loading code) about which associations are needed.
+     * As serializers evolve over time - adding new `rendersOne` and `rendersMany` calls or
+     * modifying existing ones - the loading code automatically adapts without requiring
+     * corresponding modifications to preload statements.
+     *
+     * This method analyzes the serializer (specified by `serializerKey` or 'default') and
+     * automatically preloads all associations that will be needed during serialization.
+     *
+     * ```ts
+     * // Instead of manually specifying all associations:
+     * await User.preload('posts', 'comments', 'replies').all()
+     *
+     * // Automatically preload everything needed for serialization:
+     * await User.preloadFor('summary').all()
+     *
+     * // Add where conditions to specific associations during preloading:
+     * await User.txn(txn).leftJoinPreloadFor('detailed', (dreamClass, associationName) => {
+     *   if (dreamClass.typeof(Post) && associationName === 'comments') {
+     *     return { and: { published: true } }
+     *   }
+     * }).all()
+     *
+     * // Skip preloading specific associations to handle them manually:
+     * await User.txn(txn).leftJoinPreloadFor('summary', (dreamClass, associationName) => {
+     *   if (dreamClass.typeof(User) && associationName === 'posts') {
+     *     return 'omit' // Handle posts preloading separately with custom logic
+     *   }
+     * })
+     * .preload('posts', { and: { featured: true } }) // Custom preloading
+     * .all()
+     * ```
+     *
+     * @param serializerKey - The serializer key to use for determining which associations to preload.
+     * @param modifierFn - Optional callback function to modify or omit specific associations during preloading. Called for each association with the Dream class and association name. Return an object with `and`, `andAny`, or `andNot` properties to add where conditions, return 'omit' to skip preloading that association (useful when you want to handle it manually), or return undefined to use default preloading
+     * @returns A Query with all serialization associations preloaded
+     */
+    leftJoinPreloadFor(serializerKey, modifierFn) {
+        return this.queryInstance().leftJoinPreloadFor(serializerKey, modifierFn);
+    }
     /**
      * Applies preload statement to a Query scoped to this model.
      * Upon instantiating records of this model type,
@@ -394,6 +440,52 @@ class DreamClassTransactionBuilder {
     preload(...args) {
         return this.queryInstance().preload(...args);
     }
+    /**
+     * Recursively preloads all Dream associations referenced by `rendersOne` and `rendersMany`
+     * in a DreamSerializer. This traverses the entire content tree of serializers to automatically
+     * load all necessary associations, eliminating N+1 query problems and removing the need to
+     * manually remember which associations to preload for serialization.
+     *
+     * This method decouples data loading code from data rendering code by having the serializer
+     * (rendering code) inform the query (loading code) about which associations are needed.
+     * As serializers evolve over time - adding new `rendersOne` and `rendersMany` calls or
+     * modifying existing ones - the loading code automatically adapts without requiring
+     * corresponding modifications to preload statements.
+     *
+     * This method analyzes the serializer (specified by `serializerKey` or 'default') and
+     * automatically preloads all associations that will be needed during serialization.
+     *
+     * ```ts
+     * // Instead of manually specifying all associations:
+     * await User.preload('posts', 'comments', 'replies').all()
+     *
+     * // Automatically preload everything needed for serialization:
+     * await User.preloadFor('summary').all()
+     *
+     * // Add where conditions to specific associations during preloading:
+     * await User.txn(txn).preloadFor('detailed', (dreamClass, associationName) => {
+     *   if (dreamClass.typeof(Post) && associationName === 'comments') {
+     *     return { and: { published: true } }
+     *   }
+     * }).all()
+     *
+     * // Skip preloading specific associations to handle them manually:
+     * await User.txn(txn).preloadFor('summary', (dreamClass, associationName) => {
+     *   if (dreamClass.typeof(User) && associationName === 'posts') {
+     *     return 'omit' // Handle posts preloading separately with custom logic
+     *   }
+     * })
+     * .preload('posts', { and: { featured: true } }) // Custom preloading
+     * .all()
+     * ```
+     *
+     * @param serializerKey - The serializer key to use for determining which associations to preload.
+     * @param modifierFn - Optional callback function to modify or omit specific associations during preloading. Called for each association with the Dream class and association name. Return an object with `and`, `andAny`, or `andNot` properties to add where conditions, return 'omit' to skip preloading that association (useful when you want to handle it manually), or return undefined to use default preloading
+     * @returns A Query with all serialization associations preloaded
+     */
+    preloadFor(serializerKey, modifierFn) {
+        return this.queryInstance().preloadFor(serializerKey, modifierFn);
+    }
     /**
      * Returns a new Query instance with the provided
      * inner join statement attached

package/dist/cjs/src/dream/DreamInstanceTransactionBuilder.js

@@ -55,6 +55,55 @@ class DreamInstanceTransactionBuilder {
     load(...args) {
         return new LoadBuilder_js_1.default(this.dreamInstance, this.dreamTransaction).load(...args);
     }
+    /**
+     * Recursively loads all Dream associations referenced by `rendersOne` and `rendersMany`
+     * in a DreamSerializer. This traverses the entire content tree of serializers to automatically
+     * load all necessary associations, eliminating N+1 query problems and removing the need to
+     * manually remember which associations to preload for serialization.
+     *
+     * This method decouples data loading code from data rendering code by having the serializer
+     * (rendering code) inform the query (loading code) about which associations are needed.
+     * As serializers evolve over time - adding new `rendersOne` and `rendersMany` calls or
+     * modifying existing ones - the loading code automatically adapts without requiring
+     * corresponding modifications to preload statements.
+     *
+     * This method analyzes the serializer (specified by `serializerKey` or 'default') and
+     * automatically preloads all associations that will be needed during serialization.
+     *
+     * ```ts
+     * // Instead of manually specifying all associations:
+     * await User.preload('posts', 'comments', 'replies').all()
+     *
+     * // Automatically preload everything needed for serialization:
+     * await user.loadFor('summary').execute()
+     *
+     * // Add where conditions to specific associations during preloading:
+     * await user.txn(txn).loadFor('detailed', (dreamClass, associationName) => {
+     *   if (dreamClass.typeof(Post) && associationName === 'comments') {
+     *     return { and: { published: true } }
+     *   }
+     * })
+     *    .execute()
+     *
+     * // Skip preloading specific associations to handle them manually:
+     * await user
+     *   .txn(txn)
+     *   .loadFor('summary', (dreamClass, associationName) => {
+     *     if (dreamClass.typeof(User) && associationName === 'posts') {
+     *       return 'omit' // Handle posts preloading separately with custom logic
+     *     }
+     *   })
+     *     .load('posts', { and: { featured: true } }) // Custom preloading
+     *     .execute()
+     * ```
+     *
+     * @param serializerKey - The serializer key to use for determining which associations to preload.
+     * @param modifierFn - Optional callback function to modify or omit specific associations during preloading. Called for each association with the Dream class and association name. Return an object with `and`, `andAny`, or `andNot` properties to add where conditions, return 'omit' to skip preloading that association (useful when you want to handle it manually), or return undefined to use default preloading
+     * @returns A Query with all serialization associations preloaded
+     */
+    loadFor(serializerKey, modifierFn) {
+        return new LoadBuilder_js_1.default(this.dreamInstance, this.dreamTransaction)['loadFor'](serializerKey, modifierFn);
+    }
     /**
      * Load each specified association using a single SQL query.
      * See {@link #load} for loading in separate queries.
@@ -90,6 +139,55 @@ class DreamInstanceTransactionBuilder {
     leftJoinLoad(...args) {
         return new LeftJoinLoadBuilder_js_1.default(this.dreamInstance, this.dreamTransaction).leftJoinLoad(...args);
     }
+    /**
+     * Recursively loads all Dream associations referenced by `rendersOne` and `rendersMany`
+     * in a DreamSerializer. This traverses the entire content tree of serializers to automatically
+     * load all necessary associations, eliminating N+1 query problems and removing the need to
+     * manually remember which associations to preload for serialization.
+     *
+     * This method decouples data loading code from data rendering code by having the serializer
+     * (rendering code) inform the query (loading code) about which associations are needed.
+     * As serializers evolve over time - adding new `rendersOne` and `rendersMany` calls or
+     * modifying existing ones - the loading code automatically adapts without requiring
+     * corresponding modifications to preload statements.
+     *
+     * This method analyzes the serializer (specified by `serializerKey` or 'default') and
+     * automatically preloads all associations that will be needed during serialization.
+     *
+     * ```ts
+     * // Instead of manually specifying all associations:
+     * await User.preload('posts', 'comments', 'replies').all()
+     *
+     * // Automatically preload everything needed for serialization:
+     * await user.leftJoinLoadFor('summary').execute()
+     *
+     * // Add where conditions to specific associations during preloading:
+     * await user.txn(txn).leftJoinLoadFor('detailed', (dreamClass, associationName) => {
+     *   if (dreamClass.typeof(Post) && associationName === 'comments') {
+     *     return { and: { published: true } }
+     *   }
+     * })
+     *    .execute()
+     *
+     * // Skip preloading specific associations to handle them manually:
+     * await user
+     *   .txn(txn)
+     *   .leftJoinLoadFor('summary', (dreamClass, associationName) => {
+     *     if (dreamClass.typeof(User) && associationName === 'posts') {
+     *       return 'omit' // Handle posts preloading separately with custom logic
+     *     }
+     *   })
+     *     .load('posts', { and: { featured: true } }) // Custom preloading
+     *     .execute()
+     * ```
+     *
+     * @param serializerKey - The serializer key to use for determining which associations to preload.
+     * @param modifierFn - Optional callback function to modify or omit specific associations during preloading. Called for each association with the Dream class and association name. Return an object with `and`, `andAny`, or `andNot` properties to add where conditions, return 'omit' to skip preloading that association (useful when you want to handle it manually), or return undefined to use default preloading
+     * @returns A Query with all serialization associations preloaded
+     */
+    leftJoinLoadFor(serializerKey, modifierFn) {
+        return new LeftJoinLoadBuilder_js_1.default(this.dreamInstance, this.dreamTransaction)['leftJoinLoadFor'](serializerKey, modifierFn);
+    }
     /**
      * Returns a new Query instance with the provided
      * inner join statement attached

package/dist/cjs/src/dream/LeftJoinLoadBuilder.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 const UnexpectedUndefined_js_1 = require("../errors/UnexpectedUndefined.js");
+const unaliasTableName_js_1 = require("./internal/unaliasTableName.js");
 class LeftJoinLoadBuilder {
     dreamTransaction;
     dream;
@@ -45,6 +46,55 @@ class LeftJoinLoadBuilder {
         this.query = this.query.leftJoinPreload(...args);
         return this;
     }
+    /**
+     * Recursively loads all Dream associations referenced by `rendersOne` and `rendersMany`
+     * in a DreamSerializer. This traverses the entire content tree of serializers to automatically
+     * load all necessary associations, eliminating N+1 query problems and removing the need to
+     * manually remember which associations to preload for serialization.
+     *
+     * This method decouples data loading code from data rendering code by having the serializer
+     * (rendering code) inform the query (loading code) about which associations are needed.
+     * As serializers evolve over time - adding new `rendersOne` and `rendersMany` calls or
+     * modifying existing ones - the loading code automatically adapts without requiring
+     * corresponding modifications to preload statements.
+     *
+     * This method analyzes the serializer (specified by `serializerKey` or 'default') and
+     * automatically preloads all associations that will be needed during serialization.
+     *
+     * ```ts
+     * // Instead of manually specifying all associations:
+     * await User.preload('posts', 'comments', 'replies').all()
+     *
+     * // Automatically preload everything needed for serialization:
+     * await user.leftJoinLoadFor('summary').execute()
+     *
+     * // Add where conditions to specific associations during preloading:
+     * await user.leftJoinLoadFor('detailed', (dreamClass, associationName) => {
+     *   if (dreamClass.typeof(Post) && associationName === 'comments') {
+     *     return { and: { published: true } }
+     *   }
+     * })
+     *    .execute()
+     *
+     * // Skip preloading specific associations to handle them manually:
+     * await user
+     *   .leftJoinLoadFor('summary', (dreamClass, associationName) => {
+     *     if (dreamClass.typeof(User) && associationName === 'posts') {
+     *       return 'omit' // Handle posts preloading separately with custom logic
+     *     }
+     *   })
+     *     .load('posts', { and: { featured: true } }) // Custom preloading
+     *     .execute()
+     * ```
+     *
+     * @param serializerKey - The serializer key to use for determining which associations to preload.
+     * @param modifierFn - Optional callback function to modify or omit specific associations during preloading. Called for each association with the Dream class and association name. Return an object with `and`, `andAny`, or `andNot` properties to add where conditions, return 'omit' to skip preloading that association (useful when you want to handle it manually), or return undefined to use default preloading
+     * @returns A Query with all serialization associations preloaded
+     */
+    leftJoinLoadFor(serializerKey, modifierFn) {
+        this.query = this.query.leftJoinPreloadFor(serializerKey, modifierFn);
+        return this;
+    }
     /**
      * executes a load builder query, binding
      * all associations to their respective model
@@ -63,7 +113,8 @@ class LeftJoinLoadBuilder {
             this.query = this.query.txn(this.dreamTransaction);
         }
         const dreamWithLoadedAssociations = await this.query.firstOrFail();
-        Object.keys(this.query['leftJoinStatements']).forEach(associationName => {
+        Object.keys(this.query['leftJoinStatements']).forEach(aliasedAssociationName => {
+            const associationName = (0, unaliasTableName_js_1.default)(aliasedAssociationName);
             const associationMetadata = this.dream['getAssociationMetadata'](associationName);
             if (associationMetadata === undefined)
                 throw new UnexpectedUndefined_js_1.default();

package/dist/cjs/src/dream/LoadBuilder.js

@@ -44,6 +44,55 @@ class LoadBuilder {
         this.query = this.query.preload(...args);
         return this;
     }
+    /**
+     * Recursively loads all Dream associations referenced by `rendersOne` and `rendersMany`
+     * in a DreamSerializer. This traverses the entire content tree of serializers to automatically
+     * load all necessary associations, eliminating N+1 query problems and removing the need to
+     * manually remember which associations to preload for serialization.
+     *
+     * This method decouples data loading code from data rendering code by having the serializer
+     * (rendering code) inform the query (loading code) about which associations are needed.
+     * As serializers evolve over time - adding new `rendersOne` and `rendersMany` calls or
+     * modifying existing ones - the loading code automatically adapts without requiring
+     * corresponding modifications to preload statements.
+     *
+     * This method analyzes the serializer (specified by `serializerKey` or 'default') and
+     * automatically preloads all associations that will be needed during serialization.
+     *
+     * ```ts
+     * // Instead of manually specifying all associations:
+     * await User.preload('posts', 'comments', 'replies').all()
+     *
+     * // Automatically preload everything needed for serialization:
+     * await user.loadFor('summary').execute()
+     *
+     * // Add where conditions to specific associations during preloading:
+     * await user.loadFor('detailed', (dreamClass, associationName) => {
+     *   if (dreamClass.typeof(Post) && associationName === 'comments') {
+     *     return { and: { published: true } }
+     *   }
+     * })
+     *    .execute()
+     *
+     * // Skip preloading specific associations to handle them manually:
+     * await user
+     *   .loadFor('summary', (dreamClass, associationName) => {
+     *     if (dreamClass.typeof(User) && associationName === 'posts') {
+     *       return 'omit' // Handle posts preloading separately with custom logic
+     *     }
+     *   })
+     *     .load('posts', { and: { featured: true } }) // Custom preloading
+     *     .execute()
+     * ```
+     *
+     * @param serializerKey - The serializer key to use for determining which associations to preload.
+     * @param modifierFn - Optional callback function to modify or omit specific associations during preloading. Called for each association with the Dream class and association name. Return an object with `and`, `andAny`, or `andNot` properties to add where conditions, return 'omit' to skip preloading that association (useful when you want to handle it manually), or return undefined to use default preloading
+     * @returns A Query with all serialization associations preloaded
+     */
+    loadFor(serializerKey, modifierFn) {
+        this.query = this.query.preloadFor(serializerKey, modifierFn);
+        return this;
+    }
     /**
      * executes a load builder query, binding
      * all associations to their respective model