monastery 1.36.0 → 1.36.3

package/test/mock/blacklisting.js

@@ -0,0 +1,122 @@
+module.exports.bird = {
+  schema: function() {
+    return {
+      fields: {
+        color: { type: 'string', default: 'red' },
+        height: { type: 'number' },
+        name: { type: 'string' },
+        sub: {
+          color: { type: 'string', default: 'red' },
+        },
+        wing: {
+          size: { type: 'number' },
+          sizes: {
+            one: { type: 'number' },
+            two: { type: 'number' },
+          }
+        },
+      },
+      findBL: ['wing'],
+    }
+  },
+  mock: function() {
+    return {
+      height: 12,
+      name: 'Ponyo',
+      sub: {},
+      wing: { size: 1, sizes: { one: 1, two: 1 }},
+    }
+  },
+}
+
+module.exports.user = {
+  schema: function() {
+    return {
+      fields: {
+        bird: { model: 'bird' },
+        list: [{ type: 'number' }],
+        dog: { type: 'string' },
+        pet: { type: 'string' },
+        pets: [{
+          name: { type: 'string'},
+          age: { type: 'number'}
+        }],
+        animals: {
+          cat: { type: 'string' },
+          dog: { type: 'string' }
+        },
+        hiddenPets: [{
+          name: { type: 'string'}
+        }],
+        hiddenList: [{ type: 'number'}],
+        deep: {
+          deep2: {
+            deep3: {
+              deep4: { type: 'string' }
+            }
+          }
+        },
+        deeper: {
+          deeper2: {
+            deeper3: {
+              deeper4: { type: 'string' }
+            }
+          }
+        },
+        deepModel: {
+          myBird: { model: 'bird' }
+        },
+        hiddenDeepModel: {
+          myBird: { model: 'bird' }
+        },
+      },
+      findBL: [
+        'dog',
+        'animals.cat',
+        'pets.age',
+        'hiddenPets',
+        'hiddenList',
+        'deep.deep2.deep3',
+        'deeper',
+        'hiddenDeepModel',
+      ],
+    }
+  },
+  mock: function(bird1) {
+    return {
+      bird: bird1._id,
+      list: [44, 54],
+      dog: 'Bruce',
+      pet: 'Freddy',
+      pets: [{ name: 'Pluto', age: 5 }, { name: 'Milo', age: 4 }],
+      animals: {
+        cat: 'Ginger',
+        dog: 'Max'
+      },
+      hiddenPets: [{
+        name: 'secretPet'
+      }],
+      hiddenList: [12, 23],
+      deep: {
+        deep2: {
+          deep3: {
+            deep4: 'hideme'
+          }
+        }
+      },
+      deeper: {
+        deeper2: {
+          deeper3: {
+            deeper4: 'hideme'
+          }
+        }
+      },
+      deepModel: {
+        myBird: bird1._id
+      },
+      hiddenDeepModel: {
+        myBird: bird1._id
+      }
+    }
+  },
+}

package/test/test.js

@@ -12,6 +12,8 @@
  *   - expect.objectContaining:
  */
 
+global.oid = require('mongodb').ObjectID
+
 let monastery = require('../lib')
 let opendb = async function(uri, opts) {
   let db = monastery(

package/test/validate.js

@@ -808,8 +808,10 @@ module.exports = function(monastery, opendb) {
     })
   })
 
-  test('schema default rules', async () => {
+  test('schema options default', async () => {
     // Setup
+    // todo: test objects
+    // todo: change test name
     let db = (await opendb(false)).db
     let user = db.model('user', { fields: {
       name: { type: 'string', minLength: 7 },
@@ -889,7 +891,37 @@ module.exports = function(monastery, opendb) {
     await expect(user.validate({ amount: 'bad' })).rejects.toContainEqual(mock2)
   })
 
-  test('schema default objects', async () => {
+  test('schema options objects', async () => {
+    let db = (await opendb(null, {
+      timestamps: false,
+      nullObjects: true,
+      serverSelectionTimeoutMS: 2000
+    })).db
+    let user = db.model('user', {
+      fields: {
+        location: {
+          lat: { type: 'number' },
+          lng: { type: 'number' },
+          schema: { required: true },
+        },
+      },
+    })
+    let requiredError = [{
+      'detail': 'This field is required.',
+      'meta': {'detailLong': undefined, 'field': 'location', 'model': 'user', 'rule': 'required'},
+      'status': '400',
+      'title': 'location'
+    }]
+    // required errors
+    await expect(user.validate({ location: null })).rejects.toEqual(requiredError)
+    await expect(user.validate({ location: '' })).rejects.toEqual(requiredError)
+    await expect(user.validate({ location: undefined })).rejects.toEqual(requiredError)
+    // required no error
+    await expect(user.validate({ location: {} })).resolves.toEqual({ location: {} })
+    db.close()
+  })
+
+  test('validate defaultObjects', async () => {
     let db = (await opendb(null, {
       timestamps: false,
       defaultObjects: true,
@@ -915,7 +947,7 @@ module.exports = function(monastery, opendb) {
     db.close()
   })
 
-  test('schema nullObjects', async () => {
+  test('validate nullObjects', async () => {
     let db = (await opendb(null, {
       timestamps: false,
       nullObjects: true,

package/docs/schema/index.md

@@ -1,313 +0,0 @@
----
-title: Schema
-nav_order: 4
-has_children: true
----
-
-# Schema
-
-Model schema object.
-
-### Table of Contents
-
-- [Fields](#fields)
-- [Field blacklisting](#field-blacklisting)
-- [Field options](#field-options)
-- [MongoDB indexes](#mongodb-indexes)
-- [Custom validation rules](#custom-validation-rules)
-- [Custom error messages](#custom-error-messages)
-- [Operation hooks](#operation-hooks)
-- [Full example](#full-example)
-
-### Fields
-
-1. Fields may contain subdocuments, array of values, or an array of subdocuments
-2. Field values need to have the `type` rule defined
-3. Field values can contain [custom](#custom-validation-rules) and [default validation rules](./rules), e.g. `{ minLength: 2 }`
-4. Field values can contain [field options](#field-options).
-
-```js
-schema.fields = {
-  name: { // value
-    type: 'string',
-    required: true
-  },
-  address: { // subdocument
-    line1: { type: 'string', required: true },
-    city: { type: 'string', minLength: 2 }
-  },
-  names: [ // array of values
-    { type: 'string' }
-  ],
-  pets: [{ // array of subdocuments
-    name: { type: 'string' },
-    type: { type: 'string' }
-  }]
-}
-```
-
-These fields automatically get assigned and take presidence over any input data when [`manager.timestamps`](./manager) is true (default). You can override the `timestamps` value per operation, e.g. `db.user.update({ ..., timestamps: false})`. These fields use unix timestamps in seconds (by default), but can be configured to use use milliseconds via the manager [`useMilliseconds` ](./manager) option.
-
-```js
-schema.fields = {
-  createdAt: {
-    type: 'date',
-    insertOnly: true,
-    default: function() { return Math.floor(Date.now() / 1000) }
-  },
-  updatedAt: {
-    type: 'date',
-    default: function() { return Math.floor(Date.now() / 1000) }
-  }
-}
-```
-
-### Field blacklisting
-
-You are able to provide a list of fields to blacklist per model operation.
-
-```js
-// The 'password' field will be removed from the results returned from `model.find`
-schema.findBL = ['password']
-
-// The 'password' field will be removed before inserting via `model.insert`
-schema.insertBL = ['password']
-
-// The 'password' and 'createdAt' fields will be removed before updating via `model.update`
-schema.updateBL = ['createdAt', 'password']
-```
-
-You are also able to blacklist nested fields within subdocuments and arrays of subdocuments.
-
-```js
-// Subdocument example: `address.city` will be excluded from the response
-schema.findBL = ['address.city']
-
-// Array of subdocuments example: `meta` will be removed from each comment in the array
-schema.findBL = ['comments.meta']
-```
-
-### Field options
-
-Here are some other special field options that can be used alongside validation rules.
-
-```js
-let fieldName = {
-
-  // Enables population, you would save the foreign document _id on this field.
-  model: 'pet',
-
-  // Field will only be allowed to be set on insert when calling model.insert
-  insertOnly: true,
-
-  // Default will always override any passed value (it has some use-cases)
-  defaultOverride: true,
-
-  // Default value
-  default: 12,
-
-  // Default value can be returned from a function. `this` refers to the data object, but be
-  // sure to pass any referenced default fields along with insert/update/validate, e.g. `this.age`
-  default: function(fieldName, model) { return `I'm ${this.age} years old` },
-
-  // Monastery will automatically create a mongodb index for this field, see "MongoDB indexes"
-  // below for more information
-  index: true|1|-1|'text'|'unique'|Object,
-
-  // The field  won't stored, handy for fields that get populated with documents, see ./find for more details
-  virtual: true
-}
-```
-
-### MongoDB indexes
-
-You are able to automatically setup MongoDB indexes via the `index` field option.
-
-```js
-let fieldName = {
-  // This will create an ascending / descending index for this field
-  index: true|1|-1,
-
-  // This will create an ascending unique index which translates:
-  // { key: { [fieldName]: 1 }, unique: true }
-  index: 'unique',
-
-  // Text indexes are handled a little differently in which all the fields on the model
-  // schema that have a `index: 'text` set are collated into one index, e.g.
-  // { key: { [fieldName1]: 'text', [fieldName2]: 'text', .. }}
-  index: 'text'
-
-  // You can also pass an object if you need to use mongodb's index options
-  // https://docs.mongodb.com/manual/reference/command/createIndexes/
-  // https://mongodb.github.io/node-mongodb-native/2.1/api/Collection.html#createIndexes
-  index: { type: 1, ...(any mongodb index option) },
-}
-```
-
-And here's how you would use a 2dsphere index, e.g.
-
-```js
-schema.fields = {
-  name: {
-    type: 'string',
-    required: true
-  },
-  location: {
-    index: '2dsphere',
-    type: { type: 'string', default: 'Point' },
-    coordinates: [{ type: 'number' }] // lng, lat
-  }
-}
-
-// Inserting a 2dsphere point
-await db.user.insert({
-  data: {
-    location: { coordinates: [170.2628528648167, -43.59467883784971] }
-  }
-}
-```
-
-Since unique indexes by default don't allow mutliple documents with `null`, you use a partial index (less performant), e.g.
-
-```js
-
-schema.fields = {
-index: {
-  name: {
-    type: 'string',
-    index: {
-      type: 'unique',
-      partialFilterExpression: {
-        email: { $type: 'string' }
-      }
-    }
-  }
-}
-```
-
-### Custom validation rules
-
-You are able to define custom validation rules to use. (`this` will refer to the data object passed in)
-
-```js
-schema.rules = {
-  // Basic definition
-  isGrandMaster: function(value, ruleArgument, path, model) {
-    return (value == 'Martin Luther')? true : false
-  },
-  // Full definition
-  isGrandMaster: {
-    message: (value, ruleArgument, path, model) => 'Only grand masters are permitted'
-    fn: function(value, ruleArgument, path, model) {
-      return (value == 'Martin Luther' || this.age > 100)? true : false
-    }
-  }
-}
-
-// And referencing is the same as any other builtin rule
-schema.fields = {
-  user: {
-    name: {
-      type: 'string'
-      isGrandMaster: true // true is the ruleArgument
-    }
-  }
-}
-
-// Additionally, you can define custom messages here
-schema.messages = {
-  'user.name': {
-    isGrandMaster: 'Only grand masters are permitted'
-  }
-}
-```
-
-### Custom error messages
-
-You are able to define custom error messages for each validation rule.
-
-```js
-schema.messages = {
-  'name': {
-    required: 'Sorry, even a monk cannot be nameless'
-    type: 'Sorry, your name needs to be a string'
-  },
-  'address.city': {
-    minLength: (value, ruleArgument, path, model) => {
-      return `Is your city of residence really only ${ruleArgument} characters long?`
-    }
-  },
-  // You can assign custom error messages for all subdocument fields in an array
-  // e.g. pets = [{ name: { type: 'string' }}]
-  'pets.name': {
-    required: `Your pet's name needs to be a string.`
-  }
-  // To target a specific array item
-  'pets.0.name': {
-    required: `You first pet needs a name`
-  }
-  // You can also target any rules set on the array or sub arrays
-  // e.g.
-  // // let arrayWithSchema = (array, schema) => { array.schema = schema; return array }, OR you can use db.arrayWithSchema
-  // petGroups = db.arrayWithSchema(
-  //   [db.arrayWithSchema(
-  //     [{ name: { type: 'string' }}],
-  //     { minLength: 1 }
-  //   )],
-  //   { minLength: 1 }
-  // )
-  'petGroups': {
-    minLength: `Please add at least one pet pet group.`
-  }
-  'petGroups.$': {
-    minLength: `Please add at least one pet into your pet group.`
-  }
-}
-```
-
-### Operation hooks
-
-You are able provide an array of callbacks to these model operation hooks. If you need to throw an error asynchronously, please pass an error as the first argument to `next()`, e.g. `next(new Error('Your error here'))`. You can also access the operation details via `this` in each callback.
-
-```js
-schema.afterFind = [function(data, next) {}]
-schema.afterInsert = [function(data, next) {}]
-schema.afterInsertUpdate = [function(data, next) {}]
-schema.afterUpdate = [function(data, next) {}]
-schema.afterRemove = [function(next) {}]
-schema.beforeInsert = [function(data, next) {}]
-schema.beforeInsertUpdate = [function(data, next) {}]
-schema.beforeUpdate = [function(data, next) {}]
-schema.beforeRemove = [function(next) {}]
-schema.beforeValidate = [function(data, next) {}]
-```
-
-### Full example
-
-```js
-let schema = {
-  fields: {
-    email: { type: 'email', required: true, index: 'unique' },
-    firstName: { type: 'string', required: true },
-    lastName: { type: 'string' }
-  },
-
-  messages: {
-    email: { required: 'Please enter an email.' }
-  },
-
-  updateBL: ['email'],
-
-  beforeValidate: [function (data, next) {
-    if (data.firstName) data.firstName = util.ucFirst(data.firstName)
-    if (data.lastName) data.lastName = util.ucFirst(data.lastName)
-    next()
-  }],
-
-  afterFind: [function(data) {// Synchronous
-    data = data || {}
-    data.name = data.firstName + ' ' + data.lastName
-  }]
-}
-
-```