@nocobase/database 1.6.0-alpha.2 → 1.6.0-alpha.21

package/lib/relation-repository/relation-repository.d.ts

@@ -11,7 +11,7 @@ import { Collection } from '../collection';
 import Database from '../database';
 import { RelationField } from '../fields/relation-field';
 import { Model } from '../model';
-import { CreateOptions, Filter, FindOptions, TargetKey } from '../repository';
+import { CreateOptions, Filter, FindOptions, FirstOrCreateOptions, TargetKey, UpdateOptions } from './types';
 export declare const transaction: (transactionInjector?: any) => (target: any, name: any, descriptor: any) => any;
 export declare abstract class RelationRepository {
     sourceCollection: Collection;
@@ -30,6 +30,8 @@ export declare abstract class RelationRepository {
     isMultiTargetKey(value?: any): boolean;
     get collection(): Collection<any, any>;
     abstract find(options?: FindOptions): Promise<any>;
+    abstract findOne(options?: FindOptions): Promise<any>;
+    abstract update(options: UpdateOptions): Promise<any>;
     chunk(options: FindOptions & {
         chunkSize: number;
         callback: (rows: Model[], options: FindOptions) => Promise<void>;
@@ -37,6 +39,8 @@ export declare abstract class RelationRepository {
     convertTk(options: any): any;
     convertTks(options: any): any[];
     targetKey(): any;
+    firstOrCreate(options: FirstOrCreateOptions): Promise<any>;
+    updateOrCreate(options: FirstOrCreateOptions): Promise<any>;
     create(options?: CreateOptions): Promise<any>;
     getSourceModel(transaction?: Transaction): Promise<Model<any, any>>;
     protected accessors(): import("sequelize").SingleAssociationAccessors | import("sequelize").MultiAssociationAccessors;

package/lib/relation-repository/relation-repository.js

@@ -55,6 +55,7 @@ var import_filter_parser = __toESM(require("../filter-parser"));
 var import_options_parser = require("../options-parser");
 var import_update_associations = require("../update-associations");
 var import_update_guard = require("../update-guard");
+var import_filter_utils = require("../utils/filter-utils");
 const transaction = (0, import_transaction_decorator.transactionWrapperBuilder)(function() {
   return this.sourceCollection.model.sequelize.transaction();
 });
@@ -141,6 +142,32 @@ const _RelationRepository = class _RelationRepository {
   targetKey() {
     return this.associationField.targetKey;
   }
+  async firstOrCreate(options) {
+    const { filterKeys, values, transaction: transaction2, hooks, context } = options;
+    const filter = (0, import_filter_utils.valuesToFilter)(values, filterKeys);
+    const instance = await this.findOne({ filter, transaction: transaction2, context });
+    if (instance) {
+      return instance;
+    }
+    return this.create({ values, transaction: transaction2, hooks, context });
+  }
+  async updateOrCreate(options) {
+    const { filterKeys, values, transaction: transaction2, hooks, context } = options;
+    const filter = (0, import_filter_utils.valuesToFilter)(values, filterKeys);
+    const instance = await this.findOne({ filter, transaction: transaction2, context });
+    if (instance) {
+      return await this.update({
+        filterByTk: instance.get(
+          this.targetCollection.filterTargetKey || this.targetCollection.model.primaryKeyAttribute
+        ),
+        values,
+        transaction: transaction2,
+        hooks,
+        context
+      });
+    }
+    return this.create({ values, transaction: transaction2, hooks, context });
+  }
   async create(options) {
     if (Array.isArray(options.values)) {
       return Promise.all(options.values.map((record) => this.create({ ...options, values: record })));
@@ -210,6 +237,12 @@ const _RelationRepository = class _RelationRepository {
   }
 };
 __name(_RelationRepository, "RelationRepository");
+__decorateClass([
+  transaction()
+], _RelationRepository.prototype, "firstOrCreate", 1);
+__decorateClass([
+  transaction()
+], _RelationRepository.prototype, "updateOrCreate", 1);
 __decorateClass([
   transaction()
 ], _RelationRepository.prototype, "create", 1);

package/lib/relation-repository/single-relation-repository.d.ts

@@ -8,15 +8,8 @@
  */
 import { SingleAssociationAccessors, Transactionable } from 'sequelize';
 import { Model } from '../model';
-import { Appends, Except, Fields, Filter, TargetKey, UpdateOptions } from '../repository';
+import { FindOptions, TargetKey, UpdateOptions } from './types';
 import { RelationRepository } from './relation-repository';
-export interface SingleRelationFindOption extends Transactionable {
-    fields?: Fields;
-    except?: Except;
-    appends?: Appends;
-    filter?: Filter;
-    targetCollection?: string;
-}
 interface SetOption extends Transactionable {
     tk?: TargetKey;
 }
@@ -24,8 +17,8 @@ export declare abstract class SingleRelationRepository extends RelationRepositor
     abstract filterOptions(sourceModel: any): any;
     remove(options?: Transactionable): Promise<void>;
     set(options: TargetKey | SetOption): Promise<void>;
-    find(options?: SingleRelationFindOption): Promise<any>;
-    findOne(options?: SingleRelationFindOption): Promise<Model<any>>;
+    find(options?: FindOptions): Promise<any>;
+    findOne(options?: FindOptions): Promise<Model<any>>;
     destroy(options?: Transactionable): Promise<boolean>;
     update(options: UpdateOptions): Promise<any>;
     /**

package/lib/relation-repository/single-relation-repository.js

@@ -48,10 +48,10 @@ __export(single_relation_repository_exports, {
   SingleRelationRepository: () => SingleRelationRepository
 });
 module.exports = __toCommonJS(single_relation_repository_exports);
-var import_lodash = __toESM(require("lodash"));
 var import_target_collection_decorator = __toESM(require("../decorators/target-collection-decorator"));
 var import_update_associations = require("../update-associations");
 var import_relation_repository = require("./relation-repository");
+var import_lodash = __toESM(require("lodash"));
 const _SingleRelationRepository = class _SingleRelationRepository extends import_relation_repository.RelationRepository {
   async remove(options) {
     const transaction2 = await this.getTransaction(options);
@@ -97,6 +97,7 @@ const _SingleRelationRepository = class _SingleRelationRepository extends import
     const transaction2 = await this.getTransaction(options);
     const target = await this.find({
       transaction: transaction2,
+      // @ts-ignore
       targetCollection: options.targetCollection
     });
     if (!target) {

package/lib/relation-repository/types.d.ts

@@ -6,10 +6,81 @@
  * This project is dual-licensed under AGPL-3.0 and NocoBase Commercial License.
  * For more information, please refer to: https://www.nocobase.com/agreement.
  */
-import { TargetKey, Values } from '../repository';
-import { Transactionable } from 'sequelize';
-export type PrimaryKeyWithThroughValues = [TargetKey, Values];
-export interface AssociatedOptions extends Transactionable {
-    tk?: TargetKey | TargetKey[] | PrimaryKeyWithThroughValues | PrimaryKeyWithThroughValues[];
+import { AssociationKeysToBeUpdate, BlackList, Values, WhiteList } from '@nocobase/database';
+import { Transaction } from 'sequelize';
+import { CreateOptions as SequelizeCreateOptions, UpdateOptions as SequelizeUpdateOptions } from 'sequelize/types/model';
+export type TargetKey = string | number | {
+    [key: string]: any;
+};
+export interface Filter {
+    [key: string]: any;
+}
+export interface Appends {
+    [key: string]: true | Appends;
+}
+export interface Except {
+    [key: string]: true | Except;
+}
+export interface CommonOptions {
+    transaction?: Transaction;
+    context?: any;
+}
+export interface FindOptions extends CommonOptions {
+    filter?: Filter;
+    filterByTk?: TargetKey;
+    fields?: string[];
+    appends?: string[];
+    except?: string[];
+    sort?: string[];
+    limit?: number;
+    offset?: number;
+    raw?: boolean;
+    targetCollection?: string;
+}
+export interface CountOptions extends CommonOptions {
+    filter?: Filter;
+}
+export interface CreateOptions extends SequelizeCreateOptions {
+    values?: Values | Values[];
+    whitelist?: WhiteList;
+    blacklist?: BlackList;
+    updateAssociationValues?: AssociationKeysToBeUpdate;
+    context?: any;
+}
+export interface UpdateOptions extends Omit<SequelizeUpdateOptions, 'where'> {
+    values: Values;
+    filter?: Filter;
+    filterByTk?: TargetKey;
+    whitelist?: WhiteList;
+    blacklist?: BlackList;
+    updateAssociationValues?: AssociationKeysToBeUpdate;
+    targetCollection?: string;
+    context?: any;
+}
+export interface DestroyOptions extends CommonOptions {
+    filter?: Filter;
+    filterByTk?: TargetKey;
+    truncate?: boolean;
+    context?: any;
+}
+export interface FirstOrCreateOptions extends CommonOptions {
+    filterKeys: string[];
+    values: any;
+    hooks?: boolean;
+    context?: any;
+}
+export interface ThroughValues {
+    [key: string]: any;
+}
+export interface AssociatedOptions extends CommonOptions {
+    tk?: TargetKey | TargetKey[];
+    transaction?: Transaction;
+}
+export interface PrimaryKeyWithThroughValues {
+    pk: any;
+    throughValues?: ThroughValues;
+}
+export interface ToggleOptions extends CommonOptions {
+    tk?: TargetKey;
+    transaction?: Transaction;
 }
-export type setAssociationOptions = TargetKey | TargetKey[] | PrimaryKeyWithThroughValues | PrimaryKeyWithThroughValues[] | AssociatedOptions;

package/lib/repository.d.ts

@@ -7,18 +7,19 @@
  * For more information, please refer to: https://www.nocobase.com/agreement.
  */
 /// <reference types="node" />
-import { Association, BulkCreateOptions, CountOptions as SequelizeCountOptions, CreateOptions as SequelizeCreateOptions, DestroyOptions as SequelizeDestroyOptions, FindAndCountOptions as SequelizeAndCountOptions, FindOptions as SequelizeFindOptions, ModelStatic, Transactionable, UpdateOptions as SequelizeUpdateOptions, WhereOperators } from 'sequelize';
+import { Association, BulkCreateOptions, ModelStatic, FindAndCountOptions as SequelizeAndCountOptions, CountOptions as SequelizeCountOptions, CreateOptions as SequelizeCreateOptions, DestroyOptions as SequelizeDestroyOptions, FindOptions as SequelizeFindOptions, UpdateOptions as SequelizeUpdateOptions, Transactionable, WhereOperators } from 'sequelize';
 import { Collection } from './collection';
 import { Database } from './database';
 import { ArrayFieldRepository } from './field-repository/array-field-repository';
 import { Model } from './model';
 import operators from './operators';
+import { BelongsToArrayRepository } from './belongs-to-array/belongs-to-array-repository';
 import { BelongsToManyRepository } from './relation-repository/belongs-to-many-repository';
 import { BelongsToRepository } from './relation-repository/belongs-to-repository';
 import { HasManyRepository } from './relation-repository/hasmany-repository';
 import { HasOneRepository } from './relation-repository/hasone-repository';
 import { RelationRepository } from './relation-repository/relation-repository';
-import { BelongsToArrayRepository } from './relation-repository/belongs-to-array-repository';
+import { valuesToFilter } from './utils/filter-utils';
 interface CreateManyOptions extends BulkCreateOptions {
     records: Values[];
 }
@@ -134,19 +135,18 @@ export interface AggregateOptions {
     filter?: Filter;
     distinct?: boolean;
 }
-interface FirstOrCreateOptions extends Transactionable {
+export interface FirstOrCreateOptions extends Transactionable {
     filterKeys: string[];
     values?: Values;
     hooks?: boolean;
+    context?: any;
 }
 export declare class Repository<TModelAttributes extends {} = any, TCreationAttributes extends {} = TModelAttributes> {
     database: Database;
     collection: Collection;
     model: ModelStatic<Model>;
     constructor(collection: Collection);
-    static valuesToFilter(values: Values, filterKeys: Array<string>): {
-        $and: any[];
-    };
+    static valuesToFilter: typeof valuesToFilter;
     /**
      * return count by filter
      */

package/lib/repository.js

@@ -13,6 +13,7 @@ var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;
 var __getProtoOf = Object.getPrototypeOf;
 var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
 var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
 var __export = (target, all) => {
   for (var name in all)
@@ -43,16 +44,16 @@ var __decorateClass = (decorators, target, key, kind) => {
   if (kind && result) __defProp(target, key, result);
   return result;
 };
+var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
 var repository_exports = {};
 __export(repository_exports, {
   Repository: () => Repository,
   Transactionable: () => import_sequelize2.Transactionable
 });
 module.exports = __toCommonJS(repository_exports);
-var import_flat = require("flat");
+var import_utils = require("@nocobase/utils");
 var import_lodash = __toESM(require("lodash"));
 var import_sequelize = require("sequelize");
-var import_utils = require("@nocobase/utils");
 var import_must_have_filter_decorator = __toESM(require("./decorators/must-have-filter-decorator"));
 var import_target_collection_decorator = __toESM(require("./decorators/target-collection-decorator"));
 var import_transaction_decorator = require("./decorators/transaction-decorator");
@@ -61,13 +62,14 @@ var import_array_field_repository = require("./field-repository/array-field-repo
 var import_fields = require("./fields");
 var import_filter_parser = __toESM(require("./filter-parser"));
 var import_options_parser = require("./options-parser");
+var import_belongs_to_array_repository = require("./belongs-to-array/belongs-to-array-repository");
 var import_belongs_to_many_repository = require("./relation-repository/belongs-to-many-repository");
 var import_belongs_to_repository = require("./relation-repository/belongs-to-repository");
 var import_hasmany_repository = require("./relation-repository/hasmany-repository");
 var import_hasone_repository = require("./relation-repository/hasone-repository");
 var import_update_associations = require("./update-associations");
 var import_update_guard = require("./update-guard");
-var import_belongs_to_array_repository = require("./relation-repository/belongs-to-array-repository");
+var import_filter_utils = require("./utils/filter-utils");
 var import_sequelize2 = require("sequelize");
 const debug = require("debug")("noco-database");
 const transaction = (0, import_transaction_decorator.transactionWrapperBuilder)(function() {
@@ -124,43 +126,6 @@ const _Repository = class _Repository {
     this.collection = collection;
     this.model = collection.model;
   }
-  static valuesToFilter(values = {}, filterKeys) {
-    const removeArrayIndexInKey = /* @__PURE__ */ __name((key) => {
-      const chunks = key.split(".");
-      return chunks.filter((chunk) => {
-        return !chunk.match(/\d+/);
-      }).join(".");
-    }, "removeArrayIndexInKey");
-    const filterAnd = [];
-    const flattedValues = (0, import_flat.flatten)(values);
-    const flattedValuesObject = {};
-    for (const key in flattedValues) {
-      const keyWithoutArrayIndex = removeArrayIndexInKey(key);
-      if (flattedValuesObject[keyWithoutArrayIndex]) {
-        if (!Array.isArray(flattedValuesObject[keyWithoutArrayIndex])) {
-          flattedValuesObject[keyWithoutArrayIndex] = [flattedValuesObject[keyWithoutArrayIndex]];
-        }
-        flattedValuesObject[keyWithoutArrayIndex].push(flattedValues[key]);
-      } else {
-        flattedValuesObject[keyWithoutArrayIndex] = [flattedValues[key]];
-      }
-    }
-    for (const filterKey of filterKeys) {
-      const filterValue = flattedValuesObject[filterKey] ? flattedValuesObject[filterKey] : import_lodash.default.get(values, filterKey);
-      if (filterValue) {
-        filterAnd.push({
-          [filterKey]: filterValue
-        });
-      } else {
-        filterAnd.push({
-          [filterKey]: null
-        });
-      }
-    }
-    return {
-      $and: filterAnd
-    };
-  }
   /**
    * return count by filter
    */
@@ -290,6 +255,9 @@ const _Repository = class _Repository {
       await eagerLoadingTree.load(transaction2);
       rows = eagerLoadingTree.root.instances;
     } else {
+      if (opts.where && model.primaryKeyAttributes.length === 0) {
+        opts.where = import_sequelize.Utils.mapWhereFieldNames(opts.where, model);
+      }
       rows = await model.findAll({
         ...opts,
         transaction: transaction2
@@ -339,27 +307,28 @@ const _Repository = class _Repository {
    * Get the first record matching the attributes or create it.
    */
   async firstOrCreate(options) {
-    const { filterKeys, values, transaction: transaction2, hooks } = options;
+    const { filterKeys, values, transaction: transaction2, hooks, context } = options;
     const filter = _Repository.valuesToFilter(values, filterKeys);
-    const instance = await this.findOne({ filter, transaction: transaction2 });
+    const instance = await this.findOne({ filter, transaction: transaction2, context });
     if (instance) {
       return instance;
     }
-    return this.create({ values, transaction: transaction2, hooks });
+    return this.create({ values, transaction: transaction2, hooks, context });
   }
   async updateOrCreate(options) {
-    const { filterKeys, values, transaction: transaction2, hooks } = options;
+    const { filterKeys, values, transaction: transaction2, hooks, context } = options;
     const filter = _Repository.valuesToFilter(values, filterKeys);
-    const instance = await this.findOne({ filter, transaction: transaction2 });
+    const instance = await this.findOne({ filter, transaction: transaction2, context });
     if (instance) {
       return await this.update({
         filterByTk: instance.get(this.collection.filterTargetKey || this.collection.model.primaryKeyAttribute),
         values,
         transaction: transaction2,
-        hooks
+        hooks,
+        context
       });
     }
-    return this.create({ values, transaction: transaction2, hooks });
+    return this.create({ values, transaction: transaction2, hooks, context });
   }
   async create(options) {
     if (Array.isArray(options.values)) {
@@ -500,7 +469,7 @@ const _Repository = class _Repository {
         throw new Error(`filterByTk is not supported for collection that has no primary key`);
       }
     }
-    if (filterByTk && !options.filter) {
+    if (filterByTk && !(0, import_utils.isValidFilter)(options.filter)) {
       const where = [];
       for (const tk of filterByTk) {
         const optionParser = new import_options_parser.OptionsParser(
@@ -595,6 +564,7 @@ const _Repository = class _Repository {
   }
 };
 __name(_Repository, "Repository");
+__publicField(_Repository, "valuesToFilter", import_filter_utils.valuesToFilter);
 __decorateClass([
   transaction()
 ], _Repository.prototype, "create", 1);

package/lib/update-associations.d.ts

@@ -13,7 +13,9 @@ export declare function modelAssociations(instance: Model): {
     [key: string]: Association<import("sequelize").Model<any, any>, import("sequelize").Model<any, any>>;
 };
 export declare function belongsToManyAssociations(instance: Model): Array<BelongsToMany>;
-export declare function modelAssociationByKey(instance: Model, key: string): Association;
+export declare function modelAssociationByKey(instance: Model, key: string): Association & {
+    update?: (instance: Model, value: any, options: UpdateAssociationOptions) => Promise<any>;
+};
 type UpdateValue = {
     [key: string]: any;
 };
@@ -26,7 +28,7 @@ interface UpdateOptions extends Transactionable {
     sanitized?: boolean;
     sourceModel?: Model;
 }
-interface UpdateAssociationOptions extends Transactionable, Hookable {
+export interface UpdateAssociationOptions extends Transactionable, Hookable {
     updateAssociationValues?: string[];
     sourceModel?: Model;
     context?: any;
@@ -49,7 +51,7 @@ export declare function updateAssociations(instance: Model, values: any, options
  * @param value
  * @param options
  */
-export declare function updateAssociation(instance: Model, key: string, value: any, options?: UpdateAssociationOptions): Promise<boolean>;
+export declare function updateAssociation(instance: Model, key: string, value: any, options?: UpdateAssociationOptions): Promise<any>;
 /**
  * update belongsTo and HasOne
  * @param model

package/lib/update-associations.js

@@ -51,18 +51,7 @@ module.exports = __toCommonJS(update_associations_exports);
 var import_lodash = __toESM(require("lodash"));
 var import_model = require("./model");
 var import_update_guard = require("./update-guard");
-function isUndefinedOrNull(value) {
-  return typeof value === "undefined" || value === null;
-}
-__name(isUndefinedOrNull, "isUndefinedOrNull");
-function isStringOrNumber(value) {
-  return typeof value === "string" || typeof value === "number";
-}
-__name(isStringOrNumber, "isStringOrNumber");
-function getKeysByPrefix(keys, prefix) {
-  return keys.filter((key) => key.startsWith(`${prefix}.`)).map((key) => key.substring(prefix.length + 1));
-}
-__name(getKeysByPrefix, "getKeysByPrefix");
+var import_utils = require("./utils");
 function modelAssociations(instance) {
   return instance.constructor.associations;
 }
@@ -183,6 +172,9 @@ async function updateAssociation(instance, key, value, options = {}) {
   if (options.associationContext && isReverseAssociationPair(association, options.associationContext)) {
     return false;
   }
+  if (association.update) {
+    return association.update(instance, value, options);
+  }
   switch (association.associationType) {
     case "HasOne":
     case "BelongsTo":
@@ -205,14 +197,14 @@ async function updateSingleAssociation(model, key, value, options = {}) {
     throw new Error(`The value of '${key}' cannot be in array format`);
   }
   const { recursive, context, updateAssociationValues = [], transaction } = options;
-  const keys = getKeysByPrefix(updateAssociationValues, key);
+  const keys = (0, import_utils.getKeysByPrefix)(updateAssociationValues, key);
   const setAccessor = association.accessors.set;
   const removeAssociation = /* @__PURE__ */ __name(async () => {
     await model[setAccessor](null, { transaction });
     model.setDataValue(key, null);
     return true;
   }, "removeAssociation");
-  if (isUndefinedOrNull(value)) {
+  if ((0, import_utils.isUndefinedOrNull)(value)) {
     return await removeAssociation();
   }
   if (association.associationType === "HasOne" && !model.get(association.sourceKeyAttribute)) {
@@ -226,7 +218,7 @@ async function updateSingleAssociation(model, key, value, options = {}) {
       );
     }
   }, "checkBelongsToForeignKeyValue");
-  if (isStringOrNumber(value)) {
+  if ((0, import_utils.isStringOrNumber)(value)) {
     await model[setAccessor](value, { context, transaction });
     return true;
   }
@@ -245,7 +237,7 @@ async function updateSingleAssociation(model, key, value, options = {}) {
     M = association.target;
     dataKey = M.primaryKeyAttribute;
   }
-  if (isStringOrNumber(value[dataKey])) {
+  if ((0, import_utils.isStringOrNumber)(value[dataKey])) {
     const instance2 = await M.findOne({
       where: {
         [dataKey]: value[dataKey]
@@ -298,10 +290,10 @@ async function updateMultipleAssociation(model, key, value, options = {}) {
     return false;
   }
   const { recursive, context, updateAssociationValues = [], transaction } = options;
-  const keys = getKeysByPrefix(updateAssociationValues, key);
+  const keys = (0, import_utils.getKeysByPrefix)(updateAssociationValues, key);
   const setAccessor = association.accessors.set;
   const createAccessor = association.accessors.create;
-  if (isUndefinedOrNull(value)) {
+  if ((0, import_utils.isUndefinedOrNull)(value)) {
     await model[setAccessor](null, { transaction, context, individualHooks: true, validate: false });
     model.setDataValue(key, null);
     return;
@@ -309,7 +301,7 @@ async function updateMultipleAssociation(model, key, value, options = {}) {
   if (association.associationType === "HasMany" && !model.get(association.sourceKeyAttribute)) {
     throw new Error(`The source key ${association.sourceKeyAttribute} is not set in ${model.constructor.name}`);
   }
-  if (isStringOrNumber(value)) {
+  if ((0, import_utils.isStringOrNumber)(value)) {
     await model[setAccessor](value, { transaction, context, individualHooks: true, validate: false });
     return;
   }
@@ -317,10 +309,10 @@ async function updateMultipleAssociation(model, key, value, options = {}) {
   const setItems = [];
   const objectItems = [];
   for (const item of value) {
-    if (isUndefinedOrNull(item)) {
+    if ((0, import_utils.isUndefinedOrNull)(item)) {
       continue;
     }
-    if (isStringOrNumber(item)) {
+    if ((0, import_utils.isStringOrNumber)(item)) {
       setItems.push(item);
     } else if (item instanceof import_model.Model) {
       setItems.push(item);
@@ -360,10 +352,10 @@ async function updateMultipleAssociation(model, key, value, options = {}) {
     if (throughValue) {
       accessorOptions["through"] = throughValue;
     }
-    if (pk !== targetKey && !isUndefinedOrNull(item[pk]) && isUndefinedOrNull(item[targetKey])) {
+    if (pk !== targetKey && !(0, import_utils.isUndefinedOrNull)(item[pk]) && (0, import_utils.isUndefinedOrNull)(item[targetKey])) {
       throw new Error(`${targetKey} field value is empty`);
     }
-    if (isUndefinedOrNull(item[targetKey])) {
+    if ((0, import_utils.isUndefinedOrNull)(item[targetKey])) {
       const instance = await model[createAccessor](item, accessorOptions);
       await updateAssociations(instance, item, {
         ...options,

package/lib/utils/filter-utils.d.ts

@@ -0,0 +1,13 @@
+/**
+ * This file is part of the NocoBase (R) project.
+ * Copyright (c) 2020-2024 NocoBase Co., Ltd.
+ * Authors: NocoBase Team.
+ *
+ * This project is dual-licensed under AGPL-3.0 and NocoBase Commercial License.
+ * For more information, please refer to: https://www.nocobase.com/agreement.
+ */
+type Values = Record<string, any>;
+export declare function valuesToFilter(values: Values, filterKeys: Array<string>): {
+    $and: any[];
+};
+export {};

package/lib/utils/filter-utils.js

@@ -0,0 +1,86 @@
+/**
+ * This file is part of the NocoBase (R) project.
+ * Copyright (c) 2020-2024 NocoBase Co., Ltd.
+ * Authors: NocoBase Team.
+ *
+ * This project is dual-licensed under AGPL-3.0 and NocoBase Commercial License.
+ * For more information, please refer to: https://www.nocobase.com/agreement.
+ */
+
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var filter_utils_exports = {};
+__export(filter_utils_exports, {
+  valuesToFilter: () => valuesToFilter
+});
+module.exports = __toCommonJS(filter_utils_exports);
+var import_lodash = __toESM(require("lodash"));
+var import_flat = require("flat");
+function valuesToFilter(values = {}, filterKeys) {
+  const removeArrayIndexInKey = /* @__PURE__ */ __name((key) => {
+    const chunks = key.split(".");
+    return chunks.filter((chunk) => {
+      return !chunk.match(/\d+/);
+    }).join(".");
+  }, "removeArrayIndexInKey");
+  const filterAnd = [];
+  const flattedValues = (0, import_flat.flatten)(values);
+  const flattedValuesObject = {};
+  for (const key in flattedValues) {
+    const keyWithoutArrayIndex = removeArrayIndexInKey(key);
+    if (flattedValuesObject[keyWithoutArrayIndex]) {
+      if (!Array.isArray(flattedValuesObject[keyWithoutArrayIndex])) {
+        flattedValuesObject[keyWithoutArrayIndex] = [flattedValuesObject[keyWithoutArrayIndex]];
+      }
+      flattedValuesObject[keyWithoutArrayIndex].push(flattedValues[key]);
+    } else {
+      flattedValuesObject[keyWithoutArrayIndex] = [flattedValues[key]];
+    }
+  }
+  for (const filterKey of filterKeys) {
+    const filterValue = flattedValuesObject[filterKey] ? flattedValuesObject[filterKey] : import_lodash.default.get(values, filterKey);
+    if (filterValue) {
+      filterAnd.push({
+        [filterKey]: filterValue
+      });
+    } else {
+      filterAnd.push({
+        [filterKey]: null
+      });
+    }
+  }
+  return {
+    $and: filterAnd
+  };
+}
+__name(valuesToFilter, "valuesToFilter");
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  valuesToFilter
+});

package/lib/utils.d.ts

@@ -13,3 +13,6 @@ export declare function getTableName(collectionName: string, options: any): any;
 export declare function snakeCase(name: string): any;
 export declare function patchSequelizeQueryInterface(db: Database): void;
 export declare function percent2float(value: string): number;
+export declare function isUndefinedOrNull(value: any): boolean;
+export declare function isStringOrNumber(value: any): boolean;
+export declare function getKeysByPrefix(keys: string[], prefix: string): string[];