payload 0.17.2 → 0.17.3

package/docs/fields/overview.mdx

@@ -200,35 +200,6 @@ The `condition` function should return a boolean that will control if the field
 }
 ```
 
-If you are building custom components, and you'd like for your custom components to support conditional logic as well, you can utilize Payload's `withCondition` higher-order function by importing it and using it as follows:
-
-```js
-import { withCondition } from 'payload/components/forms';
-
-const CustomComponent = () => {
-  return (
-    <div>
-      <p>Hello, on my own, I won't respect my field's conditional logic.<p/>
-      <p>But, I will if I'm wrapped with the withCondition HOC as shown below!</p>
-    </div>
-  )
-}
-
-const CustomComponentWithCondition = withCondition(CustomComponent);
-
-const customFieldWithCondition = {
-  name: 'myCustomField',
-  type: 'text',
-  admin: {
-    condition: (data) => Boolean(data.enableCustomField),
-    components: {
-      Field: CustomComponentWithCondition,
-    }
-  }
-}
-
-```
-
 ### Default values
 
 Fields can be prefilled with starting values using the `defaultValue` property. This is used in the admin UI and also on the backend as API requests will be populated with missing or undefined field values. You can assign the defaultValue directly in the field configuration or supply a function for dynamic behavior. Values assigned during a create request on the server are added before validation occurs.
@@ -243,7 +214,7 @@ Here is an example of a defaultValue function that uses both:
 ```js
 const translation: {
     en: 'Written by',
-    es: 'escrito por',
+    es: 'Escrito por',
 };
 
 const field = {

package/docs/rest-api/overview.mdx

@@ -43,6 +43,8 @@ The `find` endpoint supports the following additional query parameters:
 
 ## Auth Operations
 
+Auth enabled collections are also given the following endpoints:
+
 | Method   | Path                        | Description |
 | -------- | --------------------------- | ----------- |
 | `POST`   | `/api/{collectionSlug}/verify/:token`   | [Email verification](/docs/authentication/operations#verify-by-email), if enabled. |
@@ -72,3 +74,47 @@ In addition to the dynamically generated endpoints above Payload also has REST e
 | `GET`    | `/api/_preferences/{key}` | Get a preference by key   |
 | `POST`   | `/api/_preferences/{key}` | Create or update by key   |
 | `DELETE` | `/api/_preferences/{key}` | Delete a user preference by key |
+
+## Custom Endpoints
+
+Additional REST API endpoints can be added to `collections` and `globals` by providing array of `endpoints` in the configuration. These can be used to write additional middleware on existing routes or build custom functionality into Payload apps and plugins.
+
+Each endpoint object needs to have:
+
+| Property   | Description                               |
+| ---------- | ----------------------------------------- |
+| **`path`**     | A string for the endpoint route after the collection or globals slug |
+| **`method`**   | The lowercase HTTP verb to use: 'get', 'head', 'post', 'put', 'delete', 'connect' or 'options' |
+| **`handler`**  | A function or array of functions to be called with **req**, **res** and **next** arguments. [Express](https://expressjs.com/en/guide/routing.html#route-handlers) |
+
+Example:
+
+```js
+
+// a collection of 'orders' with an additional route for tracking details, reachable at /api/orders/:id/tracking
+const Orders = {
+	slug: 'orders',
+	fields: [ /* ... */ ],
+  // highlight-start
+  endpoints: [
+    {
+      path: '/:id/tracking',
+      method: 'get',
+      handler: async (req, res, next) => {
+        const tracking = await getTrackingInfo(req.params.id);
+        if (tracking) {
+          res.status('200').send({ tracking });
+        } else {
+          res.status('404').send({ error: 'not found' });
+        }
+      }
+    }
+  ],
+  // highlight-end
+}
+```
+
+<Banner>
+  <strong>Note:</strong><br/>
+  **req** will have the **payload** object and can be used inside your endpoint handlers for making calls like req.payload.find() that will make use of access control and hooks.
+</Banner>

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "payload",
-  "version": "0.17.2",
+  "version": "0.17.3",
   "description": "Node, React and MongoDB Headless CMS and Application Framework",
-  "license": "SEE LICENSE IN license.md",
+  "license": "MIT",
   "author": {
     "email": "info@payloadcms.com",
     "name": "Payload CMS",