add customHeaders in accessControl (#210)

* add customHeaders in accessControl

* Apply docs changes

Co-authored-by: Francesca-Bit <francesca@terminusdb.com>
Co-authored-by: Francesca-Bit <Francesca-Bit@users.noreply.github.com>

Author: Francesca-Bit

docs/api/accesscontrol.md

@@ -4,8 +4,10 @@
 **License**: Apache Version 2  
 
 ## new AccessControl()
-The AccessControl object has various methods to control the access for users.
-for the credential you can use the JWT token or the API token
+The AccessControl is a driver to work with
+TerminusDB and TerminusX access control api
+for the credential you can use the JWT token, the API token or
+the basic authentication with username and password
 
 **Example**  
 ```javascript
@@ -92,6 +94,16 @@ Get a API url from cloudAPIUrl
 | cloudAPIUrl | <code>string</code> | The base url for cloud |
 
 
+## customHeaders
+##### accessControl.customHeaders(customHeaders) ⇒ <code>object</code>
+add extra headers to your request
+
+
+| Param | Type |
+| --- | --- |
+| customHeaders | <code>object</code> | 
+
+
 ## getAllOrganizations
 ##### accessControl.getAllOrganizations() ⇒ <code>Promise</code>
 -- TerminusDB API ---

lib/accessControl.js

@@ -1,3 +1,4 @@
+/* eslint-disable no-underscore-dangle */
 const DispatchRequest = require('./dispatchRequest');
 const ErrorMessage = require('./errorMessage');
 const CONST = require('./const');
@@ -8,8 +9,10 @@ const typedef = require('./typedef');
  * @license Apache Version 2
  * @module AccessControl
  * @constructor AccessControl
- * @description The AccessControl object has various methods to control the access for users.
- * for the credential you can use the JWT token or the API token
+ * @description The AccessControl is a driver to work with
+ * TerminusDB and TerminusX access control api
+ * for the credential you can use the JWT token, the API token or
+ * the basic authentication with username and password
  * @example
  * //connect with the API token
  * //(to request a token create an account in  https://terminusdb.com/)
@@ -139,9 +142,23 @@ AccessControl.prototype.dispatch = function (requestUrl, action, payload) {
     action,
     payload,
     { type: this.apiType, key: this.apiKey, user: this.user },
+    null,
+    this.customHeaders(),
   );
 };
 
+/**
+ * add extra headers to your request
+ * @param {object} customHeaders
+ * @returns {object}
+ */
+
+// eslint-disable-next-line consistent-return
+AccessControl.prototype.customHeaders = function (customHeaders) {
+  if (customHeaders) this._customHeaders = customHeaders;
+  else return this._customHeaders;
+};
+
 /**
  * -- TerminusDB API ---
  * This end point works in basic authentication, admin user

test/accessControl.spec.js

@@ -0,0 +1,18 @@
+const { expect } = require('chai');
+const AccessControl = require('../lib/accessControl');
+
+describe('AccessControl tests', () => {
+    const startServerUrl = 'http://localhost:6363/';
+    const organization = 'admin';
+    const user = 'admin';
+    const key ='mykey'
+
+    const accessContol = new AccessControl(startServerUrl,{user,organization,key})
+
+    it('check set headers in accessControl', () => {
+        const customHeaders = { "Custom-header-01":"test-headers", "Custom-header-02": "test"}
+        accessContol.customHeaders(customHeaders)
+        expect(accessContol.customHeaders()).to.eql(customHeaders);  
+    })
+
+})