@opentap/runner-client 4.2.0 → 4.4.0-beta.1.34231471562

package/dist/cjs/BaseClient.d.ts

@@ -1,4 +1,4 @@
-import { ConnectionOptions, Consumer, ConsumerConfig, JetStreamOptions, NatsError, PublishOptions, Subscription, SubscriptionOptions } from 'nats.ws';
+import { ConnectionOptions, Consumer, ConsumerConfig, JetStreamOptions, NatsConnection, NatsError, PublishOptions, Subscription, SubscriptionOptions } from 'nats.ws';
 import { DownloadTapSettingsRequest } from './requestDTOs';
 import { ComponentSettingsBase, ComponentSettingsIdentifier, ComponentSettingsListItem, DataGridControl, ErrorResponse, FileParameter, ListItemType, ProfileGroup, RepositoryPackageReference, RepositorySettingsPackageDefinition } from './DTOs';
 interface BaseClientRequestOptions {
@@ -12,28 +12,23 @@ interface BaseClientRequestOptions {
 }
 export declare class BaseClient {
     readonly baseSubject: string;
-    private connection;
+    private natsConnection;
     private connectionOptions;
     private domainAccess;
     private eventEmitter;
     private _accessToken;
     private _headers;
     private _timeout;
-    /** Get request access token */
+    get connection(): NatsConnection | null;
     get accessToken(): string;
-    /** Set request access token */
     set accessToken(value: string);
-    /** Get request headers */
     get headers(): {
         [key: string]: string;
     };
-    /** Set request headers */
     set headers(value: {
         [key: string]: string;
     });
-    /** Get timeout */
     get timeout(): number;
-    /** Set timeout in milliseconds. Default is 40000 milliseconds */
     set timeout(value: number);
     constructor(baseSubject: string, options: ConnectionOptions);
     private withTimeout;
@@ -44,7 +39,7 @@ export declare class BaseClient {
      * @param options (optional)
      * @returns Promise of an object
      */
-    protected request<T>(subject: string, payload?: any, options?: BaseClientRequestOptions): Promise<T>;
+    request<T>(subject: string, payload?: any, options?: BaseClientRequestOptions): Promise<T>;
     /**
      * Handle the error
      * @param error
@@ -78,7 +73,7 @@ export declare class BaseClient {
      * Create a connection to the nats server.
      * @param {ConnectionOptions} options
      */
-    connect(): Promise<void>;
+    connect(connection?: NatsConnection): Promise<void>;
     /**
      * Close the connection.
      */
@@ -258,6 +253,7 @@ export declare class BaseClient {
      * Dispatches a request with the given subject and returns a Promise of type T
      * @param subject The subject to send the request to
      * @returns Promise<T> The response from the request
+     * @deprecated Use {@link request} instead.
      */
     dispatchRequest<T>(subject: string, payload?: any, options?: BaseClientRequestOptions): Promise<T>;
 }

package/dist/cjs/BaseClient.js

@@ -52,6 +52,28 @@ var nats_ws_1 = require("nats.ws");
 var DTOs_1 = require("./DTOs");
 var events_1 = require("events");
 var uuid_1 = require("uuid");
+// A browser extension like CrowdStrike may have already replaced globalThis.WebSocket before this module loads,
+// so reading the global is unreliable. A freshly created same-origin iframe exposes the browser's
+// pristine, un-patched WebSocket; NATS traffic is pinned to it to bypass any extension shim.
+// The iframe is kept attached because a detached iframe's realm becomes unusable in some browsers.
+function getNativeWebSocket() {
+    var _a, _b, _c;
+    var globalWebSocket = typeof globalThis !== 'undefined' ? globalThis.WebSocket : undefined;
+    var doc = globalThis.document;
+    if (!doc || typeof doc.createElement !== 'function') {
+        return globalWebSocket;
+    }
+    try {
+        var iframe = doc.createElement('iframe');
+        iframe.style.display = 'none';
+        ((_a = doc.body) !== null && _a !== void 0 ? _a : doc.documentElement).appendChild(iframe);
+        return (_c = (_b = iframe.contentWindow) === null || _b === void 0 ? void 0 : _b.WebSocket) !== null && _c !== void 0 ? _c : globalWebSocket;
+    }
+    catch (_d) {
+        return globalWebSocket;
+    }
+}
+var OriginalWebSocket = getNativeWebSocket();
 var DEFAULT_TIMEOUT = 40000; // default timeout of 40 seconds
 var Events;
 (function (Events) {
@@ -64,14 +86,28 @@ var BaseClient = /** @class */ (function () {
         this.baseSubject = baseSubject;
         this.connectionOptions = __assign({}, options);
         this.connectionOptions.timeout = (options === null || options === void 0 ? void 0 : options.timeout) || DEFAULT_TIMEOUT;
+        // Force NATS to use the WebSocket captured at load time so an extension that later
+        // overrides globalThis.WebSocket cannot intercept NATS traffic. Respect a caller-provided factory.
+        // wsFactory is read by nats.ws's WsTransport at runtime but lives on WsConnectionOptions, which
+        // isn't re-exported, so it's absent from the public ConnectionOptions type and requires this cast.
+        if (OriginalWebSocket && !this.connectionOptions.wsFactory) {
+            this.connectionOptions.wsFactory = function (url) {
+                return Promise.resolve({ socket: new OriginalWebSocket(url), encrypted: url.indexOf('wss://') === 0 });
+            };
+        }
         this.eventEmitter = new events_1.EventEmitter();
     }
+    Object.defineProperty(BaseClient.prototype, "connection", {
+        get: function () {
+            return this.natsConnection;
+        },
+        enumerable: false,
+        configurable: true
+    });
     Object.defineProperty(BaseClient.prototype, "accessToken", {
-        /** Get request access token */
         get: function () {
             return this._accessToken;
         },
-        /** Set request access token */
         set: function (value) {
             this._accessToken = value;
         },
@@ -79,11 +115,9 @@ var BaseClient = /** @class */ (function () {
         configurable: true
     });
     Object.defineProperty(BaseClient.prototype, "headers", {
-        /** Get request headers */
         get: function () {
             return this._headers;
         },
-        /** Set request headers */
         set: function (value) {
             this._headers = value;
         },
@@ -91,11 +125,9 @@ var BaseClient = /** @class */ (function () {
         configurable: true
     });
     Object.defineProperty(BaseClient.prototype, "timeout", {
-        /** Get timeout */
         get: function () {
             return this._timeout || DEFAULT_TIMEOUT;
         },
-        /** Set timeout in milliseconds. Default is 40000 milliseconds */
         set: function (value) {
             this._timeout = value;
         },
@@ -127,9 +159,9 @@ var BaseClient = /** @class */ (function () {
                 if (!(options === null || options === void 0 ? void 0 : options.fullSubject)) {
                     subject = "".concat(this.baseSubject, ".Request.").concat(subject);
                 }
-                if (!this.connection)
+                if (!this.natsConnection)
                     return [2 /*return*/, Promise.reject("".concat(subject, ": Connection is down! Please try again!"))];
-                if (this.connection.isClosed())
+                if (this.natsConnection.isClosed())
                     return [2 /*return*/, Promise.reject("".concat(subject, ": Connection has been closed! Please reconnect!"))];
                 data = this.encode(payload);
                 headers = this.buildHeaders();
@@ -141,7 +173,7 @@ var BaseClient = /** @class */ (function () {
                 }
                 timeout = (options === null || options === void 0 ? void 0 : options.timeout) || this.timeout;
                 replySubject = (_b = (_a = options === null || options === void 0 ? void 0 : options.publishOptions) === null || _a === void 0 ? void 0 : _a.reply) !== null && _b !== void 0 ? _b : "".concat(subject, ".Reply.").concat((0, uuid_1.v4)());
-                serverMaxPayload = (_d = (_c = this.connection) === null || _c === void 0 ? void 0 : _c.info) === null || _d === void 0 ? void 0 : _d.max_payload;
+                serverMaxPayload = (_d = (_c = this.natsConnection) === null || _c === void 0 ? void 0 : _c.info) === null || _d === void 0 ? void 0 : _d.max_payload;
                 chunkSize = serverMaxPayload ? serverMaxPayload - 50000 : 512000;
                 // The Session and the Client need to agree on the chunk size. Put it in a header.
                 headers.append('ChunkSize', chunkSize.toString());
@@ -155,9 +187,16 @@ var BaseClient = /** @class */ (function () {
                     var offset = chunk * fileDescriptor.chunkSize;
                     return data.slice(offset, offset + fileDescriptor.chunkSize);
                 };
-                subscription = this.connection.subscribe(replySubject);
+                subscription = this.natsConnection.subscribe(replySubject);
                 responsePromise = new Promise(function (resolve, reject) {
+                    // Chunk payloads stored at their sequence index so order is preserved
+                    // regardless of the order in which messages arrive.
                     var messages = [];
+                    var receivedCount = 0;
+                    // Total number of chunks and the size of the final chunk, both known
+                    // once the final (smaller) chunk arrives.
+                    var expectedCount;
+                    var finalChunkLength = 0;
                     subscription.callback = function (error, message) {
                         var _a, _b, _c, _d;
                         if (error) {
@@ -173,59 +212,65 @@ var BaseClient = /** @class */ (function () {
                             subscription.unsubscribe();
                             return resolve({ byteArray: message.data, isErrorResponse: ((_c = message.headers) === null || _c === void 0 ? void 0 : _c.get('OpenTapNatsError')) === 'true' });
                         }
-                        // Put all the response chunks in an array in the order they are received
-                        messages.push(message);
-                        // If the chunk has a size equal to the chunkSize, we should expect another message
-                        if (message.data.length === chunkSize) {
+                        // Place each chunk at its sequence position (ChunkNumber is 1-based).
+                        messages[parseInt(chunkNumber) - 1] = message.data;
+                        receivedCount += 1;
+                        // The final chunk is the only one smaller than chunkSize; its sequence
+                        // number tells us how many chunks to expect and its length fixes the total size.
+                        if (message.data.length < chunkSize) {
+                            expectedCount = parseInt(chunkNumber);
+                            finalChunkLength = message.data.length;
+                        }
+                        // Keep waiting until every expected chunk has been received.
+                        if (expectedCount === undefined || receivedCount < expectedCount) {
                             return;
                         }
-                        // If the chunk has a length smaller than the chunkSize, the message is complete
-                        // If the final message was received, we can safely unsubscribe
+                        // All expected chunks received; we can safely unsubscribe.
                         subscription.unsubscribe();
-                        // Check if the number of the final message is equal to the number of
-                        // messages we received. If this is not the case, we dropped a chunk,
-                        // likely due to a network error. In this case, the entire message is invalid.
-                        if (parseInt(chunkNumber) !== messages.length) {
-                            return reject(Error("Expected {finalMessageNumber} chunks, but received ".concat(messages.length, ". ") +
-                                "The connection may have been interrupted."));
-                        }
-                        // Concatenate the payloads
-                        // When there are many chunks, doing a single allocation
-                        // is significantly faster than concatenating arrays in sequence
-                        var flattenedSize = messages.reduce(function (sum, array) { return sum + array.data.length; }, 0);
+                        // Every chunk before the last is exactly chunkSize, so the total size is
+                        // deterministic and each chunk's offset is simply its index * chunkSize.
+                        var flattenedSize = (expectedCount - 1) * chunkSize + finalChunkLength;
                         var flattenedArray = new Uint8Array(flattenedSize);
-                        var k = 0;
-                        messages.forEach(function (m) {
-                            for (var i = 0; i < m.data.length; i++) {
-                                flattenedArray[k++] = m.data[i];
+                        for (var i = 0; i < expectedCount; i++) {
+                            var chunk_1 = messages[i];
+                            // A missing chunk means we dropped one, likely due to a network error,
+                            // so the entire message is invalid.
+                            if (!chunk_1) {
+                                return reject(Error("Expected ".concat(expectedCount, " chunks, but chunk ").concat(i + 1, " is missing. ") +
+                                    "The connection may have been interrupted."));
                             }
-                        });
+                            flattenedArray.set(chunk_1, i * chunkSize);
+                        }
                         return resolve({ byteArray: flattenedArray, isErrorResponse: ((_d = message.headers) === null || _d === void 0 ? void 0 : _d.get('OpenTapNatsError')) === 'true' });
                     };
                 }).then(function (_a) {
                     var byteArray = _a.byteArray, isErrorResponse = _a.isErrorResponse;
+                    var jsonCodec = (0, nats_ws_1.JSONCodec)();
+                    if (isErrorResponse) {
+                        return Promise.reject(DTOs_1.ErrorResponse.fromJS(jsonCodec.decode(byteArray)));
+                    }
                     if (byteArray.length === 0) {
                         return Promise.resolve(undefined);
                     }
-                    var jsonCodec = (0, nats_ws_1.JSONCodec)();
-                    // If a raw response is requested, we should avoid decoding the bytes.
-                    var response = (options === null || options === void 0 ? void 0 : options.rawResponse) ? byteArray : jsonCodec.decode(byteArray);
-                    return isErrorResponse ? Promise.reject(DTOs_1.ErrorResponse.fromJS(response)) : Promise.resolve(response);
+                    if (options === null || options === void 0 ? void 0 : options.rawResponse) {
+                        return Promise.resolve(byteArray);
+                    }
+                    return Promise.resolve(jsonCodec.decode(byteArray));
                 });
                 chunk = getChunk(0);
-                this.connection.publish(subject, chunk, opts);
+                this.natsConnection.publish(subject, chunk, opts);
                 chunkNumber += 1;
                 for (i = 1; i < fileDescriptor.numberOfChunks; i++) {
                     headers.set('ChunkNumber', chunkNumber.toString());
                     chunk = getChunk(i);
-                    this.connection.publish(subject, chunk, opts);
+                    this.natsConnection.publish(subject, chunk, opts);
                     chunkNumber += 1;
                 }
                 // In the special case where the last published chunk was full, we need to publish
                 // an empty message
                 if (data.length > 0 && data.length % fileDescriptor.chunkSize === 0) {
                     headers.set('ChunkNumber', chunkNumber.toString());
-                    this.connection.publish(subject, nats_ws_1.Empty, opts);
+                    this.natsConnection.publish(subject, nats_ws_1.Empty, opts);
                 }
                 // Now that we have sent the terminating chunk, the result should arrive on our promise.
                 return [2 /*return*/, this.withTimeout(responsePromise, timeout, subject).catch(function (err) {
@@ -281,12 +326,12 @@ var BaseClient = /** @class */ (function () {
         if (options === void 0) { options = {}; }
         if (!subject)
             throw Error('Subject is not defined!');
-        if (!this.connection)
+        if (!this.natsConnection)
             throw Error('Connection is not up yet! Please try again later!');
-        if (this.connection.isClosed())
+        if (this.natsConnection.isClosed())
             throw Error('Connection has been closed! Please reconnect!');
         var natsSubject = options.fullSubject ? subject : "".concat(this.baseSubject, ".").concat(subject);
-        return this.connection.subscribe(natsSubject, options);
+        return this.natsConnection.subscribe(natsSubject, options);
     };
     /**
      * Subscribes to given subject.
@@ -298,14 +343,14 @@ var BaseClient = /** @class */ (function () {
         var _this = this;
         if (jetStreamOptions === void 0) { jetStreamOptions = {}; }
         if (consumerOptions === void 0) { consumerOptions = {}; }
-        if (!this.connection) {
+        if (!this.natsConnection) {
             throw Error('Connection is not established');
         }
-        return this.connection.jetstreamManager(__assign({}, jetStreamOptions)).then(function (jetStreamManager) {
+        return this.natsConnection.jetstreamManager(__assign({}, jetStreamOptions)).then(function (jetStreamManager) {
             return jetStreamManager.consumers
                 .add(stream, __assign(__assign({}, consumerOptions), { filter_subject: subject, ack_policy: nats_ws_1.AckPolicy.None }))
                 .then(function (consumerInfo) {
-                return _this.connection.jetstream(jetStreamOptions).consumers.get(consumerInfo.stream_name, consumerInfo.name);
+                return _this.natsConnection.jetstream(jetStreamOptions).consumers.get(consumerInfo.stream_name, consumerInfo.name);
             });
         });
     };
@@ -322,7 +367,7 @@ var BaseClient = /** @class */ (function () {
      * Create a connection to the nats server.
      * @param {ConnectionOptions} options
      */
-    BaseClient.prototype.connect = function () {
+    BaseClient.prototype.connect = function (connection) {
         return __awaiter(this, void 0, void 0, function () {
             var error_1;
             var _this = this;
@@ -331,14 +376,21 @@ var BaseClient = /** @class */ (function () {
                     case 0:
                         if (!this.baseSubject)
                             return [2 /*return*/, Promise.reject('Subject must be given')];
-                        if (this.connection)
+                        if (this.natsConnection)
+                            return [2 /*return*/, Promise.resolve()];
+                        if (connection) {
+                            if (connection.isClosed()) {
+                                return [2 /*return*/, Promise.reject('Provided connection is closed')];
+                            }
+                            this.natsConnection = connection;
                             return [2 /*return*/, Promise.resolve()];
+                        }
                         _a.label = 1;
                     case 1:
                         _a.trys.push([1, 3, , 4]);
                         return [4 /*yield*/, (0, nats_ws_1.connect)(this.connectionOptions)
                                 .then(function (connection) {
-                                _this.connection = connection;
+                                _this.natsConnection = connection;
                                 return Promise.resolve();
                             })
                                 .catch(function (error) { return Promise.reject("Failed to connect to ".concat(_this.connectionOptions.servers, " with ").concat(error)); })];
@@ -361,9 +413,9 @@ var BaseClient = /** @class */ (function () {
             return __generator(this, function (_b) {
                 switch (_b.label) {
                     case 0:
-                        if (!this.connection) return [3 /*break*/, 2];
-                        return [4 /*yield*/, ((_a = this.connection) === null || _a === void 0 ? void 0 : _a.close().then(function () {
-                                _this.connection = null;
+                        if (!this.natsConnection) return [3 /*break*/, 2];
+                        return [4 /*yield*/, ((_a = this.natsConnection) === null || _a === void 0 ? void 0 : _a.close().then(function () {
+                                _this.natsConnection = null;
                             }).catch(function (error) {
                                 throw new Error("failed to close connection: ".concat(error));
                             }))];
@@ -699,6 +751,7 @@ var BaseClient = /** @class */ (function () {
      * Dispatches a request with the given subject and returns a Promise of type T
      * @param subject The subject to send the request to
      * @returns Promise<T> The response from the request
+     * @deprecated Use {@link request} instead.
      */
     BaseClient.prototype.dispatchRequest = function (subject, payload, options) {
         return __awaiter(this, void 0, void 0, function () {

package/dist/cjs/DTOs.d.ts

@@ -876,7 +876,8 @@ export declare enum SessionState {
     Breaking = "Breaking",
     Aborting = "Aborting",
     WaitingForUserInput = "WaitingForUserInput",
-    Loading = "Loading"
+    Loading = "Loading",
+    Restarting = "Restarting"
 }
 export declare class TestPlan implements ITestPlan {
     childTestSteps?: TestStep[] | undefined;
@@ -1207,7 +1208,9 @@ export declare enum SessionEventName {
     TestStepChanged = "TestStepChanged",
     Break = "Break",
     UserInputRequested = "UserInputRequested",
-    UserInputRequestCompleted = "UserInputRequestCompleted"
+    UserInputRequestCompleted = "UserInputRequestCompleted",
+    RestartInitiated = "RestartInitiated",
+    RestartCompleted = "RestartCompleted"
 }
 export declare abstract class SessionEvent {
     readonly eventName: SessionEventName;
@@ -1315,6 +1318,21 @@ export declare class UserInputRequestCompletedEvent extends SessionEvent {
     static fromJS(data: any): UserInputRequestCompletedEvent;
     toJSON(data?: any): any;
 }
+export declare class RestartInitiatedEvent extends SessionEvent {
+    oldProcessId?: number;
+    constructor(data?: Partial<RestartInitiatedEvent>);
+    init(_data?: any): void;
+    static fromJS(data: any): RestartInitiatedEvent;
+    toJSON(data?: any): any;
+}
+export declare class RestartCompletedEvent extends SessionEvent {
+    success?: boolean;
+    newProcessId?: number;
+    constructor(data?: Partial<RestartCompletedEvent>);
+    init(_data?: any): void;
+    static fromJS(data: any): RestartCompletedEvent;
+    toJSON(data?: any): any;
+}
 export type ISessionEvent = SessionEvent;
 export interface IOnTestPlanRun {
     status?: string;

package/dist/cjs/DTOs.js

@@ -17,7 +17,7 @@ var __extends = (this && this.__extends) || (function () {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.SettingsTapPackage = exports.SaveTestPlanToRepositoryResponse = exports.GetTestPlanReferenceResponse = exports.RepositorySettingsPackageDefinition = exports.RepositoryPackageDefinition = exports.RepositoryPackageReference = exports.ProfileGroup = exports.ListItemType = exports.ComponentSettings = exports.FileDescriptor = exports.Resource = exports.PluginTypeSelectorControl = exports.PictureControl = exports.PasswordControl = exports.MultiSelectControl = exports.DropdownControl = exports.EnabledControl = exports.DirectoryPathControl = exports.FilePathControl = exports.ComboBoxControl = exports.TextBoxControl = exports.DataGridControl = exports.DataGridReferenceControl = exports.CheckBoxControl = exports.AvailableValue = exports.ButtonsControl = exports.ButtonControl = exports.ExternalParameter = exports.MetaData = exports.DisplayAttribute = exports.VisualStatus = exports.UnitAttribute = exports.Icon = exports.ColumnDisplayName = exports.LayoutMode = exports.Layout = exports.Setting = exports.ComponentSettingsListItem = exports.AnnotatedObject = exports.ComponentSettingsList = exports.DisplayMode = exports.ComponentSettingsIdentifier = exports.ComponentSettingsBase = exports.Links = exports.Session = exports.ImageResolveErrorResponse = exports.NoResponderError = exports.ErrorResponse = exports.PackageSpecifier = exports.Image = void 0;
 exports.StartedEvent = exports.StartingEvent = exports.SessionTimeoutEvent = exports.TestPlanSettingsChangedEvent = exports.TypeCacheInvalidatedEvent = exports.SessionEvent = exports.SessionEventName = exports.MetricValue = exports.MetricsConfiguration = exports.SessionMetricInfo = exports.MetricsPollRate = exports.SessionMetricType = exports.SessionMetricKind = exports.ResultColumn = exports.Result = exports.LogEvent = exports.TestStepRun = exports.WatchDog = exports.Parameter = exports.BreakPoints = exports.InstalledFile = exports.Interaction = exports.CommonContext = exports.CommonSettings = exports.ValidationError = exports.TestStepValidationError = exports.TestStepCopy = exports.TestStepType = exports.TestStep = exports.TestPlan = exports.SessionState = exports.Verdict = exports.EditStatus = exports.RunStatus = exports.MissingLicenseResponse = exports.LogEntry = exports.LogList = exports.ApiException = exports.ImageCreationFailed = exports.ImageCreated = exports.ImageCreating = exports.ImageEventArgs = exports.SessionInactivityLimitHit = exports.SessionShutdownFailed = exports.SessionShutdown = exports.SessionShutdownInitiated = exports.SessionStartFailed = exports.SessionStarted = exports.SessionStartInitiated = exports.SessionEventArgs = void 0;
-exports.RunnerStatus = exports.StreamInfoStatus = exports.RemoteConnection = exports.SaveDefaultSettings = exports.AssetUpdatedEvent = exports.MetadataUpdatedEvent = exports.RunnerDeletedEvent = exports.RunnerUpdatedEvent = exports.RunnerRegisteredEvent = exports.RunnerEvent = exports.TestPlanRunCompletedEvent = exports.TestPlanRunStartEvent = exports.TestPlanRunEvent = exports.OnTestStepRun = exports.OnTestPlanRun = exports.UserInputRequestCompletedEvent = exports.UserInputRequestedEvent = exports.BreakEvent = exports.TestStepChangedEvent = exports.SettingsChangedEvent = exports.HeartbeatEvent = exports.SessionStateChangedEvent = exports.TestPlanReferenceChangedEvent = exports.TestPlanChangedEvent = exports.StoppedEvent = exports.StoppingEvent = void 0;
+exports.RunnerStatus = exports.StreamInfoStatus = exports.RemoteConnection = exports.SaveDefaultSettings = exports.AssetUpdatedEvent = exports.MetadataUpdatedEvent = exports.RunnerDeletedEvent = exports.RunnerUpdatedEvent = exports.RunnerRegisteredEvent = exports.RunnerEvent = exports.TestPlanRunCompletedEvent = exports.TestPlanRunStartEvent = exports.TestPlanRunEvent = exports.OnTestStepRun = exports.OnTestPlanRun = exports.RestartCompletedEvent = exports.RestartInitiatedEvent = exports.UserInputRequestCompletedEvent = exports.UserInputRequestedEvent = exports.BreakEvent = exports.TestStepChangedEvent = exports.SettingsChangedEvent = exports.HeartbeatEvent = exports.SessionStateChangedEvent = exports.TestPlanReferenceChangedEvent = exports.TestPlanChangedEvent = exports.StoppedEvent = exports.StoppingEvent = void 0;
 var Image = /** @class */ (function () {
     function Image(data) {
         this.packages = [];
@@ -2444,6 +2444,7 @@ var SessionState;
     SessionState["Aborting"] = "Aborting";
     SessionState["WaitingForUserInput"] = "WaitingForUserInput";
     SessionState["Loading"] = "Loading";
+    SessionState["Restarting"] = "Restarting";
 })(SessionState || (exports.SessionState = SessionState = {}));
 var TestPlan = /** @class */ (function () {
     function TestPlan(data) {
@@ -3326,6 +3327,8 @@ var SessionEventName;
     SessionEventName["Break"] = "Break";
     SessionEventName["UserInputRequested"] = "UserInputRequested";
     SessionEventName["UserInputRequestCompleted"] = "UserInputRequestCompleted";
+    SessionEventName["RestartInitiated"] = "RestartInitiated";
+    SessionEventName["RestartCompleted"] = "RestartCompleted";
 })(SessionEventName || (exports.SessionEventName = SessionEventName = {}));
 var SessionEvent = /** @class */ (function () {
     function SessionEvent(eventName) {
@@ -3659,6 +3662,60 @@ var UserInputRequestCompletedEvent = /** @class */ (function (_super) {
     return UserInputRequestCompletedEvent;
 }(SessionEvent));
 exports.UserInputRequestCompletedEvent = UserInputRequestCompletedEvent;
+var RestartInitiatedEvent = /** @class */ (function (_super) {
+    __extends(RestartInitiatedEvent, _super);
+    function RestartInitiatedEvent(data) {
+        var _this = _super.call(this, SessionEventName.RestartInitiated) || this;
+        if (data) {
+            Object.assign(_this, data);
+        }
+        return _this;
+    }
+    RestartInitiatedEvent.prototype.init = function (_data) {
+        var data = ensureObject(_data);
+        this.oldProcessId = data['OldProcessId'];
+    };
+    RestartInitiatedEvent.fromJS = function (data) {
+        var result = new RestartInitiatedEvent();
+        result.init(data);
+        return result;
+    };
+    RestartInitiatedEvent.prototype.toJSON = function (data) {
+        var json = ensureObject(data);
+        json['OldProcessId'] = this.oldProcessId;
+        return json;
+    };
+    return RestartInitiatedEvent;
+}(SessionEvent));
+exports.RestartInitiatedEvent = RestartInitiatedEvent;
+var RestartCompletedEvent = /** @class */ (function (_super) {
+    __extends(RestartCompletedEvent, _super);
+    function RestartCompletedEvent(data) {
+        var _this = _super.call(this, SessionEventName.RestartCompleted) || this;
+        if (data) {
+            Object.assign(_this, data);
+        }
+        return _this;
+    }
+    RestartCompletedEvent.prototype.init = function (_data) {
+        var data = ensureObject(_data);
+        this.success = data['Success'];
+        this.newProcessId = data['NewProcessId'];
+    };
+    RestartCompletedEvent.fromJS = function (data) {
+        var result = new RestartCompletedEvent();
+        result.init(data);
+        return result;
+    };
+    RestartCompletedEvent.prototype.toJSON = function (data) {
+        var json = ensureObject(data);
+        json['Success'] = this.success;
+        json['NewProcessId'] = this.newProcessId;
+        return json;
+    };
+    return RestartCompletedEvent;
+}(SessionEvent));
+exports.RestartCompletedEvent = RestartCompletedEvent;
 var OnTestPlanRun = /** @class */ (function () {
     function OnTestPlanRun(data) {
         if (data) {

package/dist/cjs/RunnerClient.d.ts

@@ -58,6 +58,12 @@ export declare class RunnerClient extends BaseClient {
      * @returns {{Promise<void>}}
      */
     shutdownSession(sessionId: string, force?: boolean): Promise<void>;
+    /**
+     * Restart a session
+     * @param sessionId the ID of the session to restart
+     * @returns {{Promise<void>}}
+     */
+    restartSession(sessionId: string): Promise<void>;
     /**
      * Start a session
      * @returns {{Promise<Session>}}

package/dist/cjs/RunnerClient.js

@@ -232,6 +232,16 @@ var RunnerClient = /** @class */ (function (_super) {
                 .catch(this.error())
             : Promise.reject('sessionId is not defined');
     };
+    /**
+     * Restart a session
+     * @param sessionId the ID of the session to restart
+     * @returns {{Promise<void>}}
+     */
+    RunnerClient.prototype.restartSession = function (sessionId) {
+        return (sessionId === null || sessionId === void 0 ? void 0 : sessionId.length) > 0
+            ? this.request('RestartSession', { SessionId: sessionId }).then(this.success()).catch(this.error())
+            : Promise.reject('sessionId is not defined');
+    };
     /**
      * Start a session
      * @returns {{Promise<Session>}}

package/dist/cjs/SessionClient.js

@@ -847,6 +847,8 @@ var SessionClient = /** @class */ (function (_super) {
         _a[DTOs_1.SessionEventName.Break] = function (payload) { return DTOs_1.BreakEvent.fromJS(payload); },
         _a[DTOs_1.SessionEventName.UserInputRequested] = function (payload) { return DTOs_1.UserInputRequestedEvent.fromJS(payload); },
         _a[DTOs_1.SessionEventName.UserInputRequestCompleted] = function (payload) { return DTOs_1.UserInputRequestCompletedEvent.fromJS(payload); },
+        _a[DTOs_1.SessionEventName.RestartInitiated] = function (payload) { return DTOs_1.RestartInitiatedEvent.fromJS(payload); },
+        _a[DTOs_1.SessionEventName.RestartCompleted] = function (payload) { return DTOs_1.RestartCompletedEvent.fromJS(payload); },
         _a);
     return SessionClient;
 }(BaseClient_1.BaseClient));

package/dist/mjs/BaseClient.d.ts

@@ -1,4 +1,4 @@
-import { ConnectionOptions, Consumer, ConsumerConfig, JetStreamOptions, NatsError, PublishOptions, Subscription, SubscriptionOptions } from 'nats.ws';
+import { ConnectionOptions, Consumer, ConsumerConfig, JetStreamOptions, NatsConnection, NatsError, PublishOptions, Subscription, SubscriptionOptions } from 'nats.ws';
 import { DownloadTapSettingsRequest } from './requestDTOs';
 import { ComponentSettingsBase, ComponentSettingsIdentifier, ComponentSettingsListItem, DataGridControl, ErrorResponse, FileParameter, ListItemType, ProfileGroup, RepositoryPackageReference, RepositorySettingsPackageDefinition } from './DTOs';
 interface BaseClientRequestOptions {
@@ -12,28 +12,23 @@ interface BaseClientRequestOptions {
 }
 export declare class BaseClient {
     readonly baseSubject: string;
-    private connection;
+    private natsConnection;
     private connectionOptions;
     private domainAccess;
     private eventEmitter;
     private _accessToken;
     private _headers;
     private _timeout;
-    /** Get request access token */
+    get connection(): NatsConnection | null;
     get accessToken(): string;
-    /** Set request access token */
     set accessToken(value: string);
-    /** Get request headers */
     get headers(): {
         [key: string]: string;
     };
-    /** Set request headers */
     set headers(value: {
         [key: string]: string;
     });
-    /** Get timeout */
     get timeout(): number;
-    /** Set timeout in milliseconds. Default is 40000 milliseconds */
     set timeout(value: number);
     constructor(baseSubject: string, options: ConnectionOptions);
     private withTimeout;
@@ -44,7 +39,7 @@ export declare class BaseClient {
      * @param options (optional)
      * @returns Promise of an object
      */
-    protected request<T>(subject: string, payload?: any, options?: BaseClientRequestOptions): Promise<T>;
+    request<T>(subject: string, payload?: any, options?: BaseClientRequestOptions): Promise<T>;
     /**
      * Handle the error
      * @param error
@@ -78,7 +73,7 @@ export declare class BaseClient {
      * Create a connection to the nats server.
      * @param {ConnectionOptions} options
      */
-    connect(): Promise<void>;
+    connect(connection?: NatsConnection): Promise<void>;
     /**
      * Close the connection.
      */
@@ -258,6 +253,7 @@ export declare class BaseClient {
      * Dispatches a request with the given subject and returns a Promise of type T
      * @param subject The subject to send the request to
      * @returns Promise<T> The response from the request
+     * @deprecated Use {@link request} instead.
      */
     dispatchRequest<T>(subject: string, payload?: any, options?: BaseClientRequestOptions): Promise<T>;
 }

package/dist/mjs/BaseClient.js

@@ -11,33 +11,52 @@ import { AckPolicy, Empty, ErrorCode, JSONCodec, StringCodec, connect, headers,
 import { ComponentSettingsBase, ComponentSettingsIdentifier, ComponentSettingsListItem, DataGridControl, ErrorResponse, FileDescriptor, ListItemType, NoResponderError, ProfileGroup, } from './DTOs';
 import { EventEmitter } from 'events';
 import { v4 as uuidv4 } from 'uuid';
+// A browser extension like CrowdStrike may have already replaced globalThis.WebSocket before this module loads,
+// so reading the global is unreliable. A freshly created same-origin iframe exposes the browser's
+// pristine, un-patched WebSocket; NATS traffic is pinned to it to bypass any extension shim.
+// The iframe is kept attached because a detached iframe's realm becomes unusable in some browsers.
+function getNativeWebSocket() {
+    var _a, _b, _c;
+    const globalWebSocket = typeof globalThis !== 'undefined' ? globalThis.WebSocket : undefined;
+    const doc = globalThis.document;
+    if (!doc || typeof doc.createElement !== 'function') {
+        return globalWebSocket;
+    }
+    try {
+        const iframe = doc.createElement('iframe');
+        iframe.style.display = 'none';
+        ((_a = doc.body) !== null && _a !== void 0 ? _a : doc.documentElement).appendChild(iframe);
+        return (_c = (_b = iframe.contentWindow) === null || _b === void 0 ? void 0 : _b.WebSocket) !== null && _c !== void 0 ? _c : globalWebSocket;
+    }
+    catch (_d) {
+        return globalWebSocket;
+    }
+}
+const OriginalWebSocket = getNativeWebSocket();
 const DEFAULT_TIMEOUT = 40000; // default timeout of 40 seconds
 var Events;
 (function (Events) {
     Events["ERROR"] = "error_event";
 })(Events || (Events = {}));
 export class BaseClient {
-    /** Get request access token */
+    get connection() {
+        return this.natsConnection;
+    }
     get accessToken() {
         return this._accessToken;
     }
-    /** Set request access token */
     set accessToken(value) {
         this._accessToken = value;
     }
-    /** Get request headers */
     get headers() {
         return this._headers;
     }
-    /** Set request headers */
     set headers(value) {
         this._headers = value;
     }
-    /** Get timeout */
     get timeout() {
         return this._timeout || DEFAULT_TIMEOUT;
     }
-    /** Set timeout in milliseconds. Default is 40000 milliseconds */
     set timeout(value) {
         this._timeout = value;
     }
@@ -47,6 +66,13 @@ export class BaseClient {
         this.baseSubject = baseSubject;
         this.connectionOptions = Object.assign({}, options);
         this.connectionOptions.timeout = (options === null || options === void 0 ? void 0 : options.timeout) || DEFAULT_TIMEOUT;
+        // Force NATS to use the WebSocket captured at load time so an extension that later
+        // overrides globalThis.WebSocket cannot intercept NATS traffic. Respect a caller-provided factory.
+        // wsFactory is read by nats.ws's WsTransport at runtime but lives on WsConnectionOptions, which
+        // isn't re-exported, so it's absent from the public ConnectionOptions type and requires this cast.
+        if (OriginalWebSocket && !this.connectionOptions.wsFactory) {
+            this.connectionOptions.wsFactory = (url) => Promise.resolve({ socket: new OriginalWebSocket(url), encrypted: url.indexOf('wss://') === 0 });
+        }
         this.eventEmitter = new EventEmitter();
     }
     withTimeout(promise, timeout, subject) {
@@ -69,9 +95,9 @@ export class BaseClient {
             if (!(options === null || options === void 0 ? void 0 : options.fullSubject)) {
                 subject = `${this.baseSubject}.Request.${subject}`;
             }
-            if (!this.connection)
+            if (!this.natsConnection)
                 return Promise.reject(`${subject}: Connection is down! Please try again!`);
-            if (this.connection.isClosed())
+            if (this.natsConnection.isClosed())
                 return Promise.reject(`${subject}: Connection has been closed! Please reconnect!`);
             const data = this.encode(payload);
             const headers = this.buildHeaders();
@@ -88,7 +114,7 @@ export class BaseClient {
             // If serverMaxPayload is not available for some reason, we just use a default chunk size of 512000.
             // We subtract 50000 from max_payload in order to leave room for headers, which
             // can be quite large since they can contain jwt tokens, which may contain all sorts of information.
-            const serverMaxPayload = (_d = (_c = this.connection) === null || _c === void 0 ? void 0 : _c.info) === null || _d === void 0 ? void 0 : _d.max_payload;
+            const serverMaxPayload = (_d = (_c = this.natsConnection) === null || _c === void 0 ? void 0 : _c.info) === null || _d === void 0 ? void 0 : _d.max_payload;
             const chunkSize = serverMaxPayload ? serverMaxPayload - 50000 : 512000;
             // The Session and the Client need to agree on the chunk size. Put it in a header.
             headers.append('ChunkSize', chunkSize.toString());
@@ -105,11 +131,18 @@ export class BaseClient {
                 return data.slice(offset, offset + fileDescriptor.chunkSize);
             };
             // Set up the subscription before we start publishing chunks
-            const subscription = this.connection.subscribe(replySubject);
+            const subscription = this.natsConnection.subscribe(replySubject);
             // The response from the session will arrive in this promise after we have finished
             // publishing chunks
             const responsePromise = new Promise((resolve, reject) => {
+                // Chunk payloads stored at their sequence index so order is preserved
+                // regardless of the order in which messages arrive.
                 const messages = [];
+                let receivedCount = 0;
+                // Total number of chunks and the size of the final chunk, both known
+                // once the final (smaller) chunk arrives.
+                let expectedCount;
+                let finalChunkLength = 0;
                 subscription.callback = (error, message) => {
                     var _a, _b, _c, _d;
                     if (error) {
@@ -125,60 +158,66 @@ export class BaseClient {
                         subscription.unsubscribe();
                         return resolve({ byteArray: message.data, isErrorResponse: ((_c = message.headers) === null || _c === void 0 ? void 0 : _c.get('OpenTapNatsError')) === 'true' });
                     }
-                    // Put all the response chunks in an array in the order they are received
-                    messages.push(message);
-                    // If the chunk has a size equal to the chunkSize, we should expect another message
-                    if (message.data.length === chunkSize) {
+                    // Place each chunk at its sequence position (ChunkNumber is 1-based).
+                    messages[parseInt(chunkNumber) - 1] = message.data;
+                    receivedCount += 1;
+                    // The final chunk is the only one smaller than chunkSize; its sequence
+                    // number tells us how many chunks to expect and its length fixes the total size.
+                    if (message.data.length < chunkSize) {
+                        expectedCount = parseInt(chunkNumber);
+                        finalChunkLength = message.data.length;
+                    }
+                    // Keep waiting until every expected chunk has been received.
+                    if (expectedCount === undefined || receivedCount < expectedCount) {
                         return;
                     }
-                    // If the chunk has a length smaller than the chunkSize, the message is complete
-                    // If the final message was received, we can safely unsubscribe
+                    // All expected chunks received; we can safely unsubscribe.
                     subscription.unsubscribe();
-                    // Check if the number of the final message is equal to the number of
-                    // messages we received. If this is not the case, we dropped a chunk,
-                    // likely due to a network error. In this case, the entire message is invalid.
-                    if (parseInt(chunkNumber) !== messages.length) {
-                        return reject(Error(`Expected {finalMessageNumber} chunks, but received ${messages.length}. ` +
-                            `The connection may have been interrupted.`));
-                    }
-                    // Concatenate the payloads
-                    // When there are many chunks, doing a single allocation
-                    // is significantly faster than concatenating arrays in sequence
-                    const flattenedSize = messages.reduce((sum, array) => sum + array.data.length, 0);
+                    // Every chunk before the last is exactly chunkSize, so the total size is
+                    // deterministic and each chunk's offset is simply its index * chunkSize.
+                    const flattenedSize = (expectedCount - 1) * chunkSize + finalChunkLength;
                     const flattenedArray = new Uint8Array(flattenedSize);
-                    let k = 0;
-                    messages.forEach(m => {
-                        for (let i = 0; i < m.data.length; i++) {
-                            flattenedArray[k++] = m.data[i];
+                    for (let i = 0; i < expectedCount; i++) {
+                        const chunk = messages[i];
+                        // A missing chunk means we dropped one, likely due to a network error,
+                        // so the entire message is invalid.
+                        if (!chunk) {
+                            return reject(Error(`Expected ${expectedCount} chunks, but chunk ${i + 1} is missing. ` +
+                                `The connection may have been interrupted.`));
                         }
-                    });
+                        flattenedArray.set(chunk, i * chunkSize);
+                    }
                     return resolve({ byteArray: flattenedArray, isErrorResponse: ((_d = message.headers) === null || _d === void 0 ? void 0 : _d.get('OpenTapNatsError')) === 'true' });
                 };
             }).then(({ byteArray, isErrorResponse }) => {
+                const jsonCodec = JSONCodec();
+                if (isErrorResponse) {
+                    return Promise.reject(ErrorResponse.fromJS(jsonCodec.decode(byteArray)));
+                }
                 if (byteArray.length === 0) {
                     return Promise.resolve(undefined);
                 }
-                const jsonCodec = JSONCodec();
-                // If a raw response is requested, we should avoid decoding the bytes.
-                const response = (options === null || options === void 0 ? void 0 : options.rawResponse) ? byteArray : jsonCodec.decode(byteArray);
-                return isErrorResponse ? Promise.reject(ErrorResponse.fromJS(response)) : Promise.resolve(response);
+                if (options === null || options === void 0 ? void 0 : options.rawResponse) {
+                    return Promise.resolve(byteArray);
+                }
+                return Promise.resolve(jsonCodec.decode(byteArray));
             });
             // 'Manually' publish the first chunk. This is to ensure that **at least** one chunk is published.
             // This is a special case for empty payloads (which are common)
             let chunk = getChunk(0);
-            this.connection.publish(subject, chunk, opts);
+            this.natsConnection.publish(subject, chunk, opts);
             chunkNumber += 1;
             for (let i = 1; i < fileDescriptor.numberOfChunks; i++) {
                 headers.set('ChunkNumber', chunkNumber.toString());
                 chunk = getChunk(i);
-                this.connection.publish(subject, chunk, opts);
+                this.natsConnection.publish(subject, chunk, opts);
                 chunkNumber += 1;
             }
             // In the special case where the last published chunk was full, we need to publish
             // an empty message
             if (data.length > 0 && data.length % fileDescriptor.chunkSize === 0) {
                 headers.set('ChunkNumber', chunkNumber.toString());
-                this.connection.publish(subject, Empty, opts);
+                this.natsConnection.publish(subject, Empty, opts);
             }
             // Now that we have sent the terminating chunk, the result should arrive on our promise.
             return this.withTimeout(responsePromise, timeout, subject).catch(err => {
@@ -229,12 +268,12 @@ export class BaseClient {
     subscribe(subject, options = {}) {
         if (!subject)
             throw Error('Subject is not defined!');
-        if (!this.connection)
+        if (!this.natsConnection)
             throw Error('Connection is not up yet! Please try again later!');
-        if (this.connection.isClosed())
+        if (this.natsConnection.isClosed())
             throw Error('Connection has been closed! Please reconnect!');
         const natsSubject = options.fullSubject ? subject : `${this.baseSubject}.${subject}`;
-        return this.connection.subscribe(natsSubject, options);
+        return this.natsConnection.subscribe(natsSubject, options);
     }
     /**
      * Subscribes to given subject.
@@ -243,12 +282,12 @@ export class BaseClient {
      * @returns Subscription object
      */
     createJetStreamConsumer(stream, subject, jetStreamOptions = {}, consumerOptions = {}) {
-        if (!this.connection) {
+        if (!this.natsConnection) {
             throw Error('Connection is not established');
         }
-        return this.connection.jetstreamManager(Object.assign({}, jetStreamOptions)).then(jetStreamManager => jetStreamManager.consumers
+        return this.natsConnection.jetstreamManager(Object.assign({}, jetStreamOptions)).then(jetStreamManager => jetStreamManager.consumers
             .add(stream, Object.assign(Object.assign({}, consumerOptions), { filter_subject: subject, ack_policy: AckPolicy.None }))
-            .then(consumerInfo => this.connection.jetstream(jetStreamOptions).consumers.get(consumerInfo.stream_name, consumerInfo.name)));
+            .then(consumerInfo => this.natsConnection.jetstream(jetStreamOptions).consumers.get(consumerInfo.stream_name, consumerInfo.name)));
     }
     encode(payload) {
         if (!payload) {
@@ -263,16 +302,23 @@ export class BaseClient {
      * Create a connection to the nats server.
      * @param {ConnectionOptions} options
      */
-    connect() {
+    connect(connection) {
         return __awaiter(this, void 0, void 0, function* () {
             if (!this.baseSubject)
                 return Promise.reject('Subject must be given');
-            if (this.connection)
+            if (this.natsConnection)
                 return Promise.resolve();
+            if (connection) {
+                if (connection.isClosed()) {
+                    return Promise.reject('Provided connection is closed');
+                }
+                this.natsConnection = connection;
+                return Promise.resolve();
+            }
             try {
                 return yield connect(this.connectionOptions)
                     .then((connection) => {
-                    this.connection = connection;
+                    this.natsConnection = connection;
                     return Promise.resolve();
                 })
                     .catch((error) => Promise.reject(`Failed to connect to ${this.connectionOptions.servers} with ${error}`));
@@ -288,9 +334,9 @@ export class BaseClient {
     close() {
         return __awaiter(this, void 0, void 0, function* () {
             var _a;
-            if (this.connection) {
-                yield ((_a = this.connection) === null || _a === void 0 ? void 0 : _a.close().then(() => {
-                    this.connection = null;
+            if (this.natsConnection) {
+                yield ((_a = this.natsConnection) === null || _a === void 0 ? void 0 : _a.close().then(() => {
+                    this.natsConnection = null;
                 }).catch((error) => {
                     throw new Error(`failed to close connection: ${error}`);
                 }));
@@ -617,6 +663,7 @@ export class BaseClient {
      * Dispatches a request with the given subject and returns a Promise of type T
      * @param subject The subject to send the request to
      * @returns Promise<T> The response from the request
+     * @deprecated Use {@link request} instead.
      */
     dispatchRequest(subject, payload, options) {
         return __awaiter(this, void 0, void 0, function* () {

package/dist/mjs/DTOs.d.ts

@@ -876,7 +876,8 @@ export declare enum SessionState {
     Breaking = "Breaking",
     Aborting = "Aborting",
     WaitingForUserInput = "WaitingForUserInput",
-    Loading = "Loading"
+    Loading = "Loading",
+    Restarting = "Restarting"
 }
 export declare class TestPlan implements ITestPlan {
     childTestSteps?: TestStep[] | undefined;
@@ -1207,7 +1208,9 @@ export declare enum SessionEventName {
     TestStepChanged = "TestStepChanged",
     Break = "Break",
     UserInputRequested = "UserInputRequested",
-    UserInputRequestCompleted = "UserInputRequestCompleted"
+    UserInputRequestCompleted = "UserInputRequestCompleted",
+    RestartInitiated = "RestartInitiated",
+    RestartCompleted = "RestartCompleted"
 }
 export declare abstract class SessionEvent {
     readonly eventName: SessionEventName;
@@ -1315,6 +1318,21 @@ export declare class UserInputRequestCompletedEvent extends SessionEvent {
     static fromJS(data: any): UserInputRequestCompletedEvent;
     toJSON(data?: any): any;
 }
+export declare class RestartInitiatedEvent extends SessionEvent {
+    oldProcessId?: number;
+    constructor(data?: Partial<RestartInitiatedEvent>);
+    init(_data?: any): void;
+    static fromJS(data: any): RestartInitiatedEvent;
+    toJSON(data?: any): any;
+}
+export declare class RestartCompletedEvent extends SessionEvent {
+    success?: boolean;
+    newProcessId?: number;
+    constructor(data?: Partial<RestartCompletedEvent>);
+    init(_data?: any): void;
+    static fromJS(data: any): RestartCompletedEvent;
+    toJSON(data?: any): any;
+}
 export type ISessionEvent = SessionEvent;
 export interface IOnTestPlanRun {
     status?: string;

package/dist/mjs/DTOs.js

@@ -2143,6 +2143,7 @@ export var SessionState;
     SessionState["Aborting"] = "Aborting";
     SessionState["WaitingForUserInput"] = "WaitingForUserInput";
     SessionState["Loading"] = "Loading";
+    SessionState["Restarting"] = "Restarting";
 })(SessionState || (SessionState = {}));
 export class TestPlan {
     constructor(data) {
@@ -2925,6 +2926,8 @@ export var SessionEventName;
     SessionEventName["Break"] = "Break";
     SessionEventName["UserInputRequested"] = "UserInputRequested";
     SessionEventName["UserInputRequestCompleted"] = "UserInputRequestCompleted";
+    SessionEventName["RestartInitiated"] = "RestartInitiated";
+    SessionEventName["RestartCompleted"] = "RestartCompleted";
 })(SessionEventName || (SessionEventName = {}));
 export class SessionEvent {
     constructor(eventName) {
@@ -3200,6 +3203,52 @@ export class UserInputRequestCompletedEvent extends SessionEvent {
         return json;
     }
 }
+export class RestartInitiatedEvent extends SessionEvent {
+    constructor(data) {
+        super(SessionEventName.RestartInitiated);
+        if (data) {
+            Object.assign(this, data);
+        }
+    }
+    init(_data) {
+        const data = ensureObject(_data);
+        this.oldProcessId = data['OldProcessId'];
+    }
+    static fromJS(data) {
+        const result = new RestartInitiatedEvent();
+        result.init(data);
+        return result;
+    }
+    toJSON(data) {
+        const json = ensureObject(data);
+        json['OldProcessId'] = this.oldProcessId;
+        return json;
+    }
+}
+export class RestartCompletedEvent extends SessionEvent {
+    constructor(data) {
+        super(SessionEventName.RestartCompleted);
+        if (data) {
+            Object.assign(this, data);
+        }
+    }
+    init(_data) {
+        const data = ensureObject(_data);
+        this.success = data['Success'];
+        this.newProcessId = data['NewProcessId'];
+    }
+    static fromJS(data) {
+        const result = new RestartCompletedEvent();
+        result.init(data);
+        return result;
+    }
+    toJSON(data) {
+        const json = ensureObject(data);
+        json['Success'] = this.success;
+        json['NewProcessId'] = this.newProcessId;
+        return json;
+    }
+}
 export class OnTestPlanRun {
     constructor(data) {
         if (data) {

package/dist/mjs/RunnerClient.d.ts

@@ -58,6 +58,12 @@ export declare class RunnerClient extends BaseClient {
      * @returns {{Promise<void>}}
      */
     shutdownSession(sessionId: string, force?: boolean): Promise<void>;
+    /**
+     * Restart a session
+     * @param sessionId the ID of the session to restart
+     * @returns {{Promise<void>}}
+     */
+    restartSession(sessionId: string): Promise<void>;
     /**
      * Start a session
      * @returns {{Promise<Session>}}

package/dist/mjs/RunnerClient.js

@@ -171,6 +171,16 @@ export class RunnerClient extends BaseClient {
                 .catch(this.error())
             : Promise.reject('sessionId is not defined');
     }
+    /**
+     * Restart a session
+     * @param sessionId the ID of the session to restart
+     * @returns {{Promise<void>}}
+     */
+    restartSession(sessionId) {
+        return (sessionId === null || sessionId === void 0 ? void 0 : sessionId.length) > 0
+            ? this.request('RestartSession', { SessionId: sessionId }).then(this.success()).catch(this.error())
+            : Promise.reject('sessionId is not defined');
+    }
     /**
      * Start a session
      * @returns {{Promise<Session>}}

package/dist/mjs/SessionClient.js

@@ -1,4 +1,4 @@
-import { BreakEvent, BreakPoints, CommonContext, CommonSettings, DataGridControl, GetTestPlanReferenceResponse, HeartbeatEvent, Image, Interaction, ListItemType, LogList, MetricsConfiguration, OnTestPlanRun, OnTestStepRun, Result, RunStatus, SaveTestPlanToRepositoryResponse, SessionEventName, SessionStateChangedEvent, SessionTimeoutEvent, Setting, SettingsChangedEvent, StartingEvent, StartedEvent, StoppedEvent, StoppingEvent, TestPlan, TestPlanChangedEvent, TestPlanReferenceChangedEvent, TestPlanSettingsChangedEvent, TestStepChangedEvent, TestStepType, TestStepValidationError, TypeCacheInvalidatedEvent, UserInputRequestCompletedEvent, UserInputRequestedEvent, WatchDog, EditStatus, } from './DTOs';
+import { BreakEvent, BreakPoints, CommonContext, CommonSettings, DataGridControl, GetTestPlanReferenceResponse, HeartbeatEvent, Image, Interaction, ListItemType, LogList, MetricsConfiguration, OnTestPlanRun, OnTestStepRun, Result, RunStatus, SaveTestPlanToRepositoryResponse, SessionEventName, SessionStateChangedEvent, SessionTimeoutEvent, Setting, SettingsChangedEvent, StartingEvent, StartedEvent, StoppedEvent, StoppingEvent, TestPlan, TestPlanChangedEvent, TestPlanReferenceChangedEvent, TestPlanSettingsChangedEvent, TestStepChangedEvent, TestStepType, TestStepValidationError, TypeCacheInvalidatedEvent, UserInputRequestCompletedEvent, UserInputRequestedEvent, RestartInitiatedEvent, RestartCompletedEvent, WatchDog, EditStatus, } from './DTOs';
 import { BaseClient } from './BaseClient';
 import { jsonCodec } from './encoders';
 import { NIL } from 'uuid';
@@ -808,4 +808,6 @@ SessionClient.sessionEventFactories = {
     [SessionEventName.Break]: payload => BreakEvent.fromJS(payload),
     [SessionEventName.UserInputRequested]: payload => UserInputRequestedEvent.fromJS(payload),
     [SessionEventName.UserInputRequestCompleted]: payload => UserInputRequestCompletedEvent.fromJS(payload),
+    [SessionEventName.RestartInitiated]: payload => RestartInitiatedEvent.fromJS(payload),
+    [SessionEventName.RestartCompleted]: payload => RestartCompletedEvent.fromJS(payload),
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@opentap/runner-client",
-  "version": "4.2.0",
+  "version": "4.4.0-beta.1.34231471562",
   "description": "This is the web client for the OpenTAP Runner.",
   "main": "./dist/cjs/index.js",
   "module": "./dist/mjs/index.js",