@sonisoft/now-sdk-ext-core 1.0.0-alpha.33 → 2.0.0-alpha.0

package/dist/sn/application/CompanyApplications.d.ts

@@ -0,0 +1,234 @@
+import { ServiceNowInstance } from "../ServiceNowInstance.js";
+/**
+ * CompanyApplications class for retrieving company application information
+ * Provides methods to get applications shared internally within the company
+ */
+export declare class CompanyApplications {
+    private readonly COMPANY_APPS_API_URL;
+    private _logger;
+    private _req;
+    private _instance;
+    constructor(instance: ServiceNowInstance);
+    /**
+     * Gets the list of company applications shared internally
+     * @param sharedInternally Filter for internally shared applications (default: true)
+     * @param isFirstLoad Indicates if this is the first load (default: true)
+     * @returns Promise<CompanyApplicationsResponse> Response containing list of applications
+     */
+    getCompanyApplications(sharedInternally?: boolean, isFirstLoad?: boolean): Promise<CompanyApplicationsResponse>;
+    /**
+     * Gets a specific company application by scope
+     * @param scope The application scope to search for
+     * @param sharedInternally Filter for internally shared applications (default: true)
+     * @returns Promise<CompanyApplication | null> The application if found, null otherwise
+     */
+    getCompanyApplicationByScope(scope: string, sharedInternally?: boolean): Promise<CompanyApplication | null>;
+    /**
+     * Gets a specific company application by sys_id
+     * @param sysId The application sys_id to search for
+     * @param sharedInternally Filter for internally shared applications (default: true)
+     * @returns Promise<CompanyApplication | null> The application if found, null otherwise
+     */
+    getCompanyApplicationBySysId(sysId: string, sharedInternally?: boolean): Promise<CompanyApplication | null>;
+    /**
+     * Gets only installed company applications
+     * @param sharedInternally Filter for internally shared applications (default: true)
+     * @returns Promise<CompanyApplication[]> Array of installed applications
+     */
+    getInstalledCompanyApplications(sharedInternally?: boolean): Promise<CompanyApplication[]>;
+}
+/**
+ * Response from company applications API
+ */
+export interface CompanyApplicationsResponse {
+    /** Application server URL */
+    appServer: string;
+    /** Array of company applications */
+    data: CompanyApplication[];
+    /** Data processing time in milliseconds */
+    dataProcessingTime: number;
+    /** Repository response time in milliseconds */
+    reporesponsetime: number;
+    /** Store URL */
+    storeURL: string;
+    /** Store tracker ID */
+    storetrackerId: string;
+}
+/**
+ * Represents a company application
+ */
+export interface CompanyApplication {
+    /** Whether the application is active */
+    active: boolean;
+    /** Application schedule details */
+    app_schedule_details: Record<string, unknown>;
+    /** Assigned version */
+    assigned_version: string;
+    /** Whether installation is blocked */
+    block_install: boolean;
+    /** Block message if installation is blocked */
+    block_message: string;
+    /** Whether the app can be edited in Studio */
+    can_edit_in_studio: boolean;
+    /** Whether the app can be installed or upgraded */
+    can_install_or_upgrade: boolean;
+    /** Whether customization can be installed or upgraded */
+    can_install_or_upgrade_customization: boolean;
+    /** Whether the app can be opened in Studio */
+    can_open_in_studio: boolean;
+    /** Compatibility information */
+    compatibilities: string;
+    /** Whether the app contains plugins */
+    contains_plugins: boolean;
+    /** Custom table count */
+    custom_table_count: string;
+    /** Customized version information */
+    customized_version_info: Record<string, unknown>;
+    /** Demo data status */
+    demo_data: string;
+    /** Application dependencies */
+    dependencies: string | null;
+    /** Display message */
+    display_message: string | null;
+    /** Whether the app has a manifest */
+    has_manifest: boolean;
+    /** Indicators array */
+    indicators: unknown[];
+    /** Installation date */
+    install_date: string;
+    /** Whether installed as a dependency */
+    installed_as_dependency: boolean;
+    /** Whether this is an App Store plugin */
+    isAppstorePlugin: boolean;
+    /** Whether the application is installed */
+    isInstalled: boolean;
+    /** Whether this is a customized app */
+    is_customized_app: boolean;
+    /** Whether this is a store app */
+    is_store_app: boolean;
+    /** Latest version available */
+    latest_version: string;
+    /** Latest version display name */
+    latest_version_display: string;
+    /** Link to the application */
+    link: string;
+    /** Line of business array */
+    lob: unknown[];
+    /** Logo URL */
+    logo: string;
+    /** Application name */
+    name: string;
+    /** Whether App Engine licensing is needed */
+    needs_app_engine_licensing: boolean;
+    /** Whether optional apps are available */
+    optional_apps_available: boolean;
+    /** Price type */
+    price_type: string;
+    /** Products array */
+    products: unknown[];
+    /** Publish date display */
+    publish_date_display: string;
+    /** Application scope */
+    scope: string;
+    /** Whether shared internally */
+    shared_internally: string;
+    /** Short description */
+    short_description: string;
+    /** Source information */
+    source: string;
+    /** Store link URL */
+    store_link: string;
+    /** System code */
+    sys_code: string | null;
+    /** System created on timestamp */
+    sys_created_on: string;
+    /** System created on display */
+    sys_created_on_display: string;
+    /** System ID */
+    sys_id: string;
+    /** System updated on timestamp */
+    sys_updated_on: string;
+    /** System updated on display */
+    sys_updated_on_display: string;
+    /** Whether uninstall is blocked */
+    uninstall_blocked: boolean;
+    /** Update date */
+    update_date: string;
+    /** Upload information */
+    upload_info: string;
+    /** Vendor name */
+    vendor: string;
+    /** Vendor prefix */
+    vendor_prefix: string;
+    /** Current version (if installed) */
+    version: string;
+    /** Array of available versions */
+    versions: CompanyApplicationVersion[];
+}
+/**
+ * Represents a version of a company application
+ */
+export interface CompanyApplicationVersion {
+    /** Auto-update flag */
+    auto_update: string;
+    /** Whether installation is blocked for this version */
+    block_install: boolean;
+    /** Block message if installation is blocked */
+    block_message: string | null;
+    /** Compatibility information */
+    compatibilities: string;
+    /** Whether this version contains plugins */
+    contains_plugins: boolean;
+    /** Custom table count */
+    custom_table_count: string;
+    /** Whether this version has demo data */
+    demo_data: boolean;
+    /** Dependencies for this version */
+    dependencies: string | null;
+    /** Display message */
+    display_message: string;
+    /** Whether this version has a manifest */
+    has_manifest: boolean;
+    /** Indicators array */
+    indicators: unknown[];
+    /** Line of business array */
+    lob: unknown[];
+    /** Application name */
+    name: string;
+    /** Whether App Engine licensing is needed */
+    needs_app_engine_licensing: boolean;
+    /** Version number in repository */
+    number: string;
+    /** Price type */
+    price_type: string;
+    /** Publish date timestamp */
+    publish_date: string;
+    /** Publish date display */
+    publish_date_display: string;
+    /** Remote application sys_id */
+    remote_application: string;
+    /** Application scope */
+    scope: string;
+    /** Short description */
+    short_description: string | null;
+    /** Sortable version number */
+    sortable_version: number;
+    /** Source application ID */
+    source_app_id: string;
+    /** Store link URL */
+    store_link: string;
+    /** System ID of this version */
+    sys_id: string;
+    /** Title of this version */
+    title: string;
+    /** Upload information */
+    upload_info: string;
+    /** Vendor name */
+    vendor: string;
+    /** Vendor key */
+    vendor_key: string;
+    /** Version number */
+    version: string;
+    /** Version display name */
+    version_display: string;
+}

package/dist/sn/application/CompanyApplications.js

@@ -0,0 +1,91 @@
+import { Logger } from "../../util/Logger.js";
+import { ServiceNowRequest } from "../../comm/http/ServiceNowRequest.js";
+/**
+ * CompanyApplications class for retrieving company application information
+ * Provides methods to get applications shared internally within the company
+ */
+export class CompanyApplications {
+    COMPANY_APPS_API_URL = "/sn_appclient_api_v1.do";
+    _logger = new Logger("CompanyApplications");
+    _req;
+    _instance;
+    constructor(instance) {
+        this._instance = instance;
+        this._req = new ServiceNowRequest(instance);
+    }
+    /**
+     * Gets the list of company applications shared internally
+     * @param sharedInternally Filter for internally shared applications (default: true)
+     * @param isFirstLoad Indicates if this is the first load (default: true)
+     * @returns Promise<CompanyApplicationsResponse> Response containing list of applications
+     */
+    async getCompanyApplications(sharedInternally = true, isFirstLoad = true) {
+        const queryParams = {
+            app_request_type: 'list_apps_versions',
+            shared_internally: sharedInternally,
+            isFirstLoad: isFirstLoad,
+            uniq_param: Date.now().toString()
+        };
+        const httpRequest = {
+            method: 'GET',
+            path: this.COMPANY_APPS_API_URL,
+            headers: {
+                'Accept': 'application/json',
+                'Content-Type': 'application/json'
+            },
+            query: queryParams,
+            body: null
+        };
+        this._logger.info(`Fetching company applications (shared_internally: ${sharedInternally})`);
+        const resp = await this._req.get(httpRequest);
+        if (resp.status === 200 && resp.bodyObject) {
+            this._logger.info(`Successfully retrieved ${resp.bodyObject.data?.length || 0} company applications`);
+            return resp.bodyObject;
+        }
+        throw new Error(`Failed to get company applications. Status: ${resp.status}, Response: ${JSON.stringify(resp.bodyObject)}`);
+    }
+    /**
+     * Gets a specific company application by scope
+     * @param scope The application scope to search for
+     * @param sharedInternally Filter for internally shared applications (default: true)
+     * @returns Promise<CompanyApplication | null> The application if found, null otherwise
+     */
+    async getCompanyApplicationByScope(scope, sharedInternally = true) {
+        const response = await this.getCompanyApplications(sharedInternally);
+        const application = response.data?.find(app => app.scope === scope);
+        if (application) {
+            this._logger.info(`Found application: ${application.name} (${scope})`);
+            return application;
+        }
+        this._logger.warn(`Application with scope '${scope}' not found`);
+        return null;
+    }
+    /**
+     * Gets a specific company application by sys_id
+     * @param sysId The application sys_id to search for
+     * @param sharedInternally Filter for internally shared applications (default: true)
+     * @returns Promise<CompanyApplication | null> The application if found, null otherwise
+     */
+    async getCompanyApplicationBySysId(sysId, sharedInternally = true) {
+        const response = await this.getCompanyApplications(sharedInternally);
+        const application = response.data?.find(app => app.sys_id === sysId);
+        if (application) {
+            this._logger.info(`Found application: ${application.name} (${sysId})`);
+            return application;
+        }
+        this._logger.warn(`Application with sys_id '${sysId}' not found`);
+        return null;
+    }
+    /**
+     * Gets only installed company applications
+     * @param sharedInternally Filter for internally shared applications (default: true)
+     * @returns Promise<CompanyApplication[]> Array of installed applications
+     */
+    async getInstalledCompanyApplications(sharedInternally = true) {
+        const response = await this.getCompanyApplications(sharedInternally);
+        const installedApps = response.data?.filter(app => app.isInstalled) || [];
+        this._logger.info(`Found ${installedApps.length} installed company applications`);
+        return installedApps;
+    }
+}
+//# sourceMappingURL=CompanyApplications.js.map

package/dist/sn/application/CompanyApplications.js.map

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

package/dist/sn/atf/ATFTestExecutor.d.ts

@@ -10,6 +10,55 @@ export declare class ATFTestExecutor {
     private doGetTestProgress;
     private getTestProgress;
     private getTestResult;
+    /**
+     * Executes a test suite by sys_id using the ServiceNow CI/CD API
+     * @param testSuiteSysId The sys_id of the test suite to execute
+     * @param options Optional execution parameters
+     * @returns Promise<TestSuiteExecutionResponse> The execution response with progress information
+     */
+    executeTestSuite(testSuiteSysId: string, options?: Partial<TestSuiteExecutionRequest>): Promise<TestSuiteExecutionResponse>;
+    /**
+     * Executes a test suite by name using the ServiceNow CI/CD API
+     * @param testSuiteName The name of the test suite to execute
+     * @param options Optional execution parameters
+     * @returns Promise<TestSuiteExecutionResponse> The execution response with progress information
+     */
+    executeTestSuiteByName(testSuiteName: string, options?: Partial<TestSuiteExecutionRequest>): Promise<TestSuiteExecutionResponse>;
+    /**
+     * Gets the progress of a test suite execution
+     * @param progressId The progress ID from the execution response
+     * @returns Promise<TestSuiteExecutionResponse> The current progress information
+     */
+    getTestSuiteProgress(progressId: string): Promise<TestSuiteExecutionResponse>;
+    /**
+     * Waits for test suite execution to complete and returns the results
+     * @param progressId The progress ID from the execution response
+     * @param pollIntervalMs Polling interval in milliseconds (default: 5000)
+     * @returns Promise<TestSuiteExecutionResult> The final execution results
+     */
+    waitForTestSuiteCompletion(progressId: string, pollIntervalMs?: number): Promise<TestSuiteExecutionResult>;
+    /**
+     * Gets the results of a completed test suite execution
+     * @param resultsId The results ID from the progress response
+     * @returns Promise<TestSuiteExecutionResult> The execution results
+     */
+    getTestSuiteResults(resultsId: string): Promise<TestSuiteExecutionResult>;
+    /**
+     * Executes a test suite and waits for completion
+     * @param testSuiteSysId The sys_id of the test suite to execute
+     * @param options Optional execution parameters
+     * @param pollIntervalMs Polling interval in milliseconds (default: 5000)
+     * @returns Promise<TestSuiteExecutionResult> The final execution results
+     */
+    executeTestSuiteAndWait(testSuiteSysId: string, options?: Partial<TestSuiteExecutionRequest>, pollIntervalMs?: number): Promise<TestSuiteExecutionResult>;
+    /**
+     * Executes a test suite by name and waits for completion
+     * @param testSuiteName The name of the test suite to execute
+     * @param options Optional execution parameters
+     * @param pollIntervalMs Polling interval in milliseconds (default: 5000)
+     * @returns Promise<TestSuiteExecutionResult> The final execution results
+     */
+    executeTestSuiteByNameAndWait(testSuiteName: string, options?: Partial<TestSuiteExecutionRequest>, pollIntervalMs?: number): Promise<TestSuiteExecutionResult>;
 }
 export type TestResult = {
     "end_time_millis": string;
@@ -23,3 +72,44 @@ export type TestResult = {
     "run_time": string;
     "status": string;
 };
+export interface TestSuiteExecutionRequest {
+    test_suite_sys_id?: string;
+    test_suite_name?: string;
+    browser_name?: string;
+    browser_version?: string;
+    is_performance_run?: boolean;
+    os_name?: string;
+    os_version?: string;
+    run_in_cloud?: boolean;
+}
+export interface TestSuiteExecutionResponse {
+    links: {
+        progress: {
+            id: string;
+            url: string;
+        };
+        results?: {
+            id: string;
+            url: string;
+        };
+    };
+    status: string;
+    status_label: string;
+    status_message: string;
+    status_detail: string;
+    error: string;
+    percent_complete: number;
+}
+export interface TestSuiteExecutionResult {
+    sys_id: string;
+    test_suite: ReferenceLink;
+    status: string;
+    start_time: string;
+    end_time: string;
+    duration: string;
+    total_tests: number;
+    passed_tests: number;
+    failed_tests: number;
+    skipped_tests: number;
+    output: string;
+}

package/dist/sn/atf/ATFTestExecutor.js

@@ -8,7 +8,7 @@ export class ATFTestExecutor {
         this._req = new ServiceNowRequest(instance);
     }
     async executeTest(testId) {
-        let dataObj = {
+        const dataObj = {
             'sysparm_want_session_messages': 'true',
             'sysparm_ajax_processor_ut_test_id': testId,
             'sysparm_ajax_processor_test_runner_session_id': '',
@@ -19,13 +19,13 @@ export class ATFTestExecutor {
             'ni.nolog.x_referer': 'ignore',
             'x_referer': 'sys_atf_test.do%3Fsys_id%3D817a3214835b4210a9f8aec0deaad3f4%26sysparm_view%3D%26sysparm_domain%3Dnull%26sysparm_domain_scope%3Dnull'
         };
-        let proc = new ServiceNowProcessorRequest(this._instance);
-        let result = await proc.execute("TestExecutorAjax", "start", "global", dataObj);
+        const proc = new ServiceNowProcessorRequest(this._instance);
+        const result = await proc.execute("TestExecutorAjax", "start", "global", dataObj);
         //In this case, result is the progress worker id.
         if (result != null) {
-            let resultId = await this.waitForTestCompletion(result);
+            const resultId = await this.waitForTestCompletion(result);
             if (resultId) {
-                let testResult = await this.getTestResult(resultId);
+                const testResult = await this.getTestResult(resultId);
                 if (testResult)
                     return testResult;
             }
@@ -46,35 +46,194 @@ export class ATFTestExecutor {
         return null;
     }
     async doGetTestProgress(progressId) {
-        let data = await this.getTestProgress(progressId);
+        const data = await this.getTestProgress(progressId);
         try {
             if (data.result) {
                 return data.result;
             }
         }
-        catch (err) {
+        catch {
             return null;
         }
         return null;
     }
     async getTestProgress(progressId) {
-        let request = { path: "/api/sn_cicd/progress/" + progressId, headers: null, query: null, body: null };
-        let resp = await this._req.get(request);
+        const request = { path: "/api/sn_cicd/progress/" + progressId, headers: null, query: null, body: null };
+        const resp = await this._req.get(request);
         if (resp.status == 200) {
             return resp.bodyObject;
         }
         return null;
     }
     async getTestResult(testResultId) {
-        let request = { path: "/api/now/table/sys_atf_test_result?sysparm_query=sys_id=" + testResultId, headers: null, query: null, body: null };
-        let resp = await this._req.get(request);
+        const request = { path: "/api/now/table/sys_atf_test_result?sysparm_query=sys_id=" + testResultId, headers: null, query: null, body: null };
+        const resp = await this._req.get(request);
         if (resp.status == 200) {
-            let tableResp = resp.bodyObject;
+            const tableResp = resp.bodyObject;
             if (tableResp.result && tableResp.result.length > 0) {
                 return tableResp.result[0];
             }
         }
         return null;
     }
+    // private async getTestStepResults(){
+    // }
+    /**
+     * Executes a test suite by sys_id using the ServiceNow CI/CD API
+     * @param testSuiteSysId The sys_id of the test suite to execute
+     * @param options Optional execution parameters
+     * @returns Promise<TestSuiteExecutionResponse> The execution response with progress information
+     */
+    async executeTestSuite(testSuiteSysId, options) {
+        const queryParams = {
+            test_suite_sys_id: testSuiteSysId
+        };
+        // Add optional parameters if provided
+        if (options) {
+            if (options.browser_name)
+                queryParams.browser_name = options.browser_name;
+            if (options.browser_version)
+                queryParams.browser_version = options.browser_version;
+            if (options.is_performance_run !== undefined)
+                queryParams.is_performance_run = options.is_performance_run;
+            if (options.os_name)
+                queryParams.os_name = options.os_name;
+            if (options.os_version)
+                queryParams.os_version = options.os_version;
+            if (options.run_in_cloud !== undefined)
+                queryParams.run_in_cloud = options.run_in_cloud;
+        }
+        const request = {
+            path: "/api/sn_cicd/testsuite/run",
+            headers: {
+                'Accept': 'application/json'
+            },
+            query: queryParams,
+            body: null
+        };
+        const resp = await this._req.post(request);
+        if (resp.status === 200 && resp.bodyObject && resp.bodyObject.result) {
+            return resp.bodyObject.result;
+        }
+        throw new Error(`Failed to execute test suite. Status: ${resp.status}, Response: ${JSON.stringify(resp.bodyObject)}`);
+    }
+    /**
+     * Executes a test suite by name using the ServiceNow CI/CD API
+     * @param testSuiteName The name of the test suite to execute
+     * @param options Optional execution parameters
+     * @returns Promise<TestSuiteExecutionResponse> The execution response with progress information
+     */
+    async executeTestSuiteByName(testSuiteName, options) {
+        const queryParams = {
+            test_suite_name: testSuiteName
+        };
+        // Add optional parameters if provided
+        if (options) {
+            if (options.browser_name)
+                queryParams.browser_name = options.browser_name;
+            if (options.browser_version)
+                queryParams.browser_version = options.browser_version;
+            if (options.is_performance_run !== undefined)
+                queryParams.is_performance_run = options.is_performance_run;
+            if (options.os_name)
+                queryParams.os_name = options.os_name;
+            if (options.os_version)
+                queryParams.os_version = options.os_version;
+            if (options.run_in_cloud !== undefined)
+                queryParams.run_in_cloud = options.run_in_cloud;
+        }
+        const request = {
+            path: "/api/sn_cicd/testsuite/run",
+            headers: {
+                'Accept': 'application/json'
+            },
+            query: queryParams,
+            body: null
+        };
+        const resp = await this._req.post(request);
+        if (resp.status === 200 && resp.bodyObject && resp.bodyObject.result) {
+            return resp.bodyObject.result;
+        }
+        throw new Error(`Failed to execute test suite by name. Status: ${resp.status}, Response: ${JSON.stringify(resp.bodyObject)}`);
+    }
+    /**
+     * Gets the progress of a test suite execution
+     * @param progressId The progress ID from the execution response
+     * @returns Promise<TestSuiteExecutionResponse> The current progress information
+     */
+    async getTestSuiteProgress(progressId) {
+        const request = {
+            path: `/api/sn_cicd/progress/${progressId}`,
+            headers: {
+                'Accept': 'application/json'
+            },
+            query: null,
+            body: null
+        };
+        const resp = await this._req.get(request);
+        if (resp.status === 200 && resp.bodyObject && resp.bodyObject.result) {
+            return resp.bodyObject.result;
+        }
+        throw new Error(`Failed to get test suite progress. Status: ${resp.status}, Response: ${JSON.stringify(resp.bodyObject)}`);
+    }
+    /**
+     * Waits for test suite execution to complete and returns the results
+     * @param progressId The progress ID from the execution response
+     * @param pollIntervalMs Polling interval in milliseconds (default: 5000)
+     * @returns Promise<TestSuiteExecutionResult> The final execution results
+     */
+    async waitForTestSuiteCompletion(progressId, pollIntervalMs = 5000) {
+        let progress = await this.getTestSuiteProgress(progressId);
+        while (progress.percent_complete < 100 && progress.status !== "3" && progress.status !== "4") {
+            await new Promise(resolve => setTimeout(resolve, pollIntervalMs));
+            progress = await this.getTestSuiteProgress(progressId);
+        }
+        if (progress.links && progress.links.results && progress.links.results.id) {
+            return await this.getTestSuiteResults(progress.links.results.id);
+        }
+        throw new Error(`Test suite execution did not complete successfully. Status: ${progress.status_label}, Error: ${progress.error}`);
+    }
+    /**
+     * Gets the results of a completed test suite execution
+     * @param resultsId The results ID from the progress response
+     * @returns Promise<TestSuiteExecutionResult> The execution results
+     */
+    async getTestSuiteResults(resultsId) {
+        const request = {
+            path: `/api/now/table/sys_atf_test_suite_result?sysparm_query=sys_id=${resultsId}`,
+            headers: {
+                'Accept': 'application/json'
+            },
+            query: null,
+            body: null
+        };
+        const resp = await this._req.get(request);
+        if (resp.status === 200 && resp.bodyObject && resp.bodyObject.result && resp.bodyObject.result.length > 0) {
+            return resp.bodyObject.result[0];
+        }
+        throw new Error(`Failed to get test suite results. Status: ${resp.status}, Response: ${JSON.stringify(resp.bodyObject)}`);
+    }
+    /**
+     * Executes a test suite and waits for completion
+     * @param testSuiteSysId The sys_id of the test suite to execute
+     * @param options Optional execution parameters
+     * @param pollIntervalMs Polling interval in milliseconds (default: 5000)
+     * @returns Promise<TestSuiteExecutionResult> The final execution results
+     */
+    async executeTestSuiteAndWait(testSuiteSysId, options, pollIntervalMs = 5000) {
+        const executionResponse = await this.executeTestSuite(testSuiteSysId, options);
+        return await this.waitForTestSuiteCompletion(executionResponse.links.progress.id, pollIntervalMs);
+    }
+    /**
+     * Executes a test suite by name and waits for completion
+     * @param testSuiteName The name of the test suite to execute
+     * @param options Optional execution parameters
+     * @param pollIntervalMs Polling interval in milliseconds (default: 5000)
+     * @returns Promise<TestSuiteExecutionResult> The final execution results
+     */
+    async executeTestSuiteByNameAndWait(testSuiteName, options, pollIntervalMs = 5000) {
+        const executionResponse = await this.executeTestSuiteByName(testSuiteName, options);
+        return await this.waitForTestSuiteCompletion(executionResponse.links.progress.id, pollIntervalMs);
+    }
 }
 //# sourceMappingURL=ATFTestExecutor.js.map