@openfin/node-adapter 34.78.12 → 34.78.14

package/out/node-adapter.js

@@ -102,6 +102,13 @@ class Base {
     get fin() {
         return this.wire.getFin();
     }
+    /**
+     * Provides access to the OpenFin representation of the current code context (usually a document
+     * such as a {@link OpenFin.View} or {@link OpenFin.Window}), as well as to the current `Interop` context.
+     *
+     * Useful for debugging in the devtools console, where this will intelligently type itself based
+     * on the context in which the devtools panel was opened.
+     */
     get me() {
         return this.wire.me;
     }
@@ -1381,6 +1388,10 @@ Object.defineProperty(main, "__esModule", { value: true });
 main.WebContents = void 0;
 const base_1$k = base;
 class WebContents extends base_1$k.EmitterBase {
+    /**
+     * @param identity The identity of the {@link OpenFin.WebContentsEvents WebContents}.
+     * @param entityType The type of the {@link OpenFin.WebContentsEvents WebContents}.
+     */
     constructor(wire, identity, entityType) {
         super(wire, entityType, identity.uuid, identity.name);
         this.identity = identity;
@@ -1433,6 +1444,11 @@ class WebContents extends base_1$k.EmitterBase {
      * }
      * console.log(await wnd.capturePage(options));
      * ```
+     *
+     * @remarks
+     * `WebContents` refers to shared functionality between {@link OpenFin.Window} and {@link OpenFin.View}.
+     * We do not expose an explicit superclass for this functionality, but it does have its own
+     * {@link OpenFin.WebContentsEvents event namespace}.
      */
     capturePage(options) {
         return this.wire.sendAction('capture-page', { options, ...this.identity }).then(({ payload }) => payload.data);
@@ -1468,6 +1484,10 @@ class WebContents extends base_1$k.EmitterBase {
      *
      * executeJavaScript(`console.log('Hello, Openfin')`).then(() => console.log('Javascript excuted')).catch(err => console.log(err));
      * ```
+     * @remarks
+     * `WebContents` refers to shared functionality between {@link OpenFin.Window} and {@link OpenFin.View}.
+     * We do not expose an explicit superclass for this functionality, but it does have its own
+     * {@link OpenFin.WebContentsEvents event namespace}.
      */
     executeJavaScript(code) {
         return this.wire
@@ -1507,6 +1527,10 @@ class WebContents extends base_1$k.EmitterBase {
      *
      * getZoomLevel().then(zoomLevel => console.log(zoomLevel)).catch(err => console.log(err));
      * ```
+     * @remarks
+     * `WebContents` refers to shared functionality between {@link OpenFin.Window} and {@link OpenFin.View}.
+     * We do not expose an explicit superclass for this functionality, but it does have its own
+     * {@link OpenFin.WebContentsEvents event namespace}.
      */
     getZoomLevel() {
         return this.wire.sendAction('get-zoom-level', this.identity).then(({ payload }) => payload.data);
@@ -1545,6 +1569,10 @@ class WebContents extends base_1$k.EmitterBase {
      *
      * setZoomLevel(4).then(() => console.log('Setting a  zoom level')).catch(err => console.log(err));
      * ```
+     * @remarks
+     * `WebContents` refers to shared functionality between {@link OpenFin.Window} and {@link OpenFin.View}.
+     * We do not expose an explicit superclass for this functionality, but it does have its own
+     * {@link OpenFin.WebContentsEvents event namespace}.
      */
     setZoomLevel(level) {
         return this.wire.sendAction('set-zoom-level', { ...this.identity, level }).then(() => undefined);
@@ -1582,6 +1610,10 @@ class WebContents extends base_1$k.EmitterBase {
      * navigate().then(() => console.log('Navigate to tutorial')).catch(err => console.log(err));
      * ```
      * @experimental
+     * @remarks
+     * `WebContents` refers to shared functionality between {@link OpenFin.Window} and {@link OpenFin.View}.
+     * We do not expose an explicit superclass for this functionality, but it does have its own
+     * {@link OpenFin.WebContentsEvents event namespace}.
      */
     navigate(url) {
         return this.wire.sendAction('navigate-window', { ...this.identity, url }).then(() => undefined);
@@ -1609,6 +1641,10 @@ class WebContents extends base_1$k.EmitterBase {
      * }
      * navigateBack().then(() => console.log('Navigated back')).catch(err => console.log(err));
      * ```
+     * @remarks
+     * `WebContents` refers to shared functionality between {@link OpenFin.Window} and {@link OpenFin.View}.
+     * We do not expose an explicit superclass for this functionality, but it does have its own
+     * {@link OpenFin.WebContentsEvents event namespace}.
      */
     navigateBack() {
         return this.wire.sendAction('navigate-window-back', { ...this.identity }).then(() => undefined);
@@ -1638,6 +1674,10 @@ class WebContents extends base_1$k.EmitterBase {
      * }
      * navigateForward().then(() => console.log('Navigated forward')).catch(err => console.log(err));
      * ```
+     * @remarks
+     * `WebContents` refers to shared functionality between {@link OpenFin.Window} and {@link OpenFin.View}.
+     * We do not expose an explicit superclass for this functionality, but it does have its own
+     * {@link OpenFin.WebContentsEvents event namespace}.
      */
     async navigateForward() {
         await this.wire.sendAction('navigate-window-forward', { ...this.identity });
@@ -1665,6 +1705,10 @@ class WebContents extends base_1$k.EmitterBase {
      * }
      * stopNavigation().then(() => console.log('you shall not navigate')).catch(err => console.log(err));
      * ```
+     * @remarks
+     * `WebContents` refers to shared functionality between {@link OpenFin.Window} and {@link OpenFin.View}.
+     * We do not expose an explicit superclass for this functionality, but it does have its own
+     * {@link OpenFin.WebContentsEvents event namespace}.
      */
     stopNavigation() {
         return this.wire.sendAction('stop-window-navigation', { ...this.identity }).then(() => undefined);
@@ -1702,6 +1746,10 @@ class WebContents extends base_1$k.EmitterBase {
      * 		console.log('Reloaded window')
      * }).catch(err => console.log(err));
      * ```
+     * @remarks
+     * `WebContents` refers to shared functionality between {@link OpenFin.Window} and {@link OpenFin.View}.
+     * We do not expose an explicit superclass for this functionality, but it does have its own
+     * {@link OpenFin.WebContentsEvents event namespace}.
      */
     reload(ignoreCache = false) {
         return this.wire
@@ -1728,6 +1776,10 @@ class WebContents extends base_1$k.EmitterBase {
      *     console.log('print call has been sent to the system');
      * });
      * ```
+     * @remarks
+     * `WebContents` refers to shared functionality between {@link OpenFin.Window} and {@link OpenFin.View}.
+     * We do not expose an explicit superclass for this functionality, but it does have its own
+     * {@link OpenFin.WebContentsEvents event namespace}.
      */
     print(options = {}) {
         return this.wire.sendAction('print', { ...this.identity, options }).then(() => undefined);
@@ -1772,6 +1824,10 @@ class WebContents extends base_1$k.EmitterBase {
      *     console.log(result)
      * });
      * ```
+     * @remarks
+     * `WebContents` refers to shared functionality between {@link OpenFin.Window} and {@link OpenFin.View}.
+     * We do not expose an explicit superclass for this functionality, but it does have its own
+     * {@link OpenFin.WebContentsEvents event namespace}.
      */
     findInPage(searchTerm, options) {
         return this.wire
@@ -1815,6 +1871,10 @@ class WebContents extends base_1$k.EmitterBase {
      *     console.log(results);
      * });
      * ```
+     * @remarks
+     * `WebContents` refers to shared functionality between {@link OpenFin.Window} and {@link OpenFin.View}.
+     * We do not expose an explicit superclass for this functionality, but it does have its own
+     * {@link OpenFin.WebContentsEvents event namespace}.
      */
     stopFindInPage(action) {
         return this.wire.sendAction('stop-find-in-page', { ...this.identity, action }).then(() => undefined);
@@ -1857,6 +1917,10 @@ class WebContents extends base_1$k.EmitterBase {
      *         console.log(err);
      *     });
      * ```
+     * @remarks
+     * `WebContents` refers to shared functionality between {@link OpenFin.Window} and {@link OpenFin.View}.
+     * We do not expose an explicit superclass for this functionality, but it does have its own
+     * {@link OpenFin.WebContentsEvents event namespace}.
      */
     getPrinters() {
         return this.wire.sendAction('get-printers', { ...this.identity }).then(({ payload }) => payload.data);
@@ -1879,6 +1943,10 @@ class WebContents extends base_1$k.EmitterBase {
      *
      * focusWindow().then(() => console.log('Window focused')).catch(err => console.log(err));
      * ```
+     * @remarks
+     * `WebContents` refers to shared functionality between {@link OpenFin.Window} and {@link OpenFin.View}.
+     * We do not expose an explicit superclass for this functionality, but it does have its own
+     * {@link OpenFin.WebContentsEvents event namespace}.
      */
     async focus({ emitSynthFocused } = { emitSynthFocused: true }) {
         await this.wire.sendAction('focus-window', { emitSynthFocused, ...this.identity });
@@ -1910,6 +1978,10 @@ class WebContents extends base_1$k.EmitterBase {
      * .then(() => console.log('Showing dev tools'))
      * .catch(err => console.error(err));
      * ```
+     * @remarks
+     * `WebContents` refers to shared functionality between {@link OpenFin.Window} and {@link OpenFin.View}.
+     * We do not expose an explicit superclass for this functionality, but it does have its own
+     * {@link OpenFin.WebContentsEvents event namespace}.
      */
     async showDeveloperTools() {
         // Note this hits the system action map in core state for legacy reasons.
@@ -1932,6 +2004,10 @@ class WebContents extends base_1$k.EmitterBase {
      *     const win = await fin.Window.getCurrent();
      *     const processInfo = await win.getProcessInfo();
      * ```
+     * @remarks
+     * `WebContents` refers to shared functionality between {@link OpenFin.Window} and {@link OpenFin.View}.
+     * We do not expose an explicit superclass for this functionality, but it does have its own
+     * {@link OpenFin.WebContentsEvents event namespace}.
      */
     async getProcessInfo() {
         const { payload: { data } } = await this.wire.sendAction('get-process-info', this.identity);
@@ -1967,6 +2043,10 @@ class WebContents extends base_1$k.EmitterBase {
      *     const win = await fin.Window.create(winOption);
      *     const sharedWorkers = await win.getSharedWorkers();
      * ```
+     * @remarks
+     * `WebContents` refers to shared functionality between {@link OpenFin.Window} and {@link OpenFin.View}.
+     * We do not expose an explicit superclass for this functionality, but it does have its own
+     * {@link OpenFin.WebContentsEvents event namespace}.
      */
     async getSharedWorkers() {
         return this.wire.sendAction('get-shared-workers', this.identity).then(({ payload }) => payload.data);
@@ -2001,6 +2081,10 @@ class WebContents extends base_1$k.EmitterBase {
      *     const win = await fin.Window.create(winOption);
      *     await win.inspectSharedWorker();
      * ```
+     * @remarks
+     * `WebContents` refers to shared functionality between {@link OpenFin.Window} and {@link OpenFin.View}.
+     * We do not expose an explicit superclass for this functionality, but it does have its own
+     * {@link OpenFin.WebContentsEvents event namespace}.
      */
     async inspectSharedWorker() {
         await this.wire.sendAction('inspect-shared-worker', { ...this.identity });
@@ -2038,6 +2122,10 @@ class WebContents extends base_1$k.EmitterBase {
      *     const sharedWorkers = await win.getSharedWorkers();
      *     await win.inspectSharedWorkerById(sharedWorkers[0].id);
      * ```
+     * @remarks
+     * `WebContents` refers to shared functionality between {@link OpenFin.Window} and {@link OpenFin.View}.
+     * We do not expose an explicit superclass for this functionality, but it does have its own
+     * {@link OpenFin.WebContentsEvents event namespace}.
      */
     async inspectSharedWorkerById(workerId) {
         await this.wire.sendAction('inspect-shared-worker-by-id', { ...this.identity, workerId });
@@ -2072,6 +2160,10 @@ class WebContents extends base_1$k.EmitterBase {
      *     const win = await fin.Window.create(winOption);
      *     await win.inspectServiceWorker();
      * ```
+     * @remarks
+     * `WebContents` refers to shared functionality between {@link OpenFin.Window} and {@link OpenFin.View}.
+     * We do not expose an explicit superclass for this functionality, but it does have its own
+     * {@link OpenFin.WebContentsEvents event namespace}.
      */
     async inspectServiceWorker() {
         await this.wire.sendAction('inspect-service-worker', { ...this.identity });
@@ -2282,6 +2374,10 @@ class WebContents extends base_1$k.EmitterBase {
      *     onPopupReady: popupWindowCallback;
      * });
      * ```
+     * @remarks
+     * `WebContents` refers to shared functionality between {@link OpenFin.Window} and {@link OpenFin.View}.
+     * We do not expose an explicit superclass for this functionality, but it does have its own
+     * {@link OpenFin.WebContentsEvents event namespace}.
      */
     async showPopupWindow(options) {
         this.wire.sendAction(`${this.entityType}-show-popup-window`, this.identity).catch(() => {
@@ -4704,7 +4800,6 @@ function requireInstance () {
 	     */
 	    constructor(wire, identity) {
 	        super(wire, identity, 'window');
-	        this.identity = identity;
 	    }
 	    /**
 	     * Adds a listener to the end of the listeners array for the specified event.
@@ -5883,7 +5978,10 @@ function requireInstance () {
 	     * Calling this method will close previously opened menus.
 	     * @experimental
 	     * @param options
-	     *
+	     * @typeParam Data User-defined shape for data returned upon menu item click.  Should be a
+	     * [union](https://www.typescriptlang.org/docs/handbook/2/everyday-types.html#union-types)
+	     * of all possible data shapes for the entire menu, and the click handler should process
+	     * these with a "reducer" pattern.
 	     * @example
 	     * This could be used to show a drop down menu over views in a platform window:
 	     * ```js
@@ -16599,7 +16697,7 @@ function launchRVM(config, manifestLocation, namedPipeName, rvm) {
 async function checkRvmPath() {
     let rvmPath = path.resolve(process.env.LOCALAPPDATA, 'OpenFin', 'OpenFinRVM.exe');
     if (!(await (0, util_1.exists)(rvmPath))) {
-        rvmPath = path.join(__dirname, '..', '..', 'resources', 'win', 'OpenFinRVM.exe');
+        rvmPath = path.join(__dirname, '..', 'resources', 'win', 'OpenFinRVM.exe');
     }
     return rvmPath;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@openfin/node-adapter",
-    "version": "34.78.12",
+    "version": "34.78.14",
     "description": "See README.md",
     "main": "out/node-adapter.js",
     "types": "out/node-adapter.d.ts",
@@ -11,7 +11,8 @@
         "build": "rollup --config"
     },
     "files": [
-        "out/*"
+        "out/*",
+        "resources/**"
     ],
     "author": "OpenFin",
     "devDependencies": {