Merge pull request #3 from klerick/3.x.x-json-api

feat(json-api-nestjs): new-version 3.x.x

Author: klerick

README.md

@@ -18,7 +18,7 @@
 ## Description
 
 <p>
-This is the plugin that works upon TypeOrm library as a main database abstraction layer tool. Module automaticly generates API according to JSON API specificaton from the database structure (TypeORM entities). It support such features as requests validation based on database fields types, request filtering, endpoints exdending, data relations control and much more. Our module significantly reduces the development time of REST services by removing the need to negotiate the mechanism of client-server interaction and implementing automatic API generation without the need to write any code.
+This plugin works upon TypeOrm library, which is used as the main database abstraction layer tool. The module automatically generates an API according to JSON API specification from the database structure (TypeORM entities). It supports features such as requests validation based on database fields types, request filtering, endpoints extending, data relations control and much more. Our module significantly reduces the development time of REST services by removing the need to negotiate the mechanism of client-server interaction and implementing automatic API generation without the need to write any code.
 </p>
 
 ## Installation

libs/json-api-nestjs/README.md

@@ -1,11 +1,99 @@
+
 # json-api-nestjs
 
-This library was generated with [Nx](https://nx.dev).
+## Installation
+
+```bash  
+$ npm install json-api-nestjs
+```  
+
+## Example
+
+Once the installation process is complete, we can import the **JsonApiModule** into the root **AppModule**.
+
+```typescript
+import { Module } from '@nestjs/common';
+import { JsonApiModule } from 'json-api-nestjs';
+import { Users } from 'database';
+
+@Module({
+  imports: [
+    JsonApiModule.forRoot({  
+	  entities: [Users]
+	}),
+  ],
+})
+export class AppModule {}
+```
+After this, you have prepare crude with ready to use end point:
+
+
+- GET /users
+- POST /users
+- GET /users/:id
+- PATCH /users/:id
+- DELETE /users/:id
+- GET /users/{id}/relationships/{relName}
+- POST /users/{id}/relationships/{relName}
+- PATCH /users/{id}/relationships/{relName}
+- DELETE /users/{id}/relationships/{relName}
+
+## Configuration params
+
+The following interface is using for the configuration:
+```typescript
+export interface ModuleOptions {  
+    entities: Entity[]; // List of typeOrm Entity
+    controllers?: NestController[];  // List of controller, if you need extend default present
+    connectionName?: string; // Type orm connection name: "default" is default name  
+    providers?: NestProvider[]; // List of addition provider for useing in custom controller
+    options?: {  
+	  requiredSelectField?: boolean; // Need list of select field in get endpoint, try is default
+	  debug?: boolean; // Debug info in result object
+	};  
+}
+```
+You can extend default controller:
+```typescript
+import { Get, Param, Inject, BadRequestException } from '@nestjs/common';  
+  
+import { Users } from 'database';  
+import {  
+  JsonApi,  
+  excludeMethod,  
+  JsonBaseController,  
+  InjectService,  
+  JsonApiService,  
+  QueryParams,  
+} from 'json-api-nestjs';  
+import { ExampleService } from '../../service/example/example.service';  
+  
+@JsonApi(Users, {  
+  allowMethod: excludeMethod(['deleteRelationship']),  
+  requiredSelectField: true,  
+})  
+export class ExtendUserController extends JsonBaseController<Users> {  
+  @InjectService() public service: JsonApiService<Users>;  
+  @Inject(ExampleService) protected exampleService: ExampleService;  
+  
+  public override getAll(query: QueryParams<Users>) { 
+	if (!this.exampleService.someCheck(query)) {
+		throw new BadRequestException({});
+	}
+    return this.service.getAll({ query });  
+  }  
+  
+  @Get(':id/example')  
+  testOne(@Param('id') id: string): string {  
+    return this.exampleService.testMethode(id);  
+  }  
+}
+```
 
-## Building
+## Swagger UI
 
-Run `nx build json-api-nestjs` to build the library.
+For using swagger, you should only add [@nestjs/swagger](https://docs.nestjs.com/openapi/introduction)
 
-## Running unit tests
+## Reference Example
 
-Run `nx test json-api-nestjs` to execute the unit tests via [Jest](https://jestjs.io).
+[example](https://github.com/klerick/nestjs-json-api/tree/master/apps/example) is an example project that demonstrates the usage of this module.

tools/utils/merge-codecoverage/index.js

@@ -0,0 +1,99 @@
+const glob = require('glob')
+const path = require('path')
+const fs = require('fs-extra')
+const {execSync} = require('child_process')
+const { createReporter } = require('istanbul-api');
+const istanbulCoverage = require('istanbul-lib-coverage');
+
+const coverageDir = path.resolve(process.cwd(), 'coverage')
+const mergedDir = path.resolve(coverageDir, 'merged')
+
+fs.emptyDirSync(mergedDir)
+const files = glob(coverageDir + '/**/*.xml', {sync: true})
+const exludeFromName = ['apps', 'libs']
+
+files.forEach((f, i) => {
+  const x = f.split('/coverage/')[1].replace(/\//g, '-').split('/').pop()
+    .split('-').filter(i => i !== 'apps' && i !== 'libs' && i !== 'cobertura').join('-')
+  fs.copySync(f, `${mergedDir}/${x}`)
+})
+
+const filesMerged = glob(mergedDir + '/**/*.xml', {sync: true})
+
+const packages = filesMerged
+  .map((f, i) => {
+    const fileName = path.basename(f)
+    const projectName = fileName.split('-')
+    projectName.pop()
+
+    return `${projectName.join('-')}=${fileName}`
+  })
+  .join(' ')
+
+
+
+const script = `npx cobertura-merge -o merged-cobertura-coverage.xml ${packages}`
+
+execSync(script, {
+  stdio: [0, 1, 2],
+  cwd: mergedDir,
+})
+
+
+const reporter = createReporter();
+
+/* [ Configuration ] */
+const rootDir = './coverage';
+const reportOut = './coverage/report';
+
+const normalizeJestCoverage = ( obj ) => {
+  const result = { ...obj };
+
+  Object
+    .entries( result )
+    .filter( ([k, v] ) => v.data )
+    .forEach( ([k, v] ) => {
+      result[k] = v.data;
+    });
+
+  return result;
+};
+
+const mergeAllReports = ( coverageMap, reports ) => {
+  if ( Array.isArray( reports ) === false ) {
+    return;
+  }
+
+  reports.forEach( reportFile => {
+    const coverageReport = fs.readJSONSync( reportFile );
+    coverageMap.merge( normalizeJestCoverage( coverageReport ) );
+  })
+};
+
+const findAllCoverageReports = ( path, callback ) => {
+  glob( path, {}, ( err, reports )=>{
+    callback( reports, err );
+  });
+};
+
+const generateReport = ( coverageMap, types ) => {
+  reporter.dir = reportOut;
+  reporter.addAll(types || ['html', 'text'] );
+  reporter.write( coverageMap );
+};
+
+async function main () {
+  const coverageMap = istanbulCoverage.createCoverageMap( {} );
+
+  findAllCoverageReports( rootDir + '/**/coverage-final.json', ( reports, err ) => {
+    if ( Array.isArray( reports ) ) {
+      mergeAllReports( coverageMap, reports );
+      generateReport( coverageMap, [ 'text' ]  )
+    }
+  });
+}
+
+main().catch(err => {
+  console.error(err);
+  process.exit(1);
+});