directus-extension-api-docs 1.9.8 → 2.0.0

package/README.md

@@ -7,6 +7,8 @@ Directus Extension to include
     -- custom endpoint definitions included
 -   validation middleware on your custom endpoints (based on your openapi)
 
+> Compatible with latest versions of Directus and monorepo installation with packaged extension.
+
 ![workspace](assets/swagger.png)
 
 All directus endpoints are autogenerated on runtime.
@@ -30,7 +32,7 @@ Ref: https://github.com/directus/directus
 
 To include you custom endpoints in your documentation.
 
-Create a `oasconfig.yaml` file under `/extensions/endpoints` folder.
+Create a `oasconfig.yaml` file under `/extensions` folder.
 
 Options:
 
@@ -71,7 +73,7 @@ components:
 
 ## Definitions (optional)
 
-For each custom endpoints group, you can define api's including a file `oas.yaml` in root path of your group folder.
+For each endpoint extension, you can define api's including a file `oas.yaml` in root path of your extension endpoint folder.
 
 Properties:
 
@@ -79,7 +81,7 @@ Properties:
 -   `paths` _optional_ openapi custom paths
 -   `components` _optional_ openapi custom components
 
-Exemple below (`./extensions/endpoints/my-custom-path/oas.yaml`) :
+Exemple below (`./extensions/my-endpoint-extensions/oas.yaml`) :
 
 ```
 tags:
@@ -120,31 +122,44 @@ components:
       type: object # ref to standard components declaring it empty
 ```
 
+### Legacy mode
+
+Configuration and definitions can also be managed in this structure:
+
+```
+- ./extensions/
+  - endpoints/
+    - oasconfig.yaml
+    - my-endpoint-extensions/
+      - oas.yaml
+    - my-endpoint-extensions2/
+      - oas.yaml
+```
+
 ## Validations (optional)
 
 You can enable a request validations middleware based on your custom definitions.
 
-Call `validate` function inside your custom endpoint registration.
+Call `validate` function inside your custom endpoint source (`./extensions/my-endpoint-extensions/src/index.js`).
 
 Pass your `router`, `services`, `schema` and a list (_optional_) of endpoints you want to validate.
 
 Example below:
 
 ```
-const { validate } = require('directus-extension-api-docs');
-
-const id = 'my-custom-path';
+const { validate } = require('directus-extension-api-docs')
 
-module.exports = {
-    id,
-    handler: async function registerEndpoint(router, { services, getSchema }) {
+const id = 'my-custom-path'
 
+export default {
+    id: 'info',
+    handler: async (router, { services, getSchema }) => {
         const schema = await getSchema();
         await validate(router, services, schema); // Enable validator
 
         router.post('/my-endpoint', async (req, res, next) => {
             ...
-        });
+        })
     },
-};
+}
 ```