@sap_oss/wdio-qmate-service 1.0.0

package/docs/gettingStarted/selectors.md

@@ -0,0 +1,168 @@
+# Selectors
+To perform any action on an element (e.g. clicking a button), you need to specify the element at which the action is being executed. This differs from the web technology you are using. Read the following instructions, depending on the UI technology of the application to be tested. 
+
+## UI5
+
+### Supported Selector Properties
+The supported properties for any UI5 based application are the following:
+```js
+const selector = {
+	"elementProperties": { ... },
+	"ancestorProperties": { ... },
+	"parentProperties": { ... },
+	"siblingProperties": { ... },
+	"prevSiblingProperties": { ... },
+	"nextSiblingProperties": { ... },
+	"childProperties": { ... },
+	"descendantProperties": { ... }
+};
+```
+
+The selector consists of one **mandatory** selector called **elementProperties**, representing the target element where the action should be applied to and seven optional selectors:  
+
+- **ancestorProperties, parentProperties**: While the `parentProperties` can be used only as direct parent of the element, the `ancestorProperties` can be used for any level of ancestry (parent, grandparent, grand-grand etc.).
+
+- **childProperties, descendantProperties** : The difference between them is, that the `childProperties` can be used only as direct child of the element, whereas the `descendantProperties` can be use for any level of descendance (child, grandson, grand-grand etc.).
+
+- **siblingProperties, prevSiblingProperties, nextSiblingProperties**: The `siblingProperties` can be any sibling, whereas the `prevSiblingProperties` can be only the direct previous sibling and `nextSiblingProperties` can be only the direct next sibling.
+
+You have to define at least one property in ```elementProperties```. This could be ```metadata``` or any other property of the [Overview](#Overview) below.
+
+
+### Sample
+```js
+"elementProperties":{
+	"metadata": "sap.m.Button",
+	"<ui5Property>": "*Any UI5 Property/Aggregation/Association"
+	"id": "*myId",
+	"viewName": "*myView*Name",
+	"viewId": "*id*viewId",
+	"bindingContextPath": "/ProductCategories(nodeKey=guid't12321-123213-34rer332', enabled='true', category='LT')"
+	"text":	[{"path": "oDataModelName>companyChangedManually"}, {"path": "*enabled"}],  
+	"tooltip": [{"path": "i18n>welcomeDescription"}]
+	"domProperties": {
+		"nodeName": "li",
+	   	"class": "*sapMButton"
+	   	"tooltip": "*text*"
+	},
+	"ancestorProperties": {	
+		"metadata":"sap.m.ColumnListItem",
+	  	"ancestorProperties": {
+			"metadata": "sap.m.Table",
+	     	"items":  {"path": "oDataModelName>PurchaseOrderItems"},
+	     	"siblingProperties": {...},
+	     	...
+	  },
+	},
+	"descendantProperties": {"metadata":"sap.m.Icon"},
+	"siblingProperties": {"metadata":"sap.m.Input"},
+	}
+```
+!!! tip
+		For most of the cases it will be sufficient to provide only the elementProperties. Spotlight will generate the minimal unique selector for you.
+
+
+### Overview
+The following properties apply to all selector types (elementProperties, ancestorProperties, parentProperties, siblingProperties, prevSiblingProperties, nextSiblingProperties, childProperties, descendantProperties).
+
+| Property | Description | Sample | Format | Remark |
+| -------- | ----------- | -------| ------ | ------ |
+| ``metadata`` | the control type | ``"metadata": "sap.m.Button"``, ``"metadata": "sap.m.Input"`` | string: ``"property": "value"`` | |
+| ``<ui5Property>`` | UI5 properties including aggregations and associations, as defined in the official [UI5 API](https://sapui5.hana.ondemand.com/#/api) | ``"text": "Amount"``, ``"tooltip": "Amount"``, ``"title": "Currency"``, ``"enabled": true`` | string: ``"property": "value"``, numeric: ``"property": 123``, boolean: ``"property": true`` | |
+| ``id`` | the ID of the control | ``"id": "myButtonId"``, ``"id": "my*Id*"`` | string: ``"property": "value"`` | |
+| ``viewName`` | the view name | ``"viewName": "myViewName"``, ``"viewName": "*view*"``| string: ``"property": "value"`` | |
+| ``viewId`` | the view ID | ``"viewId": "*myViewId*"`` | string: ``"property": "value"`` | |
+| ``bindingContextPath`` | the binding context path | ``"bindingContextPath": "/odata/entity('1')"``, ``"bindingContextPath": "/odata/entity(*)*"`` | string: ``"property": "value"`` | |
+| binding property paths | the binding property paths of the model (for all types of properties: UI properties, aggregations, associations) | ``"text":[{"path": "oDataModelName>companyChangedManually"}]``, ``"title": {"path": "oDataModelName>companyChangedTitle"}``,  ``"items": {"path": "oDataModelName>PurchaseOrderItems"}``, ``"enabled": [{"path": "company*Enabled*"}]``, | json: ``"items": {"path": ...}``, array: ``"items": [{"path": ...}, {"path": ...} ...]`` | model name is optional |
+| i18n keys | the binding properties path for i18n | ``"tooltip": [{"path": "i18n>welcomeDescription"}]``, ``"tooltip": {"path": "i18n>welcomeDescription"}``, ``"tooltip": [{"path": "*i18n*welcomeDescription"}]`` | json: ``"items": {"path": ...}``, array: ``"items": [{"path": ...}, {"path": ...} ...]`` | i18n is a model, and therefore all the above mentioned rules (as described in *binding property paths*) apply |
+| ``domProperties`` | the properties of the DOM | ``"domProperties": {"nodeName": "div", "class": "buttonNU* class2*", "id": "my*Id*"}`` | string: ``"property": "value"``, numeric: ``"property": 123``, boolean: ``"property": true`` | can be used if the UI5 Virtual DOM is not sufficient |
+
+!!! info
+		Wildcards are supported for all properties, aggregation and associations 
+		```js
+		"text": "my*text*"
+		```
+
+### Nested Properties
+In case you need to specify the element based on its surrounding, you can define nested properties. 
+```javascript
+"elementProperties": {
+	...
+	"ancestorProperties": {
+		"metadata":	"sap.m.ColumnListItem",
+		"ancestorProperties": {
+			"metadata":	"sap.m.Table",
+			"items": { "path": "oDataModelName>PurchaseOrderItems" },
+			"siblingProperties": {...},
+			...
+		},
+	}
+};
+```
+!!! info
+		Nesting is enabled infinitely for *ancestorProperties*, *siblingProperties* and *descendantProperties*. Be cautious, the more level of nesting you add the slower your script will be.
+
+### Usage of Selectors
+For almost every UI5 action we provide, you can pass the selector directly to the function like:
+```javascript
+it("Step 01: click on 'Save' button", async function () {
+  const selector = {
+    "elementProperties": {
+      "metadata": "sap.m.Button",
+      "text": "Save"
+    }
+  };
+  await ui5.userInteraction.click(selector);
+});
+```
+
+## Non UI5
+
+### Defining the element
+For all non UI5 applications you can define the element in different ways. We provide all common functionalities to get an element by its ID, Class or any other CSS attribute. Hence, you can not pass any selector directly to the function performing an action. Instead, you have to define the element first with one of the provided methods.
+```javascript
+// Get an element by its ID
+const elem = await nonUi5.element.getById("button-abc");
+
+// Get an element by its class (pass an index if there are more than one elements with the same class)
+const elem = await nonUi5.element.getByClass(".button", 0);
+
+// Get an element by its attribute value of "title"
+const elem = await nonUi5.element.getByCss("input[title='name']");
+
+// Get an element by its class and text value
+const elem = await nonUi5.element.getByCssContainingText(".button", "Save");
+```
+!!! info
+		To get a complete overview about all possible methods, please see [nonUi5.element](https://pages.github.tools.sap/sProcurement/wdio-qmate-service-ts/doc/#nonUi5.element). 
+ 
+
+### Getting the attributes with Spotlight
+The [Spotlight Chrome Extension](https://github.tools.sap/sProcurement/qmate-spotlight) also supports non UI5 applications to generate unique selectors. It is possible to use one of the alternatives generated from spotlight or to define them manually.
+
+### Getting the attributes manually 
+To get the properties of an element manually, please follow the steps below:
+
+1. Open the dev-tools <kbd>F12</kbd> and switch to the *Elements* Tab.
+
+2. Select the element (<kbd>right click</kbd> ➜ <kbd>inspect</kbd>)
+
+3. Find any attribute or set of attributes to identify the element 
+clearly.
+
+4. To verify the uniqueness of the element, switch to the *Console* tab of the dev-tools and type in the following command using your found attribute/s:
+```bash
+$$("[<attr>='<attrValue>']");
+```
+!!! warning
+		If there are more than one elements found, try to find another attribute or add some more attributes until you will find a single element (you can still pass an index to the reuse function if you are not able to find a unique selector).
+
+
+### Usage
+To perform the action, pass the defined element to the action function.
+```javascript
+it("Step 01: click on 'Save' button", async function () {
+	const elem = await nonUi5.element.getByCss(".saveButton");
+	await nonUi5.userInteraction.click(elem);
+});
+```

package/docs/gettingStarted/setup.md

@@ -0,0 +1,8 @@
+## Prerequisites 
+Make sure [Node.js](https://nodejs.org/en/download/) is installed on your computer.
+
+## Installation
+To install the latest version of the service, simply execute the following command:
+```bash
+npm install @wdio/qmate-service
+```

package/docs/index.md

@@ -0,0 +1,14 @@
+# Qmate Service
+**Qmate Service** is a custom [WebdriverIO](https://webdriver.io/) service built in TypeScript for testing web applications and APIs.
+
+## Main features
+The main features of this service are:
+
+- [x] Supporting UI5 and OPA Selectors
+- [x] Reuse API with useful functions for UI5 and any other type of web application
+- [x] REST & OData API testing
+- [x] Dynamic test data handling
+
+---
+
+[Reuse API](doc.md){ .md-button } 

package/docs/style/custom.css

@@ -0,0 +1,24 @@
+[data-md-color-scheme="qmate-light"] {
+  --md-primary-fg-color: #2c4164;
+  --md-primary-bg-color: rgb(134, 170, 247);
+  --md-footer-bg-color: #eee;
+  --md-footer-bg-color--dark: #ddd;
+  --md-footer-fg-color: #777;
+  --md-footer-fg-color--light: #777;
+  --md-footer-fg-color--lighter: #999;
+  --md-accent-fg-color: #e4457a;
+  --md-typeset-a-color: #e4457a;
+}
+
+[data-md-color-scheme="slate"] {
+  --md-primary-fg-color: rgb(134, 170, 247);
+  --md-primary-bg-color: #293851;
+  --md-footer-bg-color: #222e43;
+  --md-footer-bg-color--dark: #1c2533;
+  --md-accent-fg-color: #e4457a;
+  --md-default-bg-color: #293851;
+  --md-code-bg-color: #222e43;
+  --md-footer-fg-color--light: #576783;
+  --md-footer-fg-color--lighter: #3e4e6a;
+}
+

package/lib/index.d.ts

@@ -0,0 +1 @@
+export {};

package/lib/index.js

@@ -0,0 +1,171 @@
+/* eslint-disable no-console */
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const beforeSession_1 = __importDefault(require("./scripts/hooks/beforeSession"));
+const before_1 = __importDefault(require("./scripts/hooks/before"));
+const onPrepare_1 = __importDefault(require("./scripts/hooks/onPrepare"));
+const onComplete_1 = __importDefault(require("./scripts/hooks/onComplete"));
+const after_1 = __importDefault(require("./scripts/hooks/after"));
+const pj = require("../package.json");
+module.exports = class CustomWorkerService {
+    /**
+     * `serviceOptions` contains all options specific to the service
+     * e.g. if defined as follows:
+     *
+     * ```
+     * services: [['custom', { foo: 'bar' }]]
+     * ```
+     *
+     * the `serviceOptions` parameter will be: `{ foo: 'bar' }`
+     */
+    // @ts-ignore
+    constructor(serviceOptions, capabilities, config, browser) { }
+    /**
+     * Gets executed once before all workers get launched.
+     * @param {Object} config wdio configuration object
+     * @param {Array.<Object>} capabilities list of capabilities details
+     */
+    // @ts-ignore
+    onPrepare(config, capabilities) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const logo = `                         __     
+  ____ _____ ___  ____ _/ /____ 
+ / __ \`/ __ \`__ \\/ __ \`/ __/ _ \\
+/ /_/ / / / / / / /_/ / /_/  __/
+\\__, /_/ /_/ /_/\__,_/\\__/\\___/ 
+  /_/   \x1b[3m service v.${pj.version}\x1b[0m                              
+      `;
+            console.log(logo);
+            try {
+                yield (0, onPrepare_1.default)(config, capabilities);
+            }
+            catch (e) {
+                console.error(`onPrepare hook failed: ${e}`);
+            }
+        });
+    }
+    /**
+     * Gets executed just before initializing the webdriver session and test framework. It allows you
+     * to manipulate configurations depending on the capability or spec.
+     * @param {Object} config wdio configuration object
+     * @param {Array.<Object>} capabilities list of capabilities details
+     * @param {Array.<String>} specs List of spec file paths that are to be run
+     */
+    // @ts-ignore
+    beforeSession(config, capabilities, specs) {
+        return __awaiter(this, void 0, void 0, function* () {
+            try {
+                yield (0, beforeSession_1.default)(config, capabilities, specs);
+            }
+            catch (e) {
+                if (specs && specs[0]) {
+                    // `specs` variable is an array, but includes only one current spec
+                    console.error(`qmateLoader() in 'beforeSession' hook failed for spec '${specs[0]}'. ${e}`);
+                }
+                else {
+                    console.error(`qmateLoader() in 'beforeSession' hook failed. ${e}`);
+                }
+            }
+        });
+    }
+    /**
+     * Gets executed before test execution begins. At this point you can access to all global
+     * variables like `browser`. It is the perfect place to define custom commands.
+     * @param {Array.<Object>} capabilities list of capabilities details
+     * @param {Array.<String>} specs        List of spec file paths that are to be run
+     * @param {Object}         browser      instance of created browser/device session
+     */
+    // @ts-ignore
+    before(capabilities, specs, browser) {
+        return __awaiter(this, void 0, void 0, function* () {
+            // Errors in WDIO hooks are suppressed by default => we call process.exit(1). It will mark all specs as failed
+            try {
+                yield (0, before_1.default)(capabilities, specs, browser);
+            }
+            catch (e) {
+                if (specs && specs[0]) {
+                    // `specs` variable is an array, but includes only one current spec
+                    util.console.error(`qmateLoader() in 'before' hook failed for spec '${specs[0]}'. ${e}`);
+                }
+                else {
+                    util.console.error(`qmateLoader() in 'before' hook failed. ${e}`);
+                }
+            }
+        });
+    }
+    /**
+     * Gets executed before the suite starts.
+     * @param {Object} suite suite details
+     */
+    beforeSuite(suite) {
+        return __awaiter(this, void 0, void 0, function* () {
+            util.console.log(` ${suite.fullTitle}  `, "black", "white");
+        });
+    }
+    /**
+     * Function to be executed after a test (in Mocha/Jasmine)
+     */
+    // @ts-ignore
+    afterTest(test, context, { error, result, duration, passed, retries }) {
+        return __awaiter(this, void 0, void 0, function* () {
+            // test.title - for mocha framework
+            // test.description - for jasmine framework
+            const testName = test.title || test.description;
+            // Print test titles as in vyperForAll during test run
+            if (!error && passed === true) {
+                util.console.info(`\x1b[32m\t✓ ${testName}\x1b[0m  (${Math.round(duration / 1000)}s)`);
+            }
+            else if (error || passed !== true) {
+                util.console.error(`\x1b[31m\t✗ ${testName}\x1b[0m  (${Math.round(duration / 1000)}s)`);
+            }
+        });
+    }
+    /**
+     * Gets executed after all tests are done. You still have access to all global variables from
+     * the test.
+     * @param {Number} result 0 - test pass, 1 - test fail
+     * @param {Array.<Object>} capabilities list of capabilities details
+     * @param {Array.<String>} specs List of spec file paths that ran
+     */
+    after(result, capabilities, specs) {
+        return __awaiter(this, void 0, void 0, function* () {
+            try {
+                (0, after_1.default)(result, capabilities, specs);
+            }
+            catch (e) {
+                util.console.error(`after hook failed: ${e}`);
+            }
+        });
+    }
+    /**
+     * Gets executed after all workers have shut down and the process is about to exit.
+     * An error thrown in the `onComplete` hook will result in the test run failing.
+     * @param {Object} exitCode 0 - success, 1 - fail
+     * @param {Object} config wdio configuration object
+     * @param {Array.<Object>} capabilities list of capabilities details
+     * @param {<Object>} results object containing test results
+     */
+    onComplete(exitCode, config, capabilities, results) {
+        return __awaiter(this, void 0, void 0, function* () {
+            try {
+                yield (0, onComplete_1.default)(exitCode, config, capabilities, results);
+            }
+            catch (e) {
+                util.console.error(`onComplete hook failed: ${e}`);
+            }
+        });
+    }
+};
+//# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/lib/reuse/authenticator/authConfig.d.ts

@@ -0,0 +1,54 @@
+declare const _exports: {
+    plain: {
+        name: string;
+    };
+    basic: {
+        name: string;
+    };
+    custom: {
+        name: string;
+    };
+    "fiori-form": {
+        name: string;
+        usernameFieldSelector: string;
+        passwordFieldSelector: string;
+        logonButtonSelector: string;
+    };
+    "fiori-form-new": {
+        name: string;
+        usernameFieldSelector: string;
+        passwordFieldSelector: string;
+        logonButtonSelector: string;
+    };
+    "sapcloud-form": {
+        name: string;
+        usernameFieldSelector: string;
+        passwordFieldSelector: string;
+        logonButtonSelector: string;
+    };
+    "XSA-form": {
+        name: string;
+        usernameFieldSelector: string;
+        passwordFieldSelector: string;
+        logonButtonSelector: string;
+    };
+    "POT-form": {
+        name: string;
+        usernameFieldSelector: string;
+        passwordFieldSelector: string;
+        logonButtonSelector: string;
+    };
+    "MIA-form": {
+        name: string;
+        usernameFieldSelector: string;
+        passwordFieldSelector: string;
+        logonButtonSelector: string;
+    };
+    "UI5-Form": {
+        name: string;
+        usernameFieldSelector: string;
+        passwordFieldSelector: string;
+        logonButtonSelector: string;
+    };
+};
+export = _exports;

package/lib/reuse/authenticator/authConfig.js

@@ -0,0 +1,55 @@
+"use strict";
+module.exports = {
+    "plain": {
+        name: "./plainAuthenticator"
+    },
+    "basic": {
+        name: "./basicUrlAuthenticator"
+    },
+    "custom": {
+        name: "./customAuthenticator"
+    },
+    "fiori-form": {
+        name: "./formAuthenticator",
+        usernameFieldSelector: "#USERNAME_BLOCK input",
+        passwordFieldSelector: "#PASSWORD_BLOCK input",
+        logonButtonSelector: "#LOGIN_LINK"
+    },
+    "fiori-form-new": {
+        name: "./formAuthenticator",
+        usernameFieldSelector: "#USERNAME_BLOCK input",
+        passwordFieldSelector: "#PASSWORD_BLOCK input",
+        logonButtonSelector: "#LOGIN_LINK"
+    },
+    "sapcloud-form": {
+        name: "./formAuthenticator",
+        usernameFieldSelector: "#j_username",
+        passwordFieldSelector: "#j_password",
+        logonButtonSelector: "#logOnFormSubmit"
+    },
+    "XSA-form": {
+        name: "./formAuthenticator",
+        usernameFieldSelector: "#xs_username-inner",
+        passwordFieldSelector: "#xs_password-inner",
+        logonButtonSelector: "#logon_button"
+    },
+    "POT-form": {
+        name: "./formAuthenticator",
+        usernameFieldSelector: "#__screen0-user",
+        passwordFieldSelector: "#__screen0-pass",
+        logonButtonSelector: "#__screen0-loginBtn"
+    },
+    "MIA-form": {
+        name: "./formAuthenticator",
+        usernameFieldSelector: "#logonuidfield",
+        passwordFieldSelector: "#logonpassfield",
+        logonButtonSelector: ".urBtnStdNew"
+    },
+    "UI5-Form": {
+        name: "./formAuthenticator",
+        usernameFieldSelector: "#__control0-user-inner",
+        passwordFieldSelector: "#__control0-pass-inner",
+        logonButtonSelector: "#__control0-logonBtn"
+    }
+};
+//# sourceMappingURL=authConfig.js.map

package/lib/reuse/authenticator/authConfig.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"authConfig.js","sourceRoot":"","sources":["../../../src/reuse/authenticator/authConfig.js"],"names":[],"mappings":";AAAA,MAAM,CAAC,OAAO,GAAG;IACf,OAAO,EAAE;QACP,IAAI,EAAE,sBAAsB;KAC7B;IACD,OAAO,EAAE;QACP,IAAI,EAAE,yBAAyB;KAChC;IACD,QAAQ,EAAE;QACR,IAAI,EAAE,uBAAuB;KAC9B;IACD,YAAY,EAAE;QACZ,IAAI,EAAE,qBAAqB;QAC3B,qBAAqB,EAAE,uBAAuB;QAC9C,qBAAqB,EAAE,uBAAuB;QAC9C,mBAAmB,EAAE,aAAa;KACnC;IACD,gBAAgB,EAAE;QAChB,IAAI,EAAE,qBAAqB;QAC3B,qBAAqB,EAAE,uBAAuB;QAC9C,qBAAqB,EAAE,uBAAuB;QAC9C,mBAAmB,EAAE,aAAa;KACnC;IACD,eAAe,EAAE;QACf,IAAI,EAAE,qBAAqB;QAC3B,qBAAqB,EAAE,aAAa;QACpC,qBAAqB,EAAE,aAAa;QACpC,mBAAmB,EAAE,kBAAkB;KACxC;IACD,UAAU,EAAE;QACV,IAAI,EAAE,qBAAqB;QAC3B,qBAAqB,EAAE,oBAAoB;QAC3C,qBAAqB,EAAE,oBAAoB;QAC3C,mBAAmB,EAAE,eAAe;KACrC;IACD,UAAU,EAAE;QACV,IAAI,EAAE,qBAAqB;QAC3B,qBAAqB,EAAE,iBAAiB;QACxC,qBAAqB,EAAE,iBAAiB;QACxC,mBAAmB,EAAE,qBAAqB;KAC3C;IACD,UAAU,EAAE;QACV,IAAI,EAAE,qBAAqB;QAC3B,qBAAqB,EAAE,gBAAgB;QACvC,qBAAqB,EAAE,iBAAiB;QACxC,mBAAmB,EAAE,cAAc;KACpC;IACD,UAAU,EAAE;QACV,IAAI,EAAE,qBAAqB;QAC3B,qBAAqB,EAAE,wBAAwB;QAC/C,qBAAqB,EAAE,wBAAwB;QAC/C,mBAAmB,EAAE,sBAAsB;KAC5C;CACF,CAAC"}

package/lib/reuse/authenticator/authHandler.d.ts

@@ -0,0 +1,6 @@
+declare class AuthHandler {
+    private path;
+    attachAuthHandling(): Promise<void>;
+}
+declare const _default: AuthHandler;
+export default _default;

package/lib/reuse/authenticator/authHandler.js

@@ -0,0 +1,37 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+class AuthHandler {
+    constructor() {
+        this.path = require("path");
+    }
+    attachAuthHandling() {
+        return __awaiter(this, void 0, void 0, function* () {
+            const authConfig = require("./authConfig.js");
+            if (browser.config.params && browser.config.params.auth) {
+                const formType = browser.config.params.auth.formType;
+                if (formType && formType !== "skip") {
+                    if (!authConfig[formType] || !authConfig[formType].name || !this.path.resolve(authConfig[formType].name)) {
+                        throw new Error(`Please provide a valid 'formType' instead of '${formType}'.`);
+                    }
+                    // eslint-disable-next-line no-console
+                    console.log(this.path.resolve(authConfig[formType].name));
+                    const execAuthenticator = require(authConfig[formType].name);
+                    yield execAuthenticator();
+                }
+            }
+        });
+    }
+    ;
+}
+;
+exports.default = new AuthHandler();
+//# sourceMappingURL=authHandler.js.map

package/lib/reuse/authenticator/authHandler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"authHandler.js","sourceRoot":"","sources":["../../../src/reuse/authenticator/authHandler.ts"],"names":[],"mappings":";;;;;;;;;;;AAAA,MAAM,WAAW;IAAjB;QAEU,SAAI,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAmBjC,CAAC;IAjBO,kBAAkB;;YACtB,MAAM,UAAU,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;YAE9C,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE;gBACvD,MAAM,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC;gBACrD,IAAI,QAAQ,IAAI,QAAQ,KAAK,MAAM,EAAE;oBACnC,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,EAAE;wBACxG,MAAM,IAAI,KAAK,CAAC,iDAAiD,QAAQ,IAAI,CAAC,CAAC;qBAChF;oBACD,sCAAsC;oBACtC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;oBAC1D,MAAM,iBAAiB,GAAG,OAAO,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,CAAC;oBAC7D,MAAM,iBAAiB,EAAE,CAAC;iBAC3B;aACF;QACH,CAAC;KAAA;IAAA,CAAC;CAEH;AAAA,CAAC;AACF,kBAAe,IAAI,WAAW,EAAE,CAAC"}

package/lib/reuse/authenticator/basicUrlAuthenticator.d.ts

@@ -0,0 +1,2 @@
+export = BasicUrlAuthenticator;
+declare function BasicUrlAuthenticator(): Promise<void>;

package/lib/reuse/authenticator/basicUrlAuthenticator.js

@@ -0,0 +1,36 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+function BasicUrlAuthenticator() {
+    return __awaiter(this, void 0, void 0, function* () {
+        const username = browser.config.params ? browser.config.params.auth.username : undefined;
+        if (!username) {
+            throw new Error("Please provide a 'username' in the config.");
+        }
+        const password = browser.config.params ? browser.config.params.auth.password : undefined;
+        if (!password) {
+            throw new Error("Please provide a 'password' in the config.");
+        }
+        const url = browser.config.baseUrl;
+        if (!url) {
+            throw new Error("Please provide a 'baseUrl' in the config.");
+        }
+        // prepare basic auth url
+        const urlMatches = url.match(/(\w*\:?\/\/)(.+)/);
+        if (urlMatches === null) {
+            throw new Error(`Could not parse url: ${url}.`);
+        }
+        const urlWithAuth = urlMatches[1] + username + ":" + password + "@" + urlMatches[2];
+        // get the url
+        yield browser.url(urlWithAuth);
+    });
+}
+module.exports = BasicUrlAuthenticator;
+//# sourceMappingURL=basicUrlAuthenticator.js.map

package/lib/reuse/authenticator/basicUrlAuthenticator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"basicUrlAuthenticator.js","sourceRoot":"","sources":["../../../src/reuse/authenticator/basicUrlAuthenticator.js"],"names":[],"mappings":";;;;;;;;;;AAAA,SAAe,qBAAqB;;QAElC,MAAM,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC;QACzF,IAAI,CAAC,QAAQ,EAAE;YACb,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAC;SAC/D;QACD,MAAM,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC;QACzF,IAAI,CAAC,QAAQ,EAAE;YACb,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAC;SAC/D;QACD,MAAM,GAAG,GAAG,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC;QACnC,IAAI,CAAC,GAAG,EAAE;YACR,MAAM,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAC;SAC9D;QAED,yBAAyB;QACzB,MAAM,UAAU,GAAG,GAAG,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAAC;QACjD,IAAI,UAAU,KAAK,IAAI,EAAE;YACvB,MAAM,IAAI,KAAK,CAAC,wBAAwB,GAAG,GAAG,CAAC,CAAC;SACjD;QACD,MAAM,WAAW,GAAG,UAAU,CAAC,CAAC,CAAC,GAAG,QAAQ,GAAG,GAAG,GAAG,QAAQ,GAAG,GAAG,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC;QAEpF,cAAc;QACd,MAAM,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;IACjC,CAAC;CAAA;AACD,MAAM,CAAC,OAAO,GAAG,qBAAqB,CAAC"}

package/lib/reuse/authenticator/customAuthenticator.d.ts

@@ -0,0 +1,2 @@
+export = CustomAuthenticator;
+declare function CustomAuthenticator(): Promise<void>;