@sap_oss/wdio-qmate-service 2.9.9 → 2.11.0

package/docs/doc.md

@@ -16,6 +16,9 @@
 <dt><a href="#service">service</a></dt>
 <dd><p>Global namespace for service modules.</p>
 </dd>
+<dt><a href="#mobile">mobile</a></dt>
+<dd><p>Global namespace for mobile modules.</p>
+</dd>
 </dl>
 
 <a name="common"></a>
@@ -571,6 +574,9 @@ Global namespace for util modules.
         * [.log(message)](#util.browser.log)
         * [.warn(message)](#util.browser.warn)
         * [.error(message)](#util.browser.error)
+        * [.isMobile()](#util.browser.isMobile) ⇒ <code>boolean</code>
+        * [.isAndroid()](#util.browser.isAndroid) ⇒ <code>boolean</code>
+        * [.isIos()](#util.browser.isIos) ⇒ <code>boolean</code>
     * [.component](#util.component)
         * [new component()](#new_util.component_new)
         * [.loadEntryPoint([folderPath])](#util.component.loadEntryPoint) ⇒ <code>Object</code>
@@ -644,6 +650,9 @@ Global namespace for util modules.
     * [.log(message)](#util.browser.log)
     * [.warn(message)](#util.browser.warn)
     * [.error(message)](#util.browser.error)
+    * [.isMobile()](#util.browser.isMobile) ⇒ <code>boolean</code>
+    * [.isAndroid()](#util.browser.isAndroid) ⇒ <code>boolean</code>
+    * [.isIos()](#util.browser.isIos) ⇒ <code>boolean</code>
 
 <a name="util.browser.getBaseUrl"></a>
 
@@ -960,6 +969,39 @@ add error message to browser logs, can be viewed in the html report
 ```js
 await util.browser.error("This is an error message");
 ```
+<a name="util.browser.isMobile"></a>
+
+#### browser.isMobile() ⇒ <code>boolean</code>
+Indicates a mobile session
+
+**Kind**: static method of [<code>browser</code>](#util.browser)  
+**Returns**: <code>boolean</code> - Return true if its a mobile session driver.  
+**Example**  
+```js
+await util.browser.isMobile();
+```
+<a name="util.browser.isAndroid"></a>
+
+#### browser.isAndroid() ⇒ <code>boolean</code>
+Indicates a mobile session
+
+**Kind**: static method of [<code>browser</code>](#util.browser)  
+**Returns**: <code>boolean</code> - Return true if its a Android session driver.  
+**Example**  
+```js
+await util.browser.isAndroid();
+```
+<a name="util.browser.isIos"></a>
+
+#### browser.isIos() ⇒ <code>boolean</code>
+Indicates an iOS session
+
+**Kind**: static method of [<code>browser</code>](#util.browser)  
+**Returns**: <code>boolean</code> - Return true if its a iOS session driver.  
+**Example**  
+```js
+await util.browser.isIos();
+```
 <a name="util.component"></a>
 
 ### util.component
@@ -1185,7 +1227,7 @@ Decrypts the passed input data.
 
 | Param | Type | Description |
 | --- | --- | --- |
-| data | <code>String</code> | The encrypted data to decrypt. |
+| data | <code>String</code> \| <code>Array.&lt;String&gt;</code> | The encrypted data to decrypt. Single value or array of values for different keys. |
 
 **Example**  
 ```js
@@ -5722,3 +5764,377 @@ const config = {
         },
         let res = await service.rest.put(`${browser.config.baseUrl}/posts/99`, payload, config);
 ```
+<a name="mobile"></a>
+
+## mobile
+Global namespace for mobile modules.
+
+**Kind**: global constant  
+
+* [mobile](#mobile)
+    * [.android](#mobile.android)
+        * [.pressKeyByName(keyName)](#mobile.android.pressKeyByName)
+        * [.pressKeyByCode(keyCode)](#mobile.android.pressKeyByCode)
+    * [.device](#mobile.device)
+        * [.isAppInstalled(packageIdorBundleId)](#mobile.device.isAppInstalled) ⇒ <code>boolean</code>
+        * [.installApp(appPath)](#mobile.device.installApp)
+    * [.element](#mobile.element)
+        * [.isVisible(element, [strict])](#mobile.element.isVisible) ⇒ <code>Boolean</code>
+        * [.isPresent(elem)](#mobile.element.isPresent) ⇒ <code>Boolean</code>
+        * [.waitToBePresent(selector, [timeout])](#mobile.element.waitToBePresent)
+        * [.waitToBeVisible(selector, [timeout])](#mobile.element.waitToBeVisible)
+        * [.waitToBeClickable(selector, [timeout])](#mobile.element.waitToBeClickable)
+        * [.isSelected(elem)](#mobile.element.isSelected) ⇒ <code>boolean</code>
+    * [.gestures](#mobile.gestures)
+        * [.waitToBeClickable(startX, startY, endX, endY, duration)](#mobile.gestures.waitToBeClickable) ⇒ <code>Promise.&lt;void&gt;</code>
+    * [.ios](#mobile.ios)
+    * [.userInteraction](#mobile.userInteraction)
+        * [.tap(element, [timeout])](#mobile.userInteraction.tap)
+        * [.check(element)](#mobile.userInteraction.check)
+
+<a name="mobile.android"></a>
+
+### mobile.android
+**Kind**: static class of [<code>mobile</code>](#mobile)  
+
+* [.android](#mobile.android)
+    * [.pressKeyByName(keyName)](#mobile.android.pressKeyByName)
+    * [.pressKeyByCode(keyCode)](#mobile.android.pressKeyByCode)
+
+<a name="mobile.android.pressKeyByName"></a>
+
+#### android.pressKeyByName(keyName)
+Simulate pressing a hardware key on the android device (e.g., back button, home button, etc.),
+
+**Kind**: static method of [<code>android</code>](#mobile.android)  
+
+| Param | Type | Description |
+| --- | --- | --- |
+| keyName | <code>string</code> | The name of the key (e.g., "back", "home", "volumeUp", etc.) |
+
+**Example**  
+```js
+await mobile.device.pressKeyByName("back");
+```
+**Example**  
+```js
+await mobile.device.pressKeyByName("home");
+```
+**Example**  
+```js
+await mobile.device.pressKeyByName("volumeUp");
+```
+**Example**  
+```js
+await mobile.device.pressKeyByName("volumeDown");
+```
+**Example**  
+```js
+await mobile.device.pressKeyByName("volumeMute");
+```
+**Example**  
+```js
+await mobile.device.pressKeyByName("power");
+```
+**Example**  
+```js
+await mobile.device.pressKeyByName("enter");
+```
+**Example**  
+```js
+await mobile.device.pressKeyByName("space");
+```
+**Example**  
+```js
+await mobile.device.pressKeyByName("delete");
+```
+**Example**  
+```js
+await mobile.device.pressKeyByName("menu");
+```
+**Example**  
+```js
+await mobile.device.pressKeyByName("search");
+```
+**Example**  
+```js
+await mobile.device.pressKeyByName("camera");
+```
+**Example**  
+```js
+await mobile.device.pressKeyByName("focus");
+```
+**Example**  
+```js
+await mobile.device.pressKeyByName("notification");
+```
+**Example**  
+```js
+await mobile.device.pressKeyByName("call");
+```
+**Example**  
+```js
+await mobile.device.pressKeyByName("calendar");
+```
+**Example**  
+```js
+await mobile.device.pressKeyByName("recent");
+```
+**Example**  
+```js
+await mobile.device.pressKeyByName("settings");
+```
+<a name="mobile.android.pressKeyByCode"></a>
+
+#### android.pressKeyByCode(keyCode)
+Simulate pressing a hardware key on the android device (e.g., back button, home button, etc.),
+
+**Kind**: static method of [<code>android</code>](#mobile.android)  
+
+| Param | Type | Description |
+| --- | --- | --- |
+| keyCode | <code>string</code> | The code of the key (e.g., 4 (back), 3 (home) , etc.) |
+
+**Example**  
+```js
+await mobile.android.pressKeyByCode(4);
+```
+<a name="mobile.device"></a>
+
+### mobile.device
+**Kind**: static class of [<code>mobile</code>](#mobile)  
+
+* [.device](#mobile.device)
+    * [.isAppInstalled(packageIdorBundleId)](#mobile.device.isAppInstalled) ⇒ <code>boolean</code>
+    * [.installApp(appPath)](#mobile.device.installApp)
+
+<a name="mobile.device.isAppInstalled"></a>
+
+#### device.isAppInstalled(packageIdorBundleId) ⇒ <code>boolean</code>
+Check wether given package/bundle app is installed or not in the device.
+
+**Kind**: static method of [<code>device</code>](#mobile.device)  
+**Returns**: <code>boolean</code> - Returns true if specified app package/bundled installed in the device, or false.  
+
+| Param | Type | Description |
+| --- | --- | --- |
+| packageIdorBundleId | <code>string</code> | Android package Id, or iOS bundle Id. |
+
+**Example**  
+```js
+await mobile.device.isAppInstalled("com.google.android.apps.maps");
+```
+<a name="mobile.device.installApp"></a>
+
+#### device.installApp(appPath)
+Install the appropriate app based on the platform the test is being executed on.
+
+**Kind**: static method of [<code>device</code>](#mobile.device)  
+
+| Param | Type | Description |
+| --- | --- | --- |
+| appPath | <code>string</code> | Path of the app(.apk, .ipa) |
+
+**Example**  
+```js
+await mobile.device.installApp("/path/to/your/app.apk");
+await mobile.device.installApp("/path/to/your/app.ipa");
+```
+<a name="mobile.element"></a>
+
+### mobile.element
+**Kind**: static class of [<code>mobile</code>](#mobile)  
+
+* [.element](#mobile.element)
+    * [.isVisible(element, [strict])](#mobile.element.isVisible) ⇒ <code>Boolean</code>
+    * [.isPresent(elem)](#mobile.element.isPresent) ⇒ <code>Boolean</code>
+    * [.waitToBePresent(selector, [timeout])](#mobile.element.waitToBePresent)
+    * [.waitToBeVisible(selector, [timeout])](#mobile.element.waitToBeVisible)
+    * [.waitToBeClickable(selector, [timeout])](#mobile.element.waitToBeClickable)
+    * [.isSelected(elem)](#mobile.element.isSelected) ⇒ <code>boolean</code>
+
+<a name="mobile.element.isVisible"></a>
+
+#### element.isVisible(element, [strict]) ⇒ <code>Boolean</code>
+Returns a boolean if the mobile element is visible to the user.
+
+**Kind**: static method of [<code>element</code>](#mobile.element)  
+**Returns**: <code>Boolean</code> - Returns true or false.  
+
+| Param | Type | Default | Description |
+| --- | --- | --- | --- |
+| element | <code>Object</code> |  | The Mobile Ui element. |
+| [strict] | <code>Boolean</code> | <code>true</code> | If strict mode is enabled it will only return "true" if the element is visible on the mobile view and within the viewport. If "false", it will be sufficient if the element is visible on the view but not inside the current viewport. |
+
+**Example**  
+```js
+const elem = await mobile.element.isVisible("button01");
+await mobile.element.isVisible(elem);
+```
+<a name="mobile.element.isPresent"></a>
+
+#### element.isPresent(elem) ⇒ <code>Boolean</code>
+Returns a boolean if the element is present at the DOM or not. It might be hidden.
+
+**Kind**: static method of [<code>element</code>](#mobile.element)  
+**Returns**: <code>Boolean</code> - Returns true or false.  
+
+| Param | Type | Description |
+| --- | --- | --- |
+| elem | <code>Object</code> | The element. |
+
+**Example**  
+```js
+await mobile.element.isPresent(elem);
+```
+<a name="mobile.element.waitToBePresent"></a>
+
+#### element.waitToBePresent(selector, [timeout])
+Waits until the element with the given selector is present.
+
+**Kind**: static method of [<code>element</code>](#mobile.element)  
+
+| Param | Type | Default | Description |
+| --- | --- | --- | --- |
+| selector | <code>Object</code> |  | The CSS selector describing the element. |
+| [timeout] | <code>Number</code> | <code>30000</code> | The timeout to wait (ms). |
+
+**Example**  
+```js
+await mobile.element.waitToBePresent(".input01");
+```
+**Example**  
+```js
+await mobile.element.waitToBePresent("#button12");
+```
+**Example**  
+```js
+await mobile.element.waitToBePresent("p:first-child");
+```
+<a name="mobile.element.waitToBeVisible"></a>
+
+#### element.waitToBeVisible(selector, [timeout])
+Waits until the element with the given selector is visible.
+
+**Kind**: static method of [<code>element</code>](#mobile.element)  
+
+| Param | Type | Default | Description |
+| --- | --- | --- | --- |
+| selector | <code>Object</code> |  | The CSS selector describing the element. |
+| [timeout] | <code>Number</code> | <code>30000</code> | The timeout to wait (ms). |
+
+**Example**  
+```js
+await mobile.element.waitToBeVisible(".input01");
+```
+**Example**  
+```js
+await mobile.element.waitToBeVisible("#button12");
+```
+**Example**  
+```js
+await mobile.element.waitToBeVisible("p:first-child");
+```
+<a name="mobile.element.waitToBeClickable"></a>
+
+#### element.waitToBeClickable(selector, [timeout])
+Waits until the element with the given selector is clickable.
+
+**Kind**: static method of [<code>element</code>](#mobile.element)  
+
+| Param | Type | Default | Description |
+| --- | --- | --- | --- |
+| selector | <code>Object</code> |  | The CSS selector describing the element. |
+| [timeout] | <code>Number</code> | <code>30000</code> | The timeout to wait (ms). |
+
+**Example**  
+```js
+await mobile.element.waitToBeClickable(".input01");
+```
+**Example**  
+```js
+await mobile.element.waitToBeClickable("#button12");
+```
+**Example**  
+```js
+await mobile.element.waitToBeClickable("p:first-child");
+```
+<a name="mobile.element.isSelected"></a>
+
+#### element.isSelected(elem) ⇒ <code>boolean</code>
+Returns a boolean if the element (e.g. checkbox) is selected.
+
+**Kind**: static method of [<code>element</code>](#mobile.element)  
+
+| Param | Type | Description |
+| --- | --- | --- |
+| elem | <code>Object</code> | The element. |
+
+**Example**  
+```js
+const elem = await mobile.element.getById("elem01");
+const isSelected = await mobile.element.isSelected(elem);
+```
+<a name="mobile.gestures"></a>
+
+### mobile.gestures
+**Kind**: static class of [<code>mobile</code>](#mobile)  
+<a name="mobile.gestures.waitToBeClickable"></a>
+
+#### gestures.waitToBeClickable(startX, startY, endX, endY, duration) ⇒ <code>Promise.&lt;void&gt;</code>
+Swipe from one point to another on the screen.
+
+**Kind**: static method of [<code>gestures</code>](#mobile.gestures)  
+
+| Param | Type | Description |
+| --- | --- | --- |
+| startX | <code>number</code> | The starting X coordinate of the swipe |
+| startY | <code>number</code> | The starting Y coordinate of the swipe |
+| endX | <code>number</code> | The ending X coordinate of the swipe |
+| endY | <code>number</code> | The ending Y coordinate of the swipe |
+| duration | <code>number</code> | The duration of the swipe in milliseconds (optional, default is 1000ms) |
+
+<a name="mobile.ios"></a>
+
+### mobile.ios
+**Kind**: static class of [<code>mobile</code>](#mobile)  
+<a name="mobile.userInteraction"></a>
+
+### mobile.userInteraction
+**Kind**: static class of [<code>mobile</code>](#mobile)  
+
+* [.userInteraction](#mobile.userInteraction)
+    * [.tap(element, [timeout])](#mobile.userInteraction.tap)
+    * [.check(element)](#mobile.userInteraction.check)
+
+<a name="mobile.userInteraction.tap"></a>
+
+#### userInteraction.tap(element, [timeout])
+Tap's on the mobile element.
+
+**Kind**: static method of [<code>userInteraction</code>](#mobile.userInteraction)  
+
+| Param | Type | Default | Description |
+| --- | --- | --- | --- |
+| element | <code>Element</code> \| <code>string</code> |  | The element or CSS selector describing the element. |
+| [timeout] | <code>Number</code> | <code>30000</code> | The timeout to wait (ms). |
+
+**Example**  
+```js
+const elem = await mobile.userInteraction.tap(elem);
+```
+<a name="mobile.userInteraction.check"></a>
+
+#### userInteraction.check(element)
+Checks the given checkbox.
+
+**Kind**: static method of [<code>userInteraction</code>](#mobile.userInteraction)  
+
+| Param | Type | Description |
+| --- | --- | --- |
+| element | <code>Element</code> | The element or CSS selector describing the element. |
+
+**Example**  
+```js
+await mobile.userInteraction.check(selector);
+```

package/lib/index.js

@@ -9,6 +9,7 @@ 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 isBrowserDefined_1 = require("./scripts/hooks/utils/isBrowserDefined");
 const pj = require("../package.json");
 module.exports = class CustomWorkerService {
     /**
@@ -57,9 +58,11 @@ module.exports = class CustomWorkerService {
     // @ts-ignore
     async beforeSession(config, capabilities, specs) {
         try {
-            browser.config = config;
+            if ((0, isBrowserDefined_1.isBrowserDefined)()) {
+                browser.config = config;
+            }
             await (0, beforeSession_1.default)(config, capabilities, specs);
-            this.config = browser.config;
+            this.config = config;
         }
         catch (e) {
             if (specs && specs[0]) {

package/lib/index.js.map

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

package/lib/reuse/helper/elementResolving.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.resolveCssSelectorOrElement = void 0;
+exports.resolveCssSelectorOrElement = resolveCssSelectorOrElement;
 async function resolveCssSelectorOrElement(elementOrSelector) {
     if (!elementOrSelector) {
         throw new Error("Please provide an element or a CSS selector as first argument.");
@@ -12,5 +12,4 @@ async function resolveCssSelectorOrElement(elementOrSelector) {
         return elementOrSelector;
     }
 }
-exports.resolveCssSelectorOrElement = resolveCssSelectorOrElement;
 //# sourceMappingURL=elementResolving.js.map

package/lib/reuse/helper/elementResolving.js.map

@@ -1 +1 @@
-{"version":3,"file":"elementResolving.js","sourceRoot":"","sources":["../../../src/reuse/helper/elementResolving.ts"],"names":[],"mappings":";;;AAEO,KAAK,UAAU,2BAA2B,CAAC,iBAAmC;IACnF,IAAI,CAAC,iBAAiB,EAAE,CAAC;QACvB,MAAM,IAAI,KAAK,CAAC,gEAAgE,CAAC,CAAC;IACpF,CAAC;IAED,IAAI,OAAO,iBAAiB,KAAK,QAAQ,EAAE,CAAC;QAC1C,OAAO,MAAM,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAC,CAAC;IAC1D,CAAC;SAAM,CAAC;QACN,OAAO,iBAAiB,CAAC;IAC3B,CAAC;AACH,CAAC;AAVD,kEAUC"}
+{"version":3,"file":"elementResolving.js","sourceRoot":"","sources":["../../../src/reuse/helper/elementResolving.ts"],"names":[],"mappings":";;AAEA,kEAUC;AAVM,KAAK,UAAU,2BAA2B,CAAC,iBAAmC;IACnF,IAAI,CAAC,iBAAiB,EAAE,CAAC;QACvB,MAAM,IAAI,KAAK,CAAC,gEAAgE,CAAC,CAAC;IACpF,CAAC;IAED,IAAI,OAAO,iBAAiB,KAAK,QAAQ,EAAE,CAAC;QAC1C,OAAO,MAAM,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAC,CAAC;IAC1D,CAAC;SAAM,CAAC;QACN,OAAO,iBAAiB,CAAC;IAC3B,CAAC;AACH,CAAC"}

package/lib/reuse/helper/inputValidation.js

@@ -1,10 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.validateValue = void 0;
+exports.validateValue = validateValue;
 function validateValue(value) {
     if (typeof value !== "string" && typeof value !== "number") {
         throw new Error("value is invalid. It must be of type 'string' or 'number'");
     }
 }
-exports.validateValue = validateValue;
 //# sourceMappingURL=inputValidation.js.map

package/lib/reuse/helper/inputValidation.js.map

@@ -1 +1 @@
-{"version":3,"file":"inputValidation.js","sourceRoot":"","sources":["../../../src/reuse/helper/inputValidation.ts"],"names":[],"mappings":";;;AAAA,SAAgB,aAAa,CAAC,KAAU;IACtC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC3D,MAAM,IAAI,KAAK,CAAC,2DAA2D,CAAC,CAAC;IAC/E,CAAC;AACH,CAAC;AAJD,sCAIC"}
+{"version":3,"file":"inputValidation.js","sourceRoot":"","sources":["../../../src/reuse/helper/inputValidation.ts"],"names":[],"mappings":";;AAAA,sCAIC;AAJD,SAAgB,aAAa,CAAC,KAAU;IACtC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC3D,MAAM,IAAI,KAAK,CAAC,2DAA2D,CAAC,CAAC;IAC/E,CAAC;AACH,CAAC"}

package/lib/reuse/index.js

@@ -11,6 +11,7 @@ const Common_1 = __importDefault(require("./modules/common/Common"));
 const Ui5_1 = __importDefault(require("./modules/ui5/Ui5"));
 const NonUi5_1 = __importDefault(require("./modules/nonUi5/NonUi5"));
 const Service_1 = __importDefault(require("./modules/service/Service"));
+const Mobile_1 = __importDefault(require("./modules/mobile/Mobile"));
 // data
 const authenticators_json_1 = __importDefault(require("./data/authenticators.json"));
 class ReuseLibrary {
@@ -44,7 +45,8 @@ class ReuseLibrary {
             formatter: Util_1.default.formatter,
             function: Util_1.default.function,
             system: Util_1.default.system,
-            component: Util_1.default.component
+            component: Util_1.default.component,
+            userSettings: Util_1.default.userSettings
         };
         global.util = {
             ...util,
@@ -103,6 +105,22 @@ class ReuseLibrary {
             ...service,
             ...global.service
         };
+        /**
+         * @global
+         * @description Global namespace for mobile modules.
+         */
+        const mobile = {
+            element: Mobile_1.default.element,
+            userInteraction: Mobile_1.default.userInteraction,
+            gestures: Mobile_1.default.gestures,
+            device: Mobile_1.default.device,
+            android: Mobile_1.default.android,
+            ios: Mobile_1.default.ios
+        };
+        global.mobile = {
+            ...mobile,
+            ...global.mobile
+        };
     }
 }
 exports.default = new ReuseLibrary();

package/lib/reuse/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/reuse/index.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;;;;;AAEb,YAAY;AACZ,4CAAsC;AAEtC,UAAU;AACV,+DAA4C;AAC5C,qEAAkD;AAClD,4DAAyC;AACzC,qEAAkD;AAClD,wEAAqD;AAErD,OAAO;AACP,qFAAwD;AAExD,MAAM,YAAY;IAChB,IAAI;QACF,mBAAmB;QACnB,aAAa;QACb,MAAM,CAAC,GAAG,GAAG,YAAG,CAAC;QAEjB;;;WAGG;QACH,MAAM,MAAM,GAAG;YACb,SAAS,EAAE,gBAAW,CAAC,SAAS;YAChC,IAAI,EAAE,gBAAW,CAAC,IAAI;YACtB,UAAU,EAAE,gBAAW,CAAC,UAAU;YAClC,eAAe,EAAE,gBAAW,CAAC,eAAe;SAC7C,CAAC;QACF,MAAM,CAAC,MAAM,GAAG;YACd,GAAG,MAAM;YACT,GAAG,MAAM,CAAC,MAAM;SACjB,CAAC;QAEF;;;WAGG;QACH,MAAM,IAAI,GAAG;YACX,OAAO,EAAE,cAAS,CAAC,OAAO;YAC1B,OAAO,EAAE,cAAS,CAAC,OAAO;YAC1B,IAAI,EAAE,cAAS,CAAC,IAAI;YACpB,IAAI,EAAE,cAAS,CAAC,IAAI;YACpB,SAAS,EAAE,cAAS,CAAC,SAAS;YAC9B,QAAQ,EAAE,cAAS,CAAC,QAAQ;YAC5B,MAAM,EAAE,cAAS,CAAC,MAAM;YACxB,SAAS,EAAE,cAAS,CAAC,SAAS;SAC/B,CAAC;QACF,MAAM,CAAC,IAAI,GAAG;YACZ,GAAG,IAAI;YACP,GAAG,MAAM,CAAC,IAAI;SACf,CAAC;QAEF;;;WAGG;QACH,MAAM,GAAG,GAAG;YACV,SAAS,EAAE,aAAQ,CAAC,SAAS;YAC7B,kBAAkB,EAAE,aAAQ,CAAC,kBAAkB;YAC/C,OAAO,EAAE,aAAQ,CAAC,OAAO;YACzB,IAAI,EAAE,aAAQ,CAAC,IAAI;YACnB,WAAW,EAAE,aAAQ,CAAC,WAAW;YACjC,OAAO,EAAE,aAAQ,CAAC,OAAO;YACzB,SAAS,EAAE,aAAQ,CAAC,SAAS;YAC7B,UAAU,EAAE,aAAQ,CAAC,UAAU;YAC/B,UAAU,EAAE,aAAQ,CAAC,UAAU;YAC/B,aAAa,EAAE,aAAQ,CAAC,aAAa;YACrC,OAAO,EAAE,aAAQ,CAAC,OAAO;YACzB,KAAK,EAAE,aAAQ,CAAC,KAAK;YACrB,eAAe,EAAE,aAAQ,CAAC,eAAe;YACzC,KAAK,EAAE,aAAQ,CAAC,KAAK;YACrB,OAAO;YACP,cAAc,EAAd,6BAAc;SACf,CAAC;QACF,MAAM,CAAC,GAAG,GAAG;YACX,GAAG,GAAG;YACN,GAAG,MAAM,CAAC,GAAG;SACd,CAAC;QAEF;;;WAGG;QACH,MAAM,MAAM,GAAG;YACb,SAAS,EAAE,gBAAW,CAAC,SAAS;YAChC,OAAO,EAAE,gBAAW,CAAC,OAAO;YAC5B,UAAU,EAAE,gBAAW,CAAC,UAAU;YAClC,eAAe,EAAE,gBAAW,CAAC,eAAe;YAC5C,OAAO,EAAE,gBAAW,CAAC,OAAO;SAC7B,CAAC;QACF,MAAM,CAAC,MAAM,GAAG;YACd,GAAG,MAAM;YACT,GAAG,MAAM,CAAC,MAAM;SACjB,CAAC;QAEF;;;WAGG;QACH,MAAM,OAAO,GAAG;YACd,KAAK,EAAE,iBAAY,CAAC,KAAK;YACzB,IAAI,EAAE,iBAAY,CAAC,IAAI;SACxB,CAAC;QACF,MAAM,CAAC,OAAO,GAAG;YACf,GAAG,OAAO;YACV,GAAG,MAAM,CAAC,OAAO;SAClB,CAAC;IACJ,CAAC;CACF;AAED,kBAAe,IAAI,YAAY,EAAE,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/reuse/index.ts"],"names":[],"mappings":"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"}

package/lib/reuse/modules/common/date.d.ts

@@ -76,7 +76,7 @@ export declare class DateModule {
      * @description Calculates the date based on the input parameter and returns it in the given format.
      * @param {String} [date="today"] - Supported values: today, tomorrow, nextMonth, previousMonth, nextYear, previousYear
      * @param {String} [format="object"] - The expected format ("mm/dd/yyyy", "dd.mm.yyyy", "dd/mm/yyyy", "yyyymmdd", "yyyy/mm/dd", "mmm dd, yyyy", "mmm d, yyyy", "datetime", "object").
-     * @returns {String} The calculated date in the given format.
+     * @returns {String | Date} The calculated date in the given format.
      * @example const date = await common.date.calculate("today", "mm/dd/yyyy");
      */
     calculate(date?: CalculateDatesType, format?: DateFormatsType): Date | string;

package/lib/reuse/modules/common/date.js

@@ -21,7 +21,7 @@ class DateModule {
      * @returns {String} The date in the given format.
      * @example const date = await common.date.getToday("mm/dd/yyyy");
      */
-    getToday(format = formatter_constants_1.DateFormats.OBJECT) {
+    getToday(format = process.env.USER_SETTINGS_DATE_FORMAT ? process.env.USER_SETTINGS_DATE_FORMAT : formatter_constants_1.DateFormats.OBJECT) {
         const vl = this.vlf.initLog(this.getToday);
         const date = new Date();
         vl.log(date.toISOString());
@@ -35,7 +35,7 @@ class DateModule {
      * @returns {String} The date in the given format.
      * @example const date = await common.date.getTomorrow("mm/dd/yyyy");
      */
-    getTomorrow(format = formatter_constants_1.DateFormats.OBJECT) {
+    getTomorrow(format = process.env.USER_SETTINGS_DATE_FORMAT ? process.env.USER_SETTINGS_DATE_FORMAT : formatter_constants_1.DateFormats.OBJECT) {
         const vl = this.vlf.initLog(this.getTomorrow);
         const date = new Date();
         date.setDate(date.getDate() + 1);
@@ -50,7 +50,7 @@ class DateModule {
      * @returns {String} The date in the given format.
      * @example const date = await common.date.getNextMonth("mm/dd/yyyy");
      */
-    getNextMonth(format = formatter_constants_1.DateFormats.OBJECT) {
+    getNextMonth(format = process.env.USER_SETTINGS_DATE_FORMAT ? process.env.USER_SETTINGS_DATE_FORMAT : formatter_constants_1.DateFormats.OBJECT) {
         const vl = this.vlf.initLog(this.getTomorrow);
         const date = new Date();
         date.setMonth(date.getMonth() + 1);
@@ -65,7 +65,7 @@ class DateModule {
      * @returns {String} The date in the given format.
      * @example const date = await common.date.getPreviousMonth("mm/dd/yyyy");
      */
-    getPreviousMonth(format = formatter_constants_1.DateFormats.OBJECT) {
+    getPreviousMonth(format = process.env.USER_SETTINGS_DATE_FORMAT ? process.env.USER_SETTINGS_DATE_FORMAT : formatter_constants_1.DateFormats.OBJECT) {
         const vl = this.vlf.initLog(this.getPreviousMonth);
         const date = new Date();
         date.setMonth(date.getMonth() - 1);
@@ -80,7 +80,7 @@ class DateModule {
      * @returns {String} The date in the given format.
      * @example const date = await common.date.getNextYear("mm/dd/yyyy");
      */
-    getNextYear(format = formatter_constants_1.DateFormats.OBJECT) {
+    getNextYear(format = process.env.USER_SETTINGS_DATE_FORMAT ? process.env.USER_SETTINGS_DATE_FORMAT : formatter_constants_1.DateFormats.OBJECT) {
         const vl = this.vlf.initLog(this.getNextYear);
         const date = new Date();
         date.setFullYear(date.getFullYear() + 1);
@@ -95,7 +95,7 @@ class DateModule {
      * @returns {String} The date in the given format.
      * @example const date = await common.date.getPreviousYear("mm/dd/yyyy");
      */
-    getPreviousYear(format = formatter_constants_1.DateFormats.OBJECT) {
+    getPreviousYear(format = process.env.USER_SETTINGS_DATE_FORMAT ? process.env.USER_SETTINGS_DATE_FORMAT : formatter_constants_1.DateFormats.OBJECT) {
         const vl = this.vlf.initLog(this.getPreviousYear);
         const date = new Date();
         date.setFullYear(date.getFullYear() - 1);
@@ -111,7 +111,7 @@ class DateModule {
      * @returns {String} The date in the given format.
      * @example const date = await common.date.getSpecific("2020, 0, 17", "mm/dd/yyyy");
      */
-    getSpecific(date, format = formatter_constants_1.DateFormats.OBJECT) {
+    getSpecific(date, format = process.env.USER_SETTINGS_DATE_FORMAT ? process.env.USER_SETTINGS_DATE_FORMAT : formatter_constants_1.DateFormats.OBJECT) {
         const vl = this.vlf.initLog(this.getSpecific);
         if (!date) {
             throw new Error("Function 'getSpecific' failed: Please provide a date string ('2020, 0, 17') as first argument.");
@@ -127,10 +127,10 @@ class DateModule {
      * @description Calculates the date based on the input parameter and returns it in the given format.
      * @param {String} [date="today"] - Supported values: today, tomorrow, nextMonth, previousMonth, nextYear, previousYear
      * @param {String} [format="object"] - The expected format ("mm/dd/yyyy", "dd.mm.yyyy", "dd/mm/yyyy", "yyyymmdd", "yyyy/mm/dd", "mmm dd, yyyy", "mmm d, yyyy", "datetime", "object").
-     * @returns {String} The calculated date in the given format.
+     * @returns {String | Date} The calculated date in the given format.
      * @example const date = await common.date.calculate("today", "mm/dd/yyyy");
      */
-    calculate(date = date_constants_1.CalculateDates.TODAY, format = formatter_constants_1.DateFormats.OBJECT) {
+    calculate(date = date_constants_1.CalculateDates.TODAY, format = process.env.USER_SETTINGS_DATE_FORMAT ? process.env.USER_SETTINGS_DATE_FORMAT : formatter_constants_1.DateFormats.OBJECT) {
         const vl = this.vlf.initLog(this.calculate);
         if (date === null) {
             date = date_constants_1.CalculateDates.TODAY;