Merge branch 'Larinel-master'

Author: kamilmysliwiec

content/graphql/cli-plugin.md

@@ -144,3 +144,47 @@ getCustomTransformers: (program: any) => ({
   before: [require('@nestjs/graphql/plugin').before({}, program)]
 }),
 ```
+
+#### Integration with `ts-jest` (e2e tests)
+
+When running e2e tests with this plugin enabled, you may run into issues with compiling schema. For example, one of the most common errors is:
+
+```json
+Object type <name> must define one or more fields.
+```
+
+This happens because `jest` configuration does not import `@nestjs/graphql/plugin` plugin anywhere.
+
+To fix this, create the following file in your e2e tests directory:
+
+```javascript
+const transformer = require('@nestjs/graphql/plugin');
+
+module.exports.name = 'nestjs-graphql-transformer';
+// you should change the version number anytime you change the configuration below - otherwise, jest will not detect changes
+module.exports.version = 1;
+
+module.exports.factory = (cs) => {
+  return transformer.before(
+    {
+      // @nestjs/graphql/plugin options (can be empty)
+    },
+    cs.tsCompiler.program,
+  );
+};
+```
+
+With this in place, import AST transformer within your `jest` configuration file. By default (in the starter application), e2e tests configuration file is located under the `test` folder and is named `jest-e2e.json`.
+
+```json
+{
+  ... // other configuration
+  "globals": {
+    "ts-jest": {
+      "astTransformers": {
+        "before": ["<path to the file created above>"],
+      }
+    }
+  }
+}
+```

content/openapi/cli-plugin.md

@@ -159,3 +159,41 @@ getCustomTransformers: (program: any) => ({
   before: [require('@nestjs/swagger/plugin').before({}, program)]
 }),
 ```
+
+#### Integration with `ts-jest` (e2e tests)
+
+To run e2e tests, `ts-jest` compiles your source code files on the fly, in memory. This means, it doesn't use Nest CLI compiler and does not apply any plugins or perform AST transformations.
+
+To enable the plugin, create the following file in your e2e tests directory:
+
+```javascript
+const transformer = require('@nestjs/swagger/plugin');
+
+module.exports.name = 'nestjs-swagger-transformer';
+// you should change the version number anytime you change the configuration below - otherwise, jest will not detect changes
+module.exports.version = 1;
+
+module.exports.factory = (cs) => {
+  return transformer.before(
+    {
+      // @nestjs/swagger/plugin options (can be empty)
+    },
+    cs.tsCompiler.program,
+  );
+};
+```
+
+With this in place, import AST transformer within your `jest` configuration file. By default (in the starter application), e2e tests configuration file is located under the `test` folder and is named `jest-e2e.json`.
+
+```json
+{
+  ... // other configuration
+  "globals": {
+    "ts-jest": {
+      "astTransformers": {
+        "before": ["<path to the file created above>"],
+      }
+    }
+  }
+}
+```