@rvoh/dream 2.28.1 → 2.28.3

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
      */
@@ -234,7 +234,7 @@ export default class DreamInstanceTransactionBuilder {
      * @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,8 +44,9 @@ export default class LoadBuilder {
         return this;
     }
     /**
-     * Prevents all default scopes from applying when
-     * loading associations
+     * 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()

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,12 @@ export default class Query {
         });
     }
     /**
-     * Prevents default scopes from applying when
-     * the Query is executed
+     * 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 +1046,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 +1917,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
@@ -2057,7 +2070,7 @@ export default class Query {
         // truthiness, since a primary key of 0 is a legitimate cursor value that
         // would otherwise reset the window to the start of the set
         let lastId = undefined;
-        let attemptedCount = 0;
+        let attemptedCount;
         do {
             const batchQuery = lastId === undefined
                 ? orderedQuery
@@ -2126,7 +2139,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 +2169,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 +2209,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/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/esm/src/helpers/cli/generateMigration.js

@@ -52,7 +52,7 @@ export default async function generateMigration({ migrationName, columnsWithType
         : path.join(dreamPath('db'), 'migrations', connectionName);
     const fileName = `${migrationVersion()}-${hyphenize(migrationName).replace(/\//g, '-')}.ts`;
     const isSTI = !!fullyQualifiedParentName;
-    let content = '';
+    let content;
     if (isSTI) {
         content = generateStiMigrationContent({
             table: validTableNameOrThrow(migrationName, snakeify(pluralize(pascalizePath(fullyQualifiedParentName)))),

package/dist/esm/src/helpers/cli/resolveIgnoredColumns.js

@@ -137,8 +137,8 @@ function guardAssociationColumns(ignoredColumns, tableName, allModels) {
             // pass too, and these guards never see the association's foreign key;
             // the InvalidComputedForeignKey / ExplicitForeignKeyRequired errors
             // swallowed here resurface at runtime as the backstop.
-            let foreignKey = null;
-            let foreignKeyTypeColumn = null;
+            let foreignKey;
+            let foreignKeyTypeColumn;
             try {
                 foreignKey = associationMetaData.foreignKey();
                 foreignKeyTypeColumn = associationMetaData.polymorphic

package/dist/esm/src/helpers/cli/writeGeneratedFile.js

@@ -21,6 +21,6 @@ export default async function writeGeneratedFile({ dreamPathKey, basePath, fileN
 
       Does this file already exist? Here is the error that was raised:
         ${error.message}
-    `);
+    `, { cause: error });
     }
 }

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

@@ -594,9 +594,11 @@ export default class Dream {
      */
     static get associationNames(): string[];
     /**
-     * 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 for this model which disregards default scopes
+     * @returns A query which bypasses user-removable default scopes
      */
     static removeAllDefaultScopes<T extends typeof Dream>(this: T): Query<InstanceType<T>>;
     /**
@@ -2470,7 +2472,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 +2495,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
      */
@@ -2513,7 +2515,7 @@ export default class Dream {
      * @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

@@ -599,9 +599,11 @@ 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
+     * 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 for this model which disregards default scopes
+     * @returns A query which bypasses user-removable default scopes
      */
     removeAllDefaultScopes<I extends DreamClassTransactionBuilder<DreamClass, DreamInstance>>(this: I): Query<DreamInstance>;
     /**

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
      */
@@ -214,7 +214,7 @@ export default class DreamInstanceTransactionBuilder<DreamInstance extends Dream
      * @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,8 +41,9 @@ 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
+     * 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()

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,12 @@ export default class Query<DreamInstance extends Dream, QueryTypeOpts extends Re
      */
     private setAssociationQueryBase;
     /**
-     * Prevents default scopes from applying when
-     * the Query is executed
+     * 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(): Query<DreamInstance, QueryTypeOpts>;
     /**
@@ -727,6 +729,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 +1359,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 +1477,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 +1510,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.

package/dist/types/src/dream/internal/destroyOptions.d.ts

@@ -5,8 +5,9 @@ import { AllDefaultScopeNames } from '../../types/dream.js';
  */
 export interface DestroyOptions<DreamInstance extends Dream> {
     /**
-     * If true, bypasses all default scopes when destroying the instance.
-     * Defaults to false.
+     * If true, bypasses user-removable default scopes during the destroy operation.
+     * An STI child's reserved discriminator remains enforced, including when
+     * associations are loaded. Defaults to false.
      */
     bypassAllDefaultScopes?: boolean | undefined;
     /**

package/dist/types/src/errors/sti/STIChildTypeMismatch.d.ts

@@ -0,0 +1,11 @@
+import Dream from '../../Dream.js';
+export default class STIChildTypeMismatch extends Error {
+    readonly expectedDreamClass: typeof Dream;
+    readonly expectedType: string;
+    readonly actualType: unknown;
+    readonly baseDreamClass: typeof Dream;
+    readonly table: string;
+    readonly primaryKeyValue: unknown;
+    constructor(expectedDreamClass: typeof Dream, actualType: unknown, primaryKeyValue: unknown);
+    get message(): string;
+}

package/docs/assets/hierarchy.js

@@ -1 +1 @@
-window.hierarchyData = "eJyVksFOwzAMht/F52w0rRp1PbIJCSEGSAgO0w5Z69FoaTIl6VA17d1R2CWMQdOTI8u//y+2j2C0dhbKFWUJJZTSNQGDW4mVE1pZKI9AKfVB8RahhJcOTb8w4oDmllsEAjuhaihpWhDojIQSKsmtRXtTb6YX1dPGtRLIuQJKcLaeePnknCBQNULWBhWUq3RG1ycC6Sx0f+gtyj7oOuD/q34MAc1o6hF8DBietXUfBm08xRXFAId3zVkeuM4brHZzrawzXCj3JrTkfkX/WaMx2tjpX9IYhiILGbTsWvV0QLOV+jPG+Ycgwo8l4bYX3PF7Vel2z53YSHwXrvG5Dbd4J1DWEQiDPUZdRM5y4odCKEsTQllWfB8IS5ML7Nd+j+ff+9ejsC13VRPJe10cM76sCDiW2i07KcecyqVkyPN0+gKH6W7r"
+window.hierarchyData = "eJyVkkFPwjAUx7/LOxekY3SsRyEmxoiaGD0QDmV7uIauJW2HWQjf3VQuFdGNU5vm/fv79fUdwBrjHfAlZaOMUEpXBCxuFBZeGu2AH4BSGhYtagQOLw3adm7lHu2tcAgEtlKXwGkyJdBYBRwKJZxDd1Ouh2fVw8rXCsipAjh4Vw5CfHA6IFBUUpUWNfBlko9XRwJJPo7oD61D1Ua3dvB/1V9jQMeUBYWwRg7PxvkPi66/xYVEh0egTrK477MKi+3MaOetkNq/SaNE+KL/0GitsW74V7SPwzSPHYxqav20R7tR5rMP+UegB4+Nsog3F17c68LUO+HlWuG79FU4WwuHdxJV2UOh846rJmKSURKaQihLGKEsTb8HhCXsTPu13eHp9WH3KF0tfFH19L0c7tO+NI08FsYvGqWuGZXzSBfzePwC4ktvDw=="