@openfin/core 40.82.26 → 40.82.27

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -4748,7 +4748,7 @@ declare type Event_10 = ApplicationEvents.Event | ApiReadyEvent | SnapshotApplie
4748
4748
  * under the {@link OpenFin.SystemEvents} namespace (payloads inherited from propagated events are defined in the namespace
4749
4749
  * from which they propagate).
4750
4750
  */
4751
- declare type Event_11 = ExcludeRequested<WindowEvents.PropagatedEvent<'system'>> | ExcludeRequested<ViewEvents.PropagatedEvent<'system'>> | ExcludeRequested<ApplicationEvents.PropagatedEvent<'system'>> | ApplicationCreatedEvent | DesktopIconClickedEvent | IdleStateChangedEvent | MonitorInfoChangedEvent | SessionChangedEvent | AppVersionEventWithId | SystemShutdownEvent;
4751
+ 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;
4752
4752
 
4753
4753
  /**
4754
4754
  * [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.
@@ -4920,6 +4920,105 @@ declare type ExitCode = {
4920
4920
  exitCode: number;
4921
4921
  };
4922
4922
 
4923
+ declare type ExtensionEvent = SecurityRealmEvent & {
4924
+ /**
4925
+ * Runtime extension whose status has been (possibly) modified
4926
+ */
4927
+ extension: string;
4928
+ };
4929
+
4930
+ /**
4931
+ * @interface
4932
+ */
4933
+ declare type ExtensionInfo = {
4934
+ extensionId: string;
4935
+ name: string;
4936
+ enabled: boolean;
4937
+ };
4938
+
4939
+ /**
4940
+ * An event that fires when an extension is installed in the security realm.
4941
+ *
4942
+ * @interface
4943
+ */
4944
+ declare type ExtensionInstalledEvent = ExtensionEvent & {
4945
+ type: 'extension-installed';
4946
+ };
4947
+
4948
+ /**
4949
+ * An event that fires when an extension fails to install in the security realm.
4950
+ *
4951
+ * @interface
4952
+ */
4953
+ declare type ExtensionInstallFailedEvent = ExtensionEvent & {
4954
+ type: 'extension-install-failed';
4955
+ };
4956
+
4957
+ /**
4958
+ * An event that fires when extensions are disabled in the security realm.
4959
+ *
4960
+ * @interface
4961
+ */
4962
+ declare type ExtensionsDisabledEvent = ExtensionsEvent & {
4963
+ type: 'extensions-disabled';
4964
+ };
4965
+
4966
+ /**
4967
+ * An event that fires when extensions are enabled in the security realm.
4968
+ *
4969
+ * @interface
4970
+ */
4971
+ declare type ExtensionsEnabledEvent = ExtensionsEvent & {
4972
+ type: 'extensions-enabled';
4973
+ };
4974
+
4975
+ declare type ExtensionsEvent = SecurityRealmEvent & {
4976
+ /**
4977
+ * Runtime extensions whose status has been (possibly) modified
4978
+ */
4979
+ extensions: string[];
4980
+ };
4981
+
4982
+ /**
4983
+ * An event that fires when requested extensions are not allowed to be installed in the security realm.
4984
+ *
4985
+ * @interface
4986
+ */
4987
+ declare type ExtensionsExcludedEvent = ExtensionsEvent & {
4988
+ type: 'extensions-excluded';
4989
+ };
4990
+
4991
+ /**
4992
+ * An event that fires when extension initialization fails on initial app launch. Users may attempt to
4993
+ * re-initialize extensions by calling {@link System.refreshExtensions}. This event will not fire in response
4994
+ * to manual extension refreshes (users should catch the error normally).
4995
+ */
4996
+ declare type ExtensionsInitializationFailedEvent = Omit<ExtensionsEvent, 'extensions'> & {
4997
+ type: 'extensions-initialization-failed';
4998
+ /**
4999
+ * The error that caused the extension initialization failure
5000
+ */
5001
+ error: Error;
5002
+ };
5003
+
5004
+ /**
5005
+ * An event that fires when extensions are installed in the security realm.
5006
+ *
5007
+ * @interface
5008
+ */
5009
+ declare type ExtensionsInstalledEvent = ExtensionsEvent & {
5010
+ type: 'extensions-installed';
5011
+ };
5012
+
5013
+ /**
5014
+ * An event that fires when extensions fail to install in the security realm.
5015
+ *
5016
+ * @interface
5017
+ */
5018
+ declare type ExtensionsInstallFailedEvent = ExtensionsEvent & {
5019
+ type: 'extensions-install-failed';
5020
+ };
5021
+
4923
5022
  /**
4924
5023
  * An ExternalApplication object representing native language adapter connections to the runtime. Allows
4925
5024
  * the developer to listen to {@link OpenFin.ExternalApplicationEvents external application events}.
@@ -9461,6 +9560,7 @@ declare namespace OpenFin_2 {
9461
9560
  RoutingInfo,
9462
9561
  DownloadShelfOptions,
9463
9562
  ViewShowAtOptions,
9563
+ ExtensionInfo,
9464
9564
  ApplicationEvents,
9465
9565
  BaseEvents,
9466
9566
  ExternalApplicationEvents,
@@ -12147,6 +12247,14 @@ declare interface ProtocolMap extends ProtocolMapBase {
12147
12247
  }, void>;
12148
12248
  'system-register-shutdown-handler': VoidCall;
12149
12249
  'get-permissions': GetterCall<any>;
12250
+ 'refresh-extensions': {
12251
+ request: void;
12252
+ response: string[] | undefined;
12253
+ };
12254
+ 'get-installed-extensions': {
12255
+ request: void;
12256
+ response: OpenFin_2.ExtensionInfo[];
12257
+ };
12150
12258
  'fdc3-add-context-listener': VoidCall;
12151
12259
  'fdc3-add-intent-listener': VoidCall;
12152
12260
  'fdc3-raise-intent': VoidCall;
@@ -12835,6 +12943,21 @@ declare type ScreenshotPrintOptions = {
12835
12943
  content: 'screenshot';
12836
12944
  };
12837
12945
 
12946
+ /**
12947
+ * An event generated when an application modifies the runtime in a way that affects all other applications in the
12948
+ * application runtime/security realm.
12949
+ */
12950
+ declare type SecurityRealmEvent = BaseEvent_9 & {
12951
+ /**
12952
+ * Config URL of the application that modified the security realm's extensions
12953
+ */
12954
+ configUrl: string;
12955
+ /**
12956
+ * Identity of the application that modified the security realm's extensions
12957
+ */
12958
+ applicationIdentity: OpenFin_2.ApplicationIdentity;
12959
+ };
12960
+
12838
12961
  declare type SendActionResponse<T extends keyof ProtocolMap> = Message<{
12839
12962
  data: ProtocolMap[T]['response'];
12840
12963
  } & ProtocolMap[T]['specialResponse']>;
@@ -14726,6 +14849,16 @@ declare class System extends EmitterBase<OpenFin_2.SystemEvent> {
14726
14849
  * ```
14727
14850
  */
14728
14851
  setDomainSettings(domainSettings: OpenFin_2.DefaultDomainSettings): Promise<void>;
14852
+ /**
14853
+ * Attempts to install and enable extensions for the security realm. Users may want to call this function in response
14854
+ * to an `extensions-install-failed` event. Only extensions allowed by every application on the current security realm
14855
+ * will be installed/enabled.
14856
+ */
14857
+ refreshExtensions(): Promise<string[] | undefined>;
14858
+ /**
14859
+ * Gets the currently-installed
14860
+ */
14861
+ getInstalledExtensions(): Promise<OpenFin_2.ExtensionInfo[]>;
14729
14862
  }
14730
14863
 
14731
14864
  /**
@@ -14756,6 +14889,14 @@ declare namespace SystemEvents {
14756
14889
  ApplicationCreatedEvent,
14757
14890
  DesktopIconClickedEvent,
14758
14891
  SystemShutdownEvent,
14892
+ ExtensionsEnabledEvent,
14893
+ ExtensionsDisabledEvent,
14894
+ ExtensionsExcludedEvent,
14895
+ ExtensionsInstalledEvent,
14896
+ ExtensionInstalledEvent,
14897
+ ExtensionsInstallFailedEvent,
14898
+ ExtensionInstallFailedEvent,
14899
+ ExtensionsInitializationFailedEvent,
14759
14900
  Event_11 as Event,
14760
14901
  SystemEvent,
14761
14902
  EventType_8 as EventType,
@@ -15937,6 +16078,9 @@ declare class ViewModule extends Base {
15937
16078
  */
15938
16079
  declare type ViewOptions = ConstViewOptions & MutableViewOptions;
15939
16080
 
16081
+ /**
16082
+ * @interface
16083
+ */
15940
16084
  declare type ViewShowAtOptions = {
15941
16085
  /**
15942
16086
  * Sets the view as the top level view. See {@link OpenFin.View.bringToFront} for more information.
@@ -4748,7 +4748,7 @@ declare type Event_10 = ApplicationEvents.Event | ApiReadyEvent | SnapshotApplie
4748
4748
  * under the {@link OpenFin.SystemEvents} namespace (payloads inherited from propagated events are defined in the namespace
4749
4749
  * from which they propagate).
4750
4750
  */
4751
- declare type Event_11 = ExcludeRequested<WindowEvents.PropagatedEvent<'system'>> | ExcludeRequested<ViewEvents.PropagatedEvent<'system'>> | ExcludeRequested<ApplicationEvents.PropagatedEvent<'system'>> | ApplicationCreatedEvent | DesktopIconClickedEvent | IdleStateChangedEvent | MonitorInfoChangedEvent | SessionChangedEvent | AppVersionEventWithId | SystemShutdownEvent;
4751
+ 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;
4752
4752
 
4753
4753
  /**
4754
4754
  * [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.
@@ -4920,6 +4920,105 @@ declare type ExitCode = {
4920
4920
  exitCode: number;
4921
4921
  };
4922
4922
 
4923
+ declare type ExtensionEvent = SecurityRealmEvent & {
4924
+ /**
4925
+ * Runtime extension whose status has been (possibly) modified
4926
+ */
4927
+ extension: string;
4928
+ };
4929
+
4930
+ /**
4931
+ * @interface
4932
+ */
4933
+ declare type ExtensionInfo = {
4934
+ extensionId: string;
4935
+ name: string;
4936
+ enabled: boolean;
4937
+ };
4938
+
4939
+ /**
4940
+ * An event that fires when an extension is installed in the security realm.
4941
+ *
4942
+ * @interface
4943
+ */
4944
+ declare type ExtensionInstalledEvent = ExtensionEvent & {
4945
+ type: 'extension-installed';
4946
+ };
4947
+
4948
+ /**
4949
+ * An event that fires when an extension fails to install in the security realm.
4950
+ *
4951
+ * @interface
4952
+ */
4953
+ declare type ExtensionInstallFailedEvent = ExtensionEvent & {
4954
+ type: 'extension-install-failed';
4955
+ };
4956
+
4957
+ /**
4958
+ * An event that fires when extensions are disabled in the security realm.
4959
+ *
4960
+ * @interface
4961
+ */
4962
+ declare type ExtensionsDisabledEvent = ExtensionsEvent & {
4963
+ type: 'extensions-disabled';
4964
+ };
4965
+
4966
+ /**
4967
+ * An event that fires when extensions are enabled in the security realm.
4968
+ *
4969
+ * @interface
4970
+ */
4971
+ declare type ExtensionsEnabledEvent = ExtensionsEvent & {
4972
+ type: 'extensions-enabled';
4973
+ };
4974
+
4975
+ declare type ExtensionsEvent = SecurityRealmEvent & {
4976
+ /**
4977
+ * Runtime extensions whose status has been (possibly) modified
4978
+ */
4979
+ extensions: string[];
4980
+ };
4981
+
4982
+ /**
4983
+ * An event that fires when requested extensions are not allowed to be installed in the security realm.
4984
+ *
4985
+ * @interface
4986
+ */
4987
+ declare type ExtensionsExcludedEvent = ExtensionsEvent & {
4988
+ type: 'extensions-excluded';
4989
+ };
4990
+
4991
+ /**
4992
+ * An event that fires when extension initialization fails on initial app launch. Users may attempt to
4993
+ * re-initialize extensions by calling {@link System.refreshExtensions}. This event will not fire in response
4994
+ * to manual extension refreshes (users should catch the error normally).
4995
+ */
4996
+ declare type ExtensionsInitializationFailedEvent = Omit<ExtensionsEvent, 'extensions'> & {
4997
+ type: 'extensions-initialization-failed';
4998
+ /**
4999
+ * The error that caused the extension initialization failure
5000
+ */
5001
+ error: Error;
5002
+ };
5003
+
5004
+ /**
5005
+ * An event that fires when extensions are installed in the security realm.
5006
+ *
5007
+ * @interface
5008
+ */
5009
+ declare type ExtensionsInstalledEvent = ExtensionsEvent & {
5010
+ type: 'extensions-installed';
5011
+ };
5012
+
5013
+ /**
5014
+ * An event that fires when extensions fail to install in the security realm.
5015
+ *
5016
+ * @interface
5017
+ */
5018
+ declare type ExtensionsInstallFailedEvent = ExtensionsEvent & {
5019
+ type: 'extensions-install-failed';
5020
+ };
5021
+
4923
5022
  /**
4924
5023
  * An ExternalApplication object representing native language adapter connections to the runtime. Allows
4925
5024
  * the developer to listen to {@link OpenFin.ExternalApplicationEvents external application events}.
@@ -9461,6 +9560,7 @@ declare namespace OpenFin_2 {
9461
9560
  RoutingInfo,
9462
9561
  DownloadShelfOptions,
9463
9562
  ViewShowAtOptions,
9563
+ ExtensionInfo,
9464
9564
  ApplicationEvents,
9465
9565
  BaseEvents,
9466
9566
  ExternalApplicationEvents,
@@ -12147,6 +12247,14 @@ declare interface ProtocolMap extends ProtocolMapBase {
12147
12247
  }, void>;
12148
12248
  'system-register-shutdown-handler': VoidCall;
12149
12249
  'get-permissions': GetterCall<any>;
12250
+ 'refresh-extensions': {
12251
+ request: void;
12252
+ response: string[] | undefined;
12253
+ };
12254
+ 'get-installed-extensions': {
12255
+ request: void;
12256
+ response: OpenFin_2.ExtensionInfo[];
12257
+ };
12150
12258
  'fdc3-add-context-listener': VoidCall;
12151
12259
  'fdc3-add-intent-listener': VoidCall;
12152
12260
  'fdc3-raise-intent': VoidCall;
@@ -12835,6 +12943,21 @@ declare type ScreenshotPrintOptions = {
12835
12943
  content: 'screenshot';
12836
12944
  };
12837
12945
 
12946
+ /**
12947
+ * An event generated when an application modifies the runtime in a way that affects all other applications in the
12948
+ * application runtime/security realm.
12949
+ */
12950
+ declare type SecurityRealmEvent = BaseEvent_9 & {
12951
+ /**
12952
+ * Config URL of the application that modified the security realm's extensions
12953
+ */
12954
+ configUrl: string;
12955
+ /**
12956
+ * Identity of the application that modified the security realm's extensions
12957
+ */
12958
+ applicationIdentity: OpenFin_2.ApplicationIdentity;
12959
+ };
12960
+
12838
12961
  declare type SendActionResponse<T extends keyof ProtocolMap> = Message<{
12839
12962
  data: ProtocolMap[T]['response'];
12840
12963
  } & ProtocolMap[T]['specialResponse']>;
@@ -14726,6 +14849,16 @@ declare class System extends EmitterBase<OpenFin_2.SystemEvent> {
14726
14849
  * ```
14727
14850
  */
14728
14851
  setDomainSettings(domainSettings: OpenFin_2.DefaultDomainSettings): Promise<void>;
14852
+ /**
14853
+ * Attempts to install and enable extensions for the security realm. Users may want to call this function in response
14854
+ * to an `extensions-install-failed` event. Only extensions allowed by every application on the current security realm
14855
+ * will be installed/enabled.
14856
+ */
14857
+ refreshExtensions(): Promise<string[] | undefined>;
14858
+ /**
14859
+ * Gets the currently-installed
14860
+ */
14861
+ getInstalledExtensions(): Promise<OpenFin_2.ExtensionInfo[]>;
14729
14862
  }
14730
14863
 
14731
14864
  /**
@@ -14756,6 +14889,14 @@ declare namespace SystemEvents {
14756
14889
  ApplicationCreatedEvent,
14757
14890
  DesktopIconClickedEvent,
14758
14891
  SystemShutdownEvent,
14892
+ ExtensionsEnabledEvent,
14893
+ ExtensionsDisabledEvent,
14894
+ ExtensionsExcludedEvent,
14895
+ ExtensionsInstalledEvent,
14896
+ ExtensionInstalledEvent,
14897
+ ExtensionsInstallFailedEvent,
14898
+ ExtensionInstallFailedEvent,
14899
+ ExtensionsInitializationFailedEvent,
14759
14900
  Event_11 as Event,
14760
14901
  SystemEvent,
14761
14902
  EventType_8 as EventType,
@@ -15937,6 +16078,9 @@ declare class ViewModule extends Base {
15937
16078
  */
15938
16079
  declare type ViewOptions = ConstViewOptions & MutableViewOptions;
15939
16080
 
16081
+ /**
16082
+ * @interface
16083
+ */
15940
16084
  declare type ViewShowAtOptions = {
15941
16085
  /**
15942
16086
  * Sets the view as the top level view. See {@link OpenFin.View.bringToFront} for more information.
@@ -4748,7 +4748,7 @@ declare type Event_10 = ApplicationEvents.Event | ApiReadyEvent | SnapshotApplie
4748
4748
  * under the {@link OpenFin.SystemEvents} namespace (payloads inherited from propagated events are defined in the namespace
4749
4749
  * from which they propagate).
4750
4750
  */
4751
- declare type Event_11 = ExcludeRequested<WindowEvents.PropagatedEvent<'system'>> | ExcludeRequested<ViewEvents.PropagatedEvent<'system'>> | ExcludeRequested<ApplicationEvents.PropagatedEvent<'system'>> | ApplicationCreatedEvent | DesktopIconClickedEvent | IdleStateChangedEvent | MonitorInfoChangedEvent | SessionChangedEvent | AppVersionEventWithId | SystemShutdownEvent;
4751
+ 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;
4752
4752
 
4753
4753
  /**
4754
4754
  * [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.
@@ -4920,6 +4920,105 @@ declare type ExitCode = {
4920
4920
  exitCode: number;
4921
4921
  };
4922
4922
 
4923
+ declare type ExtensionEvent = SecurityRealmEvent & {
4924
+ /**
4925
+ * Runtime extension whose status has been (possibly) modified
4926
+ */
4927
+ extension: string;
4928
+ };
4929
+
4930
+ /**
4931
+ * @interface
4932
+ */
4933
+ declare type ExtensionInfo = {
4934
+ extensionId: string;
4935
+ name: string;
4936
+ enabled: boolean;
4937
+ };
4938
+
4939
+ /**
4940
+ * An event that fires when an extension is installed in the security realm.
4941
+ *
4942
+ * @interface
4943
+ */
4944
+ declare type ExtensionInstalledEvent = ExtensionEvent & {
4945
+ type: 'extension-installed';
4946
+ };
4947
+
4948
+ /**
4949
+ * An event that fires when an extension fails to install in the security realm.
4950
+ *
4951
+ * @interface
4952
+ */
4953
+ declare type ExtensionInstallFailedEvent = ExtensionEvent & {
4954
+ type: 'extension-install-failed';
4955
+ };
4956
+
4957
+ /**
4958
+ * An event that fires when extensions are disabled in the security realm.
4959
+ *
4960
+ * @interface
4961
+ */
4962
+ declare type ExtensionsDisabledEvent = ExtensionsEvent & {
4963
+ type: 'extensions-disabled';
4964
+ };
4965
+
4966
+ /**
4967
+ * An event that fires when extensions are enabled in the security realm.
4968
+ *
4969
+ * @interface
4970
+ */
4971
+ declare type ExtensionsEnabledEvent = ExtensionsEvent & {
4972
+ type: 'extensions-enabled';
4973
+ };
4974
+
4975
+ declare type ExtensionsEvent = SecurityRealmEvent & {
4976
+ /**
4977
+ * Runtime extensions whose status has been (possibly) modified
4978
+ */
4979
+ extensions: string[];
4980
+ };
4981
+
4982
+ /**
4983
+ * An event that fires when requested extensions are not allowed to be installed in the security realm.
4984
+ *
4985
+ * @interface
4986
+ */
4987
+ declare type ExtensionsExcludedEvent = ExtensionsEvent & {
4988
+ type: 'extensions-excluded';
4989
+ };
4990
+
4991
+ /**
4992
+ * An event that fires when extension initialization fails on initial app launch. Users may attempt to
4993
+ * re-initialize extensions by calling {@link System.refreshExtensions}. This event will not fire in response
4994
+ * to manual extension refreshes (users should catch the error normally).
4995
+ */
4996
+ declare type ExtensionsInitializationFailedEvent = Omit<ExtensionsEvent, 'extensions'> & {
4997
+ type: 'extensions-initialization-failed';
4998
+ /**
4999
+ * The error that caused the extension initialization failure
5000
+ */
5001
+ error: Error;
5002
+ };
5003
+
5004
+ /**
5005
+ * An event that fires when extensions are installed in the security realm.
5006
+ *
5007
+ * @interface
5008
+ */
5009
+ declare type ExtensionsInstalledEvent = ExtensionsEvent & {
5010
+ type: 'extensions-installed';
5011
+ };
5012
+
5013
+ /**
5014
+ * An event that fires when extensions fail to install in the security realm.
5015
+ *
5016
+ * @interface
5017
+ */
5018
+ declare type ExtensionsInstallFailedEvent = ExtensionsEvent & {
5019
+ type: 'extensions-install-failed';
5020
+ };
5021
+
4923
5022
  /**
4924
5023
  * An ExternalApplication object representing native language adapter connections to the runtime. Allows
4925
5024
  * the developer to listen to {@link OpenFin.ExternalApplicationEvents external application events}.
@@ -9461,6 +9560,7 @@ declare namespace OpenFin_2 {
9461
9560
  RoutingInfo,
9462
9561
  DownloadShelfOptions,
9463
9562
  ViewShowAtOptions,
9563
+ ExtensionInfo,
9464
9564
  ApplicationEvents,
9465
9565
  BaseEvents,
9466
9566
  ExternalApplicationEvents,
@@ -12147,6 +12247,14 @@ declare interface ProtocolMap extends ProtocolMapBase {
12147
12247
  }, void>;
12148
12248
  'system-register-shutdown-handler': VoidCall;
12149
12249
  'get-permissions': GetterCall<any>;
12250
+ 'refresh-extensions': {
12251
+ request: void;
12252
+ response: string[] | undefined;
12253
+ };
12254
+ 'get-installed-extensions': {
12255
+ request: void;
12256
+ response: OpenFin_2.ExtensionInfo[];
12257
+ };
12150
12258
  'fdc3-add-context-listener': VoidCall;
12151
12259
  'fdc3-add-intent-listener': VoidCall;
12152
12260
  'fdc3-raise-intent': VoidCall;
@@ -12835,6 +12943,21 @@ declare type ScreenshotPrintOptions = {
12835
12943
  content: 'screenshot';
12836
12944
  };
12837
12945
 
12946
+ /**
12947
+ * An event generated when an application modifies the runtime in a way that affects all other applications in the
12948
+ * application runtime/security realm.
12949
+ */
12950
+ declare type SecurityRealmEvent = BaseEvent_9 & {
12951
+ /**
12952
+ * Config URL of the application that modified the security realm's extensions
12953
+ */
12954
+ configUrl: string;
12955
+ /**
12956
+ * Identity of the application that modified the security realm's extensions
12957
+ */
12958
+ applicationIdentity: OpenFin_2.ApplicationIdentity;
12959
+ };
12960
+
12838
12961
  declare type SendActionResponse<T extends keyof ProtocolMap> = Message<{
12839
12962
  data: ProtocolMap[T]['response'];
12840
12963
  } & ProtocolMap[T]['specialResponse']>;
@@ -14726,6 +14849,16 @@ declare class System extends EmitterBase<OpenFin_2.SystemEvent> {
14726
14849
  * ```
14727
14850
  */
14728
14851
  setDomainSettings(domainSettings: OpenFin_2.DefaultDomainSettings): Promise<void>;
14852
+ /**
14853
+ * Attempts to install and enable extensions for the security realm. Users may want to call this function in response
14854
+ * to an `extensions-install-failed` event. Only extensions allowed by every application on the current security realm
14855
+ * will be installed/enabled.
14856
+ */
14857
+ refreshExtensions(): Promise<string[] | undefined>;
14858
+ /**
14859
+ * Gets the currently-installed
14860
+ */
14861
+ getInstalledExtensions(): Promise<OpenFin_2.ExtensionInfo[]>;
14729
14862
  }
14730
14863
 
14731
14864
  /**
@@ -14756,6 +14889,14 @@ declare namespace SystemEvents {
14756
14889
  ApplicationCreatedEvent,
14757
14890
  DesktopIconClickedEvent,
14758
14891
  SystemShutdownEvent,
14892
+ ExtensionsEnabledEvent,
14893
+ ExtensionsDisabledEvent,
14894
+ ExtensionsExcludedEvent,
14895
+ ExtensionsInstalledEvent,
14896
+ ExtensionInstalledEvent,
14897
+ ExtensionsInstallFailedEvent,
14898
+ ExtensionInstallFailedEvent,
14899
+ ExtensionsInitializationFailedEvent,
14759
14900
  Event_11 as Event,
14760
14901
  SystemEvent,
14761
14902
  EventType_8 as EventType,
@@ -15937,6 +16078,9 @@ declare class ViewModule extends Base {
15937
16078
  */
15938
16079
  declare type ViewOptions = ConstViewOptions & MutableViewOptions;
15939
16080
 
16081
+ /**
16082
+ * @interface
16083
+ */
15940
16084
  declare type ViewShowAtOptions = {
15941
16085
  /**
15942
16086
  * Sets the view as the top level view. See {@link OpenFin.View.bringToFront} for more information.
package/out/mock.d.ts CHANGED
@@ -4812,7 +4812,7 @@ declare type Event_10 = ApplicationEvents.Event | ApiReadyEvent | SnapshotApplie
4812
4812
  * under the {@link OpenFin.SystemEvents} namespace (payloads inherited from propagated events are defined in the namespace
4813
4813
  * from which they propagate).
4814
4814
  */
4815
- declare type Event_11 = ExcludeRequested<WindowEvents.PropagatedEvent<'system'>> | ExcludeRequested<ViewEvents.PropagatedEvent<'system'>> | ExcludeRequested<ApplicationEvents.PropagatedEvent<'system'>> | ApplicationCreatedEvent | DesktopIconClickedEvent | IdleStateChangedEvent | MonitorInfoChangedEvent | SessionChangedEvent | AppVersionEventWithId | SystemShutdownEvent;
4815
+ 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;
4816
4816
 
4817
4817
  /**
4818
4818
  * [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.
@@ -5002,6 +5002,105 @@ declare type ExitCode = {
5002
5002
  exitCode: number;
5003
5003
  };
5004
5004
 
5005
+ declare type ExtensionEvent = SecurityRealmEvent & {
5006
+ /**
5007
+ * Runtime extension whose status has been (possibly) modified
5008
+ */
5009
+ extension: string;
5010
+ };
5011
+
5012
+ /**
5013
+ * @interface
5014
+ */
5015
+ declare type ExtensionInfo = {
5016
+ extensionId: string;
5017
+ name: string;
5018
+ enabled: boolean;
5019
+ };
5020
+
5021
+ /**
5022
+ * An event that fires when an extension is installed in the security realm.
5023
+ *
5024
+ * @interface
5025
+ */
5026
+ declare type ExtensionInstalledEvent = ExtensionEvent & {
5027
+ type: 'extension-installed';
5028
+ };
5029
+
5030
+ /**
5031
+ * An event that fires when an extension fails to install in the security realm.
5032
+ *
5033
+ * @interface
5034
+ */
5035
+ declare type ExtensionInstallFailedEvent = ExtensionEvent & {
5036
+ type: 'extension-install-failed';
5037
+ };
5038
+
5039
+ /**
5040
+ * An event that fires when extensions are disabled in the security realm.
5041
+ *
5042
+ * @interface
5043
+ */
5044
+ declare type ExtensionsDisabledEvent = ExtensionsEvent & {
5045
+ type: 'extensions-disabled';
5046
+ };
5047
+
5048
+ /**
5049
+ * An event that fires when extensions are enabled in the security realm.
5050
+ *
5051
+ * @interface
5052
+ */
5053
+ declare type ExtensionsEnabledEvent = ExtensionsEvent & {
5054
+ type: 'extensions-enabled';
5055
+ };
5056
+
5057
+ declare type ExtensionsEvent = SecurityRealmEvent & {
5058
+ /**
5059
+ * Runtime extensions whose status has been (possibly) modified
5060
+ */
5061
+ extensions: string[];
5062
+ };
5063
+
5064
+ /**
5065
+ * An event that fires when requested extensions are not allowed to be installed in the security realm.
5066
+ *
5067
+ * @interface
5068
+ */
5069
+ declare type ExtensionsExcludedEvent = ExtensionsEvent & {
5070
+ type: 'extensions-excluded';
5071
+ };
5072
+
5073
+ /**
5074
+ * An event that fires when extension initialization fails on initial app launch. Users may attempt to
5075
+ * re-initialize extensions by calling {@link System.refreshExtensions}. This event will not fire in response
5076
+ * to manual extension refreshes (users should catch the error normally).
5077
+ */
5078
+ declare type ExtensionsInitializationFailedEvent = Omit<ExtensionsEvent, 'extensions'> & {
5079
+ type: 'extensions-initialization-failed';
5080
+ /**
5081
+ * The error that caused the extension initialization failure
5082
+ */
5083
+ error: Error;
5084
+ };
5085
+
5086
+ /**
5087
+ * An event that fires when extensions are installed in the security realm.
5088
+ *
5089
+ * @interface
5090
+ */
5091
+ declare type ExtensionsInstalledEvent = ExtensionsEvent & {
5092
+ type: 'extensions-installed';
5093
+ };
5094
+
5095
+ /**
5096
+ * An event that fires when extensions fail to install in the security realm.
5097
+ *
5098
+ * @interface
5099
+ */
5100
+ declare type ExtensionsInstallFailedEvent = ExtensionsEvent & {
5101
+ type: 'extensions-install-failed';
5102
+ };
5103
+
5005
5104
  /**
5006
5105
  * An ExternalApplication object representing native language adapter connections to the runtime. Allows
5007
5106
  * the developer to listen to {@link OpenFin.ExternalApplicationEvents external application events}.
@@ -9779,6 +9878,7 @@ declare namespace OpenFin_2 {
9779
9878
  RoutingInfo,
9780
9879
  DownloadShelfOptions,
9781
9880
  ViewShowAtOptions,
9881
+ ExtensionInfo,
9782
9882
  ApplicationEvents,
9783
9883
  BaseEvents,
9784
9884
  ExternalApplicationEvents,
@@ -12548,6 +12648,14 @@ declare interface ProtocolMap extends ProtocolMapBase {
12548
12648
  }, void>;
12549
12649
  'system-register-shutdown-handler': VoidCall;
12550
12650
  'get-permissions': GetterCall<any>;
12651
+ 'refresh-extensions': {
12652
+ request: void;
12653
+ response: string[] | undefined;
12654
+ };
12655
+ 'get-installed-extensions': {
12656
+ request: void;
12657
+ response: OpenFin_2.ExtensionInfo[];
12658
+ };
12551
12659
  'fdc3-add-context-listener': VoidCall;
12552
12660
  'fdc3-add-intent-listener': VoidCall;
12553
12661
  'fdc3-raise-intent': VoidCall;
@@ -13236,6 +13344,21 @@ declare type ScreenshotPrintOptions = {
13236
13344
  content: 'screenshot';
13237
13345
  };
13238
13346
 
13347
+ /**
13348
+ * An event generated when an application modifies the runtime in a way that affects all other applications in the
13349
+ * application runtime/security realm.
13350
+ */
13351
+ declare type SecurityRealmEvent = BaseEvent_9 & {
13352
+ /**
13353
+ * Config URL of the application that modified the security realm's extensions
13354
+ */
13355
+ configUrl: string;
13356
+ /**
13357
+ * Identity of the application that modified the security realm's extensions
13358
+ */
13359
+ applicationIdentity: OpenFin_2.ApplicationIdentity;
13360
+ };
13361
+
13239
13362
  declare type SendActionResponse<T extends keyof ProtocolMap> = Message<{
13240
13363
  data: ProtocolMap[T]['response'];
13241
13364
  } & ProtocolMap[T]['specialResponse']>;
@@ -15133,6 +15256,16 @@ declare class System extends EmitterBase<OpenFin_2.SystemEvent> {
15133
15256
  * ```
15134
15257
  */
15135
15258
  setDomainSettings(domainSettings: OpenFin_2.DefaultDomainSettings): Promise<void>;
15259
+ /**
15260
+ * Attempts to install and enable extensions for the security realm. Users may want to call this function in response
15261
+ * to an `extensions-install-failed` event. Only extensions allowed by every application on the current security realm
15262
+ * will be installed/enabled.
15263
+ */
15264
+ refreshExtensions(): Promise<string[] | undefined>;
15265
+ /**
15266
+ * Gets the currently-installed
15267
+ */
15268
+ getInstalledExtensions(): Promise<OpenFin_2.ExtensionInfo[]>;
15136
15269
  }
15137
15270
 
15138
15271
  /**
@@ -15163,6 +15296,14 @@ declare namespace SystemEvents {
15163
15296
  ApplicationCreatedEvent,
15164
15297
  DesktopIconClickedEvent,
15165
15298
  SystemShutdownEvent,
15299
+ ExtensionsEnabledEvent,
15300
+ ExtensionsDisabledEvent,
15301
+ ExtensionsExcludedEvent,
15302
+ ExtensionsInstalledEvent,
15303
+ ExtensionInstalledEvent,
15304
+ ExtensionsInstallFailedEvent,
15305
+ ExtensionInstallFailedEvent,
15306
+ ExtensionsInitializationFailedEvent,
15166
15307
  Event_11 as Event,
15167
15308
  SystemEvent,
15168
15309
  EventType_8 as EventType,
@@ -16388,6 +16529,9 @@ declare class ViewModule extends Base {
16388
16529
  */
16389
16530
  declare type ViewOptions = ConstViewOptions & MutableViewOptions;
16390
16531
 
16532
+ /**
16533
+ * @interface
16534
+ */
16391
16535
  declare type ViewShowAtOptions = {
16392
16536
  /**
16393
16537
  * Sets the view as the top level view. See {@link OpenFin.View.bringToFront} for more information.
package/out/mock.js CHANGED
@@ -7198,6 +7198,22 @@ class System extends base_1$i.EmitterBase {
7198
7198
  async setDomainSettings(domainSettings) {
7199
7199
  await this.wire.sendAction('set-domain-settings', { domainSettings, ...this.identity });
7200
7200
  }
7201
+ /**
7202
+ * Attempts to install and enable extensions for the security realm. Users may want to call this function in response
7203
+ * to an `extensions-install-failed` event. Only extensions allowed by every application on the current security realm
7204
+ * will be installed/enabled.
7205
+ */
7206
+ async refreshExtensions() {
7207
+ const { payload } = await this.wire.sendAction('refresh-extensions');
7208
+ return payload.data;
7209
+ }
7210
+ /**
7211
+ * Gets the currently-installed
7212
+ */
7213
+ async getInstalledExtensions() {
7214
+ const { payload } = await this.wire.sendAction('get-installed-extensions');
7215
+ return payload.data;
7216
+ }
7201
7217
  }
7202
7218
  system.System = System;
7203
7219
 
@@ -12584,6 +12600,10 @@ class LayoutModule extends base_1$4.Base {
12584
12600
  if (!allowedErrors.some((m) => e.message.includes(m))) {
12585
12601
  throw e;
12586
12602
  }
12603
+ // If a view is attached to provider window, return null
12604
+ if (layoutWindowIdentity.uuid === layoutWindowIdentity.name) {
12605
+ throw new Error(`View identity ${JSON.stringify(viewIdentity)} is not attached to any layout in provider window ${JSON.stringify(layoutWindowIdentity)}.`);
12606
+ }
12587
12607
  // fallback logic for missing endpoint in older runtimes
12588
12608
  return this.wrapSync(layoutWindowIdentity);
12589
12609
  }
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@openfin/core",
3
- "version": "40.82.26",
3
+ "version": "40.82.27",
4
4
  "description": "The core renderer entry point of OpenFin",
5
5
  "license": "SEE LICENSE IN LICENSE.md",
6
6
  "main": "out/mock.js",