@rvoh/dream 0.40.4 → 0.40.6

package/dist/cjs/src/Dream.js

@@ -18,11 +18,13 @@ const destroyDream_js_1 = require("./dream/internal/destroyDream.js");
 const destroyOptions_js_1 = require("./dream/internal/destroyOptions.js");
 const ensureSTITypeFieldIsSet_js_1 = require("./dream/internal/ensureSTITypeFieldIsSet.js");
 const extractAssociationMetadataFromAssociationName_js_1 = require("./dream/internal/extractAssociationMetadataFromAssociationName.js");
+const findOrCreateBy_js_1 = require("./dream/internal/findOrCreateBy.js");
 const reload_js_1 = require("./dream/internal/reload.js");
 const runValidations_js_1 = require("./dream/internal/runValidations.js");
 const saveDream_js_1 = require("./dream/internal/saveDream.js");
 const scopeHelpers_js_1 = require("./dream/internal/scopeHelpers.js");
 const undestroyDream_js_1 = require("./dream/internal/undestroyDream.js");
+const updateOrCreateBy_js_1 = require("./dream/internal/updateOrCreateBy.js");
 const LeftJoinLoadBuilder_js_1 = require("./dream/LeftJoinLoadBuilder.js");
 const LoadBuilder_js_1 = require("./dream/LoadBuilder.js");
 const Query_js_1 = require("./dream/Query.js");
@@ -36,6 +38,7 @@ const NonLoadedAssociation_js_1 = require("./errors/associations/NonLoadedAssoci
 const CannotCallUndestroyOnANonSoftDeleteModel_js_1 = require("./errors/CannotCallUndestroyOnANonSoftDeleteModel.js");
 const ConstructorOnlyForInternalUse_js_1 = require("./errors/ConstructorOnlyForInternalUse.js");
 const CreateOrFindByFailedToCreateAndFind_js_1 = require("./errors/CreateOrFindByFailedToCreateAndFind.js");
+const CreateOrUpdateByFailedToCreateAndUpdate_js_1 = require("./errors/CreateOrUpdateByFailedToCreateAndUpdate.js");
 const GlobalNameNotSet_js_1 = require("./errors/dream-app/GlobalNameNotSet.js");
 const DreamMissingRequiredOverride_js_1 = require("./errors/DreamMissingRequiredOverride.js");
 const MissingSerializersDefinition_js_1 = require("./errors/MissingSerializersDefinition.js");
@@ -656,11 +659,12 @@ class Dream {
      * ```
      *
      * @param attributes - attributes or belongs to associations you wish to set on this model before persisting
+     * @param opts.skipHooks - if true, will skip applying model hooks. Defaults to false
      * @returns A newly persisted dream instance
      */
-    static async create(attributes) {
+    static async create(attributes, { skipHooks } = {}) {
         const dreamModel = this.new(attributes);
-        await dreamModel.save();
+        await dreamModel.save(skipHooks ? { skipHooks } : undefined);
         return dreamModel;
     }
     /**
@@ -701,6 +705,62 @@ class Dream {
             throw err;
         }
     }
+    /**
+     * Attempt to update the model with the given attributes.
+     * If no record is found, then a new record is created.
+     * All lifecycle hooks are run for whichever action is taken.
+     *
+     * ```ts
+     * const user = await User.updateOrCreateBy({ email }, { with: { name: 'Alice' })
+     * ```
+     *
+     * @param attributes - The base attributes for finding which record to update, also used when creating
+     * @param extraOpts.with - additional attributes to persist when updating and creating, but not used for finding
+     * @param extraOpts.skipHooks - if true, will skip applying model hooks. Defaults to false
+     * @returns A dream instance
+     */
+    static async updateOrCreateBy(attributes, extraOpts = {}) {
+        return await (0, updateOrCreateBy_js_1.default)(this, null, attributes, extraOpts);
+    }
+    /**
+     * Attempt to create the model with the given attributes.
+     * If creation fails due to uniqueness constraint, then find and update
+     * the existing model. All lifecycle hooks are run for whichever
+     * action is taken.
+     *
+     * This is useful in situations where we want to avoid
+     * a race condition creating duplicate records.
+     *
+     * IMPORTANT: A unique index/uniqueness constraint must exist on
+     * at least one of the provided attributes
+     *
+     * @param attributes - The base attributes for finding which record to update, also used when creating
+     * @param extraOpts.with - additional attributes to persist when updating and creating, but not used for finding
+     * @param extraOpts.skipHooks - if true, will skip applying model hooks. Defaults to false
+     * @returns A dream instance
+     */
+    static async createOrUpdateBy(attributes, extraOpts = {}) {
+        const { skipHooks } = extraOpts;
+        try {
+            return await this.create({
+                ...attributes,
+                ...(extraOpts?.with || {}),
+            }, skipHooks ? { skipHooks } : undefined);
+        }
+        catch (err) {
+            if ((0, errors_js_1.pgErrorType)(err) === 'UNIQUE_CONSTRAINT_VIOLATION') {
+                const existingRecord = await this.findBy(this.extractAttributesFromUpdateableProperties(attributes));
+                if (!existingRecord)
+                    throw new CreateOrUpdateByFailedToCreateAndUpdate_js_1.default(this);
+                const { with: attrs } = extraOpts;
+                if (existingRecord) {
+                    existingRecord.assignAttributes(attrs ?? {});
+                    return await (0, saveDream_js_1.default)(existingRecord, null, skipHooks ? { skipHooks } : undefined);
+                }
+            }
+            throw err;
+        }
+    }
     /**
      * Returns a new query instance with the distinct query applied.
      * If no columnName is provided, then distinct will apply to the
@@ -852,15 +912,7 @@ class Dream {
      * @returns A dream instance
      */
     static async findOrCreateBy(attributes, extraOpts = {}) {
-        const existingRecord = await this.findBy(this.extractAttributesFromUpdateableProperties(attributes));
-        if (existingRecord)
-            return existingRecord;
-        const dreamModel = this.new({
-            ...attributes,
-            ...(extraOpts?.createWith || {}),
-        });
-        await dreamModel.save();
-        return dreamModel;
+        return await (0, findOrCreateBy_js_1.default)(this, null, attributes, extraOpts);
     }
     /**
      * Returns true if a record exists for the given
@@ -1254,7 +1306,7 @@ class Dream {
      * @returns A Query scoped to this model with the transaction applied
      */
     static txn(txn) {
-        return new DreamClassTransactionBuilder_js_1.default(this.prototype, txn);
+        return new DreamClassTransactionBuilder_js_1.default(this, txn);
     }
     /**
      * Builds a new DreamTransaction instance, provides

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

@@ -1,19 +1,23 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+const findOrCreateBy_js_1 = require("./internal/findOrCreateBy.js");
 const saveDream_js_1 = require("./internal/saveDream.js");
+const updateOrCreateBy_js_1 = require("./internal/updateOrCreateBy.js");
 const Query_js_1 = require("./Query.js");
 class DreamClassTransactionBuilder {
-    dreamInstance;
+    dreamClass;
     dreamTransaction;
+    dreamInstance;
     /**
      * Constructs a new DreamClassTransactionBuilder.
      *
      * @param dreamInstance - The Dream instance to build the transaction for
      * @param txn - The DreamTransaction instance
      */
-    constructor(dreamInstance, dreamTransaction) {
-        this.dreamInstance = dreamInstance;
+    constructor(dreamClass, dreamTransaction) {
+        this.dreamClass = dreamClass;
         this.dreamTransaction = dreamTransaction;
+        this.dreamInstance = dreamClass.prototype;
     }
     /**
      * Retrieves an array containing all records corresponding to
@@ -122,9 +126,9 @@ class DreamClassTransactionBuilder {
      * @param attributes - Attributes or belongs to associations you wish to set on this model before persisting
      * @returns A newly persisted dream instance
      */
-    async create(attributes) {
-        const dream = this.dreamInstance.constructor.new(attributes);
-        return (0, saveDream_js_1.default)(dream, this.dreamTransaction);
+    async create(attributes, { skipHooks } = {}) {
+        const dream = this.dreamClass.new(attributes);
+        return (0, saveDream_js_1.default)(dream, this.dreamTransaction, skipHooks ? { skipHooks } : undefined);
     }
     /**
      * Finds a record for the corresponding model with the
@@ -196,6 +200,42 @@ class DreamClassTransactionBuilder {
     async findOrFailBy(whereStatement) {
         return await this.queryInstance().findOrFailBy(whereStatement);
     }
+    /**
+     * Attempt to find the model with the given attributes.
+     * If no record is found, then a new record is created.
+     *
+     * ```ts
+     * await ApplicationModel.transaction(async txn => {
+     *   await User.txn(txn).findOrCreateBy({ email }, { createWith: params })
+     * })
+     * ```
+     *
+     * @param attributes - The base attributes for finding, but also the attributes to use when creating
+     * @param extraOpts.createWith - additional attributes to persist when creating, but not used for finding
+     * @returns A dream instance
+     */
+    async findOrCreateBy(attributes, extraOpts = {}) {
+        return await (0, findOrCreateBy_js_1.default)(this.dreamClass, this.dreamTransaction, attributes, extraOpts);
+    }
+    /**
+     * Attempt to update the model with the given attributes.
+     * If no record is found, then a new record is created.
+     * All lifecycle hooks are run for whichever action is taken.
+     *
+     * ```ts
+     * await ApplicationModel.transaction(async txn => {
+     *   await User.txn(txn).updateOrCreateBy({ email }, { with: { name: 'Alice' })
+     * })
+     * ```
+     *
+     * @param attributes - The base attributes for finding, but also the attributes to use when creating
+     * @param extraOpts.with - additional attributes to persist when updating and creating, but not used for finding
+     * @param extraOpts.skipHooks - if true, will skip applying model hooks. Defaults to false
+     * @returns A dream instance
+     */
+    async updateOrCreateBy(attributes, extraOpts = {}) {
+        return await (0, updateOrCreateBy_js_1.default)(this.dreamClass, this.dreamTransaction, attributes, extraOpts);
+    }
     /**
      * Finds all records for the corresponding model in batches,
      * and then calls the provided callback for each found record.

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

@@ -26,9 +26,9 @@ class DreamInstanceTransactionBuilder {
      * @param dreamInstance - The Dream instance to build the transaction for
      * @param txn - The DreamTransaction instance
      */
-    constructor(dreamInstance, txn) {
+    constructor(dreamInstance, dreamTransaction) {
         this.dreamInstance = dreamInstance;
-        this.dreamTransaction = txn;
+        this.dreamTransaction = dreamTransaction;
     }
     /**
      * Loads the requested associations upon execution

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

@@ -2,8 +2,8 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 const UnexpectedUndefined_js_1 = require("../errors/UnexpectedUndefined.js");
 class LeftJoinLoadBuilder {
-    dream;
     dreamTransaction;
+    dream;
     query;
     /**
      * An intermediate class on the way to executing a load
@@ -15,7 +15,8 @@ class LeftJoinLoadBuilder {
      * await user.load('settings').execute()
      * ```
      */
-    constructor(dream, txn) {
+    constructor(dream, dreamTransaction) {
+        this.dreamTransaction = dreamTransaction;
         this.dream = dream['clone']();
         // Load queries start from the table corresponding to an instance
         // of a Dream. However, the Dream may have default scopes that would
@@ -24,7 +25,6 @@ class LeftJoinLoadBuilder {
         // to other associations (thus the use of `removeAllDefaultScopesExceptOnAssociations`
         // instead of `removeAllDefaultScopes`).
         this.query = this.dream.query()['removeAllDefaultScopesExceptOnAssociations']();
-        this.dreamTransaction = txn;
     }
     passthrough(passthroughWhereStatement) {
         this.query = this.query.passthrough(passthroughWhereStatement);

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

@@ -1,8 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 class LoadBuilder {
-    dream;
     dreamTransaction;
+    dream;
     query;
     /**
      * An intermediate class on the way to executing a load
@@ -14,7 +14,8 @@ class LoadBuilder {
      * await user.load('settings').execute()
      * ```
      */
-    constructor(dream, txn) {
+    constructor(dream, dreamTransaction) {
+        this.dreamTransaction = dreamTransaction;
         this.dream = dream['clone']();
         // Load queries start from the table corresponding to an instance
         // of a Dream. However, the Dream may have default scopes that would
@@ -23,7 +24,6 @@ class LoadBuilder {
         // to other associations (thus the use of `removeAllDefaultScopesExceptOnAssociations`
         // instead of `removeAllDefaultScopes`).
         this.query = this.dream.query()['removeAllDefaultScopesExceptOnAssociations']();
-        this.dreamTransaction = txn;
     }
     passthrough(passthroughWhereStatement) {
         this.query = this.query.passthrough(passthroughWhereStatement);

package/dist/cjs/src/dream/internal/associations/createAssociation.js

@@ -33,12 +33,7 @@ async function createAssociation(dream, txn = null, associationName, opts = {})
             if (hasAssociation.polymorphic) {
                 modifiedOpts[hasAssociation.foreignKeyTypeField()] = dream['stiBaseClassOrOwnClassName'];
             }
-            if (txn) {
-                hasresult = await associationClass.txn(txn).create(modifiedOpts);
-            }
-            else {
-                hasresult = await associationClass.create(modifiedOpts);
-            }
+            hasresult = await associationClass.txn(txn).create(modifiedOpts);
             return hasresult;
         case 'BelongsTo':
             belongstoFn = async (txn) => {

package/dist/cjs/src/dream/internal/destroyDream.js

@@ -40,7 +40,7 @@ async function destroyDreamWithTransaction(dream, txn, options) {
     }
     await maybeDestroyDream(dream, txn, reallyDestroy);
     if (!skipHooks) {
-        await (0, runHooksFor_js_1.default)('afterDestroy', dream, true, null, txn || undefined);
+        await (0, runHooksFor_js_1.default)('afterDestroy', dream, true, null, txn);
         await (0, runHooksFor_js_1.default)('afterDestroyCommit', dream, true, null, txn);
     }
     if (shouldSoftDelete(dream, reallyDestroy)) {

package/dist/cjs/src/dream/internal/findOrCreateBy.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = findOrCreateBy;
+async function findOrCreateBy(dreamClass, txn = null, attributes, extraOpts = {}) {
+    const existingRecord = await dreamClass
+        .txn(txn)
+        .findBy(dreamClass['extractAttributesFromUpdateableProperties'](attributes));
+    if (existingRecord)
+        return existingRecord;
+    const dreamModel = dreamClass.new({
+        ...attributes,
+        ...(extraOpts?.createWith || {}),
+    });
+    await dreamModel.txn(txn).save();
+    return dreamModel;
+}

package/dist/cjs/src/dream/internal/runHooksFor.js

@@ -39,7 +39,7 @@ async function runHooksFor(key, dream, alreadyPersisted, beforeSaveChanges, txn)
                         if (txn)
                             txn.addCommitHook(hook, dream);
                         else
-                            await runHook(hook, dream);
+                            await runHook(hook, dream, null);
                     }
                     break;
                 case 'afterSave':
@@ -54,7 +54,7 @@ async function runHooksFor(key, dream, alreadyPersisted, beforeSaveChanges, txn)
                         if (txn)
                             txn.addCommitHook(hook, dream);
                         else
-                            await runHook(hook, dream);
+                            await runHook(hook, dream, null);
                     }
                     break;
                 case 'afterUpdate':
@@ -67,7 +67,7 @@ async function runHooksFor(key, dream, alreadyPersisted, beforeSaveChanges, txn)
                         if (txn)
                             txn.addCommitHook(hook, dream);
                         else
-                            await runHook(hook, dream);
+                            await runHook(hook, dream, null);
                     }
                     break;
                 default:
@@ -83,7 +83,7 @@ async function runHooksFor(key, dream, alreadyPersisted, beforeSaveChanges, txn)
                     if (txn)
                         txn.addCommitHook(hook, dream);
                     else
-                        await runHook(hook, dream);
+                        await runHook(hook, dream, null);
                     break;
                 default:
                     await runHook(hook, dream, txn);

package/dist/cjs/src/dream/internal/saveDream.js

@@ -9,7 +9,7 @@ const sqlAttributes_js_1 = require("../../helpers/sqlAttributes.js");
 const executeDatabaseQuery_js_1 = require("./executeDatabaseQuery.js");
 const runHooksFor_js_1 = require("./runHooksFor.js");
 async function saveDream(dream, txn = null, { skipHooks = false } = {}) {
-    const db = txn?.kyselyTransaction || (0, index_js_1.default)('primary');
+    const db = txn?.kyselyTransaction ?? (0, index_js_1.default)('primary');
     const alreadyPersisted = dream.isPersisted;
     if (!skipHooks) {
         if (alreadyPersisted)

package/dist/cjs/src/dream/internal/updateOrCreateBy.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = updateOrCreateBy;
+const saveDream_js_1 = require("./saveDream.js");
+async function updateOrCreateBy(dreamClass, txn = null, attributes, extraOpts = {}) {
+    const existingRecord = await dreamClass
+        .txn(txn)
+        .findBy(dreamClass['extractAttributesFromUpdateableProperties'](attributes));
+    const { with: attrs, skipHooks } = extraOpts;
+    if (existingRecord) {
+        existingRecord.assignAttributes(attrs ?? {});
+        return await (0, saveDream_js_1.default)(existingRecord, txn, skipHooks ? { skipHooks } : undefined);
+    }
+    return await dreamClass.txn(txn).create({
+        ...attributes,
+        ...(extraOpts?.with || {}),
+    }, skipHooks ? { skipHooks } : undefined);
+}

package/dist/cjs/src/errors/CreateOrUpdateByFailedToCreateAndUpdate.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+class CreateOrUpdateByFailedToCreateAndUpdate extends Error {
+    dreamClass;
+    constructor(dreamClass) {
+        super();
+        this.dreamClass = dreamClass;
+    }
+    get message() {
+        return `
+Failed to create instance of ${this.dreamClass.sanitizedName} and no matching model exists to update.
+
+The likely cause is that one of the \`with\` fields violates
+a uniqueness constraint.
+    `;
+    }
+}
+exports.default = CreateOrUpdateByFailedToCreateAndUpdate;

package/dist/esm/src/Dream.js

@@ -16,11 +16,13 @@ import destroyDream from './dream/internal/destroyDream.js';
 import { destroyOptions, reallyDestroyOptions, undestroyOptions, } from './dream/internal/destroyOptions.js';
 import ensureSTITypeFieldIsSet from './dream/internal/ensureSTITypeFieldIsSet.js';
 import extractAssociationMetadataFromAssociationName from './dream/internal/extractAssociationMetadataFromAssociationName.js';
+import findOrCreateBy from './dream/internal/findOrCreateBy.js';
 import reload from './dream/internal/reload.js';
 import runValidations from './dream/internal/runValidations.js';
 import saveDream from './dream/internal/saveDream.js';
 import { DEFAULT_BYPASS_ALL_DEFAULT_SCOPES, DEFAULT_DEFAULT_SCOPES_TO_BYPASS, DEFAULT_SKIP_HOOKS, } from './dream/internal/scopeHelpers.js';
 import undestroyDream from './dream/internal/undestroyDream.js';
+import updateOrCreateBy from './dream/internal/updateOrCreateBy.js';
 import LeftJoinLoadBuilder from './dream/LeftJoinLoadBuilder.js';
 import LoadBuilder from './dream/LoadBuilder.js';
 import Query from './dream/Query.js';
@@ -34,6 +36,7 @@ import NonLoadedAssociation from './errors/associations/NonLoadedAssociation.js'
 import CannotCallUndestroyOnANonSoftDeleteModel from './errors/CannotCallUndestroyOnANonSoftDeleteModel.js';
 import ConstructorOnlyForInternalUse from './errors/ConstructorOnlyForInternalUse.js';
 import CreateOrFindByFailedToCreateAndFind from './errors/CreateOrFindByFailedToCreateAndFind.js';
+import CreateOrUpdateByFailedToCreateAndUpdate from './errors/CreateOrUpdateByFailedToCreateAndUpdate.js';
 import GlobalNameNotSet from './errors/dream-app/GlobalNameNotSet.js';
 import DreamMissingRequiredOverride from './errors/DreamMissingRequiredOverride.js';
 import MissingSerializer from './errors/MissingSerializersDefinition.js';
@@ -654,11 +657,12 @@ export default class Dream {
      * ```
      *
      * @param attributes - attributes or belongs to associations you wish to set on this model before persisting
+     * @param opts.skipHooks - if true, will skip applying model hooks. Defaults to false
      * @returns A newly persisted dream instance
      */
-    static async create(attributes) {
+    static async create(attributes, { skipHooks } = {}) {
         const dreamModel = this.new(attributes);
-        await dreamModel.save();
+        await dreamModel.save(skipHooks ? { skipHooks } : undefined);
         return dreamModel;
     }
     /**
@@ -699,6 +703,62 @@ export default class Dream {
             throw err;
         }
     }
+    /**
+     * Attempt to update the model with the given attributes.
+     * If no record is found, then a new record is created.
+     * All lifecycle hooks are run for whichever action is taken.
+     *
+     * ```ts
+     * const user = await User.updateOrCreateBy({ email }, { with: { name: 'Alice' })
+     * ```
+     *
+     * @param attributes - The base attributes for finding which record to update, also used when creating
+     * @param extraOpts.with - additional attributes to persist when updating and creating, but not used for finding
+     * @param extraOpts.skipHooks - if true, will skip applying model hooks. Defaults to false
+     * @returns A dream instance
+     */
+    static async updateOrCreateBy(attributes, extraOpts = {}) {
+        return await updateOrCreateBy(this, null, attributes, extraOpts);
+    }
+    /**
+     * Attempt to create the model with the given attributes.
+     * If creation fails due to uniqueness constraint, then find and update
+     * the existing model. All lifecycle hooks are run for whichever
+     * action is taken.
+     *
+     * This is useful in situations where we want to avoid
+     * a race condition creating duplicate records.
+     *
+     * IMPORTANT: A unique index/uniqueness constraint must exist on
+     * at least one of the provided attributes
+     *
+     * @param attributes - The base attributes for finding which record to update, also used when creating
+     * @param extraOpts.with - additional attributes to persist when updating and creating, but not used for finding
+     * @param extraOpts.skipHooks - if true, will skip applying model hooks. Defaults to false
+     * @returns A dream instance
+     */
+    static async createOrUpdateBy(attributes, extraOpts = {}) {
+        const { skipHooks } = extraOpts;
+        try {
+            return await this.create({
+                ...attributes,
+                ...(extraOpts?.with || {}),
+            }, skipHooks ? { skipHooks } : undefined);
+        }
+        catch (err) {
+            if (pgErrorType(err) === 'UNIQUE_CONSTRAINT_VIOLATION') {
+                const existingRecord = await this.findBy(this.extractAttributesFromUpdateableProperties(attributes));
+                if (!existingRecord)
+                    throw new CreateOrUpdateByFailedToCreateAndUpdate(this);
+                const { with: attrs } = extraOpts;
+                if (existingRecord) {
+                    existingRecord.assignAttributes(attrs ?? {});
+                    return await saveDream(existingRecord, null, skipHooks ? { skipHooks } : undefined);
+                }
+            }
+            throw err;
+        }
+    }
     /**
      * Returns a new query instance with the distinct query applied.
      * If no columnName is provided, then distinct will apply to the
@@ -850,15 +910,7 @@ export default class Dream {
      * @returns A dream instance
      */
     static async findOrCreateBy(attributes, extraOpts = {}) {
-        const existingRecord = await this.findBy(this.extractAttributesFromUpdateableProperties(attributes));
-        if (existingRecord)
-            return existingRecord;
-        const dreamModel = this.new({
-            ...attributes,
-            ...(extraOpts?.createWith || {}),
-        });
-        await dreamModel.save();
-        return dreamModel;
+        return await findOrCreateBy(this, null, attributes, extraOpts);
     }
     /**
      * Returns true if a record exists for the given
@@ -1252,7 +1304,7 @@ export default class Dream {
      * @returns A Query scoped to this model with the transaction applied
      */
     static txn(txn) {
-        return new DreamClassTransactionBuilder(this.prototype, txn);
+        return new DreamClassTransactionBuilder(this, txn);
     }
     /**
      * Builds a new DreamTransaction instance, provides

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

@@ -1,17 +1,21 @@
+import findOrCreateBy from './internal/findOrCreateBy.js';
 import saveDream from './internal/saveDream.js';
+import updateOrCreateBy from './internal/updateOrCreateBy.js';
 import Query from './Query.js';
 export default class DreamClassTransactionBuilder {
-    dreamInstance;
+    dreamClass;
     dreamTransaction;
+    dreamInstance;
     /**
      * Constructs a new DreamClassTransactionBuilder.
      *
      * @param dreamInstance - The Dream instance to build the transaction for
      * @param txn - The DreamTransaction instance
      */
-    constructor(dreamInstance, dreamTransaction) {
-        this.dreamInstance = dreamInstance;
+    constructor(dreamClass, dreamTransaction) {
+        this.dreamClass = dreamClass;
         this.dreamTransaction = dreamTransaction;
+        this.dreamInstance = dreamClass.prototype;
     }
     /**
      * Retrieves an array containing all records corresponding to
@@ -120,9 +124,9 @@ export default class DreamClassTransactionBuilder {
      * @param attributes - Attributes or belongs to associations you wish to set on this model before persisting
      * @returns A newly persisted dream instance
      */
-    async create(attributes) {
-        const dream = this.dreamInstance.constructor.new(attributes);
-        return saveDream(dream, this.dreamTransaction);
+    async create(attributes, { skipHooks } = {}) {
+        const dream = this.dreamClass.new(attributes);
+        return saveDream(dream, this.dreamTransaction, skipHooks ? { skipHooks } : undefined);
     }
     /**
      * Finds a record for the corresponding model with the
@@ -194,6 +198,42 @@ export default class DreamClassTransactionBuilder {
     async findOrFailBy(whereStatement) {
         return await this.queryInstance().findOrFailBy(whereStatement);
     }
+    /**
+     * Attempt to find the model with the given attributes.
+     * If no record is found, then a new record is created.
+     *
+     * ```ts
+     * await ApplicationModel.transaction(async txn => {
+     *   await User.txn(txn).findOrCreateBy({ email }, { createWith: params })
+     * })
+     * ```
+     *
+     * @param attributes - The base attributes for finding, but also the attributes to use when creating
+     * @param extraOpts.createWith - additional attributes to persist when creating, but not used for finding
+     * @returns A dream instance
+     */
+    async findOrCreateBy(attributes, extraOpts = {}) {
+        return await findOrCreateBy(this.dreamClass, this.dreamTransaction, attributes, extraOpts);
+    }
+    /**
+     * Attempt to update the model with the given attributes.
+     * If no record is found, then a new record is created.
+     * All lifecycle hooks are run for whichever action is taken.
+     *
+     * ```ts
+     * await ApplicationModel.transaction(async txn => {
+     *   await User.txn(txn).updateOrCreateBy({ email }, { with: { name: 'Alice' })
+     * })
+     * ```
+     *
+     * @param attributes - The base attributes for finding, but also the attributes to use when creating
+     * @param extraOpts.with - additional attributes to persist when updating and creating, but not used for finding
+     * @param extraOpts.skipHooks - if true, will skip applying model hooks. Defaults to false
+     * @returns A dream instance
+     */
+    async updateOrCreateBy(attributes, extraOpts = {}) {
+        return await updateOrCreateBy(this.dreamClass, this.dreamTransaction, attributes, extraOpts);
+    }
     /**
      * Finds all records for the corresponding model in batches,
      * and then calls the provided callback for each found record.

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

@@ -24,9 +24,9 @@ export default class DreamInstanceTransactionBuilder {
      * @param dreamInstance - The Dream instance to build the transaction for
      * @param txn - The DreamTransaction instance
      */
-    constructor(dreamInstance, txn) {
+    constructor(dreamInstance, dreamTransaction) {
         this.dreamInstance = dreamInstance;
-        this.dreamTransaction = txn;
+        this.dreamTransaction = dreamTransaction;
     }
     /**
      * Loads the requested associations upon execution

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

@@ -1,7 +1,7 @@
 import UnexpectedUndefined from '../errors/UnexpectedUndefined.js';
 export default class LeftJoinLoadBuilder {
-    dream;
     dreamTransaction;
+    dream;
     query;
     /**
      * An intermediate class on the way to executing a load
@@ -13,7 +13,8 @@ export default class LeftJoinLoadBuilder {
      * await user.load('settings').execute()
      * ```
      */
-    constructor(dream, txn) {
+    constructor(dream, dreamTransaction) {
+        this.dreamTransaction = dreamTransaction;
         this.dream = dream['clone']();
         // Load queries start from the table corresponding to an instance
         // of a Dream. However, the Dream may have default scopes that would
@@ -22,7 +23,6 @@ export default class LeftJoinLoadBuilder {
         // to other associations (thus the use of `removeAllDefaultScopesExceptOnAssociations`
         // instead of `removeAllDefaultScopes`).
         this.query = this.dream.query()['removeAllDefaultScopesExceptOnAssociations']();
-        this.dreamTransaction = txn;
     }
     passthrough(passthroughWhereStatement) {
         this.query = this.query.passthrough(passthroughWhereStatement);