@rvoh/dream 2.28.2 → 2.29.0

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

@@ -190,7 +190,7 @@ export default class DreamInstanceTransactionBuilder {
      * @param options - Options for destroying the instance
      * @param options.skipHooks - If true, skips applying model hooks during the destroy operation. Defaults to false
      * @param options.cascade - If false, skips destroying associations marked `dependent: 'destroy'`. Defaults to true
-     * @param options.bypassAllDefaultScopes - If true, bypasses all default scopes when cascade destroying. Defaults to false
+     * @param options.bypassAllDefaultScopes - If true, bypasses user-removable default scopes when cascade destroying; an STI child's reserved discriminator remains enforced, including when associations are loaded. Defaults to false
      * @param options.defaultScopesToBypass - An array of default scope names to bypass when cascade destroying. Defaults to an empty array
      * @returns The instance that was destroyed
      */
@@ -212,7 +212,7 @@ export default class DreamInstanceTransactionBuilder {
      * @param options - Options for destroying the instance
      * @param options.skipHooks - If true, skips applying model hooks during the destroy operation. Defaults to false
      * @param options.cascade - If false, skips destroying associations marked `dependent: 'destroy'`. Defaults to true
-     * @param options.bypassAllDefaultScopes - If true, bypasses all default scopes when cascade destroying. Defaults to false
+     * @param options.bypassAllDefaultScopes - If true, bypasses user-removable default scopes when cascade destroying; an STI child's reserved discriminator remains enforced, including when associations are loaded. Defaults to false
      * @param options.defaultScopesToBypass - An array of default scope names to bypass when cascade destroying. Defaults to an empty array
      * @returns The instance that was destroyed
      */
@@ -227,14 +227,14 @@ export default class DreamInstanceTransactionBuilder {
      * this will raise an exception.
      *
      * ```ts
-     * const user = await User.removeAllDefaultScopes().last()
+     * const user = await User.removeDefaultScope('dream:SoftDelete').last()
      * await user.txn(txn).undestroy()
      * ```
      *
      * @param options - Options for undestroying the instance
      * @param options.skipHooks - If true, skips applying model hooks during the undestroy operation. Defaults to false
      * @param options.cascade - If false, skips undestroying associations marked `dependent: 'destroy'`. Defaults to true
-     * @param options.bypassAllDefaultScopes - If true, bypasses all default scopes when cascade undestroying. Defaults to false
+     * @param options.bypassAllDefaultScopes - If true, bypasses user-removable default scopes when cascade undestroying; an STI child's reserved discriminator remains enforced, including when associations are loaded. Defaults to false
      * @param options.defaultScopesToBypass - An array of default scope names to bypass when cascade undestroying (soft delete is always bypassed). Defaults to an empty array
      * @returns The undestroyed instance
      */
@@ -403,7 +403,7 @@ export default class DreamInstanceTransactionBuilder {
      * @param attributes - The attributes to update on the association
      * @param updateAssociationOptions - Options for updating the association
      * @param updateAssociationOptions.where - Optional where statement to apply to query before updating
-     * @param updateAssociationOptions.bypassAllDefaultScopes - If true, bypasses all default scopes when updating the association. Defaults to false
+     * @param updateAssociationOptions.bypassAllDefaultScopes - If true, bypasses user-removable default scopes when updating the association; an STI child's reserved discriminator remains enforced, including when associations are loaded. Defaults to false
      * @param updateAssociationOptions.defaultScopesToBypass - An array of default scope names to bypass when updating the association. Defaults to an empty array
      * @param updateAssociationOptions.skipHooks - If true, skips applying model hooks during the update operation. Defaults to false
      * @returns The number of updated records
@@ -460,7 +460,7 @@ export default class DreamInstanceTransactionBuilder {
      * @param options.andAny - Optional andAny statement to apply to query before destroying
      * @param options.skipHooks - If true, skips applying model hooks during the destroy operation. Defaults to false
      * @param options.cascade - If false, skips destroying associations marked `dependent: 'destroy'`. Defaults to true
-     * @param options.bypassAllDefaultScopes - If true, bypasses all default scopes when destroying the association. Defaults to false
+     * @param options.bypassAllDefaultScopes - If true, bypasses user-removable default scopes when destroying the association; an STI child's reserved discriminator remains enforced, including when associations are loaded. Defaults to false
      * @param options.defaultScopesToBypass - An array of default scope names to bypass when destroying the association. Defaults to an empty array
      * @returns The number of records deleted
      */
@@ -498,7 +498,7 @@ export default class DreamInstanceTransactionBuilder {
      * @param options.andAny - Optional andAny statement to apply to query before destroying
      * @param options.skipHooks - If true, skips applying model hooks during the destroy operation. Defaults to false
      * @param options.cascade - If true, cascades the destroy operation to associations marked with `dependent: 'destroy'`. Defaults to true
-     * @param options.bypassAllDefaultScopes - If true, bypasses all default scopes when destroying the association. Defaults to false
+     * @param options.bypassAllDefaultScopes - If true, bypasses user-removable default scopes when destroying the association; an STI child's reserved discriminator remains enforced, including when associations are loaded. Defaults to false
      * @param options.defaultScopesToBypass - An array of default scope names to bypass when destroying the association. Defaults to an empty array
      * @returns The number of records deleted
      */
@@ -531,7 +531,7 @@ export default class DreamInstanceTransactionBuilder {
      * @param options.andAny - Optional andAny statement to apply to query before undestroying
      * @param options.skipHooks - If true, skips applying model hooks during the undestroy operation. Defaults to false
      * @param options.cascade - If false, skips undestroying associations marked `dependent: 'destroy'`. Defaults to true
-     * @param options.bypassAllDefaultScopes - If true, bypasses all default scopes when undestroying the association. Defaults to false
+     * @param options.bypassAllDefaultScopes - If true, bypasses user-removable default scopes when undestroying the association; an STI child's reserved discriminator remains enforced, including when associations are loaded. Defaults to false
      * @param options.defaultScopesToBypass - An array of default scope names to bypass when undestroying the association. Defaults to an empty array
      * @returns The number of records undestroyed
      */

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

@@ -44,21 +44,24 @@ export default class LoadBuilder {
         return this;
     }
     /**
-     * Prevents all default scopes from applying when
-     * loading associations
+     * @deprecated Use {@link removeDefaultScope} instead. This method will become private in v3.
+     *
+     * Prevents user-removable default scopes from applying when loading
+     * associations. An associated STI child's reserved type discriminator remains
+     * enforced; loading through its STI base still spans registered children.
      *
      * ```ts
      * const user = await User.firstOrFail()
      * const loaded = await user
      *   .load('posts')
-     *   .removeAllDefaultScopes()
+     *   .removeDefaultScope('dream:SoftDelete')
      *   .execute()
      * ```
      *
      * @returns The LoadBuilder instance for chaining
      */
     removeAllDefaultScopes() {
-        this.query = this.query.removeAllDefaultScopes();
+        this.query = this.query['removeAllDefaultScopes']();
         return this;
     }
     /**

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

@@ -177,13 +177,13 @@ export default class Query {
     /**
      * @internal
      *
-     * Whether or not to bypass all default scopes for this Query
+     * Whether or not to bypass all user-removable default scopes for this Query
      */
     bypassAllDefaultScopes = false;
     /**
      * @internal
      *
-     * Whether or not to bypass all default scopes for this Query, but not associations
+     * Whether or not to bypass all user-removable default scopes for this Query, but not associations
      */
     bypassAllDefaultScopesExceptOnAssociations = false;
     /**
@@ -778,10 +778,14 @@ export default class Query {
         });
     }
     /**
-     * Prevents default scopes from applying when
-     * the Query is executed
+     * @deprecated Use {@link removeDefaultScope} instead. This method will become private in v3.
+     *
+     * Prevents user-removable default scopes from applying when the Query is
+     * executed, including when associations are loaded. An STI child's reserved
+     * type discriminator remains enforced; query the STI base model to span its
+     * registered children.
      *
-     * @returns A new Query which will prevent default scopes from applying
+     * @returns A new Query which bypasses user-removable default scopes
      */
     removeAllDefaultScopes() {
         return this.clone({
@@ -1044,8 +1048,19 @@ export default class Query {
      * @returns A Kysely query. Depending on the type passed, it will return either a SelectQueryBuilder, DeleteQueryBuilder, or an UpdateQueryBuilder
      */
     toKysely(type) {
+        if (type !== 'select')
+            this.assertMutationPreservesAssociationQuery();
         return this.dbDriverInstance().toKysely(type);
     }
+    /**
+     * @internal
+     *
+     * Prevents mutation paths that discard an association query's ownership constraint.
+     */
+    assertMutationPreservesAssociationQuery() {
+        if (this.baseSelectQuery)
+            throw new NoUpdateOnAssociationQuery();
+    }
     /**
      * Applies transaction to the Query instance
      *
@@ -1904,7 +1919,7 @@ export default class Query {
      * @param options.cascade - If false, skips destroying associations marked `dependent: 'destroy'`. Defaults to true
      * @param options.lock - If true, each batch is re-selected with an exclusive row lock inside its own transaction before being destroyed, making the destroy a compare-and-set. Defaults to false
      * @param options.batchSize - The number of records to process per batch. Must be a positive integer. Defaults to 10 when `lock` is true, and to 1000 otherwise
-     * @param options.bypassAllDefaultScopes - If true, bypasses all default scopes when cascade destroying. Defaults to false
+     * @param options.bypassAllDefaultScopes - If true, bypasses user-removable default scopes when cascade destroying; an STI child's reserved discriminator remains enforced, including when associations are loaded. Defaults to false
      * @param options.defaultScopesToBypass - An array of default scope names to bypass when cascade destroying. Defaults to an empty array
      * @returns The number of records that were removed
      * @throws InvalidBatchSize if `batchSize` is not a positive integer
@@ -2126,7 +2141,7 @@ export default class Query {
      * @param options.cascade - If false, skips destroying associations marked `dependent: 'destroy'`. Defaults to true
      * @param options.lock - If true, each batch is re-selected with an exclusive row lock inside its own transaction before being destroyed, making the destroy a compare-and-set. See {@link Query.destroy} for the full semantics. Defaults to false
      * @param options.batchSize - The number of records to process per batch. Must be a positive integer. Defaults to 10 when `lock` is true, and to 1000 otherwise
-     * @param options.bypassAllDefaultScopes - If true, bypasses all default scopes when cascade destroying. Defaults to false
+     * @param options.bypassAllDefaultScopes - If true, bypasses user-removable default scopes when cascade destroying; an STI child's reserved discriminator remains enforced, including when associations are loaded. Defaults to false
      * @param options.defaultScopesToBypass - An array of default scope names to bypass when cascade destroying. Defaults to an empty array
      * @returns The number of records that were removed
      * @throws InvalidBatchSize if `batchSize` is not a positive integer
@@ -2156,7 +2171,7 @@ export default class Query {
      * @param options - Options for undestroying the instance
      * @param options.skipHooks - If true, skips applying model hooks during the undestroy operation. Defaults to false
      * @param options.cascade - If false, skips undestroying associations marked `dependent: 'destroy'`. Defaults to true
-     * @param options.bypassAllDefaultScopes - If true, bypasses all default scopes when cascade undestroying. Defaults to false
+     * @param options.bypassAllDefaultScopes - If true, bypasses user-removable default scopes when cascade undestroying; an STI child's reserved discriminator remains enforced, including when associations are loaded. Defaults to false
      * @param options.defaultScopesToBypass - An array of default scope names to bypass when cascade undestroying (soft delete is always bypassed). Defaults to an empty array
      * @returns The number of records that were removed
      * @throws BatchingIncompatibleWithLimitOrOffset if the query carries a `limit` or `offset`
@@ -2196,11 +2211,11 @@ export default class Query {
      * @returns The number of records that were removed
      */
     async delete() {
+        this.assertMutationPreservesAssociationQuery();
         return await this.dbDriverInstance().delete();
     }
     async update(attributesOrCb, { skipHooks, lock, batchSize } = {}) {
-        if (this.baseSelectQuery)
-            throw new NoUpdateOnAssociationQuery();
+        this.assertMutationPreservesAssociationQuery();
         if (Object.keys(this.innerJoinStatements).length)
             throw new NoUpdateAllOnJoins();
         if (Object.keys(this.leftJoinStatements).length)

package/dist/esm/src/dream/QueryDriver/Base.js

@@ -18,6 +18,14 @@ export default class QueryDriverBase {
         this.connectionOverride = query['originalOpts'].connection;
         this.innerJoinDreamClasses = Object.freeze(query['originalOpts'].innerJoinDreamClasses || []);
     }
+    /**
+     * @internal
+     *
+     * Prevents mutation paths that discard an association query's ownership constraint.
+     */
+    assertMutationPreservesAssociationQuery() {
+        this.query['assertMutationPreservesAssociationQuery']();
+    }
     // eslint-disable-next-line @typescript-eslint/require-await
     static async ensureAllMigrationsHaveBeenRun(
     // eslint-disable-next-line @typescript-eslint/no-unused-vars
@@ -110,6 +118,8 @@ export default class QueryDriverBase {
      * @returns A Kysely query. Depending on the type passed, it will return either a SelectQueryBuilder, DeleteQueryBuilder, or an UpdateQueryBuilder
      */
     toKysely(type) {
+        if (type !== 'select')
+            this.assertMutationPreservesAssociationQuery();
         throw new Error('implement toKysely in child class (if it makes sense)');
     }
     /**
@@ -543,6 +553,7 @@ export default class QueryDriverBase {
      */
     // eslint-disable-next-line @typescript-eslint/require-await
     async delete() {
+        this.assertMutationPreservesAssociationQuery();
         throw new Error('implement delete in child class');
     }
     /**
@@ -551,6 +562,7 @@ export default class QueryDriverBase {
      */
     // eslint-disable-next-line @typescript-eslint/require-await, @typescript-eslint/no-unused-vars
     async update(attributes) {
+        this.assertMutationPreservesAssociationQuery();
         throw new Error('implement update in child class');
     }
     /**

package/dist/esm/src/dream/QueryDriver/Kysely.js

@@ -301,6 +301,8 @@ export default class KyselyQueryDriver extends QueryDriverBase {
      * @returns A Kysely query. Depending on the type passed, it will return either a SelectQueryBuilder, DeleteQueryBuilder, or an UpdateQueryBuilder
      */
     toKysely(type) {
+        if (type !== 'select')
+            this.assertMutationPreservesAssociationQuery();
         switch (type) {
             case 'select':
                 return this.buildSelect();
@@ -740,6 +742,7 @@ export default class KyselyQueryDriver extends QueryDriverBase {
      * @returns the number of deleted rows
      */
     async delete() {
+        this.assertMutationPreservesAssociationQuery();
         const deletionResult = await executeDatabaseQuery(this.buildDelete(), 'executeTakeFirst');
         return Number(deletionResult?.numDeletedRows || 0);
     }
@@ -748,6 +751,7 @@ export default class KyselyQueryDriver extends QueryDriverBase {
      * @returns the number of updated rows
      */
     async update(attributes) {
+        this.assertMutationPreservesAssociationQuery();
         const kyselyQuery = this.buildUpdate(attributes);
         const res = await executeDatabaseQuery(kyselyQuery, 'execute');
         const resultData = Array.from(res.entries())?.[0]?.[1];
@@ -1014,7 +1018,11 @@ export default class KyselyQueryDriver extends QueryDriverBase {
         return { kyselyQuery, clone: this.query };
     }
     columnsWithRequiredLoadColumns(columns) {
-        return uniq(compact([this.dreamClass.primaryKey, this.dreamClass['isSTIBase'] ? 'type' : null, ...columns]));
+        return uniq(compact([
+            this.dreamClass.primaryKey,
+            this.dreamClass['isSTIBase'] || this.dreamClass['isSTIChild'] ? 'type' : null,
+            ...columns,
+        ]));
     }
     /**
      * @internal
@@ -1784,12 +1792,13 @@ export default class KyselyQueryDriver extends QueryDriverBase {
         }, {});
     }
     conditionallyApplyDefaultScopes() {
-        if (this.query['bypassAllDefaultScopes'] || this.query['bypassAllDefaultScopesExceptOnAssociations'])
+        if (this.query['bypassAllDefaultScopesExceptOnAssociations'])
             return this.query;
         const thisScopes = this.dreamClass['scopes'].default;
         let query = this.query;
         for (const scope of thisScopes) {
             if (!shouldBypassDefaultScope(scope.method, {
+                bypassAllDefaultScopes: this.query['bypassAllDefaultScopes'],
                 defaultScopesToBypass: [
                     ...this.query['defaultScopesToBypass'],
                     ...this.query['defaultScopesToBypassExceptOnAssociations'],

package/dist/esm/src/dream/internal/applyScopeBypassingSettingsToQuery.js

@@ -1,6 +1,6 @@
 export default function applyScopeBypassingSettingsToQuery(query, { bypassAllDefaultScopes, defaultScopesToBypass, }) {
     if (bypassAllDefaultScopes)
-        query = query.removeAllDefaultScopes();
+        query = query['removeAllDefaultScopes']();
     defaultScopesToBypass.forEach(defaultScopeToBypass => {
         query = query.removeDefaultScope(defaultScopeToBypass);
     });

package/dist/esm/src/dream/internal/loadDependentDestroyTree.js

@@ -21,7 +21,7 @@ export default async function loadDependentDestroyTree(dream, txn, { reallyDestr
         loadBuilder = loadBuilder.load(...args);
     }
     if (bypassAllDefaultScopes) {
-        loadBuilder = loadBuilder.removeAllDefaultScopes();
+        loadBuilder = loadBuilder['removeAllDefaultScopes']();
     }
     else {
         for (const scopeName of defaultScopesToBypass) {

package/dist/esm/src/dream/internal/reload.js

@@ -10,7 +10,9 @@ export default async function reload(dream, txn = null) {
     // we have persisted are not yet propagated
     else
         query = query.connection('primary');
-    query = query.removeAllDefaultScopes().where({ [dream['_primaryKey']]: dream.primaryKeyValue() });
+    query = query['removeAllDefaultScopes']().where({
+        [dream['_primaryKey']]: dream.primaryKeyValue(),
+    });
     const reloadedRecord = await query.firstOrFail();
     dream.setAttributes(reloadedRecord.getAttributes());
     dream['freezeAttributes']();

package/dist/esm/src/dream/internal/shouldBypassDefaultScope.js

@@ -1,9 +1,8 @@
+import { STI_SCOPE_NAME } from '../../decorators/class/STI.js';
 export default function shouldBypassDefaultScope(scopeName, { bypassAllDefaultScopes = false, defaultScopesToBypass, }) {
-    if (bypassAllDefaultScopes)
-        return true;
-    if (!defaultScopesToBypass.length)
-        return false;
     if (defaultScopesToBypass.includes(scopeName))
         return true;
+    if (bypassAllDefaultScopes)
+        return scopeName !== STI_SCOPE_NAME;
     return false;
 }

package/dist/esm/src/dream/internal/sqlResultToDreamInstance.js

@@ -1,6 +1,9 @@
 import STIChildMissing from '../../errors/sti/STIChildMissing.js';
+import STIChildTypeMismatch from '../../errors/sti/STIChildTypeMismatch.js';
 import filterRowToKnownColumns from './filterRowToKnownColumns.js';
 export default function sqlResultToDreamInstance(dreamClass, sqlResult) {
+    if (dreamClass['isSTIChild'] && sqlResult.type !== dreamClass['sti'].value)
+        throw new STIChildTypeMismatch(dreamClass, sqlResult.type, sqlResult[dreamClass.primaryKey]);
     // base-model reads select `*`, so under schema/image skew (or with a
     // column declared in ignoredColumns but not yet dropped) the row can
     // contain columns the compiled schema doesn't know about. Passing such
@@ -32,7 +35,7 @@ export default function sqlResultToDreamInstance(dreamClass, sqlResult) {
 export function findExtendingDreamClass(dreamClass, type) {
     if (!dreamClass['extendedBy'])
         return undefined;
-    const extendingDreamClass = dreamClass['extendedBy'].find(extendingDreamClass => extendingDreamClass.sanitizedName === type);
+    const extendingDreamClass = dreamClass['extendedBy'].find(extendingDreamClass => extendingDreamClass['sti'].value === type);
     if (extendingDreamClass)
         return extendingDreamClass;
     return dreamClass['extendedBy']

package/dist/esm/src/errors/NoUpdateOnAssociationQuery.js

@@ -1,7 +1,7 @@
 export default class NoUpdateOnAssociationQuery extends Error {
     get message() {
         return `
-udpate may not be called on an associationQuery. Use updateAssociation instead.
+Mutations may not be called on an associationQuery because its ownership constraint cannot be preserved. Use an association-specific mutation method or query the associated model with explicit conditions.
     `;
     }
 }

package/dist/esm/src/errors/sti/STIChildTypeMismatch.js

@@ -0,0 +1,28 @@
+export default class STIChildTypeMismatch extends Error {
+    expectedDreamClass;
+    expectedType;
+    actualType;
+    baseDreamClass;
+    table;
+    primaryKeyValue;
+    constructor(expectedDreamClass, actualType, primaryKeyValue) {
+        super();
+        this.expectedDreamClass = expectedDreamClass;
+        this.expectedType = expectedDreamClass['sti'].value;
+        this.actualType = actualType;
+        this.baseDreamClass = expectedDreamClass['sti'].baseClass;
+        this.table = this.baseDreamClass.table;
+        this.primaryKeyValue = primaryKeyValue;
+    }
+    get message() {
+        return `
+Cannot hydrate STI child from a row with a different discriminator.
+Expected Dream class: ${this.expectedDreamClass.sanitizedName}
+Expected type: ${this.expectedType}
+Type specified in DB record: ${String(this.actualType)}
+STI base Dream class: ${this.baseDreamClass.sanitizedName}
+Table: ${this.table}
+Primary key value: ${String(this.primaryKeyValue)}
+    `;
+    }
+}

package/dist/types/src/Dream.d.ts

@@ -594,9 +594,13 @@ export default class Dream {
      */
     static get associationNames(): string[];
     /**
-     * Returns a query for this model which disregards default scopes
+     * @deprecated Use {@link removeDefaultScope} instead. This method will become private in v3.
      *
-     * @returns A query for this model which disregards default scopes
+     * Returns a query which bypasses user-removable default scopes, including on
+     * association loads. An STI child's reserved type discriminator remains
+     * enforced; query the STI base model to span its registered children.
+     *
+     * @returns A query which bypasses user-removable default scopes
      */
     static removeAllDefaultScopes<T extends typeof Dream>(this: T): Query<InstanceType<T>>;
     /**
@@ -2470,7 +2474,7 @@ export default class Dream {
      * @param options - Options for destroying the instance
      * @param options.skipHooks - If true, skips applying model hooks during the destroy operation. Defaults to false
      * @param options.cascade - If false, skips destroying associations marked `dependent: 'destroy'`. Defaults to true
-     * @param options.bypassAllDefaultScopes - If true, bypasses all default scopes when cascade destroying. Defaults to false
+     * @param options.bypassAllDefaultScopes - If true, bypasses user-removable default scopes when cascade destroying; an STI child's reserved discriminator remains enforced, including when associations are loaded. Defaults to false
      * @param options.defaultScopesToBypass - An array of default scope names to bypass when cascade destroying. Defaults to an empty array
      * @returns The instance that was destroyed
      */
@@ -2493,7 +2497,7 @@ export default class Dream {
      * @param options - Options for destroying the instance
      * @param options.skipHooks - If true, skips applying model hooks during the destroy operation. Defaults to false
      * @param options.cascade - If false, skips destroying associations marked `dependent: 'destroy'`. Defaults to true
-     * @param options.bypassAllDefaultScopes - If true, bypasses all default scopes when cascade destroying. Defaults to false
+     * @param options.bypassAllDefaultScopes - If true, bypasses user-removable default scopes when cascade destroying; an STI child's reserved discriminator remains enforced, including when associations are loaded. Defaults to false
      * @param options.defaultScopesToBypass - An array of default scope names to bypass when cascade destroying. Defaults to an empty array
      * @returns The instance that was destroyed
      */
@@ -2506,14 +2510,14 @@ export default class Dream {
      * this will raise an exception.
      *
      * ```ts
-     * const user = await User.removeAllDefaultScopes().last()
+     * const user = await User.removeDefaultScope('dream:SoftDelete').last()
      * await user.undestroy()
      * ```
      *
      * @param options - Options for undestroying the instance
      * @param options.skipHooks - If true, skips applying model hooks during the undestroy operation. Defaults to false
      * @param options.cascade - If false, skips undestroying associations marked `dependent: 'destroy'`. Defaults to true
-     * @param options.bypassAllDefaultScopes - If true, bypasses all default scopes when cascade undestroying. Defaults to false
+     * @param options.bypassAllDefaultScopes - If true, bypasses user-removable default scopes when cascade undestroying; an STI child's reserved discriminator remains enforced, including when associations are loaded. Defaults to false
      * @param options.defaultScopesToBypass - An array of default scope names to bypass when cascade undestroying (soft delete is always bypassed). Defaults to an empty array
      * @returns The undestroyed record
      */

package/dist/types/src/dream/DreamClassTransactionBuilder.d.ts

@@ -1,7 +1,7 @@
 import { SelectArg, SelectExpression } from 'kysely';
 import Dream from '../Dream.js';
 import { PassthroughOnClause, WhereStatement } from '../types/associations/shared.js';
-import { CreateOrFindByExtraOpts, DefaultScopeName, DreamColumnNames, DreamSerializerKey, FindablePropertiesForClass, OrderDir, PassthroughColumnNames, PluckEachArgs, PrimaryKeyForFind, TableColumnNames, UpdateableProperties, UpdateOrCreateByExtraOpts, ValidatedPluckEachColumnNames } from '../types/dream.js';
+import { AllDefaultScopeNames, CreateOrFindByExtraOpts, DreamColumnNames, DreamSerializerKey, FindablePropertiesForClass, OrderDir, PassthroughColumnNames, PluckEachArgs, PrimaryKeyForFind, TableColumnNames, UpdateableProperties, UpdateOrCreateByExtraOpts, ValidatedPluckEachColumnNames } from '../types/dream.js';
 import { BaseModelColumnTypes, FindEachOpts, LoadForModifierFn, QueryWithJoinedAssociationsType, QueryWithJoinedAssociationsTypeAndNoPreload } from '../types/query.js';
 import { JoinedAssociation, JoinedAssociationsTypeFromAssociations, VariadicJoinsArgs, VariadicLeftJoinLoadArgs, VariadicLoadArgs } from '../types/variadic.js';
 import DreamTransaction from './DreamTransaction.js';
@@ -599,9 +599,13 @@ export default class DreamClassTransactionBuilder<DreamClass extends typeof Drea
      */
     queryInstance<I extends DreamClassTransactionBuilder<DreamClass, DreamInstance>>(this: I): Query<DreamInstance>;
     /**
-     * Returns a query for this model which disregards default scopes
+     * @deprecated Use {@link removeDefaultScope} instead. This method will become private in v3.
      *
-     * @returns A query for this model which disregards default scopes
+     * Returns a query which bypasses user-removable default scopes, including on
+     * association loads. An STI child's reserved type discriminator remains
+     * enforced; query the STI base model to span its registered children.
+     *
+     * @returns A query which bypasses user-removable default scopes
      */
     removeAllDefaultScopes<I extends DreamClassTransactionBuilder<DreamClass, DreamInstance>>(this: I): Query<DreamInstance>;
     /**
@@ -610,7 +614,7 @@ export default class DreamClassTransactionBuilder<DreamClass extends typeof Drea
      *
      * @returns A new Query which will prevent a specific default scope from applying
      */
-    removeDefaultScope<I extends DreamClassTransactionBuilder<DreamClass, DreamInstance>>(this: I, scopeName: DefaultScopeName<DreamInstance>): Query<DreamInstance>;
+    removeDefaultScope<I extends DreamClassTransactionBuilder<DreamClass, DreamInstance>>(this: I, scopeName: AllDefaultScopeNames<DreamInstance>): Query<DreamInstance>;
     /**
      * Returns the last record corresponding to the
      * model, ordered by primary key.

package/dist/types/src/dream/DreamInstanceTransactionBuilder.d.ts

@@ -174,7 +174,7 @@ export default class DreamInstanceTransactionBuilder<DreamInstance extends Dream
      * @param options - Options for destroying the instance
      * @param options.skipHooks - If true, skips applying model hooks during the destroy operation. Defaults to false
      * @param options.cascade - If false, skips destroying associations marked `dependent: 'destroy'`. Defaults to true
-     * @param options.bypassAllDefaultScopes - If true, bypasses all default scopes when cascade destroying. Defaults to false
+     * @param options.bypassAllDefaultScopes - If true, bypasses user-removable default scopes when cascade destroying; an STI child's reserved discriminator remains enforced, including when associations are loaded. Defaults to false
      * @param options.defaultScopesToBypass - An array of default scope names to bypass when cascade destroying. Defaults to an empty array
      * @returns The instance that was destroyed
      */
@@ -194,7 +194,7 @@ export default class DreamInstanceTransactionBuilder<DreamInstance extends Dream
      * @param options - Options for destroying the instance
      * @param options.skipHooks - If true, skips applying model hooks during the destroy operation. Defaults to false
      * @param options.cascade - If false, skips destroying associations marked `dependent: 'destroy'`. Defaults to true
-     * @param options.bypassAllDefaultScopes - If true, bypasses all default scopes when cascade destroying. Defaults to false
+     * @param options.bypassAllDefaultScopes - If true, bypasses user-removable default scopes when cascade destroying; an STI child's reserved discriminator remains enforced, including when associations are loaded. Defaults to false
      * @param options.defaultScopesToBypass - An array of default scope names to bypass when cascade destroying. Defaults to an empty array
      * @returns The instance that was destroyed
      */
@@ -207,14 +207,14 @@ export default class DreamInstanceTransactionBuilder<DreamInstance extends Dream
      * this will raise an exception.
      *
      * ```ts
-     * const user = await User.removeAllDefaultScopes().last()
+     * const user = await User.removeDefaultScope('dream:SoftDelete').last()
      * await user.txn(txn).undestroy()
      * ```
      *
      * @param options - Options for undestroying the instance
      * @param options.skipHooks - If true, skips applying model hooks during the undestroy operation. Defaults to false
      * @param options.cascade - If false, skips undestroying associations marked `dependent: 'destroy'`. Defaults to true
-     * @param options.bypassAllDefaultScopes - If true, bypasses all default scopes when cascade undestroying. Defaults to false
+     * @param options.bypassAllDefaultScopes - If true, bypasses user-removable default scopes when cascade undestroying; an STI child's reserved discriminator remains enforced, including when associations are loaded. Defaults to false
      * @param options.defaultScopesToBypass - An array of default scope names to bypass when cascade undestroying (soft delete is always bypassed). Defaults to an empty array
      * @returns The undestroyed instance
      */

package/dist/types/src/dream/LoadBuilder.d.ts

@@ -41,14 +41,17 @@ export default class LoadBuilder<DreamInstance extends Dream> {
      */
     removeDefaultScope<I extends LoadBuilder<DreamInstance>>(this: I, scopeName: AllDefaultScopeNames<DreamInstance>): I;
     /**
-     * Prevents all default scopes from applying when
-     * loading associations
+     * @deprecated Use {@link removeDefaultScope} instead. This method will become private in v3.
+     *
+     * Prevents user-removable default scopes from applying when loading
+     * associations. An associated STI child's reserved type discriminator remains
+     * enforced; loading through its STI base still spans registered children.
      *
      * ```ts
      * const user = await User.firstOrFail()
      * const loaded = await user
      *   .load('posts')
-     *   .removeAllDefaultScopes()
+     *   .removeDefaultScope('dream:SoftDelete')
      *   .execute()
      * ```
      *

package/dist/types/src/dream/Query.d.ts

@@ -143,13 +143,13 @@ export default class Query<DreamInstance extends Dream, QueryTypeOpts extends Re
     /**
      * @internal
      *
-     * Whether or not to bypass all default scopes for this Query
+     * Whether or not to bypass all user-removable default scopes for this Query
      */
     private readonly bypassAllDefaultScopes;
     /**
      * @internal
      *
-     * Whether or not to bypass all default scopes for this Query, but not associations
+     * Whether or not to bypass all user-removable default scopes for this Query, but not associations
      */
     private readonly bypassAllDefaultScopesExceptOnAssociations;
     /**
@@ -511,10 +511,14 @@ export default class Query<DreamInstance extends Dream, QueryTypeOpts extends Re
      */
     private setAssociationQueryBase;
     /**
-     * Prevents default scopes from applying when
-     * the Query is executed
+     * @deprecated Use {@link removeDefaultScope} instead. This method will become private in v3.
      *
-     * @returns A new Query which will prevent default scopes from applying
+     * Prevents user-removable default scopes from applying when the Query is
+     * executed, including when associations are loaded. An STI child's reserved
+     * type discriminator remains enforced; query the STI base model to span its
+     * registered children.
+     *
+     * @returns A new Query which bypasses user-removable default scopes
      */
     removeAllDefaultScopes(): Query<DreamInstance, QueryTypeOpts>;
     /**
@@ -727,6 +731,12 @@ export default class Query<DreamInstance extends Dream, QueryTypeOpts extends Re
      * @returns A Kysely query. Depending on the type passed, it will return either a SelectQueryBuilder, DeleteQueryBuilder, or an UpdateQueryBuilder
      */
     toKysely<QueryType extends 'select' | 'delete' | 'update', DbType = QueryToKyselyDBType<typeof this>, TableNames = QueryToKyselyTableNamesType<typeof this>, ToKyselyReturnType = QueryType extends 'select' ? SelectQueryBuilder<DbType, TableNames & keyof DbType, unknown> : QueryType extends 'delete' ? DeleteQueryBuilder<DbType, TableNames & keyof DbType, unknown> : QueryType extends 'update' ? UpdateQueryBuilder<DbType, TableNames & keyof DbType, TableNames & keyof DbType, unknown> : never>(type: QueryType): ToKyselyReturnType;
+    /**
+     * @internal
+     *
+     * Prevents mutation paths that discard an association query's ownership constraint.
+     */
+    private assertMutationPreservesAssociationQuery;
     /**
      * Applies transaction to the Query instance
      *
@@ -1351,7 +1361,7 @@ export default class Query<DreamInstance extends Dream, QueryTypeOpts extends Re
      * @param options.cascade - If false, skips destroying associations marked `dependent: 'destroy'`. Defaults to true
      * @param options.lock - If true, each batch is re-selected with an exclusive row lock inside its own transaction before being destroyed, making the destroy a compare-and-set. Defaults to false
      * @param options.batchSize - The number of records to process per batch. Must be a positive integer. Defaults to 10 when `lock` is true, and to 1000 otherwise
-     * @param options.bypassAllDefaultScopes - If true, bypasses all default scopes when cascade destroying. Defaults to false
+     * @param options.bypassAllDefaultScopes - If true, bypasses user-removable default scopes when cascade destroying; an STI child's reserved discriminator remains enforced, including when associations are loaded. Defaults to false
      * @param options.defaultScopesToBypass - An array of default scope names to bypass when cascade destroying. Defaults to an empty array
      * @returns The number of records that were removed
      * @throws InvalidBatchSize if `batchSize` is not a positive integer
@@ -1469,7 +1479,7 @@ export default class Query<DreamInstance extends Dream, QueryTypeOpts extends Re
      * @param options.cascade - If false, skips destroying associations marked `dependent: 'destroy'`. Defaults to true
      * @param options.lock - If true, each batch is re-selected with an exclusive row lock inside its own transaction before being destroyed, making the destroy a compare-and-set. See {@link Query.destroy} for the full semantics. Defaults to false
      * @param options.batchSize - The number of records to process per batch. Must be a positive integer. Defaults to 10 when `lock` is true, and to 1000 otherwise
-     * @param options.bypassAllDefaultScopes - If true, bypasses all default scopes when cascade destroying. Defaults to false
+     * @param options.bypassAllDefaultScopes - If true, bypasses user-removable default scopes when cascade destroying; an STI child's reserved discriminator remains enforced, including when associations are loaded. Defaults to false
      * @param options.defaultScopesToBypass - An array of default scope names to bypass when cascade destroying. Defaults to an empty array
      * @returns The number of records that were removed
      * @throws InvalidBatchSize if `batchSize` is not a positive integer
@@ -1502,7 +1512,7 @@ export default class Query<DreamInstance extends Dream, QueryTypeOpts extends Re
      * @param options - Options for undestroying the instance
      * @param options.skipHooks - If true, skips applying model hooks during the undestroy operation. Defaults to false
      * @param options.cascade - If false, skips undestroying associations marked `dependent: 'destroy'`. Defaults to true
-     * @param options.bypassAllDefaultScopes - If true, bypasses all default scopes when cascade undestroying. Defaults to false
+     * @param options.bypassAllDefaultScopes - If true, bypasses user-removable default scopes when cascade undestroying; an STI child's reserved discriminator remains enforced, including when associations are loaded. Defaults to false
      * @param options.defaultScopesToBypass - An array of default scope names to bypass when cascade undestroying (soft delete is always bypassed). Defaults to an empty array
      * @returns The number of records that were removed
      * @throws BatchingIncompatibleWithLimitOrOffset if the query carries a `limit` or `offset`

package/dist/types/src/dream/QueryDriver/Base.d.ts

@@ -20,6 +20,12 @@ export default class QueryDriverBase<DreamInstance extends Dream> {
      */
     protected readonly innerJoinDreamClasses: readonly (typeof Dream)[];
     constructor(query: Query<DreamInstance, any>);
+    /**
+     * @internal
+     *
+     * Prevents mutation paths that discard an association query's ownership constraint.
+     */
+    protected assertMutationPreservesAssociationQuery(): void;
     static ensureAllMigrationsHaveBeenRun(connectionName: string): Promise<void>;
     /**
      * migrate the database. Must respond to the NODE_ENV value.