@openfin/fdc3-api 41.100.120 → 41.100.122

package/out/fdc3-api-alpha.d.ts

@@ -12589,6 +12589,10 @@ declare interface ProtocolMap extends ProtocolMapBase {
         transitions: OpenFin.Transition;
         options: OpenFin.TransitionOptions;
     }>;
+    'activate-window-and-focus': ApiCall<{
+        winIdentity: OpenFin.Identity;
+        focusIdentity: OpenFin.Identity;
+    }, boolean>;
     'get-all-frames': IdentityCall<{}, OpenFin.FrameInfo[]>;
     'get-window-bounds': IdentityCall<{
         options?: OpenFin.GetBoundsOptions;
@@ -18244,6 +18248,30 @@ declare class _Window extends WebContents<OpenFin.WindowEvent> {
      * ```
      */
     getAllFrames(): Promise<Array<OpenFin.FrameInfo>>;
+    /**
+     * Activates the current window and focuses the child entity if it exists. If this does
+     * not succeed - say the child does not belong to this window, or the identity does not exist -
+     * it will return false.
+     *
+     * @example
+     * ```js
+     * const win = fin.Window.wrapSync({ uuid: 'myApp', name: 'myOtherWindow' });
+     *
+     * win.getCurrentViews()
+     *   .then(([view1]) => {
+     *      return win.activateAndFocus(view1.identity);
+     *   })
+     *   .then(success => {
+     *     if (success) {
+     *        console.log('Window activated and child focused');
+     *     } else {
+     *        console.log('Window activation failed, focus state unchanged');
+     *     }
+     *   })
+     *   .catch(console.error);
+     * ```
+     */
+    activateAndFocus(childIdentityToFocus: OpenFin.Identity): Promise<boolean>;
     /**
      * Gets the current bounds (top, bottom, right, left, width, height) of the window.
      *

package/out/fdc3-api-beta.d.ts

@@ -12589,6 +12589,10 @@ declare interface ProtocolMap extends ProtocolMapBase {
         transitions: OpenFin.Transition;
         options: OpenFin.TransitionOptions;
     }>;
+    'activate-window-and-focus': ApiCall<{
+        winIdentity: OpenFin.Identity;
+        focusIdentity: OpenFin.Identity;
+    }, boolean>;
     'get-all-frames': IdentityCall<{}, OpenFin.FrameInfo[]>;
     'get-window-bounds': IdentityCall<{
         options?: OpenFin.GetBoundsOptions;
@@ -18244,6 +18248,30 @@ declare class _Window extends WebContents<OpenFin.WindowEvent> {
      * ```
      */
     getAllFrames(): Promise<Array<OpenFin.FrameInfo>>;
+    /**
+     * Activates the current window and focuses the child entity if it exists. If this does
+     * not succeed - say the child does not belong to this window, or the identity does not exist -
+     * it will return false.
+     *
+     * @example
+     * ```js
+     * const win = fin.Window.wrapSync({ uuid: 'myApp', name: 'myOtherWindow' });
+     *
+     * win.getCurrentViews()
+     *   .then(([view1]) => {
+     *      return win.activateAndFocus(view1.identity);
+     *   })
+     *   .then(success => {
+     *     if (success) {
+     *        console.log('Window activated and child focused');
+     *     } else {
+     *        console.log('Window activation failed, focus state unchanged');
+     *     }
+     *   })
+     *   .catch(console.error);
+     * ```
+     */
+    activateAndFocus(childIdentityToFocus: OpenFin.Identity): Promise<boolean>;
     /**
      * Gets the current bounds (top, bottom, right, left, width, height) of the window.
      *

package/out/fdc3-api-public.d.ts

@@ -12589,6 +12589,10 @@ declare interface ProtocolMap extends ProtocolMapBase {
         transitions: OpenFin.Transition;
         options: OpenFin.TransitionOptions;
     }>;
+    'activate-window-and-focus': ApiCall<{
+        winIdentity: OpenFin.Identity;
+        focusIdentity: OpenFin.Identity;
+    }, boolean>;
     'get-all-frames': IdentityCall<{}, OpenFin.FrameInfo[]>;
     'get-window-bounds': IdentityCall<{
         options?: OpenFin.GetBoundsOptions;
@@ -18244,6 +18248,30 @@ declare class _Window extends WebContents<OpenFin.WindowEvent> {
      * ```
      */
     getAllFrames(): Promise<Array<OpenFin.FrameInfo>>;
+    /**
+     * Activates the current window and focuses the child entity if it exists. If this does
+     * not succeed - say the child does not belong to this window, or the identity does not exist -
+     * it will return false.
+     *
+     * @example
+     * ```js
+     * const win = fin.Window.wrapSync({ uuid: 'myApp', name: 'myOtherWindow' });
+     *
+     * win.getCurrentViews()
+     *   .then(([view1]) => {
+     *      return win.activateAndFocus(view1.identity);
+     *   })
+     *   .then(success => {
+     *     if (success) {
+     *        console.log('Window activated and child focused');
+     *     } else {
+     *        console.log('Window activation failed, focus state unchanged');
+     *     }
+     *   })
+     *   .catch(console.error);
+     * ```
+     */
+    activateAndFocus(childIdentityToFocus: OpenFin.Identity): Promise<boolean>;
     /**
      * Gets the current bounds (top, bottom, right, left, width, height) of the window.
      *

package/out/fdc3-api.d.ts

@@ -12990,6 +12990,10 @@ declare interface ProtocolMap extends ProtocolMapBase {
         transitions: OpenFin.Transition;
         options: OpenFin.TransitionOptions;
     }>;
+    'activate-window-and-focus': ApiCall<{
+        winIdentity: OpenFin.Identity;
+        focusIdentity: OpenFin.Identity;
+    }, boolean>;
     'get-all-frames': IdentityCall<{}, OpenFin.FrameInfo[]>;
     'get-window-bounds': IdentityCall<{
         options?: OpenFin.GetBoundsOptions;
@@ -18698,6 +18702,30 @@ declare class _Window extends WebContents<OpenFin.WindowEvent> {
      * ```
      */
     getAllFrames(): Promise<Array<OpenFin.FrameInfo>>;
+    /**
+     * Activates the current window and focuses the child entity if it exists. If this does
+     * not succeed - say the child does not belong to this window, or the identity does not exist -
+     * it will return false.
+     *
+     * @example
+     * ```js
+     * const win = fin.Window.wrapSync({ uuid: 'myApp', name: 'myOtherWindow' });
+     *
+     * win.getCurrentViews()
+     *   .then(([view1]) => {
+     *      return win.activateAndFocus(view1.identity);
+     *   })
+     *   .then(success => {
+     *     if (success) {
+     *        console.log('Window activated and child focused');
+     *     } else {
+     *        console.log('Window activation failed, focus state unchanged');
+     *     }
+     *   })
+     *   .catch(console.error);
+     * ```
+     */
+    activateAndFocus(childIdentityToFocus: OpenFin.Identity): Promise<boolean>;
     /**
      * Gets the current bounds (top, bottom, right, left, width, height) of the window.
      *

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@openfin/fdc3-api",
-    "version": "41.100.120",
+    "version": "41.100.122",
     "description": "OpenFin fdc3 module utilities and types.",
     "license": "SEE LICENSE IN LICENSE.md",
     "private": false,