askui 0.2.0 → 0.2.1

package/README.md

@@ -45,8 +45,8 @@ Visit our [documentation](https://docs.askui.com) for examples and a full list o
 ### Notes
 
 Important note for Linux users: Currently, Wayland is not supported.
-You can read more in our [troubleshooting chapter](https://docs.askui.com/docs/general/Troubleshooting/askui-ui-controller-starting-problems#wayland).
-If you want to use the askui library libfuse2 is needed ([libfuse2 installation](https://docs.askui.com/docs/general/Troubleshooting/askui-ui-controller-starting-problems#libfuse2)).
+You can read more in our [troubleshooting chapter](https://docs.askui.com/docs/general/Troubleshooting/askui-ui-controller#wayland).
+If you want to use the askui library libfuse2 is needed ([libfuse2 installation](https://docs.askui.com/docs/general/Troubleshooting/askui-ui-controller#libfuse2)).
 
 ## Example
 

package/bin/askui-postinstall

@@ -0,0 +1,35 @@
+#!/usr/bin/env node
+
+const { access } = require('fs/promises');
+const { join } = require('path');
+
+async function shouldBeExecuted() {
+  try {
+    await access(join(__dirname, '../.no-askui-postinstall'));
+  } catch (err) {
+    if (err.code === 'ENOENT') {
+      return true;
+    }
+    // eslint-disable-next-line no-console
+    console.error(err);
+  }
+  return false;
+}
+
+async function createInstallationTimestamp() {
+  try {
+    const { InstallationTimestamp } = require('../dist/cjs/utils/analytics/installation-timestamp');
+    InstallationTimestamp.create();
+  } catch (err) {
+    // eslint-disable-next-line no-console
+    console.error(err);
+  }
+}
+
+async function main() {
+  if (await shouldBeExecuted()) {
+    await createInstallationTimestamp();
+  }
+}
+
+main();

package/dist/cjs/core/model/test-case-dto/index.js

@@ -1,7 +1,5 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.TestStep = exports.CustomElement = void 0;
+exports.CustomElement = void 0;
 var custom_element_1 = require("./custom-element");
 Object.defineProperty(exports, "CustomElement", { enumerable: true, get: function () { return custom_element_1.CustomElement; } });
-var test_step_1 = require("./test-step");
-Object.defineProperty(exports, "TestStep", { enumerable: true, get: function () { return test_step_1.TestStep; } });

package/dist/cjs/core/model/test-case-dto/test-step.d.ts

@@ -1,10 +1,6 @@
 import { CustomElement } from './custom-element';
-import { CustomElementJson } from './custom-element-json';
-export declare class TestStep {
+export interface TestStep {
     instruction: string;
-    customElements: CustomElement[];
-    constructor(instruction: string, customElements?: CustomElement[]);
-    static fromJson(step: TestStep & {
-        customElements: CustomElementJson[];
-    }): TestStep;
+    customElements?: CustomElement[];
+    secretText?: string | undefined;
 }

package/dist/cjs/core/model/test-case-dto/test-step.js

@@ -1,14 +1,2 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.TestStep = void 0;
-const custom_element_1 = require("./custom-element");
-class TestStep {
-    constructor(instruction, customElements = []) {
-        this.instruction = instruction;
-        this.customElements = customElements;
-    }
-    static fromJson(step) {
-        return new TestStep(step.instruction, (step.customElements || []).map((customELement) => custom_element_1.CustomElement.fromJson(customELement)));
-    }
-}
-exports.TestStep = TestStep;

package/dist/cjs/core/ui-control-commands/control-command.d.ts

@@ -6,4 +6,5 @@ export declare class ControlCommand {
     tryToRepeat: boolean;
     constructor(code: ControlCommandCode, actions: Action[], tryToRepeat?: boolean);
     static fromJson(json: ControlCommand, resizeRatio?: number): ControlCommand;
+    setTextToBeTyped(text: string): void;
 }

package/dist/cjs/core/ui-control-commands/control-command.js

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.ControlCommand = void 0;
 const action_1 = require("./action");
 const control_command_code_1 = require("./control-command-code");
+const input_event_1 = require("./input-event");
 class ControlCommand {
     constructor(code, actions, tryToRepeat = false) {
         this.code = code;
@@ -12,5 +13,9 @@ class ControlCommand {
     static fromJson(json, resizeRatio = 1) {
         return new ControlCommand(control_command_code_1.ControlCommandCode[json.code], json.actions.map((action) => action_1.Action.fromJson(action, resizeRatio)), json.tryToRepeat);
     }
+    setTextToBeTyped(text) {
+        this.actions = this.actions.map((action) => ([input_event_1.InputEvent.TYPE, input_event_1.InputEvent.TYPE_TEXT].includes(action.inputEvent)
+            ? new action_1.Action(action.inputEvent, action.position, text) : action));
+    }
 }
 exports.ControlCommand = ControlCommand;

package/dist/cjs/core/ui-control-commands/input-event.d.ts

@@ -16,6 +16,5 @@ export declare enum InputEvent {
     MOUSE_MOVE = "MOUSE_MOVE",
     MOUSE_DOWN = "MOUSE_DOWN",
     MOUSE_UP = "MOUSE_UP",
-    EXECUTE_COMMAND = "EXECUTE_COMMAND",
-    WAIT = "WAIT"
+    EXECUTE_COMMAND = "EXECUTE_COMMAND"
 }

package/dist/cjs/core/ui-control-commands/input-event.js

@@ -21,5 +21,4 @@ var InputEvent;
     InputEvent["MOUSE_DOWN"] = "MOUSE_DOWN";
     InputEvent["MOUSE_UP"] = "MOUSE_UP";
     InputEvent["EXECUTE_COMMAND"] = "EXECUTE_COMMAND";
-    InputEvent["WAIT"] = "WAIT";
 })(InputEvent = exports.InputEvent || (exports.InputEvent = {}));

package/dist/cjs/execution/execution-runtime.d.ts

@@ -8,6 +8,7 @@ export declare class ExecutionRuntime {
     private inferenceClient;
     constructor(uiControllerClient: UiControllerClient, inferenceClient: InferenceClient);
     executeTestStep(step: TestStep): Promise<void>;
+    private requestControl;
     /**
      * @param {TestStep} step - Test step used for predicting command.
      */
@@ -20,6 +21,7 @@ export declare class ExecutionRuntime {
      * --> retry with linear back-off
      */
     private predictCommandWithRetry;
+    private getImageIfRequired;
     private predictCommand;
     annotateInteractively(): Promise<void>;
     takeScreenshotIfImageisNotProvided(imagePath?: string): Promise<string>;

package/dist/cjs/execution/execution-runtime.js

@@ -30,6 +30,11 @@ class ExecutionRuntime {
             yield this.executeCommand(step);
         });
     }
+    requestControl(controlCommand) {
+        return __awaiter(this, void 0, void 0, function* () {
+            yield this.uiControllerClient.requestControl(controlCommand);
+        });
+    }
     /**
      * @param {TestStep} step - Test step used for predicting command.
      */
@@ -38,15 +43,13 @@ class ExecutionRuntime {
         return __awaiter(this, void 0, void 0, function* () {
             const controlCommand = yield this.predictCommandWithRetry(step);
             if (controlCommand.code === ui_control_commands_1.ControlCommandCode.OK) {
-                yield this.uiControllerClient.requestControl(controlCommand);
+                return this.requestControl(controlCommand);
             }
-            else if (controlCommand.tryToRepeat) {
-                yield this.uiControllerClient.requestControl(controlCommand);
-                this.executeCommandRepeatedly(step);
-            }
-            else {
-                throw new control_command_error_1.ControlCommandError(((_a = controlCommand.actions[0]) === null || _a === void 0 ? void 0 : _a.text) || '');
+            if (controlCommand.tryToRepeat) {
+                yield this.requestControl(controlCommand);
+                return this.executeCommandRepeatedly(step);
             }
+            throw new control_command_error_1.ControlCommandError(((_a = controlCommand.actions[0]) === null || _a === void 0 ? void 0 : _a.text) || '');
         });
     }
     executeCommandRepeatedly(step) {
@@ -63,8 +66,8 @@ class ExecutionRuntime {
                 if (controlCommand.code === ui_control_commands_1.ControlCommandCode.OK) {
                     break;
                 }
-                else if (controlCommand.tryToRepeat) {
-                    yield this.uiControllerClient.requestControl(controlCommand);
+                if (controlCommand.tryToRepeat) {
+                    yield this.requestControl(controlCommand);
                 }
                 else {
                     throw new control_command_error_1.ControlCommandError(((_a = controlCommand.actions[0]) === null || _a === void 0 ? void 0 : _a.text) || '');
@@ -94,15 +97,24 @@ class ExecutionRuntime {
             return command;
         });
     }
+    getImageIfRequired(instruction) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const isImageRequired = yield this.inferenceClient.isImageRequired(instruction);
+            if (!isImageRequired) {
+                return undefined;
+            }
+            const screenshotResponse = yield this.uiControllerClient.requestScreenshot();
+            return screenshotResponse.data.image;
+        });
+    }
     predictCommand(step) {
         return __awaiter(this, void 0, void 0, function* () {
-            const isImageRequired = yield this.inferenceClient.isImageRequired(step.instruction);
-            let image;
-            if (isImageRequired) {
-                const screenshotResponse = yield this.uiControllerClient.requestScreenshot();
-                image = screenshotResponse.data.image;
+            const image = yield this.getImageIfRequired(step.instruction);
+            const controlCommand = yield this.inferenceClient.predictControlCommand(step.instruction, step.customElements, image);
+            if (step.secretText !== undefined) {
+                controlCommand.setTextToBeTyped(step.secretText);
             }
-            return this.inferenceClient.predictControlCommand(step.instruction, step.customElements, image);
+            return controlCommand;
         });
     }
     annotateInteractively() {

package/dist/cjs/execution/inference-client.d.ts

@@ -8,6 +8,6 @@ export declare class InferenceClient {
     constructor(url: string, httpClient: HttpClientGot);
     isImageRequired(instruction: string): Promise<boolean>;
     private resizeIfNeeded;
-    predictControlCommand(instruction: string, customElements: CustomElement[], image?: string): Promise<ControlCommand>;
+    predictControlCommand(instruction: string, customElements?: CustomElement[], image?: string): Promise<ControlCommand>;
     predictImageAnnotation(image: string, customElements?: CustomElement[]): Promise<Annotation>;
 }

package/dist/cjs/execution/inference-client.js

@@ -41,7 +41,7 @@ class InferenceClient {
             return (0, transformations_1.resizeBase64ImageWithSameRatio)(image);
         });
     }
-    predictControlCommand(instruction, customElements, image) {
+    predictControlCommand(instruction, customElements = [], image) {
         return __awaiter(this, void 0, void 0, function* () {
             const resizedImage = yield this.resizeIfNeeded(customElements, image);
             const httpBody = {

package/dist/cjs/execution/ui-control-client.d.ts

@@ -1,5 +1,5 @@
 import { CustomElementJson } from '../core/model/test-case-dto';
-import { Executable, FluentCommand } from './dsl';
+import { Exec, Executable, FluentCommand, FluentFilters } from './dsl';
 import { UiControllerClientConnectionState } from './ui-controller-client-connection-state';
 import { Annotation } from '../core/annotation/annotation';
 import { AnnotationRequest } from '../core/model/annotation-result/annotation-interface';
@@ -18,6 +18,51 @@ export declare class UiControlClient extends FluentCommand {
     annotate(annotationRequest?: AnnotationRequest): Promise<Annotation>;
     annotateInteractively(): Promise<void>;
     exec(instruction: string, customElementJson?: CustomElementJson[]): Promise<void>;
+    private secretText;
+    /**
+     * Types a text inside the filtered element.
+     *
+     * By default, the `text` is included in the logs and sent over to the askui Inference server to
+     * predict in which context the typing has to occur. You can exclude the `text` from the logs
+     * and the request to the askui Inference server setting `options.isSecret` to `true`.
+     * This should not change the quality of the prediction of the askui Inference server. In this
+     * case, `options.secretMask` is included in logs and sent over instead of the `text`.
+     *
+     * @param {string} text - A text to type.
+     * @param {Object} [options]
+     * @param {boolean} [options.isSecret = false] - If set to `true`, `text` is neither included in
+     *   logs of askui nor sent over to askui Inference for prediction.
+     * @param {string} [options.secretMask = '****'] - If `options.isSecret` is set to `true`, this
+     *   is included in logs and sent over to askui Inference for prediction instead of the `text`.
+     *
+     * @return {FluentFilters}
+     */
+    typeIn(text: string, { isSecret, secretMask }?: {
+        isSecret?: boolean | undefined;
+        secretMask?: string | undefined;
+    }): FluentFilters;
+    /**
+     * Types a text at the current position.
+     *
+     * By default, the `text` is included in the logs and sent over to the askui Inference server to
+     * predict in which context the typing has to occur. You can exclude the `text` from the logs
+     * and the request to the askui Inference server setting `options.isSecret` to `true`.
+     * This should not change the quality of the prediction of the askui Inference server. In this
+     * case, `options.secretMask` is included in logs and sent over instead of the `text`.
+     *
+     * @param {string} text - A text to type.
+     * @param {Object} options
+     * @param {boolean} [options.isSecret = false] - If set to `true`, `text` is neither included in
+     *   logs of askui nor sent over to askui Inference for prediction.
+     * @param {string} [options.secretMask = '****'] - If `options.isSecret` is set to `true`, this
+     *   is included in logs and sent over to askui Inference for prediction instead of the `text`.
+     *
+     * @return {Exec}
+     */
+    type(text: string, { isSecret, secretMask }?: {
+        isSecret?: boolean | undefined;
+        secretMask?: string | undefined;
+    }): Exec;
     /**
      * Waits for `<delayInMs>` ms, e.g., 1000 ms. The exact delay may be a little longer
      * than `<delayInMs>` but never shorter than that.

package/dist/cjs/execution/ui-control-client.js

@@ -29,6 +29,7 @@ class UiControlClient extends dsl_1.FluentCommand {
         super();
         this.httpClient = httpClient;
         this.clientArgs = clientArgs;
+        this.secretText = undefined;
     }
     static build(clientArgs) {
         return __awaiter(this, void 0, void 0, function* () {
@@ -88,16 +89,15 @@ class UiControlClient extends dsl_1.FluentCommand {
             }
         });
     }
-    exec(instruction, customElementJson) {
+    exec(instruction, customElementJson = []) {
         return __awaiter(this, void 0, void 0, function* () {
-            let customElements = [];
-            if (customElementJson !== undefined) {
-                customElements = yield test_case_dto_1.CustomElement.fromJsonListWithImagePathOrImage(customElementJson);
-            }
+            const customElements = yield test_case_dto_1.CustomElement.fromJsonListWithImagePathOrImage(customElementJson);
+            const { secretText } = this;
             try {
                 yield this.executionRuntime.executeTestStep({
                     instruction,
                     customElements,
+                    secretText,
                 });
                 yield this.annotateByDefault(test_case_result_dto_1.TestStepState.PASSED, customElements);
                 return yield Promise.resolve();
@@ -108,6 +108,56 @@ class UiControlClient extends dsl_1.FluentCommand {
             }
         });
     }
+    /**
+     * Types a text inside the filtered element.
+     *
+     * By default, the `text` is included in the logs and sent over to the askui Inference server to
+     * predict in which context the typing has to occur. You can exclude the `text` from the logs
+     * and the request to the askui Inference server setting `options.isSecret` to `true`.
+     * This should not change the quality of the prediction of the askui Inference server. In this
+     * case, `options.secretMask` is included in logs and sent over instead of the `text`.
+     *
+     * @param {string} text - A text to type.
+     * @param {Object} [options]
+     * @param {boolean} [options.isSecret = false] - If set to `true`, `text` is neither included in
+     *   logs of askui nor sent over to askui Inference for prediction.
+     * @param {string} [options.secretMask = '****'] - If `options.isSecret` is set to `true`, this
+     *   is included in logs and sent over to askui Inference for prediction instead of the `text`.
+     *
+     * @return {FluentFilters}
+     */
+    typeIn(text, { isSecret = false, secretMask = '****' } = {}) {
+        if (isSecret) {
+            this.secretText = text;
+            return super.typeIn(secretMask);
+        }
+        return super.typeIn(text);
+    }
+    /**
+     * Types a text at the current position.
+     *
+     * By default, the `text` is included in the logs and sent over to the askui Inference server to
+     * predict in which context the typing has to occur. You can exclude the `text` from the logs
+     * and the request to the askui Inference server setting `options.isSecret` to `true`.
+     * This should not change the quality of the prediction of the askui Inference server. In this
+     * case, `options.secretMask` is included in logs and sent over instead of the `text`.
+     *
+     * @param {string} text - A text to type.
+     * @param {Object} options
+     * @param {boolean} [options.isSecret = false] - If set to `true`, `text` is neither included in
+     *   logs of askui nor sent over to askui Inference for prediction.
+     * @param {string} [options.secretMask = '****'] - If `options.isSecret` is set to `true`, this
+     *   is included in logs and sent over to askui Inference for prediction instead of the `text`.
+     *
+     * @return {Exec}
+     */
+    type(text, { isSecret = false, secretMask = '****' } = {}) {
+        if (isSecret) {
+            this.secretText = text;
+            return super.type(secretMask);
+        }
+        return super.type(text);
+    }
     /**
      * Waits for `<delayInMs>` ms, e.g., 1000 ms. The exact delay may be a little longer
      * than `<delayInMs>` but never shorter than that.

package/dist/cjs/lib/copy-example-project.js

@@ -7,6 +7,7 @@ exports.init = void 0;
 const commander_1 = require("commander");
 const path_1 = __importDefault(require("path"));
 const fs_extra_1 = __importDefault(require("fs-extra"));
+const path_2 = require("../utils/path");
 const createProgram = () => {
     const program = new commander_1.Command('askui');
     program.usage('<command> [options]');
@@ -14,7 +15,7 @@ const createProgram = () => {
 };
 function copyExampleProject() {
     const exampleProjectPath = path_1.default.join('example_projects_templates', 'typescript_jest');
-    fs_extra_1.default.copySync(path_1.default.join(__dirname, '..', '..', exampleProjectPath), '.');
+    fs_extra_1.default.copySync(path_1.default.join((0, path_2.getPathToNodeModulesRoot)(), exampleProjectPath), '.');
 }
 function init(argv) {
     const args = argv || process.argv;

package/dist/cjs/lib/download-binaries.js

@@ -8,6 +8,7 @@ const fs_1 = __importDefault(require("fs"));
 const got_1 = __importDefault(require("got"));
 const os_1 = __importDefault(require("os"));
 const path_1 = __importDefault(require("path"));
+const path_2 = require("../utils/path");
 const logger_1 = require("./logger");
 var SupportedPlatform;
 (function (SupportedPlatform) {
@@ -35,7 +36,7 @@ function buildBinaryNotAvailbleError(binaryVersion) {
     return new Error(`It seems that the UI Controller version "${binaryVersion}" for your system "${platform()} ${os_1.default.arch}" is not availble, Please contact as at info@askui.com for more information`);
 }
 function getBinaryPath(version) {
-    return path_1.default.join(__dirname, '..', '..', 'release', version, ...binarySubPathsByPlatform[platform()]);
+    return path_1.default.join((0, path_2.getPathToNodeModulesRoot)(), 'release', version, ...binarySubPathsByPlatform[platform()]);
 }
 exports.getBinaryPath = getBinaryPath;
 function getBinaryDownloadUrl(binaryVersion) {

package/dist/cjs/lib/ui-controller-linux.js

@@ -27,7 +27,7 @@ class UiControllerLinux extends ui_controller_facade_1.UiControllerFacade {
             const runCommand = (0, util_1.promisify)(child_process_1.exec);
             const waylandStatus = yield runCommand('echo $WAYLAND_DISPLAY');
             if (waylandStatus.stdout.trim().includes('wayland')) {
-                throw new wayland_error_1.WaylandError('Wayland is not supported: https://docs.askui.com/docs/general/Troubleshooting/askui-ui-controller-starting-problems#wayland');
+                throw new wayland_error_1.WaylandError('Wayland is not supported: https://docs.askui.com/docs/general/Troubleshooting/askui-ui-controller#wayland');
             }
             /* First we want to check if the user is using a debian distribution.
             * and in the following if libfuse2 is installed.
@@ -44,7 +44,7 @@ class UiControllerLinux extends ui_controller_facade_1.UiControllerFacade {
                 yield runCommand('dpkg -s libfuse2 | grep Status');
             }
             catch (_a) {
-                throw new libfuse_error_1.LibfuseError('Libfuse2 package is missing: https://docs.askui.com/docs/general/Troubleshooting/askui-ui-controller-starting-problems#libfuse2');
+                throw new libfuse_error_1.LibfuseError('Libfuse2 package is missing: https://docs.askui.com/docs/general/Troubleshooting/askui-ui-controller#libfuse2');
             }
         });
     }

package/dist/cjs/utils/analytics/analytics.js

@@ -15,6 +15,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.Analytics = void 0;
 const os_1 = __importDefault(require("os"));
 const user_identifier_1 = require("./user-identifier");
+const installation_timestamp_1 = require("./installation-timestamp");
 class Analytics {
     constructor() {
         this.userIdentifier = new user_identifier_1.UserIdentifier();
@@ -22,10 +23,15 @@ class Analytics {
     getAnalyticsHeaders() {
         return __awaiter(this, void 0, void 0, function* () {
             const userID = yield this.userIdentifier.userId();
-            return {
+            const headers = {
                 'askui-user-id': userID,
                 'askui-user-agent': `os:${os_1.default.platform()};arch:${os_1.default.arch()}`,
             };
+            const askuiInstalledAt = yield installation_timestamp_1.InstallationTimestamp.get();
+            if (askuiInstalledAt) {
+                headers['askui-installed-at'] = askuiInstalledAt.toISOString();
+            }
+            return headers;
         });
     }
 }

package/dist/cjs/utils/analytics/installation-timestamp-create-error.d.ts

@@ -0,0 +1,4 @@
+/// <reference types="node" />
+export declare class InstallationTimestampCreateError extends Error {
+    constructor(err: NodeJS.ErrnoException);
+}

package/dist/cjs/utils/analytics/installation-timestamp-create-error.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InstallationTimestampCreateError = void 0;
+class InstallationTimestampCreateError extends Error {
+    constructor(err) {
+        super(`Installation timestamp could not be created. \n${err.message}`);
+    }
+}
+exports.InstallationTimestampCreateError = InstallationTimestampCreateError;

package/dist/cjs/utils/analytics/installation-timestamp-get-error.d.ts

@@ -0,0 +1,4 @@
+/// <reference types="node" />
+export declare class InstallationTimestampGetError extends Error {
+    constructor(err: NodeJS.ErrnoException);
+}

package/dist/cjs/utils/analytics/installation-timestamp-get-error.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InstallationTimestampGetError = void 0;
+class InstallationTimestampGetError extends Error {
+    constructor(err) {
+        super(`Installation timestamp does not exist. Try reinstalling the lib to create it. \n${err.message}`);
+    }
+}
+exports.InstallationTimestampGetError = InstallationTimestampGetError;

package/dist/cjs/utils/analytics/installation-timestamp.d.ts

@@ -0,0 +1,7 @@
+export declare abstract class InstallationTimestamp {
+    private static fileName;
+    private static value?;
+    static create(): Promise<void>;
+    static get(): Promise<Date | null>;
+    private static getFromFile;
+}

package/dist/cjs/utils/analytics/installation-timestamp.js

@@ -0,0 +1,68 @@
+"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 });
+exports.InstallationTimestamp = void 0;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const lib_1 = require("../../lib");
+const installation_timestamp_create_error_1 = require("./installation-timestamp-create-error");
+const installation_timestamp_get_error_1 = require("./installation-timestamp-get-error");
+const path_2 = require("../path");
+class InstallationTimestamp {
+    static create() {
+        return __awaiter(this, void 0, void 0, function* () {
+            const timestamp = new Date().toISOString();
+            return new Promise((resolve, reject) => {
+                fs_1.default.writeFile(InstallationTimestamp.fileName, timestamp, { encoding: 'utf-8' }, (err) => {
+                    if (err) {
+                        reject(new installation_timestamp_create_error_1.InstallationTimestampCreateError(err));
+                    }
+                    else {
+                        resolve();
+                    }
+                });
+            });
+        });
+    }
+    static get() {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (InstallationTimestamp.value === undefined) {
+                try {
+                    InstallationTimestamp.value = yield this.getFromFile();
+                }
+                catch (err) {
+                    InstallationTimestamp.value = null;
+                    lib_1.logger.warn(err.message);
+                }
+            }
+            return InstallationTimestamp.value;
+        });
+    }
+    static getFromFile() {
+        return __awaiter(this, void 0, void 0, function* () {
+            return new Promise((resolve, reject) => {
+                fs_1.default.readFile(InstallationTimestamp.fileName, 'utf-8', (err, isoDateStr) => {
+                    if (err) {
+                        reject(new installation_timestamp_get_error_1.InstallationTimestampGetError(err));
+                    }
+                    else {
+                        resolve(new Date(isoDateStr));
+                    }
+                });
+            });
+        });
+    }
+}
+exports.InstallationTimestamp = InstallationTimestamp;
+InstallationTimestamp.fileName = path_1.default.join((0, path_2.getPathToNodeModulesRoot)(), 'install-timestamp');

package/dist/cjs/utils/path.d.ts

@@ -0,0 +1 @@
+export declare function getPathToNodeModulesRoot(): string;

package/dist/cjs/utils/path.js

@@ -0,0 +1,11 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getPathToNodeModulesRoot = void 0;
+const path_1 = __importDefault(require("path"));
+function getPathToNodeModulesRoot() {
+    return path_1.default.join(__dirname, '..', '..');
+}
+exports.getPathToNodeModulesRoot = getPathToNodeModulesRoot;

package/dist/esm/core/model/test-case-dto/index.js

@@ -1,2 +1 @@
 export { CustomElement } from './custom-element';
-export { TestStep } from './test-step';

package/dist/esm/core/model/test-case-dto/test-step.d.ts

@@ -1,10 +1,6 @@
 import { CustomElement } from './custom-element';
-import { CustomElementJson } from './custom-element-json';
-export declare class TestStep {
+export interface TestStep {
     instruction: string;
-    customElements: CustomElement[];
-    constructor(instruction: string, customElements?: CustomElement[]);
-    static fromJson(step: TestStep & {
-        customElements: CustomElementJson[];
-    }): TestStep;
+    customElements?: CustomElement[];
+    secretText?: string | undefined;
 }

package/dist/esm/core/model/test-case-dto/test-step.js

@@ -1,10 +1 @@
-import { CustomElement } from './custom-element';
-export class TestStep {
-    constructor(instruction, customElements = []) {
-        this.instruction = instruction;
-        this.customElements = customElements;
-    }
-    static fromJson(step) {
-        return new TestStep(step.instruction, (step.customElements || []).map((customELement) => CustomElement.fromJson(customELement)));
-    }
-}
+export {};

package/dist/esm/core/ui-control-commands/control-command.d.ts

@@ -6,4 +6,5 @@ export declare class ControlCommand {
     tryToRepeat: boolean;
     constructor(code: ControlCommandCode, actions: Action[], tryToRepeat?: boolean);
     static fromJson(json: ControlCommand, resizeRatio?: number): ControlCommand;
+    setTextToBeTyped(text: string): void;
 }