@perforce-perfecto/scriptless-helpers 1.46.3 → 1.47.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@perforce-perfecto/scriptless-helpers",
-  "version": "1.46.3",
+  "version": "1.47.1",
   "type": "commonjs",
   "main": "./src/index.js",
   "types": "./src/index.d.ts",
@@ -9,7 +9,8 @@
     "webdriverio": "^9.21.0",
     "lodash": "^4.17.21",
     "axios": "^1.12.2",
-    "jsonpointer": "^5.0.1"
+    "jsonpointer": "^5.0.1",
+    "file-type": "^21.0.0"
   },
   "publishConfig": {
     "access": "public"

package/src/index.d.ts

@@ -1,8 +1,33 @@
+export * from './lib/action-arguments-helper';
+export * from './lib/action-result-helper';
+export * from './lib/constants-helper';
 export * from './lib/counter-helper';
+export * from './lib/custom-error';
+export * from './lib/data-table-helper';
+export * from './lib/element-helper';
+export * from './lib/exit-execution-helper';
+export * from './lib/file-transfer-helper';
+export * from './lib/handset-open-helper';
+export * from './lib/handset-select-helper';
+export * from './lib/handset-variable-helper';
 export * from './lib/http-request-helper';
 export * from './lib/integer-helper';
 export * from './lib/json-pointer-helper';
 export * from './lib/message-helper';
+export * from './lib/parameter-helper';
+export * from './lib/perfecto-execute-script-helper';
+export * from './lib/script-info-helper';
+export * from './lib/secured-variable-helper';
+export * from './lib/test-end-status-helper';
 export * from './lib/text-helper';
 export * from './lib/timer-helper';
+export * from './lib/touch-drag-helper';
+export * from './lib/variable-attribute-checkpoint-helper';
 export * from './lib/webdriver-session-helper';
+export * from './types/active-script-function-data';
+export * from './types/scriptless-helper';
+export * from './types/logger';
+export * from './types/data-table';
+export * from './types/user-defined-variables';
+export * from './types/desired-device-capabilities';
+export * from './types/perfecto-device-capabilities';

package/src/index.js

@@ -1,12 +1,37 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 const tslib_1 = require("tslib");
+tslib_1.__exportStar(require("./lib/action-arguments-helper"), exports);
+tslib_1.__exportStar(require("./lib/action-result-helper"), exports);
+tslib_1.__exportStar(require("./lib/constants-helper"), exports);
 tslib_1.__exportStar(require("./lib/counter-helper"), exports);
+tslib_1.__exportStar(require("./lib/custom-error"), exports);
+tslib_1.__exportStar(require("./lib/data-table-helper"), exports);
+tslib_1.__exportStar(require("./lib/element-helper"), exports);
+tslib_1.__exportStar(require("./lib/exit-execution-helper"), exports);
+tslib_1.__exportStar(require("./lib/file-transfer-helper"), exports);
+tslib_1.__exportStar(require("./lib/handset-open-helper"), exports);
+tslib_1.__exportStar(require("./lib/handset-select-helper"), exports);
+tslib_1.__exportStar(require("./lib/handset-variable-helper"), exports);
 tslib_1.__exportStar(require("./lib/http-request-helper"), exports);
 tslib_1.__exportStar(require("./lib/integer-helper"), exports);
 tslib_1.__exportStar(require("./lib/json-pointer-helper"), exports);
 tslib_1.__exportStar(require("./lib/message-helper"), exports);
+tslib_1.__exportStar(require("./lib/parameter-helper"), exports);
+tslib_1.__exportStar(require("./lib/perfecto-execute-script-helper"), exports);
+tslib_1.__exportStar(require("./lib/script-info-helper"), exports);
+tslib_1.__exportStar(require("./lib/secured-variable-helper"), exports);
+tslib_1.__exportStar(require("./lib/test-end-status-helper"), exports);
 tslib_1.__exportStar(require("./lib/text-helper"), exports);
 tslib_1.__exportStar(require("./lib/timer-helper"), exports);
+tslib_1.__exportStar(require("./lib/touch-drag-helper"), exports);
+tslib_1.__exportStar(require("./lib/variable-attribute-checkpoint-helper"), exports);
 tslib_1.__exportStar(require("./lib/webdriver-session-helper"), exports);
+tslib_1.__exportStar(require("./types/active-script-function-data"), exports);
+tslib_1.__exportStar(require("./types/scriptless-helper"), exports);
+tslib_1.__exportStar(require("./types/logger"), exports);
+tslib_1.__exportStar(require("./types/data-table"), exports);
+tslib_1.__exportStar(require("./types/user-defined-variables"), exports);
+tslib_1.__exportStar(require("./types/desired-device-capabilities"), exports);
+tslib_1.__exportStar(require("./types/perfecto-device-capabilities"), exports);
 //# sourceMappingURL=index.js.map

package/src/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../libs/execution-helpers-public/src/index.ts"],"names":[],"mappings":";;;AAAA,+DAAqC;AACrC,oEAA0C;AAC1C,+DAAqC;AACrC,oEAA0C;AAC1C,+DAAqC;AACrC,4DAAkC;AAClC,6DAAmC;AACnC,yEAA+C"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../libs/execution-helpers-public/src/index.ts"],"names":[],"mappings":";;;AAAA,wEAA8C;AAC9C,qEAA2C;AAC3C,iEAAuC;AACvC,+DAAqC;AACrC,6DAAmC;AACnC,kEAAwC;AACxC,+DAAqC;AACrC,sEAA4C;AAC5C,qEAA2C;AAC3C,oEAA0C;AAC1C,sEAA4C;AAC5C,wEAA8C;AAC9C,oEAA0C;AAC1C,+DAAqC;AACrC,oEAA0C;AAC1C,+DAAqC;AACrC,iEAAuC;AACvC,+EAAqD;AACrD,mEAAyC;AACzC,wEAA8C;AAC9C,uEAA6C;AAC7C,4DAAkC;AAClC,6DAAmC;AACnC,kEAAwC;AACxC,qFAA2D;AAC3D,yEAA+C;AAE/C,8EAAoD;AACpD,oEAA0C;AAC1C,yDAA+B;AAC/B,6DAAmC;AACnC,yEAA+C;AAC/C,8EAAoD;AACpD,+EAAqD"}

package/src/lib/action-arguments-helper.d.ts

@@ -0,0 +1,36 @@
+import { SecuredVariableHelper } from './secured-variable-helper';
+import { DesiredDeviceCapability } from '../types/desired-device-capabilities';
+import { ProcessedDataTableCell } from '../types/data-table';
+import { UserDefinedVariable } from '../types/user-defined-variables';
+import { ScriptlessHelper } from '../types/scriptless-helper';
+import { Logger } from '../types/logger';
+declare enum CommandParameterAttribute {
+    SENSITIVE = "SENSITIVE",
+    HIDDEN = "HIDDEN"
+}
+type ConstantActionArgument = {
+    argumentName?: string;
+    dataSource: 'CONSTANT';
+    data: string | boolean | undefined;
+    secured?: boolean;
+};
+type VariableActionArgument = {
+    argumentName?: string;
+    dataSource: 'VARIABLE';
+    data: UserDefinedVariable;
+};
+type DataTableActionArgument = {
+    argumentName?: string;
+    dataSource: 'DATATABLE';
+    data: ProcessedDataTableCell;
+};
+export type ActionArgument = ConstantActionArgument | VariableActionArgument | DataTableActionArgument;
+export declare class ActionArgumentsHelper extends ScriptlessHelper {
+    protected securedVariableHelper: SecuredVariableHelper;
+    constructor(securedVariableHelper: SecuredVariableHelper, logger?: Logger);
+    extractAndValidateActionArgumentValue(actionArgument: ActionArgument): string | number | boolean | undefined;
+    extractActionArgumentKeyOrValueAsFallback(actionArgument: ActionArgument): string | number | boolean | DesiredDeviceCapability | undefined;
+    fetchActionArgumentForReporting(actionArgument: ActionArgument): string | number | boolean | DesiredDeviceCapability | undefined;
+    extractSensitiveCommandParameterAttribute(actionArgument: ActionArgument): CommandParameterAttribute.SENSITIVE | undefined;
+}
+export {};

package/src/lib/action-arguments-helper.js

@@ -0,0 +1,60 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ActionArgumentsHelper = void 0;
+const scriptless_helper_1 = require("../types/scriptless-helper");
+var CommandParameterAttribute;
+(function (CommandParameterAttribute) {
+    CommandParameterAttribute["SENSITIVE"] = "SENSITIVE";
+    CommandParameterAttribute["HIDDEN"] = "HIDDEN";
+})(CommandParameterAttribute || (CommandParameterAttribute = {}));
+class ActionArgumentsHelper extends scriptless_helper_1.ScriptlessHelper {
+    constructor(securedVariableHelper, logger) {
+        super(logger);
+        this.securedVariableHelper = securedVariableHelper;
+    }
+    extractAndValidateActionArgumentValue(actionArgument) {
+        let argumentValue;
+        if (actionArgument.dataSource === 'CONSTANT') {
+            if (actionArgument.secured) {
+                argumentValue = this.securedVariableHelper.decryptSecuredString(actionArgument.data);
+            }
+            else {
+                argumentValue = actionArgument.data;
+            }
+        }
+        else if (actionArgument.dataSource === 'VARIABLE' ||
+            actionArgument.dataSource === 'DATATABLE') {
+            argumentValue = actionArgument.data.value;
+        }
+        return argumentValue;
+    }
+    extractActionArgumentKeyOrValueAsFallback(actionArgument) {
+        var _a;
+        if (actionArgument.dataSource === 'CONSTANT') {
+            return actionArgument.data;
+        }
+        return (_a = actionArgument.data.key) !== null && _a !== void 0 ? _a : actionArgument.data.value;
+    }
+    fetchActionArgumentForReporting(actionArgument) {
+        // While reporting 'Device ID' we send deviceId for device
+        if (((actionArgument.dataSource === 'VARIABLE' &&
+            actionArgument.data['@type'] === 'HandsetData') ||
+            (actionArgument.dataSource === 'DATATABLE' &&
+                actionArgument.data['@type'] === 'HANDSET')) &&
+            actionArgument.data.key) {
+            return actionArgument.data.key.deviceId;
+        }
+        return this.extractActionArgumentKeyOrValueAsFallback(actionArgument);
+    }
+    extractSensitiveCommandParameterAttribute(actionArgument) {
+        if ((actionArgument.dataSource === 'CONSTANT' && actionArgument.secured) ||
+            (actionArgument.dataSource === 'VARIABLE' &&
+                actionArgument.data.secured) ||
+            (actionArgument.dataSource === 'DATATABLE' && actionArgument.data.secured)) {
+            return CommandParameterAttribute.SENSITIVE;
+        }
+        return;
+    }
+}
+exports.ActionArgumentsHelper = ActionArgumentsHelper;
+//# sourceMappingURL=action-arguments-helper.js.map

package/src/lib/action-arguments-helper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"action-arguments-helper.js","sourceRoot":"","sources":["../../../../../libs/execution-helpers-public/src/lib/action-arguments-helper.ts"],"names":[],"mappings":";;;AAIA,kEAA8D;AAG9D,IAAK,yBAGJ;AAHD,WAAK,yBAAyB;IAC5B,oDAAuB,CAAA;IACvB,8CAAiB,CAAA;AACnB,CAAC,EAHI,yBAAyB,KAAzB,yBAAyB,QAG7B;AA0BD,MAAa,qBAAsB,SAAQ,oCAAgB;IACzD,YACY,qBAA4C,EACtD,MAAe;QAEf,KAAK,CAAC,MAAM,CAAC,CAAC;QAHJ,0BAAqB,GAArB,qBAAqB,CAAuB;IAIxD,CAAC;IAED,qCAAqC,CAAC,cAA8B;QAClE,IAAI,aAAa,CAAC;QAClB,IAAI,cAAc,CAAC,UAAU,KAAK,UAAU,EAAE,CAAC;YAC7C,IAAI,cAAc,CAAC,OAAO,EAAE,CAAC;gBAC3B,aAAa,GAAG,IAAI,CAAC,qBAAqB,CAAC,oBAAoB,CAC7D,cAAc,CAAC,IAAc,CAC9B,CAAC;YACJ,CAAC;iBAAM,CAAC;gBACN,aAAa,GAAG,cAAc,CAAC,IAAI,CAAC;YACtC,CAAC;QACH,CAAC;aAAM,IACL,cAAc,CAAC,UAAU,KAAK,UAAU;YACxC,cAAc,CAAC,UAAU,KAAK,WAAW,EACzC,CAAC;YACD,aAAa,GAAG,cAAc,CAAC,IAAI,CAAC,KAAK,CAAC;QAC5C,CAAC;QACD,OAAO,aAAa,CAAC;IACvB,CAAC;IAED,yCAAyC,CAAC,cAA8B;;QACtE,IAAI,cAAc,CAAC,UAAU,KAAK,UAAU,EAAE,CAAC;YAC7C,OAAO,cAAc,CAAC,IAAI,CAAC;QAC7B,CAAC;QACD,OAAO,MAAA,cAAc,CAAC,IAAI,CAAC,GAAG,mCAAI,cAAc,CAAC,IAAI,CAAC,KAAK,CAAC;IAC9D,CAAC;IAED,+BAA+B,CAAC,cAA8B;QAC5D,0DAA0D;QAC1D,IACE,CAAC,CAAC,cAAc,CAAC,UAAU,KAAK,UAAU;YACxC,cAAc,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,aAAa,CAAC;YAC/C,CAAC,cAAc,CAAC,UAAU,KAAK,WAAW;gBACxC,cAAc,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,SAAS,CAAC,CAAC;YAChD,cAAc,CAAC,IAAI,CAAC,GAAG,EACvB,CAAC;YACD,OAAQ,cAAc,CAAC,IAAI,CAAC,GAA+B,CAAC,QAAQ,CAAC;QACvE,CAAC;QACD,OAAO,IAAI,CAAC,yCAAyC,CAAC,cAAc,CAAC,CAAC;IACxE,CAAC;IAED,yCAAyC,CAAC,cAA8B;QACtE,IACE,CAAC,cAAc,CAAC,UAAU,KAAK,UAAU,IAAI,cAAc,CAAC,OAAO,CAAC;YACpE,CAAC,cAAc,CAAC,UAAU,KAAK,UAAU;gBACvC,cAAc,CAAC,IAAI,CAAC,OAAO,CAAC;YAC9B,CAAC,cAAc,CAAC,UAAU,KAAK,WAAW,IAAI,cAAc,CAAC,IAAI,CAAC,OAAO,CAAC,EAC1E,CAAC;YACD,OAAO,yBAAyB,CAAC,SAAS,CAAC;QAC7C,CAAC;QACD,OAAO;IACT,CAAC;CACF;AA3DD,sDA2DC"}

package/src/lib/action-result-helper.d.ts

@@ -0,0 +1,8 @@
+import { ScriptlessHelper } from '../types/scriptless-helper';
+import { ActiveScriptFunctionData } from '../types/active-script-function-data';
+import { PerfectoExecuteScriptHelper } from './perfecto-execute-script-helper';
+export declare class ActionResultHelper extends ScriptlessHelper {
+    perfectoExecuteScriptHelper: PerfectoExecuteScriptHelper;
+    convertActionResultToMap(actionResult: string): Map<string, string>;
+    isActiveScriptFunctionSuccess(activeScriptFunctionData: ActiveScriptFunctionData): boolean;
+}

package/src/lib/action-result-helper.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ActionResultHelper = void 0;
+const scriptless_helper_1 = require("../types/scriptless-helper");
+const perfecto_execute_script_helper_1 = require("./perfecto-execute-script-helper");
+class ActionResultHelper extends scriptless_helper_1.ScriptlessHelper {
+    constructor() {
+        super(...arguments);
+        this.perfectoExecuteScriptHelper = new perfecto_execute_script_helper_1.PerfectoExecuteScriptHelper();
+    }
+    convertActionResultToMap(actionResult) {
+        const actionResultMap = new Map();
+        const pairs = actionResult
+            .substring(1, actionResult.length - 1)
+            .split(', ');
+        for (const pair of pairs) {
+            const [key, value] = pair.split('=');
+            actionResultMap.set(key, value);
+        }
+        return actionResultMap;
+    }
+    isActiveScriptFunctionSuccess(activeScriptFunctionData) {
+        return (!activeScriptFunctionData.actionError &&
+            !this.perfectoExecuteScriptHelper.isExecuteScriptResultFailed(activeScriptFunctionData.actionResult));
+    }
+}
+exports.ActionResultHelper = ActionResultHelper;
+//# sourceMappingURL=action-result-helper.js.map

package/src/lib/action-result-helper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"action-result-helper.js","sourceRoot":"","sources":["../../../../../libs/execution-helpers-public/src/lib/action-result-helper.ts"],"names":[],"mappings":";;;AAAA,kEAA8D;AAE9D,qFAA+E;AAE/E,MAAa,kBAAmB,SAAQ,oCAAgB;IAAxD;;QACE,gCAA2B,GAAG,IAAI,4DAA2B,EAAE,CAAC;IAwBlE,CAAC;IAvBC,wBAAwB,CAAC,YAAoB;QAC3C,MAAM,eAAe,GAAG,IAAI,GAAG,EAAkB,CAAC;QAClD,MAAM,KAAK,GAAG,YAAY;aACvB,SAAS,CAAC,CAAC,EAAE,YAAY,CAAC,MAAM,GAAG,CAAC,CAAC;aACrC,KAAK,CAAC,IAAI,CAAC,CAAC;QAEf,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YACrC,eAAe,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QAClC,CAAC;QACD,OAAO,eAAe,CAAC;IACzB,CAAC;IAED,6BAA6B,CAC3B,wBAAkD;QAElD,OAAO,CACL,CAAC,wBAAwB,CAAC,WAAW;YACrC,CAAC,IAAI,CAAC,2BAA2B,CAAC,2BAA2B,CAC3D,wBAAwB,CAAC,YAAY,CACtC,CACF,CAAC;IACJ,CAAC;CACF;AAzBD,gDAyBC"}

package/src/lib/constants-helper.d.ts

@@ -0,0 +1,10 @@
+export declare class ConstantsHelper {
+    private static readonly TENANT_ID_SUFFIX;
+    static getTenantId(): string;
+    static getShortTenantId(): string;
+    static getPerfectoAuthHeaders(): Record<string, string>;
+    static getExecutedByUserEmail(): string;
+    static getExecutionReportiumUrl(): string;
+    static setAppiumServer(): string;
+    static getSecurityToken(): string;
+}

package/src/lib/constants-helper.js

@@ -0,0 +1,43 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConstantsHelper = void 0;
+class ConstantsHelper {
+    static getTenantId() {
+        if (!process.env['TENANT_ID']) {
+            throw new Error('Tenant ID is not set');
+        }
+        return process.env['TENANT_ID'];
+    }
+    static getShortTenantId() {
+        return this.getTenantId().replace(ConstantsHelper.TENANT_ID_SUFFIX, '');
+    }
+    static getPerfectoAuthHeaders() {
+        return process.env['PERFECTO_AUTH_HEADERS']
+            ? JSON.parse(process.env['PERFECTO_AUTH_HEADERS'])
+            : {};
+    }
+    static getExecutedByUserEmail() {
+        if (!process.env['EXECUTED_BY_USER_EMAIL']) {
+            throw new Error('Executed by user email is not set');
+        }
+        return process.env['EXECUTED_BY_USER_EMAIL'];
+    }
+    static getExecutionReportiumUrl() {
+        if (!process.env['EXECUTION_REPORTIUM_URL']) {
+            throw new Error('Reportium URL is not set');
+        }
+        return process.env['EXECUTION_REPORTIUM_URL'];
+    }
+    static setAppiumServer() {
+        return `https://${ConstantsHelper.getShortTenantId()}.perfectomobile.com/nexperience/perfectomobile/wd/hub`;
+    }
+    static getSecurityToken() {
+        if (!process.env['SECURITY_TOKEN']) {
+            throw new Error('Security token is not set');
+        }
+        return process.env['SECURITY_TOKEN'];
+    }
+}
+exports.ConstantsHelper = ConstantsHelper;
+ConstantsHelper.TENANT_ID_SUFFIX = '-perfectomobile-com';
+//# sourceMappingURL=constants-helper.js.map

package/src/lib/constants-helper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants-helper.js","sourceRoot":"","sources":["../../../../../libs/execution-helpers-public/src/lib/constants-helper.ts"],"names":[],"mappings":";;;AAAA,MAAa,eAAe;IAG1B,MAAM,CAAC,WAAW;QAChB,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE,CAAC;YAC9B,MAAM,IAAI,KAAK,CAAC,sBAAsB,CAAC,CAAC;QAC1C,CAAC;QACD,OAAO,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;IAClC,CAAC;IAED,MAAM,CAAC,gBAAgB;QACrB,OAAO,IAAI,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,eAAe,CAAC,gBAAgB,EAAE,EAAE,CAAC,CAAC;IAC1E,CAAC;IAED,MAAM,CAAC,sBAAsB;QAC3B,OAAO,OAAO,CAAC,GAAG,CAAC,uBAAuB,CAAC;YACzC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,uBAAuB,CAAC,CAAC;YAClD,CAAC,CAAC,EAAE,CAAC;IACT,CAAC;IAED,MAAM,CAAC,sBAAsB;QAC3B,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,wBAAwB,CAAC,EAAE,CAAC;YAC3C,MAAM,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAC;QACvD,CAAC;QACD,OAAO,OAAO,CAAC,GAAG,CAAC,wBAAwB,CAAC,CAAC;IAC/C,CAAC;IAED,MAAM,CAAC,wBAAwB;QAC7B,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,yBAAyB,CAAC,EAAE,CAAC;YAC5C,MAAM,IAAI,KAAK,CAAC,0BAA0B,CAAC,CAAC;QAC9C,CAAC;QACD,OAAO,OAAO,CAAC,GAAG,CAAC,yBAAyB,CAAC,CAAC;IAChD,CAAC;IAED,MAAM,CAAC,eAAe;QACpB,OAAO,WAAW,eAAe,CAAC,gBAAgB,EAAE,uDAAuD,CAAC;IAC9G,CAAC;IAED,MAAM,CAAC,gBAAgB;QACrB,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,EAAE,CAAC;YACnC,MAAM,IAAI,KAAK,CAAC,2BAA2B,CAAC,CAAC;QAC/C,CAAC;QACD,OAAO,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;IACvC,CAAC;;AA3CH,0CA4CC;AA3CyB,gCAAgB,GAAG,qBAAqB,CAAC"}

package/src/lib/custom-error.d.ts

@@ -0,0 +1,5 @@
+import { TimerData } from './timer-helper';
+export declare class CustomError extends Error {
+    readonly scriptTimer?: TimerData;
+    constructor(name: string, message: string, stack?: string, scriptTimer?: TimerData);
+}

package/src/lib/custom-error.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CustomError = void 0;
+class CustomError extends Error {
+    constructor(name, message, stack, scriptTimer) {
+        super(message);
+        this.name = name || this.name;
+        this.message = message;
+        this.stack = stack || this.stack;
+        this.scriptTimer = scriptTimer;
+    }
+}
+exports.CustomError = CustomError;
+//# sourceMappingURL=custom-error.js.map

package/src/lib/custom-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"custom-error.js","sourceRoot":"","sources":["../../../../../libs/execution-helpers-public/src/lib/custom-error.ts"],"names":[],"mappings":";;;AAEA,MAAa,WAAY,SAAQ,KAAK;IAGpC,YACE,IAAY,EACZ,OAAe,EACf,KAAc,EACd,WAAuB;QAEvB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,IAAI,IAAI,IAAI,CAAC,IAAI,CAAC;QAC9B,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,KAAK,GAAG,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC;QACjC,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;IACjC,CAAC;CACF;AAfD,kCAeC"}

package/src/lib/data-table-helper.d.ts

@@ -0,0 +1,17 @@
+import { ProcessedDataTable } from '../types/data-table';
+import { Logger } from '../types/logger';
+import { ScriptlessHelper } from '../types/scriptless-helper';
+import { SecuredVariableHelper } from './secured-variable-helper';
+export declare class DataTableHelper extends ScriptlessHelper {
+    private securedVariableHelper;
+    private handsetVariableHelper;
+    constructor(securedVariableHelper: SecuredVariableHelper, logger?: Logger);
+    generateTableData(dataTableKey: string): Promise<ProcessedDataTable>;
+    private processValue;
+    private processKey;
+    private replaceSecuredPrefix;
+    private isSecuredString;
+    private getDataTable;
+    private getDataTableUrl;
+    private getNativeAutomationServiceBaseUrl;
+}

package/src/lib/data-table-helper.js

@@ -0,0 +1,88 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DataTableHelper = void 0;
+const tslib_1 = require("tslib");
+const axios_1 = tslib_1.__importDefault(require("axios"));
+const scriptless_helper_1 = require("../types/scriptless-helper");
+const constants_helper_1 = require("./constants-helper");
+const handset_variable_helper_1 = require("./handset-variable-helper");
+class DataTableHelper extends scriptless_helper_1.ScriptlessHelper {
+    /*
+     * * IMPORTANT NOTE **
+     * The securedVariableHelper must always be taken as an argument to the constructor
+     * This is to ensure that the SecuredVariableInternalHelper is passed from execution-helpers (private).
+     */
+    constructor(securedVariableHelper, logger) {
+        super(logger);
+        this.securedVariableHelper = securedVariableHelper;
+        this.handsetVariableHelper = new handset_variable_helper_1.HandsetVariableHelper(logger);
+    }
+    generateTableData(dataTableKey) {
+        return tslib_1.__awaiter(this, void 0, void 0, function* () {
+            if (!dataTableKey) {
+                return [];
+            }
+            const dataTable = yield this.getDataTable(dataTableKey, constants_helper_1.ConstantsHelper.getShortTenantId(), constants_helper_1.ConstantsHelper.getPerfectoAuthHeaders());
+            const processedDataTable = dataTable.elementsData.map((row) => {
+                const obj = {};
+                dataTable.columns.forEach((col, index) => {
+                    obj[`${col.name}`] = {
+                        '@type': col.type,
+                        secured: this.isSecuredString(row[index]),
+                        value: this.processValue(col.type, row[index]),
+                        key: this.processKey(col.type, row[index])
+                    };
+                });
+                return obj;
+            });
+            return processedDataTable;
+        });
+    }
+    processValue(type, value) {
+        if (type === 'INTEGER') {
+            return Number(value);
+        }
+        else if (type === 'STRING') {
+            if (this.isSecuredString(value)) {
+                return this.securedVariableHelper.decryptSecuredString(this.replaceSecuredPrefix(value));
+            }
+            return value;
+        }
+        else if (type === 'HANDSET') {
+            return;
+        }
+        return value;
+    }
+    processKey(type, value) {
+        if (type === 'HANDSET') {
+            return this.handsetVariableHelper.handsetKeyToDeviceCapability(value);
+        }
+        else if (type === 'STRING' && this.isSecuredString(value)) {
+            return this.replaceSecuredPrefix(value);
+        }
+        return;
+    }
+    replaceSecuredPrefix(value) {
+        return value.replace('secured.', '');
+    }
+    isSecuredString(value) {
+        return value.startsWith('secured.');
+    }
+    getDataTable(dataTableKey, tenantName, authHeaders) {
+        return tslib_1.__awaiter(this, void 0, void 0, function* () {
+            const dataTableApiUrl = `${this.getDataTableUrl(tenantName)}?itemKey=${encodeURIComponent(dataTableKey)}`;
+            const dataTableApiResponse = yield axios_1.default.get(dataTableApiUrl, {
+                headers: authHeaders
+            });
+            return dataTableApiResponse.data.dataTable;
+        });
+    }
+    getDataTableUrl(tenantName) {
+        return `${this.getNativeAutomationServiceBaseUrl(tenantName)}/datatable`;
+    }
+    getNativeAutomationServiceBaseUrl(tenantName) {
+        return `https://${tenantName}.app.perfectomobile.com/native-automation-webapp/rest/v1/native-automation`;
+    }
+}
+exports.DataTableHelper = DataTableHelper;
+//# sourceMappingURL=data-table-helper.js.map

package/src/lib/data-table-helper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-table-helper.js","sourceRoot":"","sources":["../../../../../libs/execution-helpers-public/src/lib/data-table-helper.ts"],"names":[],"mappings":"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"}

package/src/lib/element-helper.d.ts

@@ -0,0 +1,16 @@
+import { ScriptlessHelper } from '../types/scriptless-helper';
+import { ChainablePromiseElement } from 'webdriverio';
+export declare class ElementHelper extends ScriptlessHelper {
+    generateElementIdentifier(identifyBy: string | undefined, identifier: string): string;
+    getElementProperty(element: ChainablePromiseElement, property: string): Promise<string | number | boolean | undefined>;
+    private getText;
+    private getClass;
+    private getDisabled;
+    private getHeight;
+    private getWidth;
+    private getOpaque;
+    private getVisibility;
+    private getX;
+    private getY;
+    private getDisplayed;
+}

package/src/lib/element-helper.js

@@ -0,0 +1,191 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ElementHelper = void 0;
+const tslib_1 = require("tslib");
+const scriptless_helper_1 = require("../types/scriptless-helper");
+class ElementHelper extends scriptless_helper_1.ScriptlessHelper {
+    generateElementIdentifier(identifyBy, identifier) {
+        let elementIdentifier;
+        if (identifyBy && identifyBy === 'name') {
+            elementIdentifier = `//*[@name=${identifier}]`;
+        }
+        else if (identifyBy && identifyBy === 'id') {
+            elementIdentifier = `id=${identifier}`;
+        }
+        else if (identifyBy && identifyBy === 'className') {
+            elementIdentifier = identifier;
+        }
+        else if (identifyBy && identifyBy === 'accessibilityId') {
+            elementIdentifier = `~${identifier}`;
+        }
+        else if (identifyBy && identifyBy === 'classChain') {
+            elementIdentifier = `-ios class chain:${identifier}`;
+        }
+        else if (identifyBy && identifyBy === 'uiAutomator') {
+            elementIdentifier = `android=${identifier}`;
+        }
+        else if (identifyBy && identifyBy === 'uiAutomation') {
+            elementIdentifier = `ios=${identifier}`;
+        }
+        else if (identifyBy && identifyBy === 'tagName') {
+            elementIdentifier = `<${identifier} />`;
+        }
+        else if (identifyBy && identifyBy === 'linkText') {
+            elementIdentifier = `=${identifier}`;
+        }
+        else if (identifyBy && identifyBy === 'partialLinkText') {
+            elementIdentifier = `*=${identifier}`;
+        }
+        else {
+            elementIdentifier = identifier;
+        }
+        return elementIdentifier;
+    }
+    getElementProperty(element, property) {
+        return tslib_1.__awaiter(this, void 0, void 0, function* () {
+            if (property === 'text') {
+                return yield this.getText(element);
+            }
+            else if (property === 'class') {
+                return yield this.getClass(element);
+            }
+            else if (property === 'disabled') {
+                return yield this.getDisabled(element);
+            }
+            else if (property === 'height') {
+                return yield this.getHeight(element);
+            }
+            else if (property === 'width') {
+                return yield this.getWidth(element);
+            }
+            else if (property === 'opaque') {
+                return yield this.getOpaque(element);
+            }
+            else if (property === 'visibility') {
+                return yield this.getVisibility(element);
+            }
+            else if (property === 'x') {
+                return yield this.getX(element);
+            }
+            else if (property === 'y') {
+                return yield this.getY(element);
+            }
+            else if (property === 'displayed') {
+                return yield this.getDisplayed(element);
+            }
+            return undefined;
+        });
+    }
+    getText(element) {
+        return tslib_1.__awaiter(this, void 0, void 0, function* () {
+            try {
+                const result = yield element.getText();
+                return result;
+            }
+            catch (error) {
+                return undefined;
+            }
+        });
+    }
+    getClass(element) {
+        return tslib_1.__awaiter(this, void 0, void 0, function* () {
+            try {
+                const result = yield element.getAttribute('class');
+                return result;
+            }
+            catch (error) {
+                return undefined;
+            }
+        });
+    }
+    getDisabled(element) {
+        return tslib_1.__awaiter(this, void 0, void 0, function* () {
+            try {
+                const result = !(yield element.isEnabled());
+                return result;
+            }
+            catch (error) {
+                return undefined;
+            }
+        });
+    }
+    getHeight(element) {
+        return tslib_1.__awaiter(this, void 0, void 0, function* () {
+            try {
+                const result = (yield element.getSize()).height;
+                return result;
+            }
+            catch (error) {
+                return undefined;
+            }
+        });
+    }
+    getWidth(element) {
+        return tslib_1.__awaiter(this, void 0, void 0, function* () {
+            try {
+                const result = (yield element.getSize()).width;
+                return result;
+            }
+            catch (error) {
+                return undefined;
+            }
+        });
+    }
+    getOpaque(element) {
+        return tslib_1.__awaiter(this, void 0, void 0, function* () {
+            try {
+                const result = yield element.getAttribute('opacity');
+                return result;
+            }
+            catch (error) {
+                return undefined;
+            }
+        });
+    }
+    getVisibility(element) {
+        return tslib_1.__awaiter(this, void 0, void 0, function* () {
+            try {
+                const result = yield element.isDisplayed();
+                return result;
+            }
+            catch (error) {
+                return undefined;
+            }
+        });
+    }
+    getX(element) {
+        return tslib_1.__awaiter(this, void 0, void 0, function* () {
+            try {
+                const result = (yield element.getLocation()).x;
+                return result;
+            }
+            catch (error) {
+                return undefined;
+            }
+        });
+    }
+    getY(element) {
+        return tslib_1.__awaiter(this, void 0, void 0, function* () {
+            try {
+                const result = (yield element.getLocation()).y;
+                return result;
+            }
+            catch (error) {
+                return undefined;
+            }
+        });
+    }
+    getDisplayed(element) {
+        return tslib_1.__awaiter(this, void 0, void 0, function* () {
+            try {
+                const result = yield element.isDisplayed();
+                return result;
+            }
+            catch (error) {
+                return undefined;
+            }
+        });
+    }
+}
+exports.ElementHelper = ElementHelper;
+//# sourceMappingURL=element-helper.js.map