@openfin/core 30.73.28 → 31.74.1

package/src/api/platform/provider.d.ts

@@ -0,0 +1,162 @@
+import { WindowOptionsChangedEvent } from '../events/window';
+import * as OpenFin from '../../OpenFin';
+/**
+ * This class handles Platform actions. It does not need to be used directly by developers.
+ * However, its methods can be overriden by passing an `overrideCallback` to {@link Platform#init Platform.init}
+ * in order to implement custom Platform behavior. (See {@tutorial Platform.init})
+ *
+ * For an overview of Provider customization, see
+ * {@link https://developers.openfin.co/docs/platform-customization#section-customizing-platform-behavior}.
+ */
+export interface PlatformProvider {
+    /**
+     * Handles requests to create a window in the current platform.
+     * @param { WindowOption } payload Window options for the window to be created.
+     * @param { Identity } [identity] If {@link Platform#createWindow Platform.createWindow} was called, the identity of the caller will be here.
+     * If `createWindow` was called as part of applying a snapshot or creating a view without a target window, `identity` will be undefined.
+     */
+    createWindow(options: OpenFin.PlatformWindowCreationOptions, identity?: OpenFin.Identity): Promise<OpenFin.Window>;
+    /**
+     * Gets the current state of windows and their views and returns a snapshot object containing that info.
+     * @param { undefined } payload Undefined unless you've defined a custom `getSnapshot` protocol.
+     * @param { Identity } identity Identity of the entity that called {@link Platform#getSnapshot Platform.getSnapshot}.
+     * @return { Promise<Snapshot> } Snapshot of current platform state.
+     */
+    getSnapshot(payload: undefined, identity: OpenFin.Identity): Promise<OpenFin.Snapshot>;
+    /**
+     * **NOTE**: Internal use only. It is not recommended to manage the state of individual views.
+     * Gets the current state of a single view and returns an object with the options needed to restore that view as part of a snapshot.
+     * @param { Identity } payload Identity of the view.
+     * @return { Promise<ViewState> }
+     * @internal
+     * @experimental
+     */
+    getViewSnapshot(payload: {
+        viewIdentity: OpenFin.Identity;
+    }): Promise<OpenFin.ViewState>;
+    /**
+     * Called when a snapshot is being applied and some windows in that snapshot would be fully or partially off-screen.
+     * Returns an array of windows with modified positions, such that any off-screen windows are positioned in the top left
+     * corner of the main monitor.
+     * @param { Snapshot } snapshot The snapshot to be applied.
+     * @param { WindowOptions[] } outOfBoundsWindows An array of WindowOptions for any windows that would be off-screen.
+     * @return { Promise<WindowOptions[]> } An array of WindowOptions with their position modified to fit on screen.
+     */
+    positionOutOfBoundsWindows(snapshot: OpenFin.Snapshot, outOfBoundsWindows: OpenFin.WindowCreationOptions[]): Promise<OpenFin.WindowCreationOptions[]>;
+    /**
+     * Handles requests to apply a snapshot to the current Platform.
+     * @param { ApplySnapshotPayload } payload Payload containing the snapshot to be applied, as well as any options.
+     * @param { Identity } [identity] Identity of the entity that called {@link Platform#applySnapshot Platform.applySnapshot}.
+     * Undefined if called internally (e.g. when opening the initial snapshot).
+     * @return { Promise<void> }
+     */
+    applySnapshot(payload: OpenFin.ApplySnapshotPayload, identity?: OpenFin.Identity): Promise<void>;
+    /**
+     * Closes the current Platform and all child windows and views.
+     * @param { undefined } payload Undefined unless you have implemented a custom quite protocol.
+     * @param { Identity } identity Identity of the entity that called {@link Platform#quit Platform.quit}.
+     * @return { Promise<void> }
+     */
+    quit(payload: undefined, identity: OpenFin.Identity): Promise<void>;
+    /**
+     * Closes a view
+     * @param { CloseViewPayload } payload Specifies the `target` view to be closed.
+     * @param { Identity } identity Identity of the entity that called {@link Platform#closeView Platform.closeView}.
+     */
+    closeView(payload: OpenFin.CloseViewPayload, identity?: OpenFin.Identity): Promise<any>;
+    /**
+     * Creates a new view and attaches it to a specified target window.
+     * @param { CreateViewPayload } payload Creation options for the new view.
+     * @param { Identity } identity Identity of the entity that called {@link Platform#createView Platform.createView}.
+     * @return { Promise<void> }
+     */
+    createView(payload: OpenFin.CreateViewPayload, identity: OpenFin.Identity): Promise<OpenFin.View>;
+    /** Handles requests to fetch manifests in the current platform.
+     * @param { FetchManifestPayload } payload Payload containing the manifestUrl to be fetched.
+     * @param { Identity } callerIdentity If {@link Platform#fetchManifest Platform.fetchManifest}
+     * was called, the identity of the caller will be here.
+     * If `fetchManifest` was called internally, `callerIdentity` will be the provider's identity.
+     */
+    fetchManifest(payload: OpenFin.FetchManifestPayload, callerIdentity: OpenFin.Identity): Promise<any>;
+    /**
+     * Replaces a Platform window's layout with a new layout. Any views that were in the old layout but not the new layout will be destroyed.
+     * @param { ReplaceLayoutPayload } payload Contains the `target` window and an `opts` object with a `layout` property to apply.
+     * @param { Identity } [identity] Identity of the entity that called {@link Platform#replaceLayout Platform.replaceLayout}.
+     * Undefined if `replaceLayout` is called internally (e.g. while applying a snapshot).
+     * @return { Promise<void> }
+     */
+    replaceLayout(payload: OpenFin.ReplaceLayoutPayload, identity?: OpenFin.Identity): Promise<void>;
+    replaceView(payload: OpenFin.ReplaceViewPayload, identity?: OpenFin.Identity): Promise<void>;
+    launchIntoPlatform(payload: OpenFin.LaunchIntoPlatformPayload): Promise<void>;
+    /**
+     * Handles requests to set a window's context. `target` may be a window or a view.
+     * If it is a window, that window's `customContext` will be updated.
+     * If it is a view, the `customContext` of that view's current host window will be updated.
+     * @param { SetWindowContextPayload } payload Object containing the requested `context` update,
+     * the `target`'s identity, and the target's `entityType`.
+     * @param { Identity } [identity] Identity of the entity that called {@link Platform#setWindowContext Platform.setWindowContext}.
+     * Undefined if `setWindowContext` is called internally (e.g. while applying a snapshot).
+     * @return { Promise<any> } The new context.
+     */
+    setWindowContext(payload: OpenFin.SetWindowContextPayload, identity?: OpenFin.Identity): Promise<any>;
+    /**
+     * Handles requests to get a window's context. `target` may be a window or a view.
+     * If it is a window, that window's `customContext` will be returned.
+     * If it is a view, the `customContext` of that view's current host window will be returned.
+     * @param { GetWindowContextPayload } payload Object containing the requested `context` update,
+     * the `target`'s identity, and the target's `entityType`.
+     * @param { Identity } [identity] Identity of the entity that called {@link Platform#getWindowContext Platform.getWindowContext}.
+     * Undefined when `getWindowContext` is called internally
+     * (e.g. when getting a window's context for the purpose of raising a "host-context-changed" event on a reparented view).
+     * @return { Promise<any> } The new context.
+     */
+    getWindowContext(payload: OpenFin.GetWindowContextPayload, identity?: OpenFin.Identity): Promise<any>;
+    /**
+     * Called when a window's `customContext` is updated. Responsible for raising the `host-context-updated` event on that window's child views.
+     * @param { WindowOptionsChangedEvent<'window', 'options-changed'> } payload The event payload for the window whose context has changed.
+     * The new context will be contained as `payload.diff.customContext.newVal`.
+     * @return { Promise<HostContextChangedPayload> } The event that it raised.
+     */
+    onWindowContextUpdated(payload: WindowOptionsChangedEvent): Promise<OpenFin.HostContextChangedPayload | undefined>;
+    /**
+     * Closes a Window.
+     * By default it will fire any before unload handler set by a View in the Window.
+     * This can be disabled by setting skipBeforeUnload in the options object of the payload.
+     * This method is called by {@link Platform#closeWindow Platform.closeWindow}.
+     * @param {CloseWindowPayload} payload Object that contains the Window Identity and related options.
+     * @param {Identity} callerIdentity
+     * @returns {Promise<void>}
+     */
+    closeWindow(payload: OpenFin.CloseWindowPayload, callerIdentity: OpenFin.Identity): Promise<void>;
+    /**
+     * Gets all the Views attached to a Window that should close along with it. This is meant to be overridable
+     * in the case where you want to return other Views that may not be attached to the Window that is closing.
+     * @param winId Identity of the Window that is closing
+     * @returns { Promise<View> }
+     */
+    getViewsForWindowClose(windowId: OpenFin.Identity): Promise<OpenFin.View[]>;
+    /**
+     * It takes in an array of Views and returns an object specifying which of them are trying to prevent an unload and which are not.
+     * @param {View[]} views Array of Views
+     * @returns { Promise<ViewStatuses> }
+     */
+    checkViewsForPreventUnload(views: OpenFin.View[]): Promise<OpenFin.ViewStatuses>;
+    /**
+     * Handle the decision of whether a Window or specific View should close when trying to prevent an unload. This is meant to be overridden.
+     * Called in {@link PlatformProvider#closeWindow PlatformProvider.closeWindow}.
+     * Normally you would use this method to show a dialog indicating that there are Views that are trying to prevent an unload.
+     * By default it will always return all Views passed into it as meaning to close.
+     * @param {ViewsPreventingUnloadPayload} payload
+     * @tutorial PlatformProvider.getUserDecisionForBeforeUnload
+     * @returns {Promise<BeforeUnloadUserDecision>}
+     */
+    getUserDecisionForBeforeUnload(payload: OpenFin.ViewsPreventingUnloadPayload): Promise<OpenFin.BeforeUnloadUserDecision>;
+    /**
+     * Handles the closing of a Window and/or its Views. Called in {@link PlatformProvider#closeWindow PlatformProvider.closeWindow}.
+     * The return of {@link PlatformProvider#getUserDecisionForBeforeUnload PlatformProvider.getUserDecisionForBeforeUnload} is passed into this method.
+     * @param {Identity} winId Identity of the Window
+     * @param {BeforeUnloadUserDecision} userDecision Decision object
+     * @returns {Promise<void>}
+     */
+    handleViewsAndWindowClose(windowId: OpenFin.Identity, userDecision: OpenFin.BeforeUnloadUserDecision): Promise<void>;
+}

package/src/api/platform/provider.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/src/api/snapshot-source/Factory.d.ts

@@ -2,6 +2,7 @@ import type * as OpenFin from '../../OpenFin';
 import { Base } from '../base';
 import { SnapshotSource } from './Instance';
 /**
+ * @REMOVED
  * @typedef { object } SnapshotProvider
  * @property {getSnapshot} [getSnapshot]
  * @property {applySnapshot} [applySnapshot]

package/src/api/snapshot-source/Factory.js

@@ -4,6 +4,7 @@ const base_1 = require("../base");
 const Instance_1 = require("./Instance");
 const utils_1 = require("./utils");
 /**
+ * @REMOVED
  * @typedef { object } SnapshotProvider
  * @property {getSnapshot} [getSnapshot]
  * @property {applySnapshot} [applySnapshot]

package/src/api/snapshot-source/Instance.d.ts

@@ -1,6 +1,6 @@
 import type * as OpenFin from '../../OpenFin';
 import { Base } from '../base';
-import Transport from '../../transport/transport';
+import { Transport } from '../../transport/transport';
 /**
  * Enables configuring a SnapshotSource with custom getSnapshot and applySnapshot methods.
  * @namespace

package/src/api/system/index.d.ts

@@ -1,6 +1,6 @@
 import type * as OpenFin from '../../OpenFin';
 import { EmitterBase } from '../base';
-import Transport from '../../transport/transport';
+import { Transport } from '../../transport/transport';
 declare type Identity = OpenFin.Identity;
 declare type ProxyInfo = OpenFin.ProxyInfo;
 declare type ProxyConfig = OpenFin.ProxyConfig;
@@ -14,476 +14,6 @@ declare type Entity = OpenFin.ApplicationType;
 declare type ApplicationState = OpenFin.ApplicationState;
 declare type ApplicationWindowInfo = OpenFin.ApplicationWindowInfo;
 declare type PrinterInfo = OpenFin.PrinterInfo;
-/**
- * AppAssetInfo interface
- * @typedef { object } AppAssetInfo
- * @property { string } src  The URL to a zip file containing the package files (executables, dlls, etc…)
- * @property { string } alias The name of the asset
- * @property { string } version The version of the package
- * @property { string } target Specify default executable to launch. This option can be overridden in launchExternalProcess
- * @property { string } args The default command line arguments for the aforementioned target.
- * @property { boolean } mandatory When set to true, the app will fail to load if the asset cannot be downloaded.
- * When set to false, the app will continue to load if the asset cannot be downloaded. (Default: true)
- */
-/**
- * AppAssetRequest interface
- * @typedef { object } AppAssetRequest
- * @property { string } alias The name of the asset
- */
-/**
- * ApplicationState interface
- * @typedef { object } ApplicationState
- * @property { boolean } isPlatform true when the application is a Platform controller
- * @property { boolean } isRunning  true when the application is running
- * @property { string } uuid uuid of the application
- * @property { string } parentUuid uuid of the application that launches this application
- */
-/**
- * @typedef { object } ClearCacheOption
- * @summary Clear cache options.
- * @desc These are the options required by the clearCache function.
- *
- * @property {boolean} appcache html5 application cache
- * @property {boolean} cache browser data cache for html files and images
- * @property {boolean} cookies browser cookies
- * @property {boolean} localStorage browser data that can be used across sessions
- */
-/**
- * CookieInfo interface
- * @typedef { object } CookieInfo
- * @property { string } name  The name of the cookie
- * @property { string } domain The domain of the cookie
- * @property { string } path The path of the cookie
- */
-/**
- * CookieOption interface
- * @typedef { object } CookieOption
- * @property { string } name The name of the cookie
- */
-/**
- * CpuInfo interface
- * @typedef { object } CpuInfo
- * @property { string } model The model of the cpu
- * @property { number } speed The number in MHz
- * @property { Time } times The numbers of milliseconds the CPU has spent in different modes.
- */
-/**
- * CrashReporterState interface
- * @typedef { object } CrashReporterState
- * @property { boolean } diagnosticsMode In diagnostics mode the crash reporter will send diagnostic logs to
- *  the OpenFin reporting service on runtime shutdown
- * @property { boolean } isRunning check if it's running
- */
-/**
- * CrashReporterOptions interface
- * @typedef { object } CrashReporterOptions
- * @property { boolean } diagnosticsMode In diagnostics mode the crash reporter will send diagnostic logs to
- *  the OpenFin reporting service on runtime shutdown
- */
-/**
- * DipRect interface
- * @typedef { object } DipRect
- * @property { Rect } dipRect The DIP coordinates
- * @property { Rect } scaledRect The scale coordinates
- */
-/**
- * DipScaleRects interface
- * @typedef { object } DipScaleRects
- * @property { Rect } dipRect The DIP coordinates
- * @property { Rect } scaledRect The scale coordinates
- */
-/**
- * DownloadPreloadInfo interface
- * @typedef { object } DownloadPreloadInfo
- * @desc downloadPreloadScripts function return value
- * @property { string } url url to the preload script
- * @property { string } error error during preload script acquisition
- * @property { boolean } succeess download operation success
- */
-/**
- * DownloadPreloadOption interface
- * @typedef { object } DownloadPreloadOption
- * @desc These are the options object required by the downloadPreloadScripts function
- * @property { string } url url to the preload script
- */
-/**
- * ApplicationType interface
- * @typedef { object } ApplicationType
- * @property { string } type The type of the entity
- * @property { string } uuid The uuid of the entity
- */
-/**
- * EntityInfo interface
- * @typedef { object } EntityInfo
- * @property { string } name The name of the entity
- * @property { string } uuid The uuid of the entity
- * @property { Identity } parent The parent of the entity
- * @property { string } entityType The type of the entity
- */
-/**
- * ExternalApplicationInfo interface
- * @typedef { object } ExternalApplicationInfo
- * @property { Identity } parent The parent identity
- */
-/**
- * ExternalConnection interface
- * @typedef { object } ExternalConnection
- * @property { string } token The token to broker an external connection
- * @property { string } uuid The uuid of the external connection
- */
-/**
- * ExternalProcessRequestType interface
- * @typedef { object } ExternalProcessRequestType
- * @property { string } path The file path to where the running application resides
- * @property { string } arguments The argument passed to the running application
- * @property { LaunchExternalProcessListener } listener This is described in the {LaunchExternalProcessListner} type definition
- * @property { string } initialWindowState Initial window state after launching: 'normal' (default), 'minimized', 'maximized'
- * @property { string } cwd current working directory
- */
-/**
- * FrameInfo interface
- * @typedef { object } FrameInfo
- * @property { string } name The name of the frame
- * @property { string } uuid The uuid of the frame
- * @property { EntityType } entityType The entity type, could be 'window', 'iframe', 'external connection' or 'unknown'
- * @property { Identity } parent The parent identity
- * @property { string } url URL
- */
-/**
- * GetLogRequestType interface
- * @typedef { object } GetLogRequestType
- * @property { string } name The name of the running application
- * @property { number } endFile The file length of the log file
- * @property { number } sizeLimit The set size limit of the log file
- */
-/**
- * GpuInfo interface
- * @typedef { object } GpuInfo
- * @property { string } name The graphics card name
- */
-/**
- * HostSpecs interface
- * @typedef { object } HostSpecs
- * @property { boolean } aeroGlassEnabled Value to check if Aero Glass theme is supported on Windows platforms
- * @property { string } arch "x86" for 32-bit or "x86_64" for 64-bit
- * @property { Array<CpuInfo> } cpus The same payload as Node's os.cpus()
- * @property { GpuInfo } gpu The graphics card name
- * @property { number } memory The same payload as Node's os.totalmem()
- * @property { string } name The OS name and version/edition
- * @property { boolean } screenSaver Value to check if screensaver is running. Supported on Windows only
- */
-/**
- * Identity interface
- * @typedef { object } Identity
- * @property { string } name Optional - the name of the component
- * @property { string } uuid Universally unique identifier of the application
- */
-/**
- * LogInfo interface
- * @typedef { object } LogInfo
- * @property { string } name The filename of the log
- * @property { number } size The size of the log in bytes
- * @property { string } date The unix time at which the log was created "Thu Jan 08 2015 14:40:30 GMT-0500 (Eastern Standard Time)"
- */
-/**
- * ManifestInfo interface
- * @typedef { object } ManifestInfo
- * @property { string } uuid The uuid of the application
- * @property { string } manifestUrl The runtime manifest URL
- */
-/**
- * MonitorDetails interface
- * @typedef { object } MonitorDetails
- * @property { DipScaleRects } available The available DIP scale coordinates
- * @property { Rect } availableRect The available monitor coordinates
- * @property { string } deviceId The device id of the display
- * @property { boolean } displayDeviceActive true if the display is active
- * @property { number } deviceScaleFactor The device scale factor
- * @property { Rect } monitorRect The monitor coordinates
- * @property { string } name The name of the display
- * @property { Point } dpi The dots per inch
- * @property { DipScaleRects } monitor The monitor coordinates
- */
-/**
- * MonitorInfo interface
- * @typedef { object } MonitorInfo
- * @property { number } deviceScaleFactor The device scale factor
- * @property { Point } dpi The dots per inch
- * @property { Array<MonitorDetails> } nonPrimaryMonitors The array of monitor details
- * @property { MonitorDetails } primaryMonitor The monitor details
- * @property { string } reason always "api-query"
- * @property { TaskBar } taskBar The taskbar on monitor
- * @property { DipRect } virtualScreen The virtual display screen coordinates
- */
-/**
- * @typedef { verbose | info | warning | error | fatal } LogLevel
- * @summary Log verbosity levels.
- * @desc Describes the minimum level (inclusive) above which logs will be written
- *
- * @property { string } verbose all logs written
- * @property { string } info info and above
- * @property { string } warning warning and above
- * @property { string } error error and above
- * @property { string } fatal fatal only, indicates a crash is imminent
- */
-/**
- * PointTopLeft interface
- * @typedef { object } PointTopLeft
- * @property { number } top The mouse top position in virtual screen coordinates
- * @property { number } left The mouse left position in virtual screen coordinates
- */
-/**
- * Point interface
- * @typedef { object } Point
- * @property { number } x The mouse x position
- * @property { number } y The mouse y position
- */
-/**
- * ProcessInfo interface
- * @typedef { object } ProcessInfo
- * @property { number } cpuUsage The percentage of total CPU usage
- * @property { string } name The application name
- * @property { number } nonPagedPoolUsage The current nonpaged pool usage in bytes
- * @property { number } pageFaultCount The number of page faults
- * @property { number } pagedPoolUsage The current paged pool usage in bytes
- * @property { number } pagefileUsage The total amount of memory in bytes that the memory manager has committed
- * @property { number } peakNonPagedPoolUsage The peak nonpaged pool usage in bytes
- * @property { number } peakPagedPoolUsage The peak paged pool usage in bytes
- * @property { number } peakPagefileUsage The peak value in bytes of pagefileUsage during the lifetime of this process
- * @property { number } peakWorkingSetSize The peak working set size in bytes
- * @property { number } processId The native process identifier
- * @property { string } uuid The application UUID
- * @property { number } workingSetSize The current working set size (both shared and private data) in bytes
- */
-/**
- * SystemProcessInfo interface
- * @typedef { object } SystemProcessInfo
- * @property { ProcessDetails } browserProcess Info on browser process
- * @property { Array<AppProcessInfo> } apps Array of apps and their process info
- */
-/**
- * AppProcessInfo interface
- * @typedef { object } AppProcessInfo
- * @property { string } uuid The uuid of the application
- * @property { Array<EntityProcessDetails> } entities  Array of process info for each window and view for the application
- */
-/**
- * EntityProcessDetails interface
- * @typedef { object } EntityProcessDetails
- * @property { string } uuid The uuid for the entity
- * @property { string } name The name for the entity
- * @property { string } url URL associated with the entity
- * @property { string } entityType Type for the entity: window or view
- * @property { number } cpuUsage The percentage of total CPU usage
- * @property { number } nonPagedPoolUsage The current nonpaged pool usage in bytes
- * @property { number } pageFaultCount The number of page faults
- * @property { number } pagedPoolUsage The current paged pool usage in bytes
- * @property { number } pagefileUsage The total amount of memory in bytes that the memory manager has committed
- * @property { number } peakNonPagedPoolUsage The peak nonpaged pool usage in bytes
- * @property { number } peakPagedPoolUsage The peak paged pool usage in bytes
- * @property { number } peakPagefileUsage The peak value in bytes of pagefileUsage during the lifetime of this process
- * @property { number } peakWorkingSetSize The peak working set size in bytes
- * @property { number } privateSetSize The current working set size (not shared)
- * @property { number } workingSetSize The current working set size (both shared and private data) in bytes
- * @property { number } pid The native process identifier
- * @property { Array<FrameProcessDetails> } frames Array of process info for each iframe corresponeding to the entity
- */
-/**
- * FrameProcessDetails interface
- * @typedef { object } FrameProcessDetails
- * @property { string } url Current URL associated with the process
- * @property { string } entityType Type for the frame
- * @property { number } cpuUsage The percentage of total CPU usage
- * @property { number } nonPagedPoolUsage The current nonpaged pool usage in bytes
- * @property { number } pageFaultCount The number of page faults
- * @property { number } pagedPoolUsage The current paged pool usage in bytes
- * @property { number } pagefileUsage The total amount of memory in bytes that the memory manager has committed
- * @property { number } peakNonPagedPoolUsage The peak nonpaged pool usage in bytes
- * @property { number } peakPagedPoolUsage The peak paged pool usage in bytes
- * @property { number } peakPagefileUsage The peak value in bytes of pagefileUsage during the lifetime of this process
- * @property { number } peakWorkingSetSize The peak working set size in bytes
- * @property { number } workingSetSize The current working set size (both shared and private data) in bytes
- * @property { number } pid The native process identifier
- */
-/**
- * ProcessDetails interface
- * @typedef { object } ProcessDetails
- * @property { number } cpuUsage The percentage of total CPU usage
- * @property { number } nonPagedPoolUsage The current nonpaged pool usage in bytes
- * @property { number } pageFaultCount The number of page faults
- * @property { number } pagedPoolUsage The current paged pool usage in bytes
- * @property { number } pagefileUsage The total amount of memory in bytes that the memory manager has committed
- * @property { number } peakNonPagedPoolUsage The peak nonpaged pool usage in bytes
- * @property { number } peakPagedPoolUsage The peak paged pool usage in bytes
- * @property { number } peakPagefileUsage The peak value in bytes of pagefileUsage during the lifetime of this process
- * @property { number } peakWorkingSetSize The peak working set size in bytes
- * @property { number } workingSetSize The current working set size (both shared and private data) in bytes
- * @property { number } pid The native process identifier
- */
-/**
- * ProxyConfig interface
- * @typedef { object } ProxyConfig
- * @property { string } proxyAddress The configured proxy address
- * @property { number } proxyPort The configured proxy port
- * @property { string } type The proxy Type
- */
-/**
- * ProxyInfo interface
- * @typedef { object } ProxyInfo
- * @property { ProxyConfig } config The proxy config
- * @property { ProxySystemInfo } system The proxy system info
- */
-/**
- * QueryPermissionResult interface
- * @typedef { object } QueryPermissionResult
- * @property { string } permission The full name of a secured API
- * @property { string } state 'granted' | 'denied' | 'unavailable'
- * @property { boolean } granted true if permission is granted
- * @property { object } [rawValue] The value of permission
- */
-/**
- * ProxySystemInfo interface
- * @typedef { object } ProxySystemInfo
- * @property { string } autoConfigUrl The auto configuration url
- * @property { string } bypass The proxy bypass info
- * @property { boolean } enabled Value to check if a proxy is enabled
- * @property { string } proxy The proxy info
- */
-/**
- * Rect interface
- * @typedef { object } Rect
- * @property { number } bottom The bottom-most coordinate
- * @property { number } left The left-most coordinate
- * @property { number } right The right-most coordinate
- * @property { number } top The top-most coordinate
- */
-/**
- * RegistryInfo interface
- * @typedef { object } RegistryInfo
- * @property { any } data The registry data
- * @property { string } rootKey The registry root key
- * @property { string } subkey The registry key
- * @property { string } type The registry type
- * @property { string } value The registry value name
- */
-/**
- * RuntimeDownloadOptions interface
- * @typedef { object } RuntimeDownloadOptions
- * @desc These are the options object required by the downloadRuntime function.
- * @property { string } version The given version to download
- */
-/**
- * RuntimeInfo interface
- * @typedef { object } RuntimeInfo
- * @property { string } architecture The runtime build architecture
- * @property { string } manifestUrl The runtime manifest URL
- * @property { number } port The runtime websocket port
- * @property { string } securityRealm The runtime security realm
- * @property { string } version The runtime version
- * @property { object } args the command line argument used to start the Runtime
- * @property { string } chromeVersion The chrome version
- * @property { string } electronVersion The electron version
- */
-/**
- * RVMInfo interface
- * @typedef { object } RVMInfo
- * @property { string } action The name of action: "get-rvm-info"
- * @property { string } appLogDirectory The app log directory
- * @property { string } path The path of OpenfinRVM.exe
- * @property { string } 'start-time' The start time of RVM
- * @property { string } version The version of RVM
- * @property { string } 'working-dir' The working directory
- */
-/**
- * RvmLaunchOptions interface
- * @typedef { object } RvmLaunchOptions
- * @property { boolean } [noUi] true if no UI when launching
- * @property { object } [userAppConfigArgs] The user app configuration args
- * @property { number } [timeToLive] Timeout in seconds until RVM launch request expires
- * @property { Function } [subscribe] Called whenever app version resolver events occur.
- */
-/**
- * ServiceIdentifier interface
- * @typedef { object } ServiceIdentifier
- * @property { string } name The name of the service
- */
-/**
- * ServiceConfiguration interface
- * @typedef { object } ServiceConfiguration
- * @property { object } config The service configuration
- * @property { string } name The name of the service
- */
-/**
- * ShortCutConfig interface
- * @typedef { object } ShortCutConfig
- * @property { boolean } desktop true if application has a shortcut on the desktop
- * @property { boolean } startMenu true if application has shortcut in the start menu
- * @property { boolean } systemStartup true if application will be launched on system startup
- */
-/**
- * SubOptions interface
- * @typedef { Object } SubOptions
- * @property { number } timestamp The event timestamp
- */
-/**
- * TaskBar interface
- * @typedef { object } TaskBar
- * @property { string } edge which edge of a monitor the taskbar is on
- * @property { Rect } rect The taskbar coordinates
- */
-/**
- * TerminateExternalRequestType interface
- * @typedef { object } TerminateExternalRequestType
- * @property { string } uuid The uuid of the running application
- * @property { number } timeout Time out period before the running application terminates
- * @property { boolean } killtree Value to terminate the running application
- */
-/**
- * Time interface
- * @typedef { object } Time
- * @property { number } user The number of milliseconds the CPU has spent in user mode
- * @property { number } nice The number of milliseconds the CPU has spent in nice mode
- * @property { number } sys The number of milliseconds the CPU has spent in sys mode
- * @property { number } idle The number of milliseconds the CPU has spent in idle mode
- * @property { number } irq The number of milliseconds the CPU has spent in irq mode
- */
-/**
- * TrayInfo interface
- * @typedef { object } TrayInfo
- * @property { Bounds } bounds The bound of tray icon in virtual screen pixels
- * @property { MonitorInfo } monitorInfo Please see fin.System.getMonitorInfo for more information
- * @property { number } x copy of bounds.x
- * @property { number } y copy of bounds.y
- */
-/**
- * WindowDetail interface
- * @typedef { object } WindowDetail
- * @property { number } bottom The bottom-most coordinate of the window
- * @property { number } height The height of the window
- * @property { boolean } isShowing Value to check if the window is showing
- * @property { number } left The left-most coordinate of the window
- * @property { string } name The name of the window
- * @property { number } right The right-most coordinate of the window
- * @property { string } state The window state
- * @property { number } top The top-most coordinate of the window
- * @property { number } width The width of the window
- */
-/**
- * ApplicationWindowInfo interface
- * @typedef { object } ApplicationWindowInfo
- * @property { Array<WindowDetail> } childWindows The array of child windows details
- * @property { WindowDetail } mainWindow The main window detail
- * @property { string } uuid The uuid of the application
- */
-/**
- * CertifiedAppInfo interface
- * @typedef { object } CertifiedAppInfo
- * @property { boolean } isRunning true if the app is running
- * @property { boolean } [isOptedIntoCertfiedApp] true if the app has opted into certification
- * @property { boolean } [isCertified] true if the app is certified
- * @property { boolean } [isSSLCertified] true if the app manifest's SSL certificate is valid
- * @property { boolean } [isPresentInAppDirectory] true if the app is present in the OpenFin app directory
- */
 /**
  * An object representing the core of OpenFin Runtime. Allows the developer
  * to perform system-level actions, such as accessing logs, viewing processes,