payload 0.15.3 → 0.15.6

package/dist/webpack/init.d.ts

@@ -1,4 +1,4 @@
-import { Router } from 'express';
-import { SanitizedConfig } from '../config/types';
-declare function initWebpack(config: SanitizedConfig): Router;
-export default initWebpack;
+import { Router } from 'express';
+import { SanitizedConfig } from '../config/types';
+declare function initWebpack(config: SanitizedConfig): Router;
+export default initWebpack;

package/dist/webpack/init.js

@@ -1,22 +1,22 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-const webpack_1 = __importDefault(require("webpack"));
-const express_1 = __importDefault(require("express"));
-const webpack_dev_middleware_1 = __importDefault(require("webpack-dev-middleware"));
-const webpack_hot_middleware_1 = __importDefault(require("webpack-hot-middleware"));
-const getDevConfig_1 = __importDefault(require("./getDevConfig"));
-const router = express_1.default.Router();
-function initWebpack(config) {
-    const webpackDevConfig = (0, getDevConfig_1.default)(config);
-    const compiler = (0, webpack_1.default)(webpackDevConfig);
-    router.use((0, webpack_dev_middleware_1.default)(compiler, {
-        publicPath: webpackDevConfig.output.publicPath,
-    }));
-    router.use((0, webpack_hot_middleware_1.default)(compiler));
-    return router;
-}
-exports.default = initWebpack;
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const webpack_1 = __importDefault(require("webpack"));
+const express_1 = __importDefault(require("express"));
+const webpack_dev_middleware_1 = __importDefault(require("webpack-dev-middleware"));
+const webpack_hot_middleware_1 = __importDefault(require("webpack-hot-middleware"));
+const getDevConfig_1 = __importDefault(require("./getDevConfig"));
+const router = express_1.default.Router();
+function initWebpack(config) {
+    const webpackDevConfig = (0, getDevConfig_1.default)(config);
+    const compiler = (0, webpack_1.default)(webpackDevConfig);
+    router.use((0, webpack_dev_middleware_1.default)(compiler, {
+        publicPath: webpackDevConfig.output.publicPath,
+    }));
+    router.use((0, webpack_hot_middleware_1.default)(compiler));
+    return router;
+}
+exports.default = initWebpack;
 //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5pdC5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy93ZWJwYWNrL2luaXQudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6Ijs7Ozs7QUFBQSxzREFBOEI7QUFDOUIsc0RBQTBDO0FBQzFDLG9GQUEwRDtBQUMxRCxvRkFBMEQ7QUFDMUQsa0VBQWlEO0FBR2pELE1BQU0sTUFBTSxHQUFHLGlCQUFPLENBQUMsTUFBTSxFQUFFLENBQUM7QUFFaEMsU0FBUyxXQUFXLENBQUMsTUFBdUI7SUFDMUMsTUFBTSxnQkFBZ0IsR0FBRyxJQUFBLHNCQUFtQixFQUFDLE1BQU0sQ0FBQyxDQUFDO0lBQ3JELE1BQU0sUUFBUSxHQUFHLElBQUEsaUJBQU8sRUFBQyxnQkFBZ0IsQ0FBQyxDQUFDO0lBRTNDLE1BQU0sQ0FBQyxHQUFHLENBQUMsSUFBQSxnQ0FBb0IsRUFBQyxRQUFRLEVBQUU7UUFDeEMsVUFBVSxFQUFFLGdCQUFnQixDQUFDLE1BQU0sQ0FBQyxVQUFvQjtLQUN6RCxDQUFDLENBQUMsQ0FBQztJQUVKLE1BQU0sQ0FBQyxHQUFHLENBQUMsSUFBQSxnQ0FBb0IsRUFBQyxRQUFRLENBQUMsQ0FBQyxDQUFDO0lBRTNDLE9BQU8sTUFBTSxDQUFDO0FBQ2hCLENBQUM7QUFFRCxrQkFBZSxXQUFXLENBQUMifQ==

package/dist/webpack/mocks/dotENV.d.ts

@@ -1,4 +1,4 @@
-declare namespace _default {
-    function config(): any;
-}
-export default _default;
+declare namespace _default {
+    function config(): any;
+}
+export default _default;

package/dist/webpack/mocks/dotENV.js

@@ -1,6 +1,6 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.default = {
-    config: () => null,
-};
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = {
+    config: () => null,
+};
 //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZG90RU5WLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vc3JjL3dlYnBhY2svbW9ja3MvZG90RU5WLmpzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7O0FBQUEsa0JBQWU7SUFDYixNQUFNLEVBQUUsR0FBRyxFQUFFLENBQUMsSUFBSTtDQUNuQixDQUFDIn0=

package/dist/webpack/mocks/emptyModule.d.ts

@@ -1,2 +1,2 @@
-declare function _default(): void;
-export default _default;
+declare function _default(): void;
+export default _default;

package/dist/webpack/mocks/emptyModule.js

@@ -1,4 +1,4 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.default = () => { };
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = () => { };
 //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZW1wdHlNb2R1bGUuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi9zcmMvd2VicGFjay9tb2Nrcy9lbXB0eU1vZHVsZS5qcyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiOztBQUFBLGtCQUFlLEdBQUcsRUFBRSxHQUFFLENBQUMsQ0FBQyJ9

package/dist/webpack/mocks/fileMock.d.ts

@@ -1,2 +1,2 @@
-declare var _default: "file-stub";
-export default _default;
+declare var _default: "file-stub";
+export default _default;

package/dist/webpack/mocks/fileMock.js

@@ -1,4 +1,4 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.default = 'file-stub';
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = 'file-stub';
 //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZmlsZU1vY2suanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi9zcmMvd2VicGFjay9tb2Nrcy9maWxlTW9jay5qcyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiOztBQUFBLGtCQUFlLFdBQVcsQ0FBQyJ9

package/docs/fields/overview.mdx

@@ -62,7 +62,19 @@ In addition to being able to define access control on a document-level, you can
 
 ### Validation
 
-You can provide your own validation function for all field types. It will be used on both the frontend and the backend, so it should not rely on any Node-specific packages. The validation function can be either synchronous or asynchronous and accepts the field's value and expects to return either `true` or a string error message to display in both API responses and within the Admin panel.
+Field validation is enforced automatically based on the field type and other properties such as `required` or `min` and `max` value constraints on certain field types. This default behavior can be replaced by providing your own validate function for any field. It will be used on both the frontend and the backend, so it should not rely on any Node-specific packages. The validation function can be either synchronous or asynchronous and expects to return either `true` or a string error message to display in both API responses and within the Admin panel.
+
+There are two arguments available to custom validation functions.
+1. The value which is currently assigned to the field
+2. An optional object with dynamic properties for more complex validation having the following:
+
+| Property      | Description  |
+| ------------- | -------------|
+| `data`             | An object of the full collection or global document |
+| `siblingData`      | An object of the document data limited to fields within the same parent to the field |
+| `operation`        | Will be "create" or "update" depending on the UI action or API call |
+| `id`               | The value of the collection `id`, will be `undefined` on create request |
+| `user`             | The currently authenticated user object |
 
 Example:
 ```js
@@ -72,7 +84,11 @@ Example:
     {
       name: 'customerNumber',
       type: 'text',
-      validate: async (val) => {
+      validate: async (val, { operation }) => {
+        if (operation !== 'create') {
+          // skip validation on update
+          return true;
+        }
         const response = await fetch(`https://your-api.com/customers/${val}`);
         if (response.ok) {
           return true;
@@ -85,6 +101,26 @@ Example:
 }
 ```
 
+When supplying a field `validate` function, Payload will use yours in place of the default. To make use of the default field validation in your custom logic you can import, call and return the result as needed.
+
+For example:
+```js
+import { text } from 'payload/fields/validations';
+const field =
+  {
+    name: 'notBad',
+    type: 'text',
+    validate: (val, args) => {
+      if (value === 'bad') {
+        return 'This cannot be "bad"';
+      }
+      // highlight-start
+      return text(val, args);
+      // highlight-end
+    },
+}
+```
+
 ### Customizable ID
 
 Collections ID fields are generated automatically by default. An explicit `id` field can be declared in the `fields` array to override this behavior.
@@ -198,7 +234,7 @@ A description can be configured three ways.
 - As a function that accepts an object containing the field's value, which returns a string
 - As a React component that accepts value as a prop
 
-As shown above, you can simply provide a string that will show by the field, but there are use cases where you may want to create some dynamic feedback. By using a function or a component for the `description` property you can provide rich feedback in realtime the user interacts with the form.
+As shown above, you can simply provide a string that will show by the field, but there are use cases where you may want to create some dynamic feedback. By using a function or a component for the `description` property you can provide realtime feedback as the user interacts with the form.
 
 **Function Example:**
 

package/docs/fields/relationship.mdx

@@ -22,6 +22,7 @@ keywords: relationship, fields, config, configuration, documentation, Content Ma
 | ---------------- | ----------- |
 | **`name`** *         | To be used as the property name when stored and retrieved from the database.  |
 | **`relationTo`** *   | Provide one or many collection `slug`s to be able to assign relationships to. |
+| **`filterOptions`**  | A query to filter which options appear in the UI and validate against. [More](#filtering-relationship-options). |
 | **`hasMany`**        | Boolean when, if set to `true`, allows this field to have many relations instead of only one. |
 | **`maxDepth`**       | Sets a number limit on iterations of related documents to populate when queried. [Depth](/docs/getting-started/concepts#depth) |
 | **`label`**          | Used as a field label in the Admin panel and to name the generated GraphQL type. |
@@ -44,6 +45,50 @@ keywords: relationship, fields, config, configuration, documentation, Content Ma
   The <a href="/docs/getting-started/concepts#depth">Depth</a> parameter can be used to automatically populate related documents that are returned by the API.
 </Banner>
 
+### Filtering relationship options
+
+Options can be dynamically limited by supplying a [query constraint](/docs/queries/overview), which will be used both for validating input and filtering available relationships in the UI.
+
+The `filterOptions` property can either be a `Where` query directly, or a function that returns one. When using a function, it will be called with an argument object with the following properties:
+
+| Property      | Description  |
+| ------------- | -------------|
+| `relationTo`       | The `relationTo` to filter against (as defined on the field) |
+| `data`             | An object of the full collection or global document currently being edited |
+| `siblingData`      | An object of the document data limited to fields within the same parent to the field |
+| `id`               | The value of the collection `id`, will be `undefined` on create request |
+| `user`             | The currently authenticated user object |
+
+**Example:**
+
+```js
+  const relationshipField = {
+    name: 'purchase',
+    type: 'relationship',
+    relationTo: ['products', 'services'],
+    filterOptions: ({ relationTo, siblingData }) => {
+      // returns a Where query dynamically by the type of relationship
+      if (relationTo === 'products') {
+        return {
+          'stock': { is_greater_than: siblingData.quantity }
+        }
+      }
+
+      if (relationTo === 'services') {
+        return {
+          'isAvailable': { equals: true }
+        }
+      }
+    },
+  };
+```
+
+You can learn more about writing queries [here](/docs/queries/overview).
+
+<Banner type="warning">
+  When a relationship field has both <strong>filterOptions</strong> and a custom <strong>validate</strong> function, the server-side validation will not enforce <strong>filterOptions</strong>unless you call the default relationship field validation function imported from <strong>payload/fields/validations</strong> within your custom function.
+</Banner>
+
 ### How the data is saved
 
 Given the variety of options possible within the `relationship` field type, the shape of the data needed for creating and updating these fields can vary. The following sections will describe the variety of data shapes that can arise from this field.

package/docs/fields/upload.mdx

@@ -27,6 +27,7 @@ keywords: upload, images media, fields, config, configuration, documentation, Co
 | ---------------- | ----------- |
 | **`name`** *         | To be used as the property name when stored and retrieved from the database.  |
 | **`*relationTo`** *  | Provide a single collection `slug` to allow this field to accept a relation to. <strong>Note: the related collection must be configured to support Uploads.</strong> |
+| **`filterOptions`**  | A query to filter which options appear in the UI and validate against. [More](#filtering-relationship-options). |
 | **`maxDepth`**       | Sets a number limit on iterations of related documents to populate when queried. [Depth](/docs/getting-started/concepts#depth) |
 | **`label`**          | Used as a field label in the Admin panel and to name the generated GraphQL type. |
 | **`unique`**         | Enforce that each entry in the Collection has a unique value for this field. |

package/docs/getting-started/installation.mdx

@@ -88,15 +88,19 @@ app.listen(3000, async () => {
 
 ```
 
-As you can see above, the required arguments to the `init` function are as follows:
+Here is a list of all properties available to pass through `payload.init`:
+
+##### `express`
+
+**Required**. This is your Express app as shown above. Payload will tie into your existing `app` and scope all of its functionalities to sub-routers. By default, Payload will add an `/admin` router and an `/api` router, but you can customize these paths.
 
 ##### `secret`
 
-This is a secure string that will be used to authenticate with Payload. It can be random but should be at least 14 characters and be very difficult to guess. Often, it's smart to store this value in an `env` and set different values for each of your environments (local, stage, prod, etc). The `dotenv` package is very handy and works well alongside of Payload.
+**Required**. This is a secure string that will be used to authenticate with Payload. It can be random but should be at least 14 characters and be very difficult to guess. Often, it's smart to store this value in an `env` and set different values for each of your environments (local, stage, prod, etc). The `dotenv` package is very handy and works well alongside of Payload.
 
 ##### `mongoURL`
 
-This is a fully qualified MongoDB connection string that points to your Mongo database. If you don't have Mongo installed locally, you can [follow these steps for Mac OSX](https://docs.mongodb.com/manual/tutorial/install-mongodb-on-os-x/) and [these steps](https://docs.mongodb.com/manual/tutorial/install-mongodb-on-windows/) for Windows 10. If you want to use a local database and you know you have MongoDB installed locally, a typical connection string will look like this:
+**Required**. This is a fully qualified MongoDB connection string that points to your Mongo database. If you don't have Mongo installed locally, you can [follow these steps for Mac OSX](https://docs.mongodb.com/manual/tutorial/install-mongodb-on-os-x/) and [these steps](https://docs.mongodb.com/manual/tutorial/install-mongodb-on-windows/) for Windows 10. If you want to use a local database and you know you have MongoDB installed locally, a typical connection string will look like this:
 
 `mongodb://localhost/payload`
 
@@ -104,11 +108,7 @@ In contrast to running Mongo locally, a popular option is to sign up for a free
 
 ##### `mongoOptions`
 
-An optional object to customize connection options. Payload will connect to your MongoDB database using default options which you can override and extend to include all the [options](https://mongoosejs.com/docs/connections.html#options) available to mongoose.
-
-##### `express`
-
-This is your Express app as shown above. Payload will tie into your existing `app` and scope all of its functionalities to sub-routers. By default, Payload will add an `/admin` router and an `/api` router, but you can customize these paths.
+Customize Mongo connection options. Payload will connect to your MongoDB database using default options which you can override and extend to include all the [options](https://mongoosejs.com/docs/connections.html#options) available to mongoose.
 
 ##### `license`
 
@@ -116,15 +116,19 @@ Your Payload license key. Not needed for development purposes, but when it's tim
 
 ##### `email`
 
-An Optional object used to configure SMTP. [Read more](/docs/email/overview).
+An object used to configure SMTP. [Read more](/docs/email/overview).
 
 ##### `local`
 
 A boolean that when set to `true` tells Payload to start in local-only mode which will bypass setting up API routes. When set to `true`, `express` is not required. This is useful when running scripts that need to use Payload's [local-api](/docs/local-api/overview).
 
+##### `loggerOptions`
+
+Specify options for the built-in Pino logger that Payload uses for internal logging. See [Pino Docs](https://getpino.io/#/docs/api?id=options) for more info on what is available.
+
 ##### `onInit`
 
-An optional function that is called immediately following startup that receives the Payload instance as it's only argument.
+A function that is called immediately following startup that receives the Payload instance as it's only argument.
 
 ### Test it out
 

package/docs/queries/overview.mdx

@@ -59,7 +59,8 @@ The above example demonstrates a simple query but you can get much more complex.
 | `greater_than_equal` | For numeric or date-based fields. |
 | `less_than`          | For numeric or date-based fields. |
 | `less_than_equal`    | For numeric or date-based fields. |
-| `like`               | The value must partially match. |
+| `like`               | Case-insensitive string must be present. If string of words, all words must be present, in any order. |
+| `contains`           | Must contain the value entered, case-insensitive. |
 | `in`                 | The value must be found within the provided comma-delimited list of values. |
 | `not_in`             | The value must NOT be within the provided comma-delimited list of values. |
 | `exists`             | Only return documents where the value either exists (`true`) or does not exist (`false`). |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "payload",
-  "version": "0.15.3",
+  "version": "0.15.6",
   "description": "Node, React and MongoDB Headless CMS and Application Framework",
   "license": "SEE LICENSE IN license.md",
   "author": {