@rvoh/dream 0.36.3 → 0.37.4

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

@@ -9,8 +9,8 @@ const AssociationDeclaredWithoutAssociatedDreamClass_js_1 = require("../errors/a
 const CannotAssociateThroughPolymorphic_js_1 = require("../errors/associations/CannotAssociateThroughPolymorphic.js");
 const CannotJoinPolymorphicBelongsToError_js_1 = require("../errors/associations/CannotJoinPolymorphicBelongsToError.js");
 const JoinAttemptedOnMissingAssociation_js_1 = require("../errors/associations/JoinAttemptedOnMissingAssociation.js");
-const MissingRequiredAssociationOnClause_js_1 = require("../errors/associations/MissingRequiredAssociationOnClause.js");
-const MissingRequiredPassthroughForAssociationOnClause_js_1 = require("../errors/associations/MissingRequiredPassthroughForAssociationOnClause.js");
+const MissingRequiredAssociationAndClause_js_1 = require("../errors/associations/MissingRequiredAssociationAndClause.js");
+const MissingRequiredPassthroughForAssociationAndClause_js_1 = require("../errors/associations/MissingRequiredPassthroughForAssociationAndClause.js");
 const MissingThroughAssociation_js_1 = require("../errors/associations/MissingThroughAssociation.js");
 const MissingThroughAssociationSource_js_1 = require("../errors/associations/MissingThroughAssociationSource.js");
 const CannotCallUndestroyOnANonSoftDeleteModel_js_1 = require("../errors/CannotCallUndestroyOnANonSoftDeleteModel.js");
@@ -152,7 +152,7 @@ class Query extends ConnectedToDB_js_1.default {
      * stores the joins on statements applied to the
      * current Query instance
      */
-    innerJoinOnStatements = Object.freeze({});
+    innerJoinAndStatements = Object.freeze({});
     /**
      * @internal
      *
@@ -166,7 +166,7 @@ class Query extends ConnectedToDB_js_1.default {
      * stores the joins on statements applied to the
      * current Query instance
      */
-    leftJoinOnStatements = Object.freeze({});
+    leftJoinAndStatements = Object.freeze({});
     /**
      * @internal
      *
@@ -236,9 +236,9 @@ class Query extends ConnectedToDB_js_1.default {
         this.preloadStatements = Object.freeze(opts.preloadStatements || {});
         this.preloadOnStatements = Object.freeze(opts.preloadOnStatements || {});
         this.innerJoinStatements = Object.freeze(opts.innerJoinStatements || {});
-        this.innerJoinOnStatements = Object.freeze(opts.innerJoinOnStatements || {});
+        this.innerJoinAndStatements = Object.freeze(opts.innerJoinAndStatements || {});
         this.leftJoinStatements = Object.freeze(opts.leftJoinStatements || {});
-        this.leftJoinOnStatements = Object.freeze(opts.leftJoinOnStatements || {});
+        this.leftJoinAndStatements = Object.freeze(opts.leftJoinAndStatements || {});
         this.baseSqlAlias = opts.baseSqlAlias || this.tableName;
         this.baseSelectQuery = opts.baseSelectQuery || null;
         this.limitStatement = opts.limit || null;
@@ -310,16 +310,16 @@ class Query extends ConnectedToDB_js_1.default {
             order: opts.order === null ? [] : [...this.orderStatements, ...(opts.order || [])],
             distinctColumn: opts.distinctColumn !== undefined ? opts.distinctColumn : this.distinctColumn,
             loadFromJoins: opts.loadFromJoins !== undefined ? opts.loadFromJoins : this.joinLoadActivated,
-            // when passed, preloadStatements, preloadOnStatements, innerJoinStatements, and innerJoinOnStatements are already
+            // when passed, preloadStatements, preloadOnStatements, innerJoinStatements, and innerJoinAndStatements are already
             // cloned versions of the `this.` versions, handled in the `preload` and `joins` methods
             preloadStatements: opts.preloadStatements || this.preloadStatements,
             preloadOnStatements: opts.preloadOnStatements || this.preloadOnStatements,
             innerJoinDreamClasses: opts.innerJoinDreamClasses || this.innerJoinDreamClasses,
             innerJoinStatements: opts.innerJoinStatements || this.innerJoinStatements,
-            innerJoinOnStatements: opts.innerJoinOnStatements || this.innerJoinOnStatements,
+            innerJoinAndStatements: opts.innerJoinAndStatements || this.innerJoinAndStatements,
             leftJoinStatements: opts.leftJoinStatements || this.leftJoinStatements,
-            leftJoinOnStatements: opts.leftJoinOnStatements || this.leftJoinOnStatements,
-            // end:when passed, preloadStatements, preloadOnStatements, innerJoinStatements, and innerJoinOnStatements are already...
+            leftJoinAndStatements: opts.leftJoinAndStatements || this.leftJoinAndStatements,
+            // end:when passed, preloadStatements, preloadOnStatements, innerJoinStatements, and innerJoinAndStatements are already...
             bypassAllDefaultScopes: opts.bypassAllDefaultScopes !== undefined ? opts.bypassAllDefaultScopes : this.bypassAllDefaultScopes,
             bypassAllDefaultScopesExceptOnAssociations: opts.bypassAllDefaultScopesExceptOnAssociations !== undefined
                 ? opts.bypassAllDefaultScopesExceptOnAssociations
@@ -465,7 +465,7 @@ class Query extends ConnectedToDB_js_1.default {
      * // [Reply{id: 1}, Reply{id: 2}]
      * ```
      *
-     * @param args - A chain of association names and on/notOn/onAny clauses
+     * @param args - A chain of association names and and/andNot/andAny clauses
      * @returns A cloned Query with the joinLoad statement applied
      */
     leftJoinPreload(...args) {
@@ -487,7 +487,7 @@ class Query extends ConnectedToDB_js_1.default {
      * // [Reply{id: 1}, Reply{id: 2}]
      * ```
      *
-     * @param args - A chain of association names and on/notOn/onAny clauses
+     * @param args - A chain of association names and and/andNot/andAny clauses
      * @returns A cloned Query with the preload statement applied
      */
     preload(...args) {
@@ -504,36 +504,44 @@ class Query extends ConnectedToDB_js_1.default {
      * await User.query().innerJoin('posts').first()
      * ```
      *
-     * @param args - A chain of association names and on/notOn/onAny clauses
+     * @param args - A chain of association names and and/andNot/andAny clauses
      * @returns A cloned Query with the joins clause applied
      */
     innerJoin(...args) {
         const innerJoinDreamClasses = [...this.innerJoinDreamClasses];
         const innerJoinStatements = (0, cloneDeepSafe_js_1.default)(this.innerJoinStatements);
-        const innerJoinOnStatements = (0, cloneDeepSafe_js_1.default)(this.innerJoinOnStatements);
-        this.fleshOutJoinStatements(innerJoinDreamClasses, innerJoinStatements, innerJoinOnStatements, null, [...args]);
-        return this.clone({ innerJoinDreamClasses, innerJoinStatements, innerJoinOnStatements });
+        const innerJoinAndStatements = (0, cloneDeepSafe_js_1.default)(this.innerJoinAndStatements);
+        this.fleshOutJoinStatements(innerJoinDreamClasses, innerJoinStatements, innerJoinAndStatements, null, [...args]);
+        return this.clone({
+            innerJoinDreamClasses,
+            innerJoinStatements,
+            innerJoinAndStatements,
+        });
     }
     /**
      * @internal
      *
-     * @param args - A chain of association names and on/notOn/onAny clauses
+     * @param args - A chain of association names and and/andNot/andAny clauses
      * @returns A cloned Query with the joins clause applied
      */
     leftJoin(...args) {
         const innerJoinDreamClasses = [...this.innerJoinDreamClasses];
         const leftJoinStatements = (0, cloneDeepSafe_js_1.default)(this.leftJoinStatements);
-        const leftJoinOnStatements = (0, cloneDeepSafe_js_1.default)(this.leftJoinOnStatements);
-        this.fleshOutJoinStatements(innerJoinDreamClasses, leftJoinStatements, leftJoinOnStatements, null, [
+        const leftJoinAndStatements = (0, cloneDeepSafe_js_1.default)(this.leftJoinAndStatements);
+        this.fleshOutJoinStatements(innerJoinDreamClasses, leftJoinStatements, leftJoinAndStatements, null, [
             ...args,
         ]);
-        return this.clone({ innerJoinDreamClasses, leftJoinStatements, leftJoinOnStatements });
+        return this.clone({
+            innerJoinDreamClasses,
+            leftJoinStatements,
+            leftJoinAndStatements,
+        });
     }
     /**
      * @internal
      *
      */
-    fleshOutJoinStatements(innerJoinDreamClasses, joinStatements, joinOnStatements, previousAssociationName, associationStatements, previousDreamClass = this.dreamClass) {
+    fleshOutJoinStatements(innerJoinDreamClasses, joinStatements, joinAndStatements, previousAssociationName, associationStatements, previousDreamClass = this.dreamClass) {
         const nextAssociationStatement = associationStatements.shift();
         if (nextAssociationStatement === undefined) {
             // just satisfying typing
@@ -542,11 +550,11 @@ class Query extends ConnectedToDB_js_1.default {
             const nextStatement = nextAssociationStatement;
             if (!joinStatements[nextStatement])
                 joinStatements[(0, protectAgainstPollutingAssignment_js_1.default)(nextStatement)] = {};
-            if (!joinOnStatements[nextStatement])
-                joinOnStatements[(0, protectAgainstPollutingAssignment_js_1.default)(nextStatement)] = {};
+            if (!joinAndStatements[nextStatement])
+                joinAndStatements[(0, protectAgainstPollutingAssignment_js_1.default)(nextStatement)] = {};
             const nextDreamClass = this.addAssociatedDreamClassToInnerJoinDreamClasses(previousDreamClass, nextStatement, innerJoinDreamClasses);
             const nextJoinsStatements = joinStatements[nextStatement];
-            const nextJoinsOnStatements = joinOnStatements[nextStatement];
+            const nextJoinsOnStatements = joinAndStatements[nextStatement];
             this.fleshOutJoinStatements(innerJoinDreamClasses, nextJoinsStatements, nextJoinsOnStatements, nextStatement, associationStatements, nextDreamClass);
             //
         }
@@ -564,9 +572,9 @@ class Query extends ConnectedToDB_js_1.default {
             const clonedNextAssociationStatement = (0, cloneDeepSafe_js_1.default)(nextAssociationStatement);
             const keys = Object.keys(clonedNextAssociationStatement);
             keys.forEach((key) => {
-                joinOnStatements[(0, protectAgainstPollutingAssignment_js_1.default)(key)] = clonedNextAssociationStatement[key];
+                joinAndStatements[(0, protectAgainstPollutingAssignment_js_1.default)(key)] = clonedNextAssociationStatement[key];
             });
-            this.fleshOutJoinStatements(innerJoinDreamClasses, joinStatements, joinOnStatements, previousAssociationName, associationStatements, previousDreamClass);
+            this.fleshOutJoinStatements(innerJoinDreamClasses, joinStatements, joinAndStatements, previousAssociationName, associationStatements, previousDreamClass);
         }
     }
     /**
@@ -786,7 +794,7 @@ class Query extends ConnectedToDB_js_1.default {
      *   public localizedTexts: LocalizedText[]
      *
      *   @deco.HasOne('LocalizedText', {
-     *     on: { locale: DreamConst.passthrough },
+     *     and: { locale: DreamConst.passthrough },
      *   })
      *   public currentLocalizedText: LocalizedText
      * }
@@ -1955,11 +1963,11 @@ class Query extends ConnectedToDB_js_1.default {
             const value = preloadOnStatements[key];
             if (value === undefined)
                 throw new UnexpectedUndefined_js_1.default();
-            // filter out plain objects, but not ops and not on/notOn/onAny statements
+            // filter out plain objects, but not ops and not and/andNot/andAny statements
             // because plain objects are just the next level of nested preload
-            if (key === 'on' ||
-                key === 'notOn' ||
-                key === 'onAny' ||
+            if (key === 'and' ||
+                key === 'andNot' ||
+                key === 'andAny' ||
                 value === null ||
                 value.constructor !== Object) {
                 agg[key] = value;
@@ -2048,9 +2056,9 @@ class Query extends ConnectedToDB_js_1.default {
             }
         }
     }
-    applyOneJoin({ query, dreamClass, previousAssociationTableOrAlias, currentAssociationTableOrAlias, joinOnStatements = {}, throughAssociations = [], joinType, }) {
+    applyOneJoin({ query, dreamClass, previousAssociationTableOrAlias, currentAssociationTableOrAlias, joinAndStatements = {}, throughAssociations = [], joinType, }) {
         const { name, alias } = (0, extractAssociationMetadataFromAssociationName_js_1.default)(currentAssociationTableOrAlias);
-        const joinOnStatement = joinOnStatements[currentAssociationTableOrAlias];
+        const joinAndStatement = joinAndStatements[currentAssociationTableOrAlias];
         previousAssociationTableOrAlias = (0, extractAssociationMetadataFromAssociationName_js_1.default)(previousAssociationTableOrAlias).alias;
         currentAssociationTableOrAlias = alias;
         let association = dreamClass['getAssociationMetadata'](name);
@@ -2124,12 +2132,12 @@ class Query extends ConnectedToDB_js_1.default {
                 join = join.onRef(this.namespaceColumn(association.foreignKey(), previousAssociationTableOrAlias), '=', this.namespaceColumn(association.primaryKey(), currentAssociationTableOrAlias));
                 if (timeToApplyThroughAssociations) {
                     throughAssociations.forEach((throughAssociation) => {
-                        join = this.applyAssociationOnStatementsToJoinStatement({
+                        join = this.applyAssociationAndStatementsToJoinStatement({
                             join,
                             association: throughAssociation,
                             currentAssociationTableOrAlias,
                             previousAssociationTableOrAlias: originalPreviousAssociationTableOrAlias,
-                            joinOnStatements,
+                            joinAndStatements,
                         });
                     });
                 }
@@ -2138,7 +2146,7 @@ class Query extends ConnectedToDB_js_1.default {
                     tableNameOrAlias: currentAssociationTableOrAlias,
                     association,
                 });
-                join = this.applyJoinOnStatement(join, joinOnStatement, currentAssociationTableOrAlias);
+                join = this.applyJoinAndStatement(join, joinAndStatement, currentAssociationTableOrAlias);
                 return join;
             });
         }
@@ -2158,28 +2166,28 @@ class Query extends ConnectedToDB_js_1.default {
                 }
                 if (timeToApplyThroughAssociations) {
                     throughAssociations.forEach((throughAssociation) => {
-                        join = this.applyAssociationOnStatementsToJoinStatement({
+                        join = this.applyAssociationAndStatementsToJoinStatement({
                             join,
                             association: throughAssociation,
                             currentAssociationTableOrAlias,
                             previousAssociationTableOrAlias: originalPreviousAssociationTableOrAlias,
-                            joinOnStatements,
+                            joinAndStatements,
                         });
                     });
                 }
-                join = this.applyAssociationOnStatementsToJoinStatement({
+                join = this.applyAssociationAndStatementsToJoinStatement({
                     join,
                     association,
                     currentAssociationTableOrAlias,
                     previousAssociationTableOrAlias,
-                    joinOnStatements,
+                    joinAndStatements,
                 });
                 join = this.conditionallyApplyDefaultScopesDependentOnAssociation({
                     join,
                     tableNameOrAlias: currentAssociationTableOrAlias,
                     association,
                 });
-                join = this.applyJoinOnStatement(join, joinOnStatement, currentAssociationTableOrAlias);
+                join = this.applyJoinAndStatement(join, joinAndStatement, currentAssociationTableOrAlias);
                 return join;
             });
             if (association.type === 'HasMany') {
@@ -2206,29 +2214,29 @@ class Query extends ConnectedToDB_js_1.default {
             currentAssociationTableOrAlias,
         };
     }
-    applyAssociationOnStatementsToJoinStatement({ join, currentAssociationTableOrAlias, previousAssociationTableOrAlias, association, joinOnStatements, }) {
-        if (association.on) {
-            this.throwUnlessAllRequiredWhereClausesProvided(association, currentAssociationTableOrAlias, joinOnStatements);
-            join = join.on((eb) => this.whereStatementToExpressionWrapper(eb, this.aliasWhereStatement(association.on, currentAssociationTableOrAlias), { disallowSimilarityOperator: false }));
+    applyAssociationAndStatementsToJoinStatement({ join, currentAssociationTableOrAlias, previousAssociationTableOrAlias, association, joinAndStatements, }) {
+        if (association.and) {
+            this.throwUnlessAllRequiredWhereClausesProvided(association, currentAssociationTableOrAlias, joinAndStatements);
+            join = join.on((eb) => this.whereStatementToExpressionWrapper(eb, this.aliasWhereStatement(association.and, currentAssociationTableOrAlias), { disallowSimilarityOperator: false }));
         }
-        if (association.notOn) {
-            join = join.on((eb) => this.whereStatementToExpressionWrapper(eb, this.aliasWhereStatement(association.notOn, currentAssociationTableOrAlias), { negate: true }));
+        if (association.andNot) {
+            join = join.on((eb) => this.whereStatementToExpressionWrapper(eb, this.aliasWhereStatement(association.andNot, currentAssociationTableOrAlias), { negate: true }));
         }
-        if (association.onAny) {
-            join = join.on((eb) => eb.or(association.onAny.map(whereAnyStatement => this.whereStatementToExpressionWrapper(eb, this.aliasWhereStatement(whereAnyStatement, currentAssociationTableOrAlias), { disallowSimilarityOperator: false }))));
+        if (association.andAny) {
+            join = join.on((eb) => eb.or(association.andAny.map(whereAnyStatement => this.whereStatementToExpressionWrapper(eb, this.aliasWhereStatement(whereAnyStatement, currentAssociationTableOrAlias), { disallowSimilarityOperator: false }))));
         }
-        if (association.selfOn) {
+        if (association.selfAnd) {
             join = join.on((eb) => this.whereStatementToExpressionWrapper(eb, this.rawifiedSelfOnClause({
                 associationAlias: association.as,
                 selfAlias: previousAssociationTableOrAlias,
-                selfOnClause: association.selfOn,
+                selfAndClause: association.selfAnd,
             })));
         }
-        if (association.selfNotOn) {
+        if (association.selfAndNot) {
             join = join.on((eb) => this.whereStatementToExpressionWrapper(eb, this.rawifiedSelfOnClause({
                 associationAlias: association.as,
                 selfAlias: previousAssociationTableOrAlias,
-                selfOnClause: association.selfNotOn,
+                selfAndClause: association.selfAndNot,
             }), { negate: true }));
         }
         return join;
@@ -2263,22 +2271,22 @@ class Query extends ConnectedToDB_js_1.default {
             return this.namespaceColumn(foreignKey, tableNameOrAlias);
         return this.namespaceColumn(association.distinct, tableNameOrAlias);
     }
-    recursivelyJoin({ query, joinsStatement, joinOnStatements, dreamClass, previousAssociationTableOrAlias, joinType, }) {
-        for (const currentAssociationTableOrAlias of Object.keys(joinsStatement)) {
+    recursivelyJoin({ query, joinStatement, joinAndStatements, dreamClass, previousAssociationTableOrAlias, joinType, }) {
+        for (const currentAssociationTableOrAlias of Object.keys(joinStatement)) {
             const results = this.applyOneJoin({
                 query,
                 dreamClass,
                 previousAssociationTableOrAlias,
                 currentAssociationTableOrAlias,
-                joinOnStatements,
+                joinAndStatements,
                 joinType,
             });
             query = results.query;
             const association = results.association;
             query = this.recursivelyJoin({
                 query,
-                joinsStatement: joinsStatement[currentAssociationTableOrAlias],
-                joinOnStatements: joinOnStatements[currentAssociationTableOrAlias],
+                joinStatement: joinStatement[currentAssociationTableOrAlias],
+                joinAndStatements: joinAndStatements[currentAssociationTableOrAlias],
                 dreamClass: association.modelCB(),
                 previousAssociationTableOrAlias: currentAssociationTableOrAlias,
                 joinType,
@@ -2286,16 +2294,16 @@ class Query extends ConnectedToDB_js_1.default {
         }
         return query;
     }
-    throwUnlessAllRequiredWhereClausesProvided(association, namespace, joinOnStatements) {
-        const whereStatement = association.on;
-        const columnsRequiringWhereStatements = Object.keys(whereStatement).reduce((agg, column) => {
-            if (whereStatement[column] === constants_js_1.DreamConst.required)
+    throwUnlessAllRequiredWhereClausesProvided(association, namespace, joinAndStatements) {
+        const andClause = association.and;
+        const columnsRequiringAndStatements = Object.keys(andClause).reduce((agg, column) => {
+            if (andClause[column] === constants_js_1.DreamConst.required)
                 agg.push(column);
             return agg;
         }, []);
-        const missingRequiredWhereStatements = columnsRequiringWhereStatements.filter(column => joinOnStatements[namespace]?.on?.[column] === undefined);
+        const missingRequiredWhereStatements = columnsRequiringAndStatements.filter(column => joinAndStatements[namespace]?.and?.[column] === undefined);
         if (missingRequiredWhereStatements.length)
-            throw new MissingRequiredAssociationOnClause_js_1.default(association, missingRequiredWhereStatements[0]);
+            throw new MissingRequiredAssociationAndClause_js_1.default(association, missingRequiredWhereStatements[0]);
     }
     applyOrderStatementForAssociation({ query, tableNameOrAlias, association, }) {
         if (!query.orderBy)
@@ -2423,7 +2431,7 @@ class Query extends ConnectedToDB_js_1.default {
         else if (val === constants_js_1.DreamConst.passthrough) {
             const column = attr.split('.').pop();
             if (this.passthroughOnStatement[column] === undefined)
-                throw new MissingRequiredPassthroughForAssociationOnClause_js_1.default(column);
+                throw new MissingRequiredPassthroughForAssociationAndClause_js_1.default(column);
             val = this.passthroughOnStatement[column];
         }
         if (val === null) {
@@ -2490,36 +2498,36 @@ class Query extends ConnectedToDB_js_1.default {
             throw new CannotPassUndefinedAsAValueToAWhereClause_js_1.default(this.dreamClass, a2);
         return { a, b, c, a2, b2, c2 };
     }
-    applyJoinOnStatement(join, joinOnStatement, rootTableOrAssociationAlias) {
-        if (!joinOnStatement)
+    applyJoinAndStatement(join, joinAndStatement, rootTableOrAssociationAlias) {
+        if (!joinAndStatement)
             return join;
-        join = this._applyJoinOnStatements(join, joinOnStatement.on, rootTableOrAssociationAlias);
-        join = this._applyJoinOnStatements(join, joinOnStatement.notOn, rootTableOrAssociationAlias, {
+        join = this._applyJoinAndStatements(join, joinAndStatement.and, rootTableOrAssociationAlias);
+        join = this._applyJoinAndStatements(join, joinAndStatement.andNot, rootTableOrAssociationAlias, {
             negate: true,
         });
-        join = this._applyJoinOnAnyStatements(join, joinOnStatement.onAny, rootTableOrAssociationAlias);
+        join = this._applyJoinAndAnyStatements(join, joinAndStatement.andAny, rootTableOrAssociationAlias);
         return join;
     }
-    _applyJoinOnStatements(join, joinOnStatement, rootTableOrAssociationAlias, { negate = false, } = {}) {
-        if (!joinOnStatement)
+    _applyJoinAndStatements(join, joinAndStatement, rootTableOrAssociationAlias, { negate = false, } = {}) {
+        if (!joinAndStatement)
             return join;
-        return join.on((eb) => this.joinOnStatementToExpressionWrapper(joinOnStatement, rootTableOrAssociationAlias, eb, {
+        return join.on((eb) => this.joinAndStatementToExpressionWrapper(joinAndStatement, rootTableOrAssociationAlias, eb, {
             negate,
             disallowSimilarityOperator: negate,
         }));
     }
-    _applyJoinOnAnyStatements(join, joinOnAnyStatement, rootTableOrAssociationAlias) {
-        if (!joinOnAnyStatement)
+    _applyJoinAndAnyStatements(join, joinAndAnyStatement, rootTableOrAssociationAlias) {
+        if (!joinAndAnyStatement)
             return join;
-        if (!joinOnAnyStatement.length)
+        if (!joinAndAnyStatement.length)
             return join;
         return join.on((eb) => {
-            return eb.or(joinOnAnyStatement.map(joinOnStatement => this.joinOnStatementToExpressionWrapper(joinOnStatement, rootTableOrAssociationAlias, eb)));
+            return eb.or(joinAndAnyStatement.map(joinAndStatement => this.joinAndStatementToExpressionWrapper(joinAndStatement, rootTableOrAssociationAlias, eb)));
         });
     }
-    joinOnStatementToExpressionWrapper(joinOnStatement, rootTableOrAssociationAlias, eb, { negate = false, disallowSimilarityOperator = true, } = {}) {
-        return this.whereStatementToExpressionWrapper(eb, Object.keys(joinOnStatement).reduce((agg, key) => {
-            agg[this.namespaceColumn(key.toString(), rootTableOrAssociationAlias)] = joinOnStatement[key];
+    joinAndStatementToExpressionWrapper(joinAndStatement, rootTableOrAssociationAlias, eb, { negate = false, disallowSimilarityOperator = true, } = {}) {
+        return this.whereStatementToExpressionWrapper(eb, Object.keys(joinAndStatement).reduce((agg, key) => {
+            agg[this.namespaceColumn(key.toString(), rootTableOrAssociationAlias)] = joinAndStatement[key];
             return agg;
         }, {}), {
             negate,
@@ -2532,8 +2540,8 @@ class Query extends ConnectedToDB_js_1.default {
         if (!(0, isEmpty_js_1.default)(query.innerJoinStatements)) {
             kyselyQuery = query.recursivelyJoin({
                 query: kyselyQuery,
-                joinsStatement: query.innerJoinStatements,
-                joinOnStatements: query.innerJoinOnStatements,
+                joinStatement: query.innerJoinStatements,
+                joinAndStatements: query.innerJoinAndStatements,
                 dreamClass: query.dreamClass,
                 previousAssociationTableOrAlias: this.baseSqlAlias,
                 joinType: 'inner',
@@ -2542,8 +2550,8 @@ class Query extends ConnectedToDB_js_1.default {
         if (!(0, isEmpty_js_1.default)(query.leftJoinStatements)) {
             kyselyQuery = query.recursivelyJoin({
                 query: kyselyQuery,
-                joinsStatement: query.leftJoinStatements,
-                joinOnStatements: query.leftJoinOnStatements,
+                joinStatement: query.leftJoinStatements,
+                joinAndStatements: query.leftJoinAndStatements,
                 dreamClass: query.dreamClass,
                 previousAssociationTableOrAlias: this.baseSqlAlias,
                 joinType: 'left',
@@ -2579,11 +2587,11 @@ class Query extends ConnectedToDB_js_1.default {
             return aliasedWhere;
         }, {});
     }
-    rawifiedSelfOnClause({ associationAlias, selfAlias, selfOnClause, }) {
+    rawifiedSelfOnClause({ associationAlias, selfAlias, selfAndClause, }) {
         const alphanumericUnderscoreRegexp = /[^a-zA-Z0-9_]/g;
         selfAlias = selfAlias.replace(alphanumericUnderscoreRegexp, '');
-        return Object.keys(selfOnClause).reduce((acc, key) => {
-            const selfColumn = selfOnClause[key]?.replace(alphanumericUnderscoreRegexp, '');
+        return Object.keys(selfAndClause).reduce((acc, key) => {
+            const selfColumn = selfAndClause[key]?.replace(alphanumericUnderscoreRegexp, '');
             if (!selfColumn)
                 return acc;
             acc[this.namespaceColumn(key, associationAlias)] = kysely_1.sql.raw(`"${(0, snakeify_js_1.default)(selfAlias)}"."${(0, snakeify_js_1.default)(selfColumn)}"`);
@@ -2661,7 +2669,7 @@ class Query extends ConnectedToDB_js_1.default {
         return new SimilarityBuilder_js_1.default(this.dreamInstance, {
             where: [...this.whereStatements],
             whereNot: [...this.whereNotStatements],
-            joinOnStatements: this.innerJoinOnStatements,
+            joinAndStatements: this.innerJoinAndStatements,
             transaction: this.dreamTransaction,
             connection: this.connectionOverride,
         });

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

@@ -2,7 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.default = associationQuery;
 const applyScopeBypassingSettingsToQuery_js_1 = require("../applyScopeBypassingSettingsToQuery.js");
-function associationQuery(dream, txn = null, associationName, { joinOnStatements, bypassAllDefaultScopes, defaultScopesToBypass, }) {
+function associationQuery(dream, txn = null, associationName, { joinAndStatements, bypassAllDefaultScopes, defaultScopesToBypass, }) {
     const association = dream['associationMetadataMap']()[associationName];
     const associationClass = association.modelCB();
     const dreamClass = dream.constructor;
@@ -10,8 +10,8 @@ function associationQuery(dream, txn = null, associationName, { joinOnStatements
     let baseSelectQuery = dreamClassOrTransaction.where({
         [dream.primaryKey]: dream.primaryKeyValue,
     });
-    if (joinOnStatements && (joinOnStatements.on || joinOnStatements.notOn || joinOnStatements.onAny))
-        baseSelectQuery = baseSelectQuery.innerJoin(association.as, joinOnStatements);
+    if (joinAndStatements && (joinAndStatements.and || joinAndStatements.andNot || joinAndStatements.andAny))
+        baseSelectQuery = baseSelectQuery.innerJoin(association.as, joinAndStatements);
     else
         baseSelectQuery = baseSelectQuery.innerJoin(association.as);
     let query = txn ? associationClass.txn(txn).queryInstance() : associationClass.query();

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

@@ -4,7 +4,7 @@ exports.default = associationUpdateQuery;
 const UnexpectedUndefined_js_1 = require("../../../errors/UnexpectedUndefined.js");
 const namespaceColumn_js_1 = require("../../../helpers/namespaceColumn.js");
 const applyScopeBypassingSettingsToQuery_js_1 = require("../applyScopeBypassingSettingsToQuery.js");
-function associationUpdateQuery(dream, txn = null, associationName, { joinOnStatements, bypassAllDefaultScopes, defaultScopesToBypass, }) {
+function associationUpdateQuery(dream, txn = null, associationName, { joinAndStatements, bypassAllDefaultScopes, defaultScopesToBypass, }) {
     const association = dream['associationMetadataMap']()[associationName];
     if (association === undefined)
         throw new UnexpectedUndefined_js_1.default();
@@ -20,8 +20,8 @@ function associationUpdateQuery(dream, txn = null, associationName, { joinOnStat
         bypassAllDefaultScopes,
         defaultScopesToBypass,
     });
-    if (joinOnStatements && (joinOnStatements.on || joinOnStatements.notOn || joinOnStatements.onAny))
-        nestedScope = nestedScope.innerJoin(association.as, joinOnStatements);
+    if (joinAndStatements && (joinAndStatements.and || joinAndStatements.andNot || joinAndStatements.andAny))
+        nestedScope = nestedScope.innerJoin(association.as, joinAndStatements);
     else
         nestedScope = nestedScope.innerJoin(association.as);
     const nestedSelect = nestedScope

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

@@ -2,9 +2,9 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.default = destroyAssociation;
 const associationUpdateQuery_js_1 = require("./associationUpdateQuery.js");
-async function destroyAssociation(dream, txn = null, associationName, { joinOnStatements, bypassAllDefaultScopes, defaultScopesToBypass, cascade, reallyDestroy, skipHooks, }) {
+async function destroyAssociation(dream, txn = null, associationName, { joinAndStatements, bypassAllDefaultScopes, defaultScopesToBypass, cascade, reallyDestroy, skipHooks, }) {
     const query = (0, associationUpdateQuery_js_1.default)(dream, txn, associationName, {
-        joinOnStatements,
+        joinAndStatements,
         bypassAllDefaultScopes,
         defaultScopesToBypass,
     });

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

@@ -2,9 +2,9 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.default = undestroyAssociation;
 const associationUpdateQuery_js_1 = require("./associationUpdateQuery.js");
-async function undestroyAssociation(dream, txn = null, associationName, { joinOnStatements, bypassAllDefaultScopes, defaultScopesToBypass, cascade, skipHooks, }) {
+async function undestroyAssociation(dream, txn = null, associationName, { joinAndStatements, bypassAllDefaultScopes, defaultScopesToBypass, cascade, skipHooks, }) {
     const query = (0, associationUpdateQuery_js_1.default)(dream, txn, associationName, {
-        joinOnStatements,
+        joinAndStatements,
         bypassAllDefaultScopes,
         defaultScopesToBypass,
     });

package/dist/cjs/src/dream/internal/similarity/SimilarityBuilder.js

@@ -14,12 +14,12 @@ const similarityWhereSql_js_1 = require("./similarityWhereSql.js");
 class SimilarityBuilder extends ConnectedToDB_js_1.default {
     whereStatement;
     whereNotStatement;
-    joinOnStatements = Object.freeze({});
+    joinAndStatements = Object.freeze({});
     constructor(dreamInstance, opts = {}) {
         super(dreamInstance, opts);
         this.whereStatement = Object.freeze(opts.where || []);
         this.whereNotStatement = Object.freeze(opts.whereNot || []);
-        this.joinOnStatements = Object.freeze(opts.joinOnStatements || {});
+        this.joinAndStatements = Object.freeze(opts.joinAndStatements || {});
     }
     /*
     #select
@@ -73,11 +73,11 @@ class SimilarityBuilder extends ConnectedToDB_js_1.default {
                 bypassOrder,
             });
         });
-        this.joinOnStatementsWithSimilarityClauses().forEach((similarityStatement, index) => {
+        this.joinAndStatementsWithSimilarityClauses().forEach((similarityStatement, index) => {
             kyselyQuery = this.addStatementToSelectQuery({
                 kyselyQuery,
                 similarityStatement,
-                statementType: 'on',
+                statementType: 'join_and',
                 index,
                 bypassOrder,
             });
@@ -148,11 +148,11 @@ class SimilarityBuilder extends ConnectedToDB_js_1.default {
                 index,
             });
         });
-        this.joinOnStatementsWithSimilarityClauses().forEach((similarityStatement, index) => {
+        this.joinAndStatementsWithSimilarityClauses().forEach((similarityStatement, index) => {
             kyselyQuery = this.addStatementToUpdateQuery({
                 kyselyQuery,
                 similarityStatement,
-                statementType: 'on',
+                statementType: 'join_and',
                 index,
             });
         });
@@ -167,8 +167,8 @@ class SimilarityBuilder extends ConnectedToDB_js_1.default {
     whereNotStatementsWithSimilarityClauses() {
         return this.similarityStatementFilter(this.whereNotStatement);
     }
-    joinOnStatementsWithSimilarityClauses() {
-        return this.recursiveJoinsOnFinder(removeOnFromObjectHierarchy(this.joinOnStatements), this.dreamClass);
+    joinAndStatementsWithSimilarityClauses() {
+        return this.recursiveJoinsOnFinder(removeJoinAndFromObjectHierarchy(this.joinAndStatements), this.dreamClass);
     }
     recursiveJoinsOnFinder(obj, dreamClass) {
         const similar = [];
@@ -210,7 +210,7 @@ class SimilarityBuilder extends ConnectedToDB_js_1.default {
         return [
             ...this.whereStatementsWithSimilarityClauses(),
             ...this.whereNotStatementsWithSimilarityClauses(),
-            ...this.joinOnStatementsWithSimilarityClauses(),
+            ...this.joinAndStatementsWithSimilarityClauses(),
         ];
     }
     addStatementToSelectQuery({ kyselyQuery, similarityStatement, index, statementType, bypassOrder, }) {
@@ -312,15 +312,15 @@ class SimilarityBuilder extends ConnectedToDB_js_1.default {
     }
 }
 exports.default = SimilarityBuilder;
-exports.SIMILARITY_TYPES = ['where', 'on'];
-function removeOnFromObjectHierarchy(obj) {
+exports.SIMILARITY_TYPES = ['where', 'join_and'];
+function removeJoinAndFromObjectHierarchy(obj) {
     if (obj?.isOpsStatement)
         return obj;
     const result = {};
     for (const key in obj) {
         if (Object.prototype.hasOwnProperty.call(obj, key)) {
             if ((0, typechecks_js_1.isObject)(obj[key])) {
-                result[key] = removeOnFromObjectHierarchy(obj[key].on || obj[key]);
+                result[key] = removeJoinAndFromObjectHierarchy(obj[key].and || obj[key]);
             }
             else {
                 result[key] = obj[key];

package/dist/cjs/src/errors/{CannotDefineAssociationWithBothDependentAndRequiredOnClause.js → CannotDefineAssociationWithBothDependentAndRequiredAndClause.js}

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-class CannotDefineAssociationWithBothDependentAndRequiredOnClause extends Error {
+class CannotDefineAssociationWithBothDependentAndRequiredAndClause extends Error {
     dreamClass;
     associationName;
     constructor(dreamClass, associationName) {
@@ -16,4 +16,4 @@ ${this.dreamClass.sanitizedName} dream class.
     `;
     }
 }
-exports.default = CannotDefineAssociationWithBothDependentAndRequiredOnClause;
+exports.default = CannotDefineAssociationWithBothDependentAndRequiredAndClause;

package/dist/cjs/src/errors/associations/{MissingRequiredAssociationOnClause.js → MissingRequiredAssociationAndClause.js}

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-class MissingRequiredAssociationOnClause extends Error {
+class MissingRequiredAssociationAndClause extends Error {
     association;
     column;
     constructor(association, column) {
@@ -10,10 +10,10 @@ class MissingRequiredAssociationOnClause extends Error {
     }
     get message() {
         return `
-Missing required association on clause:
+Missing required association and-clause:
 Association: ${this.association.as}
-Missing on clause for column: ${this.column}
+Missing and-clause for column: ${this.column}
 `;
     }
 }
-exports.default = MissingRequiredAssociationOnClause;
+exports.default = MissingRequiredAssociationAndClause;