@daktela/daktela-connector 1.0.1 → 1.1.0

package/CHANGELOG.md

@@ -1,3 +1,8 @@
+# 1.1.0
+- Add `X-AUTH-TOKEN` header authentication (new default).
+- Add `authMethod` option with values: `'header'` (default), `'cookie'`, `'query'`.
+- Deprecate `cookieAuth` option (still functional for backward compatibility).
+
 # 1.0.1
 Update README.md
 

package/README.md

@@ -16,7 +16,11 @@ The only dependency of this library is HTTP client `Axios` (https://axios-http.c
 `DaktelaConnector` is a class that allows you to send CRUD requests on your Daktela server.
 Beside `instance` and `accessToken` you can pass `options` object with following parameters:
 
-* `cookieAuth` (boolean) - whether authorize requests via Cookie header or via query parameters. Default value is authorization via cookies.
+* `authMethod` (string) - authentication method. Possible values:
+  * `'header'` (default) - uses `X-AUTH-TOKEN` HTTP header.
+  * `'cookie'` - uses `Cookie` header with `c_user` cookie.
+  * `'query'` - passes access token as query parameter.
+* `cookieAuth` (boolean) - **deprecated**, use `authMethod` instead. When set to `true`, uses cookie authentication; when `false`, uses query parameter authentication.
 * `userAgent` (string) - HTTP User-Agent header.
 * `timeout` {number} - requests' timeout. Default value is `0` (no timeout).
 
@@ -40,8 +44,15 @@ Other way is to directly pass Axios's `params` argument which overrides Daktela
 ```js
 require('dotenv').config();
 const Daktela = require('daktela-connector');
+
+// Default - uses X-AUTH-TOKEN header
 let daktela = new Daktela.DaktelaConnector(process.env.INSTANCE, process.env.ACCESS_TOKEN);
 
+// Or explicitly specify authentication method
+let daktela = new Daktela.DaktelaConnector(process.env.INSTANCE, process.env.ACCESS_TOKEN, {
+    authMethod: 'cookie'  // 'header' (default), 'cookie', or 'query'
+});
+
 //...
 
 // login request

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@daktela/daktela-connector",
-  "version": "1.0.1",
+  "version": "1.1.0",
   "description": "Daktela's JavaScript SDK",
   "keywords": ["daktela", "omnichannel", "contact center", "communication"],
   "main": "src/index.js",

package/src/index.js

@@ -130,7 +130,8 @@ class DaktelaError extends Error {
  * @param {string}  url                 Target Daktela instance (e. g. my.daktela.com).
  * @param {string}  [accessToken=null]  Access token.
  * @param {Object}  [options={}]        Options of the connector. See below.
- * @param {boolean} options.cookieAuth  Authorize requests via Cookie header. Default value is true. Otherwise access token will be passed as query parameter.
+ * @param {string}  options.authMethod  Authentication method: 'header' (X-AUTH-TOKEN, default), 'cookie' (Cookie header), or 'query' (query parameter).
+ * @param {boolean} options.cookieAuth  @deprecated Use authMethod instead. Authorize requests via Cookie header. Default value is true. Otherwise access token will be passed as query parameter.
  * @param {string}  options.userAgent   User agent header.
  * @param {number}  options.timeout     Specifies the number of milliseconds before the request times out. Default is 0 (no timout)
  */
@@ -141,10 +142,20 @@ const DaktelaConnector = function DaktelaConnector(url, accessToken = null, opti
     if (!url.endsWith('/')) {
         url += '/';
     }
-    this.cookieAuth = options.cookieAuth ?? true;
+    // Determine auth method: 'header' (default), 'cookie', or 'query'
+    this.authMethod = options.authMethod ?? 'header';
+    // Backward compatibility: if cookieAuth is explicitly set, use legacy behavior
+    if (options.cookieAuth !== undefined) {
+        this.authMethod = options.cookieAuth ? 'cookie' : 'query';
+    }
     var headers = {};
-    if (this.cookieAuth && accessToken != null) {
-        headers['Cookie'] = 'c_user=' + accessToken;
+    if (accessToken != null) {
+        if (this.authMethod === 'header') {
+            headers['X-AUTH-TOKEN'] = accessToken;
+        } else if (this.authMethod === 'cookie') {
+            headers['Cookie'] = 'c_user=' + accessToken;
+        }
+        // 'query' method handled in buildRequestParams()
     }
     if (options.userAgent !== null) {
         headers['User-Agent'] = options.userAgent;
@@ -205,7 +216,7 @@ DaktelaConnector.prototype.buildRequestParams = function (options) {
             }
         }
     }
-    if (!this.cookieAuth && this.accessToken !== null) {
+    if (this.authMethod === 'query' && this.accessToken !== null) {
         params.accessToken = this.accessToken;
     }
     return {