@openfin/core 42.100.91 → 42.100.93

package/out/mock-alpha.d.ts

@@ -5570,6 +5570,7 @@ declare interface FinApi<MeType extends OpenFin_2.EntityType> {
     readonly Platform: PlatformModule;
     readonly Interop: InteropModule;
     readonly SnapshotSource: SnapshotSourceModule;
+    readonly NotificationManager: NotificationManagerModule;
     /**
      * Provides access to the OpenFin representation of the current code context (usually an entity
      * such as a {@link OpenFin.View} or {@link OpenFin.Window}), as well as to the current `Interop` context.
@@ -9459,6 +9460,29 @@ declare type NonPropagatedWindowEvent = never;
 
 /* Excluded from this release type: NotCloseRequested */
 
+declare type NotificationEvent = {
+    type: 'close' | 'click' | 'show';
+    notificationId: string;
+};
+
+declare class NotificationManagerInstance {
+    #private;
+    constructor(wire: Transport, id: string);
+    setNotificationHandler: (handler: NotificiationHandler) => Promise<void>;
+    destroy: () => Promise<void>;
+    dispatch: (event: NotificationEvent) => Promise<void>;
+}
+
+declare class NotificationManagerModule extends Base {
+    init: () => Promise<NotificationManagerInstance>;
+}
+
+declare type NotificationManagerPermissions = {
+    init: boolean;
+};
+
+declare type NotificiationHandler = (event: WebNotificationInfo) => void;
+
 /* Excluded from this release type: NotRequested */
 
 /**
@@ -9631,6 +9655,7 @@ declare namespace OpenFin_2 {
         ApplicationPermissions,
         LaunchExternalProcessRule,
         SystemPermissions,
+        NotificationManagerPermissions,
         DevicePermissionName,
         WebPermissionName,
         WebPermission,
@@ -9867,6 +9892,11 @@ declare namespace OpenFin_2 {
         RoutingInfo,
         DownloadShelfOptions,
         ViewShowAtOptions,
+        NotificationEvent,
+        NotificationManagerInstance,
+        NotificationManagerModule,
+        WebNotificationInfo,
+        WebNotificationProperties,
         ExtensionInfo,
         ServeRequest,
         AppAssetServeRequest,
@@ -10163,6 +10193,7 @@ declare type Permissions_2 = {
     Clipboard?: Partial<ClipboardApiPermissions>;
     webAPIs?: WebPermission[];
     devices?: DeviceInfo[];
+    NotificationManager?: Partial<NotificationManagerPermissions>;
 };
 
 declare type PermissionState_2 = 'granted' | 'denied' | 'unavailable';
@@ -12331,6 +12362,10 @@ declare type ProtocolMap = ExternalAdapterOnlyCallsMap & AnalyticsProtocolMap &
         transitions: OpenFin_2.Transition;
         options: OpenFin_2.TransitionOptions;
     }>;
+    'activate-window-and-focus': ApiCall<{
+        winIdentity: OpenFin_2.Identity;
+        focusIdentity: OpenFin_2.Identity;
+    }, boolean>;
     'get-all-frames': IdentityCall<{}, OpenFin_2.FrameInfo[]>;
     'get-window-bounds': IdentityCall<{
         options?: OpenFin_2.GetBoundsOptions;
@@ -12953,6 +12988,28 @@ declare type ProtocolMap = ExternalAdapterOnlyCallsMap & AnalyticsProtocolMap &
         };
         response: void;
     };
+    'dispatch-notification-event': {
+        request: {
+            notificationId: string;
+            type: 'close' | 'show' | 'click';
+        };
+        response: void;
+    };
+    'init-notification-manager': {
+        request: {};
+        response: {
+            managerId: string;
+        };
+        apiPath: '.init';
+        secure: true;
+        namespace: 'NotificationManager';
+    };
+    'destroy-notification-manager': {
+        request: {
+            managerId: string;
+        };
+        response: void;
+    };
 };
 
 declare type ProtocolOffer = ClassicProtocolOffer | RTCProtocolOffer;
@@ -17821,6 +17878,19 @@ declare namespace WebContentsEvents {
     }
 }
 
+declare type WebNotificationInfo = {
+    notificationId: string;
+    properties: WebNotificationProperties;
+    url: string;
+    images: {
+        icon?: string;
+        badge?: string;
+        image?: string;
+    };
+};
+
+declare type WebNotificationProperties = Pick<Notification, 'tag' | 'body' | 'data' | 'dir' | 'icon' | 'lang' | 'title'>;
+
 /**
  * Defines the type of requested web APIs permission.
  *
@@ -17963,6 +18033,30 @@ declare class _Window extends WebContents<OpenFin_2.WindowEvent> {
      * ```
      */
     getAllFrames(): Promise<Array<OpenFin_2.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_2.Identity): Promise<boolean>;
     /**
      * Gets the current bounds (top, bottom, right, left, width, height) of the window.
      *

package/out/mock-beta.d.ts

@@ -5570,6 +5570,7 @@ declare interface FinApi<MeType extends OpenFin_2.EntityType> {
     readonly Platform: PlatformModule;
     readonly Interop: InteropModule;
     readonly SnapshotSource: SnapshotSourceModule;
+    readonly NotificationManager: NotificationManagerModule;
     /**
      * Provides access to the OpenFin representation of the current code context (usually an entity
      * such as a {@link OpenFin.View} or {@link OpenFin.Window}), as well as to the current `Interop` context.
@@ -9459,6 +9460,29 @@ declare type NonPropagatedWindowEvent = never;
 
 /* Excluded from this release type: NotCloseRequested */
 
+declare type NotificationEvent = {
+    type: 'close' | 'click' | 'show';
+    notificationId: string;
+};
+
+declare class NotificationManagerInstance {
+    #private;
+    constructor(wire: Transport, id: string);
+    setNotificationHandler: (handler: NotificiationHandler) => Promise<void>;
+    destroy: () => Promise<void>;
+    dispatch: (event: NotificationEvent) => Promise<void>;
+}
+
+declare class NotificationManagerModule extends Base {
+    init: () => Promise<NotificationManagerInstance>;
+}
+
+declare type NotificationManagerPermissions = {
+    init: boolean;
+};
+
+declare type NotificiationHandler = (event: WebNotificationInfo) => void;
+
 /* Excluded from this release type: NotRequested */
 
 /**
@@ -9631,6 +9655,7 @@ declare namespace OpenFin_2 {
         ApplicationPermissions,
         LaunchExternalProcessRule,
         SystemPermissions,
+        NotificationManagerPermissions,
         DevicePermissionName,
         WebPermissionName,
         WebPermission,
@@ -9867,6 +9892,11 @@ declare namespace OpenFin_2 {
         RoutingInfo,
         DownloadShelfOptions,
         ViewShowAtOptions,
+        NotificationEvent,
+        NotificationManagerInstance,
+        NotificationManagerModule,
+        WebNotificationInfo,
+        WebNotificationProperties,
         ExtensionInfo,
         ServeRequest,
         AppAssetServeRequest,
@@ -10163,6 +10193,7 @@ declare type Permissions_2 = {
     Clipboard?: Partial<ClipboardApiPermissions>;
     webAPIs?: WebPermission[];
     devices?: DeviceInfo[];
+    NotificationManager?: Partial<NotificationManagerPermissions>;
 };
 
 declare type PermissionState_2 = 'granted' | 'denied' | 'unavailable';
@@ -12331,6 +12362,10 @@ declare type ProtocolMap = ExternalAdapterOnlyCallsMap & AnalyticsProtocolMap &
         transitions: OpenFin_2.Transition;
         options: OpenFin_2.TransitionOptions;
     }>;
+    'activate-window-and-focus': ApiCall<{
+        winIdentity: OpenFin_2.Identity;
+        focusIdentity: OpenFin_2.Identity;
+    }, boolean>;
     'get-all-frames': IdentityCall<{}, OpenFin_2.FrameInfo[]>;
     'get-window-bounds': IdentityCall<{
         options?: OpenFin_2.GetBoundsOptions;
@@ -12953,6 +12988,28 @@ declare type ProtocolMap = ExternalAdapterOnlyCallsMap & AnalyticsProtocolMap &
         };
         response: void;
     };
+    'dispatch-notification-event': {
+        request: {
+            notificationId: string;
+            type: 'close' | 'show' | 'click';
+        };
+        response: void;
+    };
+    'init-notification-manager': {
+        request: {};
+        response: {
+            managerId: string;
+        };
+        apiPath: '.init';
+        secure: true;
+        namespace: 'NotificationManager';
+    };
+    'destroy-notification-manager': {
+        request: {
+            managerId: string;
+        };
+        response: void;
+    };
 };
 
 declare type ProtocolOffer = ClassicProtocolOffer | RTCProtocolOffer;
@@ -17821,6 +17878,19 @@ declare namespace WebContentsEvents {
     }
 }
 
+declare type WebNotificationInfo = {
+    notificationId: string;
+    properties: WebNotificationProperties;
+    url: string;
+    images: {
+        icon?: string;
+        badge?: string;
+        image?: string;
+    };
+};
+
+declare type WebNotificationProperties = Pick<Notification, 'tag' | 'body' | 'data' | 'dir' | 'icon' | 'lang' | 'title'>;
+
 /**
  * Defines the type of requested web APIs permission.
  *
@@ -17963,6 +18033,30 @@ declare class _Window extends WebContents<OpenFin_2.WindowEvent> {
      * ```
      */
     getAllFrames(): Promise<Array<OpenFin_2.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_2.Identity): Promise<boolean>;
     /**
      * Gets the current bounds (top, bottom, right, left, width, height) of the window.
      *

package/out/mock-public.d.ts

@@ -5570,6 +5570,7 @@ declare interface FinApi<MeType extends OpenFin_2.EntityType> {
     readonly Platform: PlatformModule;
     readonly Interop: InteropModule;
     readonly SnapshotSource: SnapshotSourceModule;
+    readonly NotificationManager: NotificationManagerModule;
     /**
      * Provides access to the OpenFin representation of the current code context (usually an entity
      * such as a {@link OpenFin.View} or {@link OpenFin.Window}), as well as to the current `Interop` context.
@@ -9459,6 +9460,29 @@ declare type NonPropagatedWindowEvent = never;
 
 /* Excluded from this release type: NotCloseRequested */
 
+declare type NotificationEvent = {
+    type: 'close' | 'click' | 'show';
+    notificationId: string;
+};
+
+declare class NotificationManagerInstance {
+    #private;
+    constructor(wire: Transport, id: string);
+    setNotificationHandler: (handler: NotificiationHandler) => Promise<void>;
+    destroy: () => Promise<void>;
+    dispatch: (event: NotificationEvent) => Promise<void>;
+}
+
+declare class NotificationManagerModule extends Base {
+    init: () => Promise<NotificationManagerInstance>;
+}
+
+declare type NotificationManagerPermissions = {
+    init: boolean;
+};
+
+declare type NotificiationHandler = (event: WebNotificationInfo) => void;
+
 /* Excluded from this release type: NotRequested */
 
 /**
@@ -9631,6 +9655,7 @@ declare namespace OpenFin_2 {
         ApplicationPermissions,
         LaunchExternalProcessRule,
         SystemPermissions,
+        NotificationManagerPermissions,
         DevicePermissionName,
         WebPermissionName,
         WebPermission,
@@ -9867,6 +9892,11 @@ declare namespace OpenFin_2 {
         RoutingInfo,
         DownloadShelfOptions,
         ViewShowAtOptions,
+        NotificationEvent,
+        NotificationManagerInstance,
+        NotificationManagerModule,
+        WebNotificationInfo,
+        WebNotificationProperties,
         ExtensionInfo,
         ServeRequest,
         AppAssetServeRequest,
@@ -10163,6 +10193,7 @@ declare type Permissions_2 = {
     Clipboard?: Partial<ClipboardApiPermissions>;
     webAPIs?: WebPermission[];
     devices?: DeviceInfo[];
+    NotificationManager?: Partial<NotificationManagerPermissions>;
 };
 
 declare type PermissionState_2 = 'granted' | 'denied' | 'unavailable';
@@ -12331,6 +12362,10 @@ declare type ProtocolMap = ExternalAdapterOnlyCallsMap & AnalyticsProtocolMap &
         transitions: OpenFin_2.Transition;
         options: OpenFin_2.TransitionOptions;
     }>;
+    'activate-window-and-focus': ApiCall<{
+        winIdentity: OpenFin_2.Identity;
+        focusIdentity: OpenFin_2.Identity;
+    }, boolean>;
     'get-all-frames': IdentityCall<{}, OpenFin_2.FrameInfo[]>;
     'get-window-bounds': IdentityCall<{
         options?: OpenFin_2.GetBoundsOptions;
@@ -12953,6 +12988,28 @@ declare type ProtocolMap = ExternalAdapterOnlyCallsMap & AnalyticsProtocolMap &
         };
         response: void;
     };
+    'dispatch-notification-event': {
+        request: {
+            notificationId: string;
+            type: 'close' | 'show' | 'click';
+        };
+        response: void;
+    };
+    'init-notification-manager': {
+        request: {};
+        response: {
+            managerId: string;
+        };
+        apiPath: '.init';
+        secure: true;
+        namespace: 'NotificationManager';
+    };
+    'destroy-notification-manager': {
+        request: {
+            managerId: string;
+        };
+        response: void;
+    };
 };
 
 declare type ProtocolOffer = ClassicProtocolOffer | RTCProtocolOffer;
@@ -17821,6 +17878,19 @@ declare namespace WebContentsEvents {
     }
 }
 
+declare type WebNotificationInfo = {
+    notificationId: string;
+    properties: WebNotificationProperties;
+    url: string;
+    images: {
+        icon?: string;
+        badge?: string;
+        image?: string;
+    };
+};
+
+declare type WebNotificationProperties = Pick<Notification, 'tag' | 'body' | 'data' | 'dir' | 'icon' | 'lang' | 'title'>;
+
 /**
  * Defines the type of requested web APIs permission.
  *
@@ -17963,6 +18033,30 @@ declare class _Window extends WebContents<OpenFin_2.WindowEvent> {
      * ```
      */
     getAllFrames(): Promise<Array<OpenFin_2.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_2.Identity): Promise<boolean>;
     /**
      * Gets the current bounds (top, bottom, right, left, width, height) of the window.
      *

package/out/stub.d.ts

@@ -5655,6 +5655,7 @@ declare interface FinApi<MeType extends OpenFin_2.EntityType> {
     readonly Platform: PlatformModule;
     readonly Interop: InteropModule;
     readonly SnapshotSource: SnapshotSourceModule;
+    readonly NotificationManager: NotificationManagerModule;
     /**
      * Provides access to the OpenFin representation of the current code context (usually an entity
      * such as a {@link OpenFin.View} or {@link OpenFin.Window}), as well as to the current `Interop` context.
@@ -9772,6 +9773,29 @@ declare type NonPropagatedWindowEvent = never;
  */
 declare type NotCloseRequested<EventType extends string> = Exclude<EventType, 'close-requested'>;
 
+declare type NotificationEvent = {
+    type: 'close' | 'click' | 'show';
+    notificationId: string;
+};
+
+declare class NotificationManagerInstance {
+    #private;
+    constructor(wire: Transport, id: string);
+    setNotificationHandler: (handler: NotificiationHandler) => Promise<void>;
+    destroy: () => Promise<void>;
+    dispatch: (event: NotificationEvent) => Promise<void>;
+}
+
+declare class NotificationManagerModule extends Base {
+    init: () => Promise<NotificationManagerInstance>;
+}
+
+declare type NotificationManagerPermissions = {
+    init: boolean;
+};
+
+declare type NotificiationHandler = (event: WebNotificationInfo) => void;
+
 /**
  * @internal
  *
@@ -9949,6 +9973,7 @@ declare namespace OpenFin_2 {
         ApplicationPermissions,
         LaunchExternalProcessRule,
         SystemPermissions,
+        NotificationManagerPermissions,
         DevicePermissionName,
         WebPermissionName,
         WebPermission,
@@ -10185,6 +10210,11 @@ declare namespace OpenFin_2 {
         RoutingInfo,
         DownloadShelfOptions,
         ViewShowAtOptions,
+        NotificationEvent,
+        NotificationManagerInstance,
+        NotificationManagerModule,
+        WebNotificationInfo,
+        WebNotificationProperties,
         ExtensionInfo,
         ServeRequest,
         AppAssetServeRequest,
@@ -10481,6 +10511,7 @@ declare type Permissions_2 = {
     Clipboard?: Partial<ClipboardApiPermissions>;
     webAPIs?: WebPermission[];
     devices?: DeviceInfo[];
+    NotificationManager?: Partial<NotificationManagerPermissions>;
 };
 
 declare type PermissionState_2 = 'granted' | 'denied' | 'unavailable';
@@ -12732,6 +12763,10 @@ declare type ProtocolMap = ExternalAdapterOnlyCallsMap & AnalyticsProtocolMap &
         transitions: OpenFin_2.Transition;
         options: OpenFin_2.TransitionOptions;
     }>;
+    'activate-window-and-focus': ApiCall<{
+        winIdentity: OpenFin_2.Identity;
+        focusIdentity: OpenFin_2.Identity;
+    }, boolean>;
     'get-all-frames': IdentityCall<{}, OpenFin_2.FrameInfo[]>;
     'get-window-bounds': IdentityCall<{
         options?: OpenFin_2.GetBoundsOptions;
@@ -13354,6 +13389,28 @@ declare type ProtocolMap = ExternalAdapterOnlyCallsMap & AnalyticsProtocolMap &
         };
         response: void;
     };
+    'dispatch-notification-event': {
+        request: {
+            notificationId: string;
+            type: 'close' | 'show' | 'click';
+        };
+        response: void;
+    };
+    'init-notification-manager': {
+        request: {};
+        response: {
+            managerId: string;
+        };
+        apiPath: '.init';
+        secure: true;
+        namespace: 'NotificationManager';
+    };
+    'destroy-notification-manager': {
+        request: {
+            managerId: string;
+        };
+        response: void;
+    };
 };
 
 declare type ProtocolOffer = ClassicProtocolOffer | RTCProtocolOffer;
@@ -18272,6 +18329,19 @@ declare namespace WebContentsEvents {
     }
 }
 
+declare type WebNotificationInfo = {
+    notificationId: string;
+    properties: WebNotificationProperties;
+    url: string;
+    images: {
+        icon?: string;
+        badge?: string;
+        image?: string;
+    };
+};
+
+declare type WebNotificationProperties = Pick<Notification, 'tag' | 'body' | 'data' | 'dir' | 'icon' | 'lang' | 'title'>;
+
 /**
  * Defines the type of requested web APIs permission.
  *
@@ -18417,6 +18487,30 @@ declare class _Window extends WebContents<OpenFin_2.WindowEvent> {
      * ```
      */
     getAllFrames(): Promise<Array<OpenFin_2.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_2.Identity): Promise<boolean>;
     /**
      * Gets the current bounds (top, bottom, right, left, width, height) of the window.
      *