@naturalcycles/db-lib 10.12.0 → 10.13.0

package/dist/commondao/common.dao.js

@@ -952,9 +952,9 @@ export class CommonDao {
         }
         const inputName = opt.table || this.cfg.table;
         const [error, convertedValue] = this.cfg.validateBM(input, {
-            // Passing `mutateInput` through allows to do opt-in mutation
-            // for individual operations, e.g `someDao.save(myObj, { mutateInput: true })`,
-            // while still keeping safe non-mutating behavior by default
+            // Passing `mutateInput` through allows to opt-out of mutation
+            // for individual operations, e.g `someDao.save(myObj, { mutateInput: false })`
+            // Default is undefined (the validation function decides whether to mutate or not).
             mutateInput: opt.mutateInput,
             inputName,
         });

package/dist/commondao/common.dao.model.d.ts

@@ -186,7 +186,11 @@ export interface CommonDaoOptions extends CommonDBOptions {
      */
     skipValidation?: boolean;
     /**
-     * Default to false.
+     * Defaults to undefined.
+     *
+     * Undefined means that it's up for the underlying validation library (implementation)
+     * to mutate or not.
+     * E.g joi and zod would deep-clone, while ajv would MUTATE.
      *
      * False ensures that the input is not mutated by the Validation function (`validateBM`).
      *

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@naturalcycles/db-lib",
   "type": "module",
-  "version": "10.12.0",
+  "version": "10.13.0",
   "dependencies": {
     "@naturalcycles/js-lib": "^15",
     "@naturalcycles/nodejs-lib": "^15"

package/src/commondao/common.dao.model.ts

@@ -227,7 +227,11 @@ export interface CommonDaoOptions extends CommonDBOptions {
   skipValidation?: boolean
 
   /**
-   * Default to false.
+   * Defaults to undefined.
+   *
+   * Undefined means that it's up for the underlying validation library (implementation)
+   * to mutate or not.
+   * E.g joi and zod would deep-clone, while ajv would MUTATE.
    *
    * False ensures that the input is not mutated by the Validation function (`validateBM`).
    *

package/src/commondao/common.dao.ts

@@ -1222,9 +1222,9 @@ export class CommonDao<BM extends BaseDBEntity, DBM extends BaseDBEntity = BM, I
     const inputName = opt.table || this.cfg.table
 
     const [error, convertedValue] = this.cfg.validateBM(input as BM, {
-      // Passing `mutateInput` through allows to do opt-in mutation
-      // for individual operations, e.g `someDao.save(myObj, { mutateInput: true })`,
-      // while still keeping safe non-mutating behavior by default
+      // Passing `mutateInput` through allows to opt-out of mutation
+      // for individual operations, e.g `someDao.save(myObj, { mutateInput: false })`
+      // Default is undefined (the validation function decides whether to mutate or not).
       mutateInput: opt.mutateInput,
       inputName,
     })