@openfin/fdc3-api 40.82.25 → 40.82.27

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

@@ -4745,7 +4745,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;
+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.
@@ -4917,6 +4917,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}.
@@ -9803,6 +9902,7 @@ declare namespace OpenFin {
         RoutingInfo,
         DownloadShelfOptions,
         ViewShowAtOptions,
+        ExtensionInfo,
         ApplicationEvents,
         BaseEvents,
         ExternalApplicationEvents,
@@ -12487,6 +12587,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;
@@ -13175,6 +13283,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']>;
@@ -15066,6 +15189,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[]>;
 }
 
 /**
@@ -15096,6 +15229,14 @@ declare namespace SystemEvents {
         ApplicationCreatedEvent,
         DesktopIconClickedEvent,
         SystemShutdownEvent,
+        ExtensionsEnabledEvent,
+        ExtensionsDisabledEvent,
+        ExtensionsExcludedEvent,
+        ExtensionsInstalledEvent,
+        ExtensionInstalledEvent,
+        ExtensionsInstallFailedEvent,
+        ExtensionInstallFailedEvent,
+        ExtensionsInitializationFailedEvent,
         Event_11 as Event,
         SystemEvent,
         EventType_8 as EventType,
@@ -16383,6 +16524,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.

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

@@ -4745,7 +4745,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;
+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.
@@ -4917,6 +4917,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}.
@@ -9803,6 +9902,7 @@ declare namespace OpenFin {
         RoutingInfo,
         DownloadShelfOptions,
         ViewShowAtOptions,
+        ExtensionInfo,
         ApplicationEvents,
         BaseEvents,
         ExternalApplicationEvents,
@@ -12487,6 +12587,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;
@@ -13175,6 +13283,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']>;
@@ -15066,6 +15189,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[]>;
 }
 
 /**
@@ -15096,6 +15229,14 @@ declare namespace SystemEvents {
         ApplicationCreatedEvent,
         DesktopIconClickedEvent,
         SystemShutdownEvent,
+        ExtensionsEnabledEvent,
+        ExtensionsDisabledEvent,
+        ExtensionsExcludedEvent,
+        ExtensionsInstalledEvent,
+        ExtensionInstalledEvent,
+        ExtensionsInstallFailedEvent,
+        ExtensionInstallFailedEvent,
+        ExtensionsInitializationFailedEvent,
         Event_11 as Event,
         SystemEvent,
         EventType_8 as EventType,
@@ -16383,6 +16524,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.

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

@@ -4745,7 +4745,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;
+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.
@@ -4917,6 +4917,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}.
@@ -9803,6 +9902,7 @@ declare namespace OpenFin {
         RoutingInfo,
         DownloadShelfOptions,
         ViewShowAtOptions,
+        ExtensionInfo,
         ApplicationEvents,
         BaseEvents,
         ExternalApplicationEvents,
@@ -12487,6 +12587,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;
@@ -13175,6 +13283,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']>;
@@ -15066,6 +15189,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[]>;
 }
 
 /**
@@ -15096,6 +15229,14 @@ declare namespace SystemEvents {
         ApplicationCreatedEvent,
         DesktopIconClickedEvent,
         SystemShutdownEvent,
+        ExtensionsEnabledEvent,
+        ExtensionsDisabledEvent,
+        ExtensionsExcludedEvent,
+        ExtensionsInstalledEvent,
+        ExtensionInstalledEvent,
+        ExtensionsInstallFailedEvent,
+        ExtensionInstallFailedEvent,
+        ExtensionsInitializationFailedEvent,
         Event_11 as Event,
         SystemEvent,
         EventType_8 as EventType,
@@ -16383,6 +16524,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.

package/out/fdc3-api.d.ts

@@ -4809,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;
+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.
@@ -4999,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}.
@@ -10121,6 +10220,7 @@ declare namespace OpenFin {
         RoutingInfo,
         DownloadShelfOptions,
         ViewShowAtOptions,
+        ExtensionInfo,
         ApplicationEvents,
         BaseEvents,
         ExternalApplicationEvents,
@@ -12888,6 +12988,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;
@@ -13576,6 +13684,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']>;
@@ -15473,6 +15596,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[]>;
 }
 
 /**
@@ -15503,6 +15636,14 @@ declare namespace SystemEvents {
         ApplicationCreatedEvent,
         DesktopIconClickedEvent,
         SystemShutdownEvent,
+        ExtensionsEnabledEvent,
+        ExtensionsDisabledEvent,
+        ExtensionsExcludedEvent,
+        ExtensionsInstalledEvent,
+        ExtensionInstalledEvent,
+        ExtensionsInstallFailedEvent,
+        ExtensionInstallFailedEvent,
+        ExtensionsInitializationFailedEvent,
         Event_11 as Event,
         SystemEvent,
         EventType_8 as EventType,
@@ -16834,6 +16975,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.

package/package.json

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