@openfin/core 33.76.31 → 33.76.38

package/src/api/system/index.js

@@ -1,895 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-const base_1 = require("../base");
-const transport_errors_1 = require("../../transport/transport-errors");
-const window_1 = require("../window");
-const events_1 = require("events");
-/**
- * An object representing the core of OpenFin Runtime. Allows the developer
- * to perform system-level actions, such as accessing logs, viewing processes,
- * clearing the cache and exiting the runtime as well as listen to <a href="tutorial-System.EventEmitter.html">system events</a>.
- * @namespace
- */
-class System extends base_1.EmitterBase {
-    constructor(wire) {
-        super(wire, 'system');
-    }
-    sendExternalProcessRequest(action, options) {
-        return new Promise((resolve, reject) => {
-            const exitEventKey = 'external-process-exited';
-            let processUuid;
-            let exitPayload;
-            let externalProcessExitHandler;
-            let ofWindow;
-            if (typeof options.listener === 'function') {
-                externalProcessExitHandler = (payload) => {
-                    const data = payload || {};
-                    exitPayload = {
-                        topic: 'exited',
-                        uuid: data.processUuid || '',
-                        exitCode: data.exitCode || 0
-                    };
-                    if (processUuid === payload.processUuid) {
-                        options.listener(exitPayload);
-                        ofWindow.removeListener(exitEventKey, externalProcessExitHandler);
-                    }
-                };
-                // window constructor expects the name is not undefined
-                if (!this.wire.me.name) {
-                    this.wire.me.name = this.wire.me.uuid;
-                }
-                ofWindow = new window_1._Window(this.wire, this.wire.me);
-                ofWindow.on(exitEventKey, externalProcessExitHandler);
-            }
-            this.wire
-                .sendAction(action, options)
-                .then(({ payload }) => {
-                processUuid = payload.data.uuid;
-                resolve(payload.data);
-                if (exitPayload && processUuid === exitPayload.uuid) {
-                    options.listener(exitPayload);
-                    ofWindow.removeListener(exitEventKey, externalProcessExitHandler);
-                }
-            })
-                .catch((err) => {
-                if (ofWindow) {
-                    ofWindow.removeListener(exitEventKey, externalProcessExitHandler);
-                }
-                reject(err);
-            });
-        });
-    }
-    /**
-     * Adds a listener to the end of the listeners array for the specified event.
-     * @param { string | symbol } eventType  - The type of the event.
-     * @param { Function } listener - Called whenever an event of the specified type occurs.
-     * @param { SubOptions } [options] - Option to support event timestamps.
-     * @return {Promise.<this>}
-     * @function addListener
-     * @memberof System
-     * @instance
-     * @tutorial System.EventEmitter
-     */
-    /**
-     * Adds a listener to the end of the listeners array for the specified event.
-     * @param { string | symbol } eventType  - The type of the event.
-     * @param { Function } listener - Called whenever an event of the specified type occurs.
-     * @param { SubOptions } [options] - Option to support event timestamps.
-     * @return {Promise.<this>}
-     * @function on
-     * @memberof System
-     * @instance
-     * @tutorial System.EventEmitter
-     */
-    /**
-     * Adds a one time listener for the event. The listener is invoked only the first time the event is fired, after which it is removed.
-     * @param { string | symbol } eventType  - The type of the event.
-     * @param { Function } listener - The callback function.
-     * @param { SubOptions } [options] - Option to support event timestamps.
-     * @return {Promise.<this>}
-     * @function once
-     * @memberof System
-     * @instance
-     * @tutorial System.EventEmitter
-     */
-    /**
-     * Adds a listener to the beginning of the listeners array for the specified event.
-     * @param { string | symbol } eventType  - The type of the event.
-     * @param { Function } listener - The callback function.
-     * @param { SubOptions } [options] - Option to support event timestamps.
-     * @return {Promise.<this>}
-     * @function prependListener
-     * @memberof System
-     * @instance
-     * @tutorial System.EventEmitter
-     */
-    /**
-     * Adds a one time listener for the event. The listener is invoked only the first time the event is fired, after which it is removed.
-     * The listener is added to the beginning of the listeners array.
-     * @param { string | symbol } eventType  - The type of the event.
-     * @param { Function } listener - The callback function.
-     * @param { SubOptions } [options] - Option to support event timestamps.
-     * @return {Promise.<this>}
-     * @function prependOnceListener
-     * @memberof System
-     * @instance
-     * @tutorial System.EventEmitter
-     */
-    /**
-     * Remove a listener from the listener array for the specified event.
-     * Caution: Calling this method changes the array indices in the listener array behind the listener.
-     * @param { string | symbol } eventType  - The type of the event.
-     * @param { Function } listener - The callback function.
-     * @param { SubOptions } [options] - Option to support event timestamps.
-     * @return {Promise.<this>}
-     * @function removeListener
-     * @memberof System
-     * @instance
-     * @tutorial System.EventEmitter
-     */
-    /**
-     * Removes all listeners, or those of the specified event.
-     * @param { string | symbol } [eventType]  - The type of the event.
-     * @return {Promise.<this>}
-     * @function removeAllListeners
-     * @memberof System
-     * @instance
-     * @tutorial System.EventEmitter
-     */
-    /**
-     * Returns the version of the runtime. The version contains the major, minor,
-     * build and revision numbers.
-     * @return {Promise.<string>}
-     * @tutorial System.getVersion
-     */
-    getVersion() {
-        return this.wire.sendAction('get-version').then(({ payload }) => payload.data);
-    }
-    /**
-     * Clears cached data containing application resource
-     * files (images, HTML, JavaScript files), cookies, and items stored in the
-     * Local Storage.
-     * @param { ClearCacheOption } options - See tutorial for more details.
-     * @return {Promise.<void>}
-     * @tutorial System.clearCache
-     */
-    clearCache(options) {
-        return this.wire.sendAction('clear-cache', options).then(() => undefined);
-    }
-    /**
-     * Clears all cached data when OpenFin Runtime exits.
-     * @return {Promise.<void>}
-     * @tutorial System.deleteCacheOnExit
-     */
-    deleteCacheOnExit() {
-        return this.wire.sendAction('delete-cache-request').then(() => undefined);
-    }
-    /**
-     * Exits the Runtime.
-     * @return {Promise.<void>}
-     * @tutorial System.exit
-     */
-    exit() {
-        return this.wire.sendAction('exit-desktop').then(() => undefined);
-    }
-    /**
-     * Fetches a JSON manifest using the browser process and returns a Javascript object.
-     * @param { string } manifestUrl The URL of the manifest to fetch.
-     * @return {Promise.<any>}
-     * @tutorial System.fetchManifest
-     */
-    async fetchManifest(manifestUrl) {
-        const { payload: { data } } = await this.wire.sendAction('fetch-manifest', { manifestUrl });
-        return data;
-    }
-    /**
-     * Writes any unwritten cookies data to disk.
-     * @return {Promise.<void>}
-     * @tutorial System.flushCookieStore
-     */
-    flushCookieStore() {
-        return this.wire.sendAction('flush-cookie-store').then(() => undefined);
-    }
-    /**
-     * Retrieves an array of data (name, ids, bounds) for all application windows.
-     * @return {Promise.Array.<ApplicationWindowInfo>}
-     * @tutorial System.getAllWindows
-     */
-    getAllWindows() {
-        return this.wire.sendAction('get-all-windows').then(({ payload }) => payload.data);
-    }
-    /**
-     * Retrieves an array of data for all applications.
-     * @return {Promise.Array.<ApplicationState>}
-     * @tutorial System.getAllApplications
-     */
-    getAllApplications() {
-        return this.wire.sendAction('get-all-applications').then(({ payload }) => payload.data);
-    }
-    /**
-     * Retrieves the command line argument string that started OpenFin Runtime.
-     * @return {Promise.<string>}
-     * @tutorial System.getCommandLineArguments
-     */
-    getCommandLineArguments() {
-        return this.wire.sendAction('get-command-line-arguments').then(({ payload }) => payload.data);
-    }
-    /**
-     * Get the current state of the crash reporter.
-     * @return {Promise.<CrashReporterState>}
-     * @tutorial System.getCrashReporterState
-     */
-    async getCrashReporterState() {
-        const { payload: { data: { diagnosticMode, isRunning } } } = await this.wire.sendAction('get-crash-reporter-state');
-        console.warn('diagnosticMode property is deprecated. It will be removed in a future version');
-        return {
-            // diagnosticMode will be removed in a future version
-            diagnosticMode,
-            diagnosticsMode: diagnosticMode,
-            isRunning
-        };
-    }
-    /**
-     * Start the crash reporter if not already running.
-     * @param { CrashReporterOptions } options - configure crash reporter
-     * @return {Promise.<CrashReporterState>}
-     * @tutorial System.startCrashReporter
-     */
-    async startCrashReporter(options) {
-        const opts = options;
-        const newOpts = { ...opts, diagnosticMode: opts.diagnosticsMode || opts.diagnosticMode };
-        const { payload: { data: { diagnosticMode, isRunning } } } = await this.wire.sendAction('start-crash-reporter', newOpts);
-        return {
-            // diagnosticMode will be removed in a future version
-            diagnosticMode,
-            diagnosticsMode: diagnosticMode,
-            isRunning
-        };
-    }
-    /**
-     * Returns a hex encoded hash of the machine id and the currently logged in user name.
-     * This is the recommended way to uniquely identify a user / machine combination.
-     * @return {Promise.<string>}
-     * @tutorial System.getUniqueUserId
-     * @static
-     */
-    getUniqueUserId() {
-        return this.wire.sendAction('get-unique-user-id').then(({ payload }) => payload.data);
-    }
-    /**
-     * Retrieves a frame info object for the uuid and name passed in
-     * @param { string } uuid - The UUID of the target.
-     * @param { string } name - The name of the target.
-     * @return {Promise.<EntityInfo>}
-     * @tutorial System.getEntityInfo
-     */
-    getEntityInfo(uuid, name) {
-        return this.wire.sendAction('get-entity-info', { uuid, name }).then(({ payload }) => payload.data);
-    }
-    /**
-     * Gets the value of a given environment variable on the computer on which the runtime is installed
-     * @return {Promise.<string>}
-     * @tutorial System.getEnvironmentVariable
-     */
-    getEnvironmentVariable(envName) {
-        return this.wire
-            .sendAction('get-environment-variable', {
-            environmentVariables: envName
-        })
-            .then(({ payload }) => payload.data);
-    }
-    /**
-     * Get current focused window.
-     * @return {Promise.<Identity | null>}
-     * @tutorial System.getFocusedWindow
-     */
-    getFocusedWindow() {
-        return this.wire.sendAction('get-focused-window').then(({ payload }) => payload.data);
-    }
-    /**
-     * Returns information about the given app's certification status
-     * @return {Promise.<CertifiedAppInfo>}
-     * @tutorial System.isAppCertified
-     */
-    async isAppCertified(manifestUrl) {
-        const { payload: { data: { certifiedInfo } } } = await this.wire.sendAction('is-app-certified', { manifestUrl });
-        return certifiedInfo;
-    }
-    /**
-     * Returns an array of all the installed runtime versions in an object.
-     * @return {Promise.<string[]>}
-     * @tutorial System.getInstalledRuntimes
-     */
-    // incompatible with standalone node process.
-    getInstalledRuntimes() {
-        return this.wire.sendAction('get-installed-runtimes').then(({ payload }) => payload.data.runtimes);
-    }
-    // incompatible with standalone node process.
-    async getInstalledApps() {
-        const { payload: { data: { installedApps } } } = await this.wire.sendAction('get-installed-apps');
-        return installedApps;
-    }
-    /**
-     * Retrieves the contents of the log with the specified filename.
-     * @param { GetLogRequestType } options A object that id defined by the GetLogRequestType interface
-     * @return {Promise.<string>}
-     * @tutorial System.getLog
-     */
-    getLog(options) {
-        return this.wire.sendAction('view-log', options).then(({ payload }) => payload.data);
-    }
-    /**
-     * Returns a unique identifier (UUID) provided by the machine.
-     * @return {Promise.<string>}
-     * @tutorial System.getMachineId
-     */
-    getMachineId() {
-        return this.wire.sendAction('get-machine-id').then(({ payload }) => payload.data);
-    }
-    /**
-     * Returns the minimum (inclusive) logging level that is currently being written to the log.
-     * @return {Promise.<LogLevel>}
-     * @tutorial System.getMinLogLevel
-     */
-    getMinLogLevel() {
-        return this.wire.sendAction('get-min-log-level').then(({ payload }) => payload.data);
-    }
-    /**
-     * Retrieves an array containing information for each log file.
-     * @return {Promise.Array<LogInfo>}
-     * @tutorial System.getLogList
-     */
-    getLogList() {
-        return this.wire.sendAction('list-logs').then(({ payload }) => payload.data);
-    }
-    /**
-     * Retrieves an object that contains data about the monitor setup of the
-     * computer that the runtime is running on.
-     * @return {Promise.<MonitorInfo>}
-     * @tutorial System.getMonitorInfo
-     */
-    getMonitorInfo() {
-        return this.wire.sendAction('get-monitor-info').then(({ payload }) => payload.data);
-    }
-    /**
-     * Returns the mouse in virtual screen coordinates (left, top).
-     * @return {Promise.<PointTopLeft>}
-     * @tutorial System.getMousePosition
-     */
-    getMousePosition() {
-        return this.wire.sendAction('get-mouse-position').then(({ payload }) => payload.data);
-    }
-    /**
-     * Retrieves an array of all of the runtime processes that are currently
-     * running. Each element in the array is an object containing the uuid
-     * and the name of the application to which the process belongs.
-     * @deprecated Please use our new set of process APIs:
-     * [Window.getProcessInfo]{@link Window#getProcessInfo}
-     * [View.getProcessInfo]{@link View#getProcessInfo}
-     * [Application.getProcessInfo]{@link Application#getProcessInfo}
-     * [System.getAllProcessInfo]{@link System#getAllProcessInfo}
-     * @return {Promise.Array.<ProcessInfo>}
-     * @tutorial System.getProcessList
-     */
-    getProcessList() {
-        // eslint-disable-next-line no-console
-        console.warn('System.getProcessList has been deprecated. Please consider using our new process APIs: Window.getProcessInfo, View.getProcessInfo, Application.getProcessInfo, System.getAllProcessInfo');
-        return this.wire.sendAction('process-snapshot').then(({ payload }) => payload.data);
-    }
-    /**
-     * Retrieves all process information. This includes the browser process and every process associated to all entities (windows and views).
-     * @return {Promise.<SystemProcessInfo>}
-     * @tutorial System.getAllProcessInfo
-     * @experimental
-     */
-    async getAllProcessInfo() {
-        const { payload: { data } } = await this.wire.sendAction('get-all-process-info', this.identity);
-        return data;
-    }
-    /**
-     * Retrieves the Proxy settings.
-     * @return {Promise.<ProxyInfo>}
-     * @tutorial System.getProxySettings
-     */
-    getProxySettings() {
-        return this.wire.sendAction('get-proxy-settings').then(({ payload }) => payload.data);
-    }
-    /**
-     * Returns information about the running Runtime in an object.
-     * @return {Promise.<RuntimeInfo>}
-     * @tutorial System.getRuntimeInfo
-     */
-    getRuntimeInfo() {
-        return this.wire.sendAction('get-runtime-info').then(({ payload }) => payload.data);
-    }
-    /**
-     * Returns information about the running RVM in an object.
-     * @return {Promise.<RVMInfo>}
-     * @tutorial System.getRvmInfo
-     */
-    // incompatible with standalone node process.
-    getRvmInfo() {
-        return this.wire.sendAction('get-rvm-info').then(({ payload }) => payload.data);
-    }
-    /**
-     * Retrieves system information.
-     * @return {Promise.<HostSpecs>}
-     * @tutorial System.getHostSpecs
-     */
-    getHostSpecs() {
-        return this.wire.sendAction('get-host-specs').then(({ payload }) => payload.data);
-    }
-    /**
-     * Runs an executable or batch file. A path to the file must be included in options.
-     * <br> A uuid may be optionally provided. If not provided, OpenFin will create a uuid for the new process.
-     * <br> Note: This method is restricted by default and must be enabled via
-     * <a href="https://developers.openfin.co/docs/api-security">API security settings</a>. Also, this api has an enhanced permission set to make it less dangerous. So application owners can only allow to launch the assets owned by the application, the enabled downloaded files or the restricted executables.
-     * @param { ExternalProcessRequestType } options A object that is defined in the ExternalProcessRequestType interface
-     * @return {Promise.<Identity>}
-     * @tutorial System.launchExternalProcess
-     */
-    launchExternalProcess(options) {
-        return this.sendExternalProcessRequest('launch-external-process', options);
-    }
-    /**
-     * Monitors a running process. A pid for the process must be included in options.
-     * <br> A uuid may be optionally provided. If not provided, OpenFin will create a uuid for the new process.
-     * @param { ExternalProcessInfo } options See tutorial for more details
-     * @return {Promise.<Identity>}
-     * @tutorial System.monitorExternalProcess
-     */
-    monitorExternalProcess(options) {
-        return this.sendExternalProcessRequest('monitor-external-process', options);
-    }
-    /**
-     * Writes the passed message into both the log file and the console.
-     * @param { string } level The log level for the entry. Can be either "info", "warning" or "error"
-     * @param { string } message The log message text
-     * @return {Promise.<void>}
-     * @tutorial System.log
-     */
-    log(level, message) {
-        return this.wire.sendAction('write-to-log', { level, message }).then(() => undefined);
-    }
-    /**
-     * Opens the passed URL in the default web browser. It only supports http(s) and fin(s) protocols by default.
-     * In order to use other custom protocols, they have to be enabled via
-     * <a href="https://developers.openfin.co/docs/api-security">API security settings</a>.
-     * File protocol and file path are not supported.
-     * @param { string } url The URL to open
-     * @return {Promise.<void>}
-     * @tutorial System.openUrlWithBrowser
-     */
-    openUrlWithBrowser(url) {
-        return this.wire.sendAction('open-url-with-browser', { url }).then(() => undefined);
-    }
-    /**
-     * Removes the process entry for the passed UUID obtained from a prior call
-     * of fin.System.launchExternalProcess().
-     * @param { string } uuid The UUID for a process obtained from a prior call to fin.desktop.System.launchExternalProcess()
-     * @return {Promise.<void>}
-     * @tutorial System.releaseExternalProcess
-     */
-    releaseExternalProcess(uuid) {
-        return this.wire.sendAction('release-external-process', { uuid }).then(() => undefined);
-    }
-    /**
-     * Shows the Chromium Developer Tools for the specified window
-     * @param { Identity } identity This is a object that is defined by the Identity interface
-     * @return {Promise.<void>}
-     * @tutorial System.showDeveloperTools
-     */
-    showDeveloperTools(identity) {
-        return this.wire.sendAction('show-developer-tools', identity).then(() => undefined);
-    }
-    /**
-     * Attempt to close an external process. The process will be terminated if it
-     * has not closed after the elapsed timeout in milliseconds.<br>
-     * Note: This method is restricted by default and must be enabled via
-     * <a href="https://developers.openfin.co/docs/api-security">API security settings</a>.
-     * @param { TerminateExternalRequestType } options A object defined in the TerminateExternalRequestType interface
-     * @return {Promise.<void>}
-     * @tutorial System.terminateExternalProcess
-     */
-    terminateExternalProcess(options) {
-        return this.wire.sendAction('terminate-external-process', options).then(() => undefined);
-    }
-    /**
-     * Update the OpenFin Runtime Proxy settings.
-     * @param { ProxyConfig } options A config object defined in the ProxyConfig interface
-     * @return {Promise.<void>}
-     * @tutorial System.updateProxySettings
-     */
-    updateProxySettings(options) {
-        return this.wire.sendAction('update-proxy', options).then(() => undefined);
-    }
-    /**
-     * Downloads the given application asset<br>
-     * Note: This method is restricted by default and must be enabled via
-     * <a href="https://developers.openfin.co/docs/api-security">API security settings</a>.
-     * @param { AppAssetInfo } appAsset App asset object
-     * @return {Promise.<void>}
-     * @tutorial System.downloadAsset
-     */
-    // incompatible with standalone node process.
-    async downloadAsset(appAsset, progressListener) {
-        // eslint-disable-next-line @typescript-eslint/explicit-function-return-type, @typescript-eslint/no-empty-function
-        const noop = () => { };
-        let resolve = noop;
-        let reject = noop;
-        const downloadCompletePromise = new Promise((y, n) => {
-            resolve = y;
-            reject = n;
-        });
-        // node.js environment not supported
-        if (this.wire.environment.constructor.name === 'NodeEnvironment') {
-            throw new transport_errors_1.NotSupportedError('downloadAsset only supported in an OpenFin Render process');
-        }
-        const callSite = transport_errors_1.RuntimeError.getCallSite();
-        const downloadId = this.wire.environment.getNextMessageId().toString();
-        const dlProgressKey = `asset-download-progress-${downloadId}`;
-        const dlErrorKey = `asset-download-error-${downloadId}`;
-        const dlCompleteKey = `asset-download-complete-${downloadId}`;
-        const dlProgress = (progress) => {
-            const p = {
-                downloadedBytes: progress.downloadedBytes,
-                totalBytes: progress.totalBytes
-            };
-            progressListener(p);
-        };
-        const cleanListeners = () => {
-            // TODO: fix internal types
-            // @ts-expect-error
-            this.removeListener(dlProgressKey, dlProgress);
-        };
-        const dlError = (payload) => {
-            cleanListeners();
-            const { reason, err: error } = payload;
-            reject(new transport_errors_1.RuntimeError({ reason, error }, callSite));
-        };
-        const dlComplete = () => {
-            cleanListeners();
-            resolve();
-        };
-        await Promise.all([
-            // TODO: fix internal types
-            // @ts-expect-error
-            this.on(dlProgressKey, dlProgress),
-            // TODO: fix internal types
-            // @ts-expect-error
-            this.once(dlErrorKey, dlError),
-            // TODO: fix internal types
-            // @ts-expect-error
-            this.once(dlCompleteKey, dlComplete)
-        ]);
-        const downloadOptions = Object.assign(appAsset, { downloadId });
-        await this.wire.sendAction('download-asset', downloadOptions).catch((err) => {
-            cleanListeners();
-            throw err;
-        });
-        return downloadCompletePromise;
-    }
-    /**
-     * Downloads a version of the runtime.
-     * @param { RuntimeDownloadOptions } options - Download options.
-     * @param {Function} [progressListener] - called as the runtime is downloaded with progress information.
-     * @return {Promise.<void>}
-     * @tutorial System.downloadRuntime
-     */
-    downloadRuntime(options, progressListener) {
-        const callsites = transport_errors_1.RuntimeError.getCallSite();
-        return new Promise((resolve, reject) => {
-            // node.js environment not supported
-            if (this.wire.environment.constructor.name === 'NodeEnvironment') {
-                reject(new transport_errors_1.NotSupportedError('downloadRuntime only supported in an OpenFin Render process'));
-                return;
-            }
-            const downloadId = this.wire.environment.getNextMessageId().toString();
-            const dlProgressKey = `runtime-download-progress-${downloadId}`;
-            const dlErrorKey = `runtime-download-error-${downloadId}`;
-            const dlCompleteKey = `runtime-download-complete-${downloadId}`;
-            const dlProgress = (progress) => {
-                const p = {
-                    downloadedBytes: progress.downloadedBytes,
-                    totalBytes: progress.totalBytes
-                };
-                progressListener(p);
-            };
-            const cleanListeners = () => {
-                // TODO: fix internal types
-                // @ts-expect-error
-                this.removeListener(dlProgressKey, dlProgress);
-            };
-            const dlError = (payload) => {
-                cleanListeners();
-                const { reason, err: error } = payload;
-                reject(new transport_errors_1.RuntimeError({ reason, error }, callsites));
-            };
-            const dlComplete = () => {
-                cleanListeners();
-                resolve();
-            };
-            // TODO: fix internal types
-            // @ts-expect-error
-            this.on(dlProgressKey, dlProgress);
-            // TODO: fix internal types
-            // @ts-expect-error
-            this.once(dlErrorKey, dlError);
-            // TODO: fix internal types
-            // @ts-expect-error
-            this.once(dlCompleteKey, dlComplete);
-            const downloadOptions = Object.assign(options, { downloadId });
-            this.wire.sendAction('download-runtime', downloadOptions).catch((err) => {
-                cleanListeners();
-                reject(err);
-            });
-        });
-    }
-    /**
-     * Download preload scripts from given URLs
-     * @param {DownloadPreloadOption[]} scripts - URLs of preload scripts. See tutorial for more details.
-     * @return {Promise.Array<DownloadPreloadInfo>}
-     * @tutorial System.downloadPreloadScripts
-     */
-    downloadPreloadScripts(scripts) {
-        return this.wire.sendAction('download-preload-scripts', { scripts }).then(({ payload }) => payload.data);
-    }
-    /**
-     * Retrieves an array of data (name, ids, bounds) for all application windows.
-     * @return {Promise.Array.<Identity>}
-     * @tutorial System.getAllExternalApplications
-     */
-    getAllExternalApplications() {
-        return this.wire.sendAction('get-all-external-applications').then(({ payload }) => payload.data);
-    }
-    /**
-     * Retrieves app asset information.
-     * @param { AppAssetRequest } options
-     * @return {Promise.<AppAssetInfo>}
-     * @tutorial System.getAppAssetInfo
-     */
-    getAppAssetInfo(options) {
-        return this.wire.sendAction('get-app-asset-info', options).then(({ payload }) => payload.data);
-    }
-    /**
-     * Get additional info of cookies.
-     * @param { CookieOption } options - See tutorial for more details.
-     * @return {Promise.Array.<CookieInfo>}
-     * @tutorial System.getCookies
-     */
-    getCookies(options) {
-        const url = this.wire.environment.getUrl();
-        const newOptions = Object.assign(options, { url });
-        return this.wire.sendAction('get-cookies', newOptions).then(({ payload }) => payload.data);
-    }
-    /**
-     * Set the minimum log level above which logs will be written to the OpenFin log
-     * @param { LogLevel } The minimum level (inclusive) above which all calls to log will be written
-     * @return {Promise.<void>}
-     * @tutorial System.setMinLogLevel
-     */
-    setMinLogLevel(level) {
-        return this.wire.sendAction('set-min-log-level', { level }).then(() => undefined);
-    }
-    /**
-     * Retrieves the UUID of the computer on which the runtime is installed
-     * @param { string } uuid The uuid of the running application
-     * @return {Promise.<ApplicationType>}
-     * @tutorial System.resolveUuid
-     */
-    resolveUuid(uuid) {
-        return this.wire
-            .sendAction('resolve-uuid', {
-            entityKey: uuid
-        })
-            .then(({ payload }) => payload.data);
-    }
-    /**
-     * Retrieves an array of data for all external applications
-     * @param { Identity } requestingIdentity This object is described in the Identity typedef
-     * @param { any } data Any data type to pass to the method
-     * @return {Promise.<any>}
-     * @ignore
-     */
-    executeOnRemote(requestingIdentity, data) {
-        data.requestingIdentity = requestingIdentity;
-        return this.wire.ferryAction(data);
-    }
-    /**
-     * Reads the specifed value from the registry.<br>
-     * Note: This method is restricted by default and must be enabled via
-     * <a href="https://developers.openfin.co/docs/api-security">API security settings</a>.
-     * @param { string } rootKey - The registry root key.
-     * @param { string } subkey - The registry key.
-     * @param { string } value - The registry value name.
-     * @return {Promise.<RegistryInfo>}
-     * @tutorial System.readRegistryValue
-     */
-    readRegistryValue(rootKey, subkey, value) {
-        return this.wire
-            .sendAction('read-registry-value', {
-            rootKey,
-            subkey,
-            value
-        })
-            .then(({ payload }) => payload.data);
-    }
-    /**
-     * This function call will register a unique id and produce a token.
-     * The token can be used to broker an external connection.
-     * @param { string } uuid - A UUID for the remote connection.
-     * @return {Promise.<ExternalConnection>}
-     * @tutorial System.registerExternalConnection
-     */
-    registerExternalConnection(uuid) {
-        return this.wire.sendAction('register-external-connection', { uuid }).then(({ payload }) => payload.data);
-    }
-    /**
-     * Returns the json blob found in the [desktop owner settings](https://openfin.co/documentation/desktop-owner-settings/)
-     * for the specified service.
-     * More information about desktop services can be found [here](https://developers.openfin.co/docs/desktop-services).
-     * @param { ServiceIdentifier } serviceIdentifier An object containing a name key that identifies the service.
-     * @return {Promise.<ServiceConfiguration>}
-     * @tutorial System.getServiceConfiguration
-     */
-    async getServiceConfiguration(serviceIdentifier) {
-        if (typeof serviceIdentifier.name !== 'string') {
-            throw new Error('Must provide an object with a `name` property having a string value');
-        }
-        const { name } = serviceIdentifier;
-        return this.wire.sendAction('get-service-configuration', { name }).then(({ payload }) => payload.data);
-    }
-    async getSystemAppConfig(name) {
-        if (typeof name !== 'string') {
-            throw new Error('Must provide a string value for name of system app');
-        }
-        return this.wire.sendAction('get-system-app-configuration', { name }).then(({ payload }) => payload.data);
-    }
-    /**
-     * Registers a system shutdown handler so user can do some cleanup before system is shutting down.
-     * Note: Once system shutdown starts, you are unable to cancel it.
-     * @param { SystemShutdownHandler } handler system shutdown handler
-     * @return {Promise.<void>}
-     * @tutorial System.registerShutdownHandler
-     * @experimental
-     */
-    async registerShutdownHandler(handler) {
-        this.wire.sendAction('system-register-shutdown-handler').catch((e) => {
-            // don't expose, analytics-only call
-        });
-        const SystemShutdownEventName = 'system-shutdown';
-        const SystemShutdownHandledEventName = 'system-shutdown-handled';
-        const { uuid, name } = this.wire.me;
-        const shutdownHandler = (payload) => {
-            const proceed = () => {
-                // notify core that the app is ready for shutdown
-                this.wire.environment.raiseEvent(`application/${SystemShutdownHandledEventName}`, {
-                    uuid,
-                    name,
-                    topic: 'application'
-                });
-            };
-            handler({ proceed });
-        };
-        this.on(SystemShutdownEventName, shutdownHandler);
-    }
-    /**
-     * Signals the RVM to perform a health check and returns the results as json.
-     * @return {Promise.<string[]>}
-     * @tutorial System.runRvmHealthCheck
-     */
-    runRvmHealthCheck() {
-        return this.wire.sendAction('run-rvm-health-check').then(({ payload }) => payload.data);
-    }
-    /**
-     * Launch application using a manifest URL/path. It differs from Application.startFromManifest in that this API can accept a manifest using the fin protocol.
-     * @param {string} manifestUrl - The manifest's URL or path.
-     * @param {RvmLaunchOptions} [opts] - Parameters that the RVM will use.
-     * @return {Promise.<Manifest>}
-     * @experimental
-     * @tutorial System.launchManifest
-     * @static
-     */
-    async launchManifest(manifestUrl, opts = {}) {
-        const { subscribe, ..._sendOpts } = opts;
-        const sendOpts = _sendOpts;
-        if (subscribe) {
-            const launchEmitter = new events_1.EventEmitter();
-            subscribe(launchEmitter);
-            const AppVersionProgressEventName = 'app-version-progress';
-            const RuntimeStatusEventName = 'runtime-status';
-            const AppVersionCompleteEventName = 'app-version-complete';
-            const AppVersionErrorEventName = 'app-version-error';
-            // add id to avoid multiple api calls getting duplicated events
-            const id = this.wire.environment.getNextMessageId().toString();
-            sendOpts.appVersionId = id;
-            const supportedEvents = [
-                AppVersionCompleteEventName,
-                AppVersionProgressEventName,
-                RuntimeStatusEventName,
-                AppVersionErrorEventName
-            ];
-            const cleanEventPayload = (payload) => {
-                // We need to do type castings below to make sure the return type is correct.
-                const { appVersionId, topic, type: typeWithId, ...rest } = payload;
-                const type = supportedEvents.find((x) => typeWithId.includes(x));
-                return {
-                    ...rest,
-                    type
-                };
-            };
-            const appVersionListener = (payload) => {
-                const cleanPayload = cleanEventPayload(payload);
-                launchEmitter.emit(cleanPayload.type, cleanPayload);
-            };
-            const removeAllListeners = () => {
-                this.removeListener(`${AppVersionProgressEventName}.${id}`, appVersionListener);
-                this.removeListener(`${RuntimeStatusEventName}.${id}`, appVersionListener);
-                this.removeListener(`${AppVersionCompleteEventName}.${id}`, appVersionListener);
-                this.removeListener(`${AppVersionErrorEventName}.${id}`, appVersionListener);
-                this.removeListener(`${AppVersionCompleteEventName}.${id}`, removeAllListeners);
-                this.removeListener(`${AppVersionErrorEventName}.${id}`, removeAllListeners);
-            };
-            await Promise.all([
-                this.on(`${AppVersionProgressEventName}.${id}`, appVersionListener),
-                this.on(`${RuntimeStatusEventName}.${id}`, appVersionListener),
-                this.once(`${AppVersionCompleteEventName}.${id}`, appVersionListener),
-                this.once(`${AppVersionErrorEventName}.${id}`, appVersionListener),
-                this.once(`${AppVersionCompleteEventName}.${id}`, removeAllListeners),
-                this.once(`${AppVersionErrorEventName}.${id}`, removeAllListeners)
-            ]);
-        }
-        const response = await this.wire.sendAction('launch-manifest', {
-            manifestUrl,
-            opts: sendOpts
-        });
-        return response.payload.data.manifest;
-    }
-    /**
-     * Query permission of a secured api in current context.
-     * @param {string} apiName - The full name of a secured API.
-     * @return {Promise.<QueryPermissionResult>}
-     * @tutorial System.queryPermissionForCurrentContext
-     */
-    async queryPermissionForCurrentContext(apiName) {
-        const identity = { uuid: this.wire.me.uuid, name: this.wire.me.name };
-        const response = await this.wire.sendAction('query-permission-for-current-context', {
-            apiName,
-            identity
-        });
-        return response.payload.data;
-    }
-    // Not documenting, internal use only.
-    async enableNativeWindowIntegrationProvider(permissions) {
-        const { payload } = await this.wire.sendAction('enable-native-window-integration-provider', { permissions });
-        return payload.data;
-    }
-    /**
-     * (Internal) Register the usage of a component with a platform
-     * @param {OpenFin.RegisterUsageData} options - Object with data and type
-     * @return {Promise.<void>}
-     * @tutorial System.registerUsage
-     */
-    async registerUsage({ data, type }) {
-        await this.wire.sendAction('register-usage', { data, type });
-    }
-    /**
-     * Returns an array with all printers of the caller and not all the printers on the desktop.
-     * @return { Promise.Array.<PrinterInfo> }
-     * @tutorial System.getPrinters
-     */
-    async getPrinters() {
-        const { payload } = await this.wire.sendAction('system-get-printers');
-        return payload.data;
-    }
-    /**
-     * Updates Process Logging values: periodic interval and outlier detection entries and interval.
-     * @param {ProcessLoggingOptions} options Process Logging updatable options.
-     * @return { Promise<void> }
-     * @tutorial System.updateProcessLoggingOptions
-     */
-    async updateProcessLoggingOptions(options) {
-        await this.wire.sendAction('system-update-process-logging-options', { options });
-    }
-}
-exports.default = System;