@openfin/core 40.82.26 → 40.82.28

Sign up to get free protection for your applications and to get access to all the features.
@@ -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.28",
4
4
  "description": "The core renderer entry point of OpenFin",
5
5
  "license": "SEE LICENSE IN LICENSE.md",
6
6
  "main": "out/mock.js",