@webiny/api-headless-cms


Install

``
npm install --save @webiny/api-headless-cms
`

Or if you prefer yarn:

`
yarn add @webiny/api-headless-cms
`

Testing

Due to possibility of multiple storage operations, the tests are completely decoupled from those storage operations.

The jest.setup.js is using @webiny/project-utils/testing/presets.js to find and load all the packages containing @webiny/api-headless-cms and storage-operations keywords in their package.json file.
Those packages are then used to build the test run - one for each of the packages. So depending on how many storage operations there are in the repository, that much of api-headless-cms tests will run.

$3


To make it possible for api-headless-cms tests to run with a storage operations package you MUST create presets.js file in storage-operations-package-path/__tests__/__api__/ directory. That file is loaded when setting up the api-headless-cms tests.

It MUST contain the testEnvironment variable which contains path to the environment definition file.

That environment file MUST define the test environment which extends NodeEnvironment class.

Test environment MUST expose __getStorageOperationsPlugins method, via this.global property of the class, which will load the required plugins in the api-headless-cms tests.




$3

The first implementation of the decoupled storage operations is DynamoDB/Elasticsearch, which you can find in @webiny/api-headless-cms-ddb-es.
Files which you can check to help you define your own presets and test environment are:
* presets.js - an array of presets of which last one defines the environment to be loaded
* environment.js - a class which extends NodeEnvironment and exposes __getStorageOperationsPlugins to the tests

$3


For the WebStorm (PhpStorm,...) when starting a test you must have some values defined in the run/debug configurations screen:
#### Node options
```
--inspect=9229
```
#### Working directory
```
PATH_TO_YOUR_PROJECT_ROOT
```
example:
``
~/webiny/webiny-js/
``
#### Jest options
For DynamoDB + Elasticsearch storage operations tests:
```
--keyword=cms:base --keyword=cms:ddb-es
```
For the DynamoDB storage operations tests:
```
--keyword=cms:base --keyword=cms:ddb
```
Note that base keyword is the cms:base. It tells Jest setup to load the api-headless-cms tests with the api-headless-cms-ddb-es tests.

#### Environment variables
If you want to use local Elasticsearch:
```
ELASTICSEARCH_PORT=9200;LOCAL_ELASTICSEARCH=true
````
Nothing if you do not want to use the local Elasticsearch.