@openfin/fdc3-api 40.200.2 → 41.83.2

package/out/fdc3-api.d.ts

@@ -2301,8 +2301,6 @@ declare class Channel extends EmitterBase<ChannelEvent> {
 
 declare type Channel_2 = OpenFin.Fin['InterApplicationBus']['Channel'];
 
-declare type Channel_3 = OpenFin.Fin['InterApplicationBus']['Channel'];
-
 declare type ChannelAction = OpenFin.ChannelAction;
 
 declare type ChannelAction_2 = (payload: unknown, id: ProviderIdentity_4 | ClientIdentity) => unknown;
@@ -2993,6 +2991,18 @@ declare type ChildWindowCreatedEvent = ContentCreationRulesEvent & {
     childOptions: OpenFin.WindowOptions;
 };
 
+/**
+ * Control behavior for Chromium policies
+ *
+ * @interface
+ */
+declare type ChromiumPolicies = {
+    /**
+     * Disable AutofillAddressEnabled policy for a Window or View.
+     */
+    AutofillAddressEnabled?: PolicyOptions;
+};
+
 declare interface ClassicProtocolOffer extends ProtocolPacketBase {
     type: 'classic';
 }
@@ -3464,10 +3474,6 @@ declare type ConstViewOptions = {
      * but the properties in the manifest will take precedence if there is any collision.
      */
     manifestUrl: string;
-    /**
-     * If true, the view's call to the Web Notifications API will be intercepted by the platform. The event `notification-intercepted` will be emitted with the notification object as the payload.
-     */
-    interceptNotifications: boolean;
     zoomLevel: number;
     experimental: any;
     fdc3InteropApi?: string;
@@ -3511,6 +3517,10 @@ declare type ConstViewOptions = {
          */
         enabled: boolean;
     };
+    /**
+     * Control which options to ignore when creating a Platform View.
+     */
+    excludeOptions: ExcludeOptions;
 };
 
 /**
@@ -3641,12 +3651,6 @@ declare type ConstWindowOptions = {
      */
     downloadShelf: DownloadShelfOptions;
     height: number;
-    /**
-     * @defaultValue false
-     * @remarks
-     * When set to `true` the platform will intercept all web notifications and instead raise `notification-intercepted` events.
-     */
-    interceptNotifications: boolean;
     layout: any;
     /**
      * @experimental
@@ -3725,11 +3729,6 @@ declare type ConstWindowOptions = {
      * @deprecated - use `icon` instead.
      */
     taskbarIcon: string;
-    /**
-     * Specify a taskbar group for the window.
-     * _If omitted, defaults to app's uuid (`fin.Application.getCurrentSync().identity.uuid`)._
-     */
-    taskbarIconGroup: string;
     /**
      * @defaultValue "about:blank"
      *
@@ -3766,6 +3765,10 @@ declare type ConstWindowOptions = {
      * Controls whether an option is inherited from the parent application. The option is set as part of the window options for the parent application in either the {@link Manifest.startup_app} or {@link Manifest.platform} properties in the manifest or in {@link ApplicationOptions.mainWindowOptions} when calling {@link Application.ApplicationModule.start Application.start}. Use { [option]: false } to disable a specific [option]. All inheritable properties will be inherited by default if omitted.
      */
     inheritance?: Partial<InheritableOptions>;
+    /**
+     * Control which options to ignore when creating a Platform Window.
+     */
+    excludeOptions: ExcludeOptions;
 };
 
 /**
@@ -4772,6 +4775,7 @@ declare interface Environment {
     getInteropInfo(fin: OpenFin.Fin<OpenFin.EntityType>): Promise<InternalInteropBrokerOptions & {
         fdc3Version?: Version;
     }>;
+    getViewWindowIdentity(fin: OpenFin.Fin<OpenFin.EntityType>, identity: OpenFin.Identity): Promise<OpenFin.Identity>;
     readonly type: EnvironmentType;
 }
 
@@ -4805,7 +4809,7 @@ declare type Event_10 = ApplicationEvents.Event | ApiReadyEvent | SnapshotApplie
  *  under the {@link OpenFin.SystemEvents} namespace (payloads inherited from propagated events are defined in the namespace
  *  from which they propagate).
  */
-declare type Event_11 = ExcludeRequested<WindowEvents.PropagatedEvent<'system'>> | ExcludeRequested<ViewEvents.PropagatedEvent<'system'>> | ExcludeRequested<ApplicationEvents.PropagatedEvent<'system'>> | ApplicationCreatedEvent | DesktopIconClickedEvent | IdleStateChangedEvent | MonitorInfoChangedEvent | SessionChangedEvent | AppVersionEventWithId | SystemShutdownEvent | NotificationCloseRequested;
+declare type Event_11 = ExcludeRequested<WindowEvents.PropagatedEvent<'system'>> | ExcludeRequested<ViewEvents.PropagatedEvent<'system'>> | ExcludeRequested<ApplicationEvents.PropagatedEvent<'system'>> | ApplicationCreatedEvent | DesktopIconClickedEvent | IdleStateChangedEvent | MonitorInfoChangedEvent | SessionChangedEvent | AppVersionEventWithId | SystemShutdownEvent | ExtensionsEnabledEvent | ExtensionsDisabledEvent | ExtensionsExcludedEvent | ExtensionsInstalledEvent | ExtensionInstalledEvent | ExtensionsInstallFailedEvent | ExtensionInstallFailedEvent | ExtensionsInitializationFailedEvent;
 
 /**
  * [Union](https://www.typescriptlang.org/docs/handbook/2/everyday-types.html#union-types) containing every possible event that can be emitted by the HTMLElement Layout container.
@@ -4845,7 +4849,7 @@ declare type Event_4 = (WebContentsEvents.Event<'view'> & {
  */
 declare type Event_5<Topic extends string> = {
     topic: Topic;
-} & (BlurredEvent | CertificateSelectionShownEvent | CrashedEvent_2 | DidChangeThemeColorEvent | FocusedEvent | NavigationRejectedEvent | UrlChangedEvent | DidFailLoadEvent | DidFinishLoadEvent | DidStartLoadingEvent | PageFaviconUpdatedEvent | PageTitleUpdatedEvent | ResourceLoadFailedEvent | ResourceResponseReceivedEvent | ChildContentBlockedEvent | ChildContentOpenedInBrowserEvent | ChildViewCreatedEvent | ChildWindowCreatedEvent | FileDownloadStartedEvent | FileDownloadProgressEvent | FileDownloadCompletedEvent | FoundInPageEvent | CertificateErrorEvent | ContentBlockedEvent | WillRedirectEvent | NotificationInterceptedEvent);
+} & (BlurredEvent | CertificateSelectionShownEvent | CrashedEvent_2 | DidChangeThemeColorEvent | FocusedEvent | NavigationRejectedEvent | UrlChangedEvent | DidFailLoadEvent | DidFinishLoadEvent | DidStartLoadingEvent | PageFaviconUpdatedEvent | PageTitleUpdatedEvent | ResourceLoadFailedEvent | ResourceResponseReceivedEvent | ChildContentBlockedEvent | ChildContentOpenedInBrowserEvent | ChildViewCreatedEvent | ChildWindowCreatedEvent | FileDownloadStartedEvent | FileDownloadProgressEvent | FileDownloadCompletedEvent | FoundInPageEvent | CertificateErrorEvent | ContentBlockedEvent | WillRedirectEvent);
 
 /**
  *  [Union](https://www.typescriptlang.org/docs/handbook/2/everyday-types.html#union-types) containing every possible event that can be emitted by a {@link Window}.  Events are
@@ -4959,6 +4963,18 @@ declare type EventWithId<Event extends AppVersionEvent> = Event extends infer E
     appVersionId: string;
 } : never;
 
+/**
+ * @interface
+ */
+declare type ExcludeOptions = {
+    /**
+     * @defaultValue false
+     *
+     * When true, will not merge default preload scripts from {@link ApplicationOptions.defaultWindowOptions} or {@link ApplicationOptions.defaultViewOptions}.
+     */
+    preloadScripts: boolean;
+};
+
 /**
  * @internal
  *
@@ -4983,6 +4999,105 @@ declare type ExitCode = {
     exitCode: number;
 };
 
+declare type ExtensionEvent = SecurityRealmEvent & {
+    /**
+     * Runtime extension whose status has been (possibly) modified
+     */
+    extension: string;
+};
+
+/**
+ * @interface
+ */
+declare type ExtensionInfo = {
+    extensionId: string;
+    name: string;
+    enabled: boolean;
+};
+
+/**
+ * An event that fires when an extension is installed in the security realm.
+ *
+ * @interface
+ */
+declare type ExtensionInstalledEvent = ExtensionEvent & {
+    type: 'extension-installed';
+};
+
+/**
+ * An event that fires when an extension fails to install in the security realm.
+ *
+ * @interface
+ */
+declare type ExtensionInstallFailedEvent = ExtensionEvent & {
+    type: 'extension-install-failed';
+};
+
+/**
+ * An event that fires when extensions are disabled in the security realm.
+ *
+ * @interface
+ */
+declare type ExtensionsDisabledEvent = ExtensionsEvent & {
+    type: 'extensions-disabled';
+};
+
+/**
+ * An event that fires when extensions are enabled in the security realm.
+ *
+ * @interface
+ */
+declare type ExtensionsEnabledEvent = ExtensionsEvent & {
+    type: 'extensions-enabled';
+};
+
+declare type ExtensionsEvent = SecurityRealmEvent & {
+    /**
+     * Runtime extensions whose status has been (possibly) modified
+     */
+    extensions: string[];
+};
+
+/**
+ * An event that fires when requested extensions are not allowed to be installed in the security realm.
+ *
+ * @interface
+ */
+declare type ExtensionsExcludedEvent = ExtensionsEvent & {
+    type: 'extensions-excluded';
+};
+
+/**
+ * An event that fires when extension initialization fails on initial app launch.  Users may attempt to
+ * re-initialize extensions by calling {@link System.refreshExtensions}.  This event will not fire in response
+ * to manual extension refreshes (users should catch the error normally).
+ */
+declare type ExtensionsInitializationFailedEvent = Omit<ExtensionsEvent, 'extensions'> & {
+    type: 'extensions-initialization-failed';
+    /**
+     * The error that caused the extension initialization failure
+     */
+    error: Error;
+};
+
+/**
+ * An event that fires when extensions are installed in the security realm.
+ *
+ * @interface
+ */
+declare type ExtensionsInstalledEvent = ExtensionsEvent & {
+    type: 'extensions-installed';
+};
+
+/**
+ * An event that fires when extensions fail to install in the security realm.
+ *
+ * @interface
+ */
+declare type ExtensionsInstallFailedEvent = ExtensionsEvent & {
+    type: 'extensions-install-failed';
+};
+
 /**
  * An ExternalApplication object representing native language adapter connections to the runtime. Allows
  * the developer to listen to {@link OpenFin.ExternalApplicationEvents external application events}.
@@ -7992,6 +8107,10 @@ declare type LaunchIntoPlatformPayload = {
  */
 declare class Layout extends Base {
     #private;
+    /**
+     * @internal
+     */
+    static getClient(layout: Layout): Promise<LayoutEntitiesClient>;
     /**
      * @internal
      */
@@ -8097,6 +8216,17 @@ declare class Layout extends Base {
      * ```
      */
     getRootItem(): Promise<OpenFin.ColumnOrRow | OpenFin.TabStack>;
+    /**
+     * Retrieves the OpenFin.TabStack instance which the View belongs to.
+     *
+     * @example
+     * ```js
+     * const viewIdentity = { uuid: 'uuid', name: 'view-name' };
+     * const stack = await fin.View.wrapSync(viewIdentity).getStackByViewIdentity(viewIdentity);
+     * console.log(await stack.getViews());
+     * ```
+     */
+    getStackByViewIdentity(identity: OpenFin.Identity): Promise<OpenFin.TabStack>;
     /**
      * Replaces the specified view with a view with the provided configuration.
      *
@@ -8150,6 +8280,29 @@ declare class Layout extends Base {
      * ```
      */
     applyPreset: (options: PresetLayoutOptions) => Promise<void>;
+    /**
+     * Adds a view to the platform layout. Behaves like @link{Platform#createView} with the current layout as the target.
+     *
+     * @param viewOptions - The options for creating the view.
+     * @param options - Optional parameters for adding the view.
+     * @param options.location - The location where the view should be added.
+     * @param options.targetView - The target view to which the new view should be added.
+     * @returns A promise that resolves to an object containing the identity of the added view.
+     */
+    addView(viewOptions: OpenFin.PlatformViewCreationOptions, { location, targetView }?: {
+        location?: OpenFin.CreateViewTarget['location'];
+        targetView?: OpenFin.Identity;
+    }): Promise<{
+        identity: OpenFin.Identity;
+    }>;
+    /**
+     * Closes a view by its identity. Throws an error if the view does not belong to the current layout.
+     * Behaves like @link{Platform#closeView} but only closes the view if it belongs the current layout.
+     *
+     * @param viewIdentity - The identity of the view to close.
+     * @returns A promise that resolves when the view is closed.
+     */
+    closeView(viewIdentity: OpenFin.Identity): Promise<void>;
 }
 
 /**
@@ -8162,7 +8315,7 @@ declare type LayoutColumn = LayoutItemConfig & {
 /**
  * @interface
  */
-declare type LayoutComponent = LayoutItemConfig & {
+declare type LayoutComponent = Omit<LayoutItemConfig, 'content' | 'type'> & {
     /**
      * Only a component type will have this property and it should be set to view.
      */
@@ -8171,6 +8324,7 @@ declare type LayoutComponent = LayoutItemConfig & {
      * Only a component type will have this property and it represents the view options of a given component.
      */
     componentState?: Partial<ViewCreationOptions>;
+    type: 'component';
 };
 
 declare type LayoutContent = Array<LayoutItemConfig | LayoutRow | LayoutColumn | LayoutComponent>;
@@ -8254,10 +8408,7 @@ declare type LayoutIdentity = Identity_4 & {
 declare type LayoutInitializedEvent = BaseEvent_5 & {
     type: 'layout-initialized';
     layoutIdentity: OpenFin.LayoutIdentity;
-    ofViews: {
-        identity: OpenFin.Identity;
-        entityType: 'view';
-    }[];
+    ofViews: OpenFin.ViewCreationResult[];
 };
 
 /**
@@ -8365,7 +8516,7 @@ declare interface LayoutManager<T extends LayoutSnapshot> {
     /**
      * @experimental
      */
-    getLayoutIdentityForView(viewIdentity: Identity_4): LayoutIdentity;
+    getLayoutIdentityForView(viewIdentity: Identity_4): LayoutIdentity | undefined;
     /**
      * @experimental
      */
@@ -8466,6 +8617,17 @@ declare class LayoutModule extends Base {
      * ```
      */
     getCurrentSync(): OpenFin.Layout;
+    /**
+     * Retrieves the OpenFin.Layout instance for the Window the View is attached to.
+     *
+     * @example
+     * ```js
+     * const viewIdentity = { uuid: 'uuid', name: 'view-name' };
+     * const layout = await fin.Platform.Layout.getLayoutByViewIdentity(viewIdentity);
+     * console.log(await layout.getCurrentViews());
+     * ```
+     */
+    getLayoutByViewIdentity(viewIdentity: OpenFin.Identity): Promise<OpenFin.Layout>;
     /**
      * Initialize the window's Layout.
      *
@@ -9279,6 +9441,10 @@ declare type MutableViewOptions = {
      * @defaultValue 'enabled'
      */
     throttling: ViewThrottling;
+    /**
+     * {@inheritDoc ChromiumPolicies}
+     */
+    chromiumPolicies: ChromiumPolicies;
 };
 
 /**
@@ -9519,6 +9685,12 @@ declare type MutableWindowOptions = {
      * Shows the window's icon in the taskbar.
      */
     showTaskbarIcon: boolean;
+    /**
+     * Specify a taskbar group for the window.
+     * _If omitted, defaults to app's uuid (`fin.Application.getCurrentSync().identity.uuid`)._
+     * @remarks It's only updatable when `enableJumpList` is set to false.
+     */
+    taskbarIconGroup: string;
     interop: InteropConfig;
     /**
      * @internal
@@ -9538,6 +9710,10 @@ declare type MutableWindowOptions = {
      * @remarks If `throttling` option is present, the `backgroundThrottling` option is completely ignored for windows.
      */
     throttling: WindowThrottling;
+    /**
+     * {@inheritDoc ChromiumPolicies}
+     */
+    chromiumPolicies: ChromiumPolicies;
 };
 
 declare type NackHandler = (payloadOrMessage: RuntimeErrorPayload | string) => void;
@@ -9650,154 +9826,6 @@ declare type NonPropagatedWindowEvent = never;
  */
 declare type NotCloseRequested<EventType extends string> = Exclude<EventType, 'close-requested'>;
 
-declare type NotificationAction_2 = {
-    /**
-     * Type of action this structure represents (BUTTON, TEXT)
-     */
-    type: number;
-    /**
-     * Action name that the author can use to distinguish them.
-     */
-    action: string;
-    /**
-     * Title of the action button.
-     */
-    title: string;
-    /**
-     * URL of the icon for the button. May be empty if no url was specified.
-     */
-    icon: string;
-    /**
-     * Placeholder to display for text-based actions in absence of user input.
-     */
-    placeholder: string;
-};
-
-/**
- * Emitted when a developer has called .close on a notification which has been interecepted.
- */
-declare type NotificationCloseRequested = BaseEvent_9 & {
-    type: 'notification-close-requested';
-    notificationId: string;
-};
-
-declare type NotificationData = {
-    /**
-     * Title to be displayed with the Web Notification.
-     */
-    title: string;
-    /**
-     * Hint to determine the directionality of the displayed notification.
-     * (LEFT_TO_RIGHT, RIGHT_TO_LEFT, AUTO)
-     */
-    direction: number;
-    /**
-     * BCP 47 language tag describing the notification's contents. Optional.
-     */
-    lang: string;
-    /**
-     * Contents of the notification.
-     */
-    body: string;
-    /**
-     * Tag of the notification. Notifications sharing both their origin and their, tag
-     * will replace the first displayed notification.
-     */
-    tag: string;
-    /**
-     *  URL of the image contents of the notification. May be empty if no url was
-     * specified.
-     */
-    image: string;
-    /**
-     * URL of the icon which is to be displayed with the notification.
-     */
-    icon: string;
-    /**
-     * URL of the badge for representing the notification. May be empty if no url was
-     * specified.
-     */
-    badge: string;
-    /**
-     * Vibration pattern for the notification, following the syntax of the Vibration
-     * API. https://www.w3.org/TR/vibration/
-     */
-    vibration_pattern: number[];
-    /**
-     * The time at which the event the notification represents took place.
-     */
-    timestamp: string;
-    /**
-     * Whether default notification indicators (sound, vibration, light) should be
-     * played again if the notification is replacing an older notification.
-     */
-    renotify: boolean;
-    /**
-     *   Whether default notification indicators (sound, vibration, light) should be
-     * played again if the notification is replacing an older notification.
-     */
-    silent: boolean;
-    /**
-     * Whether the notification should remain onscreen indefinitely, rather than being
-     * auto-minimized to the notification center (if allowed by platform).
-     */
-    requireInteraction: boolean;
-    /**
-     * Base64 encoded Developer-provided data associated with the notification, in the
-     * form of a serialized string. Must not exceed |kMaximumDeveloperDataSize| bytes.
-     */
-    data: string;
-    /**
-     * Actions that should be shown as buttons on the notification.
-     */
-    actions: NotificationAction_2[];
-    /**
-     * The time at which the notification should be shown.
-     */
-    showTriggerTimestamp?: string | null;
-    /**
-     * Scenarios that define the notification behavior. (DEFAULT, INCOMING_CALL)
-     */
-    scenario: number;
-};
-
-declare type NotificationInterceptedEvent = NamedEvent & {
-    type: 'notification-intercepted';
-    /**
-     * id of the notification
-     */
-    notificationId: string;
-    /**
-     * origin of the notification
-     */
-    origin: string;
-    /**
-     * empty if notification comes from worker
-     */
-    documentUrl: string;
-    notificationData: NotificationData;
-    /**
-     * Image for the notification. The bitmap may be empty if the developer did not
-     * provide an image, or fetching of the image failed.
-     */
-    image: SerializedImage;
-    /**
-     * Main icon for the notification. The bitmap may be empty if the developer did not
-     * provide an icon, or fetching of the icon failed.
-     */
-    notificationIcon: SerializedImage;
-    /**
-     * Badge for the notification. The bitmap may be empty if the developer did not
-     * provide a badge, or fetching of the badge failed.
-     */
-    badge: SerializedImage;
-    /**
-     * Icons for the actions. A bitmap may be empty if the developer did not provide an
-     * icon, or fetching of the icon failed.
-     */
-    actionIcons: SerializedImage[];
-};
-
 /**
  * @internal
  *
@@ -9906,8 +9934,11 @@ declare namespace OpenFin {
         ViewVisibilityOptions,
         WindowState,
         AutoplayPolicyOptions,
+        ExcludeOptions,
         ConstWindowOptions,
         InheritableOptions,
+        PolicyOptions,
+        ChromiumPolicies,
         MutableWindowOptions,
         WorkspacePlatformOptions,
         WebRequestHeader,
@@ -9941,6 +9972,9 @@ declare namespace OpenFin {
         ViewOptions,
         ConstViewOptions,
         ViewState,
+        ViewCreationSuccess,
+        ViewCreationFailure,
+        ViewCreationResult,
         Certificate,
         HostContextChangedPayload,
         ApplySnapshotOptions,
@@ -10186,6 +10220,7 @@ declare namespace OpenFin {
         RoutingInfo,
         DownloadShelfOptions,
         ViewShowAtOptions,
+        ExtensionInfo,
         ApplicationEvents,
         BaseEvents,
         ExternalApplicationEvents,
@@ -10387,6 +10422,10 @@ declare type PerDomainSettings = {
      * {@link ContentRedirect} in {@link WindowOptions} and {@link ViewOptions} will be **ignored**.
      */
     content?: ContentPermission;
+    /**
+     * {@inheritdoc ChromiumPolicies}
+     */
+    chromiumPolicies?: ChromiumPolicies;
 };
 
 /**
@@ -10434,8 +10473,14 @@ declare class Platform extends EmitterBase<OpenFin.PlatformEvent> {
     identity: OpenFin.ApplicationIdentity;
     /**
      * @internal
+     * Reuse clients to avoid overwriting already-registered client in provider
+     * This ensures that only channel client is created per channel name per `fin` instance
      */
-    constructor(identity: OpenFin.ApplicationIdentity, channel: Channel_3);
+    private static clientMap;
+    /**
+     * @internal
+     */
+    constructor(wire: Transport, identity: OpenFin.ApplicationIdentity, channelName?: string);
     getClient: (identity?: OpenFin.ApplicationIdentity) => Promise<ChannelClient_2>;
     /**
      * Creates a new view and attaches it to a specified target window.
@@ -11819,6 +11864,45 @@ declare interface PlatformProvider {
      * @returns {Promise<void>}
      */
     handleRunRequested({ manifest, userAppConfigArgs }: RunRequestedEvent): Promise<void>;
+    /**
+     * @experimental
+     *
+     * This method is called to handle errors with view creation and initial navigation during layout creation.
+     * Overriding this method enables catching the error and correcting behavior (ie navigating to an error page).
+     * * To indicate that the error has been handled, view creation should be treated as successful return {identity: viewIdentity, success: true}.
+     * * Not returning anything will cause the layout-initialized event to include the view as failed with the original error.
+     * * Throwing an error will update the error on the event payload of layout-initialized to the thrown error.
+     *
+     * @param viewIdentity Identity of the view
+     * @param error error thrown during a view creation
+     * @returns {Promise<OpenFin.ViewCreationSuccess | void>}
+     *
+     * @example
+     *
+     * ```js
+     * const overrideCallback = (PlatformProvider) => {
+     *     class Override extends PlatformProvider {
+     *         async handleFailedViewCreation(viewIdentity, error) {
+     *              const view = fin.View.wrapSync(viewId);
+     *              try {
+     *                  // navigate to an error page
+     *                  await view.navigate('http://localhost:3000/errorPage.html');
+     *                  // resolve a success result after redirecting to a error page
+     *                  return {identity: viewIdentity, success: true};
+     *              } catch(e) {
+     *                  // layout-initialized event will include this view with the error
+     *                  throw error;
+     *              }
+     *         }
+     *     }
+     *     return new Override();
+     * }
+     *
+     * fin.Platform.init({ overrideCallback });
+     *
+     * ```
+     */
+    handleFailedViewCreation(viewIdentity: OpenFin.Identity, error: Error): Promise<OpenFin.ViewCreationSuccess | void>;
 }
 
 /**
@@ -11883,6 +11967,12 @@ declare type PointTopLeft = {
     left: number;
 };
 
+/**
+ * When set to `disable`, disables the policy
+ * When set to `defer-to-group-policy`, respects Group Policy settings
+ */
+declare type PolicyOptions = 'disable' | 'defer-to-group-policy';
+
 declare type PopupBaseBehavior = 'close' | 'hide';
 
 declare type PopupBlurBehavior = 'modal' | PopupBaseBehavior;
@@ -12740,13 +12830,6 @@ declare interface ProtocolMap extends ProtocolMapBase {
     'get-version': GetterCall<string>;
     'clear-cache': ApiCall<OpenFin.ClearCacheOption, void>;
     'delete-cache-request': VoidCall;
-    'dispatch-notification-action': {
-        request: {
-            notificationId: string;
-            action: 'click' | 'close' | 'show';
-        };
-        response: void;
-    };
     'exit-desktop': VoidCall;
     'fetch-manifest': ApiCall<{
         manifestUrl: string;
@@ -12777,6 +12860,9 @@ declare interface ProtocolMap extends ProtocolMapBase {
         response: string;
     };
     'get-focused-window': GetterCall<OpenFin.Identity | null>;
+    'get-focused-content': GetterCall<(OpenFin.Identity & {
+        entityType: 'window' | 'view';
+    }) | null>;
     'is-app-certified': {
         request: {
             manifestUrl: string;
@@ -12905,6 +12991,14 @@ declare interface ProtocolMap extends ProtocolMapBase {
     }, void>;
     'system-register-shutdown-handler': VoidCall;
     'get-permissions': GetterCall<any>;
+    'refresh-extensions': {
+        request: void;
+        response: string[] | undefined;
+    };
+    'get-installed-extensions': {
+        request: void;
+        response: OpenFin.ExtensionInfo[];
+    };
     'fdc3-add-context-listener': VoidCall;
     'fdc3-add-intent-listener': VoidCall;
     'fdc3-raise-intent': VoidCall;
@@ -13593,6 +13687,21 @@ declare type ScreenshotPrintOptions = {
     content: 'screenshot';
 };
 
+/**
+ * An event generated when an application modifies the runtime in a way that affects all other applications in the
+ * application runtime/security realm.
+ */
+declare type SecurityRealmEvent = BaseEvent_9 & {
+    /**
+     * Config URL of the application that modified the security realm's extensions
+     */
+    configUrl: string;
+    /**
+     * Identity of the application that modified the security realm's extensions
+     */
+    applicationIdentity: OpenFin.ApplicationIdentity;
+};
+
 declare type SendActionResponse<T extends keyof ProtocolMap> = Message<{
     data: ProtocolMap[T]['response'];
 } & ProtocolMap[T]['specialResponse']>;
@@ -13609,11 +13718,6 @@ declare type SentMessage<Value> = Promise<Value> & {
     messageId: ReturnType<Environment['getNextMessageId']>;
 };
 
-/**
- * Utility type to mark an image serialized as a base64 data URL.
- */
-declare type SerializedImage = string;
-
 /**
  * @interface
  */
@@ -14056,13 +14160,6 @@ declare class System extends EmitterBase<OpenFin.SystemEvent> {
      * @internal
      */
     constructor(wire: Transport);
-    /**
-     * Dispatch an event to the webcontents that created the notification.
-     * Only works for notifications that have been intercepted in the same runtime.
-     */
-    dispatchNotificationAction(notificationId: string, { action }: {
-        action: 'click' | 'close' | 'show';
-    }): Promise<void>;
     private sendExternalProcessRequest;
     /**
      * Returns the version of the runtime. The version contains the major, minor,
@@ -14241,7 +14338,9 @@ declare class System extends EmitterBase<OpenFin.SystemEvent> {
      */
     getEnvironmentVariable(envName: string): Promise<string>;
     /**
-     * Get current focused window.
+     * Get currently focused Window.
+     * If a View currently has focus, returns the identity of View's parent Window.
+     * Use {@link Window._Window#getFocusedContent Window.getFocusedContent} to directly access currently focused Window or View.
      *
      * @example
      * ```js
@@ -14249,6 +14348,17 @@ declare class System extends EmitterBase<OpenFin.SystemEvent> {
      * ```
      */
     getFocusedWindow(): Promise<OpenFin.Identity | null>;
+    /**
+     * Get currently focused content. Returns identity of entity with `entityType`.
+     *
+     * @example
+     * ```js
+     * fin.System.getFocusedContent().then(contentIdentity => console.log(contentIdentity)).catch(err => console.log(err));
+     * ```
+     */
+    getFocusedContent(): Promise<(OpenFin.Identity & {
+        entityType: 'window' | 'view';
+    }) | null>;
     /**
      * Returns information about the given app's certification status
      *
@@ -15502,6 +15612,16 @@ declare class System extends EmitterBase<OpenFin.SystemEvent> {
      * ```
      */
     setDomainSettings(domainSettings: OpenFin.DefaultDomainSettings): Promise<void>;
+    /**
+     * Attempts to install and enable extensions for the security realm.  Users may want to call this function in response
+     * to an `extensions-install-failed` event.  Only extensions allowed by every application on the current security realm
+     * will be installed/enabled.
+     */
+    refreshExtensions(): Promise<string[] | undefined>;
+    /**
+     * Gets the currently-installed
+     */
+    getInstalledExtensions(): Promise<OpenFin.ExtensionInfo[]>;
 }
 
 /**
@@ -15519,7 +15639,6 @@ declare namespace SystemEvents {
         IdleStateChangedEvent,
         IdleEvent,
         MonitorInfoChangedEvent,
-        NotificationCloseRequested,
         MonitorEvent,
         SessionChangedEvent,
         AppVersionEvent,
@@ -15533,6 +15652,14 @@ declare namespace SystemEvents {
         ApplicationCreatedEvent,
         DesktopIconClickedEvent,
         SystemShutdownEvent,
+        ExtensionsEnabledEvent,
+        ExtensionsDisabledEvent,
+        ExtensionsExcludedEvent,
+        ExtensionsInstalledEvent,
+        ExtensionInstalledEvent,
+        ExtensionsInstallFailedEvent,
+        ExtensionInstallFailedEvent,
+        ExtensionsInitializationFailedEvent,
         Event_11 as Event,
         SystemEvent,
         EventType_8 as EventType,
@@ -16453,7 +16580,7 @@ declare class View_2 extends WebContents<OpenFin.ViewEvent> {
      */
     getInfo: () => Promise<OpenFin.ViewInfo>;
     /**
-     * Retrieves the layout for the window the view is attached to.
+     * Retrieves the OpenFin.Layout instance for the Window the View is attached to.
      *
      * @example
      * ```js
@@ -16651,6 +16778,24 @@ declare type ViewContentCreationRule = BaseContentCreationRule & {
     options?: Partial<ViewOptions>;
 };
 
+/**
+ * @interface
+ */
+declare type ViewCreationFailure = {
+    /**
+     * The identity of the created view
+     */
+    identity: Identity_4;
+    /**
+     * Whether the view was created with errors
+     */
+    success: false;
+    /**
+     * Error thrown during view creation
+     */
+    error: Error;
+};
+
 /**
  * The options object required by {@link View.ViewModule.create View.create}.
  *
@@ -16666,6 +16811,25 @@ declare type ViewCreationOptions = Partial<ViewOptions> & {
 
 declare type ViewCreationOrReference = OpenFin.Identity | OpenFin.PlatformViewCreationOptions;
 
+/**
+ * A view creation state
+ */
+declare type ViewCreationResult = ViewCreationSuccess | ViewCreationFailure;
+
+/**
+ * @interface
+ */
+declare type ViewCreationSuccess = {
+    /**
+     * The identity of the created view
+     */
+    identity: Identity_4;
+    /**
+     * Whether the view was created without errors
+     */
+    success: true;
+};
+
 /**
  * Generated when a window has a view detached from it.
  * @remarks Will fire when a view is destroyed in which case `target` will be null.
@@ -16827,6 +16991,9 @@ declare class ViewModule extends Base {
  */
 declare type ViewOptions = ConstViewOptions & MutableViewOptions;
 
+/**
+ * @interface
+ */
 declare type ViewShowAtOptions = {
     /**
      * Sets the view as the top level view. See {@link OpenFin.View.bringToFront} for more information.
@@ -17913,10 +18080,6 @@ declare namespace WebContentsEvents {
         FileDownloadProgressEvent,
         FileDownloadCompletedEvent,
         ContentBlockedEvent,
-        SerializedImage,
-        NotificationAction_2 as NotificationAction,
-        NotificationData,
-        NotificationInterceptedEvent,
         Event_5 as Event,
         WebContentsEvent,
         WillPropagateWebContentsEvent,