@openfin/fdc3-api 39.83.5 → 39.83.7

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.
@@ -2937,6 +2937,18 @@ declare type ChildWindowCreatedEvent = ContentCreationRulesEvent & {
2937
2937
  childOptions: OpenFin.WindowOptions;
2938
2938
  };
2939
2939
 
2940
+ /**
2941
+ * Control behavior for Chromium policies
2942
+ *
2943
+ * @interface
2944
+ */
2945
+ declare type ChromiumPolicies = {
2946
+ /**
2947
+ * Disable AutofillAddressEnabled policy for a Window or View.
2948
+ */
2949
+ AutofillAddressEnabled?: PolicyOptions;
2950
+ };
2951
+
2940
2952
  declare interface ClassicProtocolOffer extends ProtocolPacketBase {
2941
2953
  type: 'classic';
2942
2954
  }
@@ -3448,6 +3460,10 @@ declare type ConstViewOptions = {
3448
3460
  */
3449
3461
  enabled: boolean;
3450
3462
  };
3463
+ /**
3464
+ * Control which options to ignore when creating a Platform View.
3465
+ */
3466
+ excludeOptions: ExcludeOptions;
3451
3467
  };
3452
3468
 
3453
3469
  /**
@@ -3692,6 +3708,10 @@ declare type ConstWindowOptions = {
3692
3708
  * Controls whether an option is inherited from the parent application. The option is set as part of the window options for the parent application in either the {@link Manifest.startup_app} or {@link Manifest.platform} properties in the manifest or in {@link ApplicationOptions.mainWindowOptions} when calling {@link Application.ApplicationModule.start Application.start}. Use { [option]: false } to disable a specific [option]. All inheritable properties will be inherited by default if omitted.
3693
3709
  */
3694
3710
  inheritance?: Partial<InheritableOptions>;
3711
+ /**
3712
+ * Control which options to ignore when creating a Platform Window.
3713
+ */
3714
+ excludeOptions: ExcludeOptions;
3695
3715
  };
3696
3716
 
3697
3717
  /**
@@ -4726,7 +4746,7 @@ declare type Event_10 = ApplicationEvents.Event | ApiReadyEvent | SnapshotApplie
4726
4746
  * under the {@link OpenFin.SystemEvents} namespace (payloads inherited from propagated events are defined in the namespace
4727
4747
  * from which they propagate).
4728
4748
  */
4729
- declare type Event_11 = ExcludeRequested<WindowEvents.PropagatedEvent<'system'>> | ExcludeRequested<ViewEvents.PropagatedEvent<'system'>> | ExcludeRequested<ApplicationEvents.PropagatedEvent<'system'>> | ApplicationCreatedEvent | DesktopIconClickedEvent | IdleStateChangedEvent | MonitorInfoChangedEvent | SessionChangedEvent | AppVersionEventWithId | SystemShutdownEvent;
4749
+ 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;
4730
4750
 
4731
4751
  /**
4732
4752
  * [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.
@@ -4871,6 +4891,18 @@ declare type EventType_9 = Event_12['type'];
4871
4891
 
4872
4892
  /* Excluded from this release type: EventWithId */
4873
4893
 
4894
+ /**
4895
+ * @interface
4896
+ */
4897
+ declare type ExcludeOptions = {
4898
+ /**
4899
+ * @defaultValue false
4900
+ *
4901
+ * When true, will not merge default preload scripts from {@link ApplicationOptions.defaultWindowOptions} or {@link ApplicationOptions.defaultViewOptions}.
4902
+ */
4903
+ preloadScripts: boolean;
4904
+ };
4905
+
4874
4906
  /* Excluded from this release type: ExcludeRequested */
4875
4907
 
4876
4908
  declare type ExistingConnectConfig = ConfigWithUuid & {
@@ -4886,6 +4918,105 @@ declare type ExitCode = {
4886
4918
  exitCode: number;
4887
4919
  };
4888
4920
 
4921
+ declare type ExtensionEvent = SecurityRealmEvent & {
4922
+ /**
4923
+ * Runtime extension whose status has been (possibly) modified
4924
+ */
4925
+ extension: string;
4926
+ };
4927
+
4928
+ /**
4929
+ * @interface
4930
+ */
4931
+ declare type ExtensionInfo = {
4932
+ extensionId: string;
4933
+ name: string;
4934
+ enabled: boolean;
4935
+ };
4936
+
4937
+ /**
4938
+ * An event that fires when an extension is installed in the security realm.
4939
+ *
4940
+ * @interface
4941
+ */
4942
+ declare type ExtensionInstalledEvent = ExtensionEvent & {
4943
+ type: 'extension-installed';
4944
+ };
4945
+
4946
+ /**
4947
+ * An event that fires when an extension fails to install in the security realm.
4948
+ *
4949
+ * @interface
4950
+ */
4951
+ declare type ExtensionInstallFailedEvent = ExtensionEvent & {
4952
+ type: 'extension-install-failed';
4953
+ };
4954
+
4955
+ /**
4956
+ * An event that fires when extensions are disabled in the security realm.
4957
+ *
4958
+ * @interface
4959
+ */
4960
+ declare type ExtensionsDisabledEvent = ExtensionsEvent & {
4961
+ type: 'extensions-disabled';
4962
+ };
4963
+
4964
+ /**
4965
+ * An event that fires when extensions are enabled in the security realm.
4966
+ *
4967
+ * @interface
4968
+ */
4969
+ declare type ExtensionsEnabledEvent = ExtensionsEvent & {
4970
+ type: 'extensions-enabled';
4971
+ };
4972
+
4973
+ declare type ExtensionsEvent = SecurityRealmEvent & {
4974
+ /**
4975
+ * Runtime extensions whose status has been (possibly) modified
4976
+ */
4977
+ extensions: string[];
4978
+ };
4979
+
4980
+ /**
4981
+ * An event that fires when requested extensions are not allowed to be installed in the security realm.
4982
+ *
4983
+ * @interface
4984
+ */
4985
+ declare type ExtensionsExcludedEvent = ExtensionsEvent & {
4986
+ type: 'extensions-excluded';
4987
+ };
4988
+
4989
+ /**
4990
+ * An event that fires when extension initialization fails on initial app launch. Users may attempt to
4991
+ * re-initialize extensions by calling {@link System.refreshExtensions}. This event will not fire in response
4992
+ * to manual extension refreshes (users should catch the error normally).
4993
+ */
4994
+ declare type ExtensionsInitializationFailedEvent = Omit<ExtensionsEvent, 'extensions'> & {
4995
+ type: 'extensions-initialization-failed';
4996
+ /**
4997
+ * The error that caused the extension initialization failure
4998
+ */
4999
+ error: Error;
5000
+ };
5001
+
5002
+ /**
5003
+ * An event that fires when extensions are installed in the security realm.
5004
+ *
5005
+ * @interface
5006
+ */
5007
+ declare type ExtensionsInstalledEvent = ExtensionsEvent & {
5008
+ type: 'extensions-installed';
5009
+ };
5010
+
5011
+ /**
5012
+ * An event that fires when extensions fail to install in the security realm.
5013
+ *
5014
+ * @interface
5015
+ */
5016
+ declare type ExtensionsInstallFailedEvent = ExtensionsEvent & {
5017
+ type: 'extensions-install-failed';
5018
+ };
5019
+
4889
5020
  /**
4890
5021
  * An ExternalApplication object representing native language adapter connections to the runtime. Allows
4891
5022
  * the developer to listen to {@link OpenFin.ExternalApplicationEvents external application events}.
@@ -9011,6 +9142,10 @@ declare type MutableViewOptions = {
9011
9142
  * @defaultValue 'enabled'
9012
9143
  */
9013
9144
  throttling: ViewThrottling;
9145
+ /**
9146
+ * {@inheritDoc ChromiumPolicies}
9147
+ */
9148
+ chromiumPolicies: ChromiumPolicies;
9014
9149
  };
9015
9150
 
9016
9151
  /**
@@ -9268,6 +9403,10 @@ declare type MutableWindowOptions = {
9268
9403
  * @remarks If `throttling` option is present, the `backgroundThrottling` option is completely ignored for windows.
9269
9404
  */
9270
9405
  throttling: WindowThrottling;
9406
+ /**
9407
+ * {@inheritDoc ChromiumPolicies}
9408
+ */
9409
+ chromiumPolicies: ChromiumPolicies;
9271
9410
  };
9272
9411
 
9273
9412
  declare type NackHandler = (payloadOrMessage: RuntimeErrorPayload | string) => void;
@@ -9478,8 +9617,11 @@ declare namespace OpenFin {
9478
9617
  ViewVisibilityOptions,
9479
9618
  WindowState,
9480
9619
  AutoplayPolicyOptions,
9620
+ ExcludeOptions,
9481
9621
  ConstWindowOptions,
9482
9622
  InheritableOptions,
9623
+ PolicyOptions,
9624
+ ChromiumPolicies,
9483
9625
  MutableWindowOptions,
9484
9626
  WorkspacePlatformOptions,
9485
9627
  WebRequestHeader,
@@ -9761,6 +9903,7 @@ declare namespace OpenFin {
9761
9903
  RoutingInfo,
9762
9904
  DownloadShelfOptions,
9763
9905
  ViewShowAtOptions,
9906
+ ExtensionInfo,
9764
9907
  ApplicationEvents,
9765
9908
  BaseEvents,
9766
9909
  ExternalApplicationEvents,
@@ -9962,6 +10105,10 @@ declare type PerDomainSettings = {
9962
10105
  * {@link ContentRedirect} in {@link WindowOptions} and {@link ViewOptions} will be **ignored**.
9963
10106
  */
9964
10107
  content?: ContentPermission;
10108
+ /**
10109
+ * {@inheritdoc ChromiumPolicies}
10110
+ */
10111
+ chromiumPolicies?: ChromiumPolicies;
9965
10112
  };
9966
10113
 
9967
10114
  /**
@@ -11419,6 +11566,12 @@ declare type PointTopLeft = {
11419
11566
  left: number;
11420
11567
  };
11421
11568
 
11569
+ /**
11570
+ * When set to `disable`, disables the policy
11571
+ * When set to `defer-to-group-policy`, respects Group Policy settings
11572
+ */
11573
+ declare type PolicyOptions = 'disable' | 'defer-to-group-policy';
11574
+
11422
11575
  declare type PopupBaseBehavior = 'close' | 'hide';
11423
11576
 
11424
11577
  declare type PopupBlurBehavior = 'modal' | PopupBaseBehavior;
@@ -12434,6 +12587,14 @@ declare interface ProtocolMap extends ProtocolMapBase {
12434
12587
  }, void>;
12435
12588
  'system-register-shutdown-handler': VoidCall;
12436
12589
  'get-permissions': GetterCall<any>;
12590
+ 'refresh-extensions': {
12591
+ request: void;
12592
+ response: string[] | undefined;
12593
+ };
12594
+ 'get-installed-extensions': {
12595
+ request: void;
12596
+ response: OpenFin.ExtensionInfo[];
12597
+ };
12437
12598
  'fdc3-add-context-listener': VoidCall;
12438
12599
  'fdc3-add-intent-listener': VoidCall;
12439
12600
  'fdc3-raise-intent': VoidCall;
@@ -13122,6 +13283,21 @@ declare type ScreenshotPrintOptions = {
13122
13283
  content: 'screenshot';
13123
13284
  };
13124
13285
 
13286
+ /**
13287
+ * An event generated when an application modifies the runtime in a way that affects all other applications in the
13288
+ * application runtime/security realm.
13289
+ */
13290
+ declare type SecurityRealmEvent = BaseEvent_9 & {
13291
+ /**
13292
+ * Config URL of the application that modified the security realm's extensions
13293
+ */
13294
+ configUrl: string;
13295
+ /**
13296
+ * Identity of the application that modified the security realm's extensions
13297
+ */
13298
+ applicationIdentity: OpenFin.ApplicationIdentity;
13299
+ };
13300
+
13125
13301
  declare type SendActionResponse<T extends keyof ProtocolMap> = Message<{
13126
13302
  data: ProtocolMap[T]['response'];
13127
13303
  } & ProtocolMap[T]['specialResponse']>;
@@ -15013,6 +15189,16 @@ declare class System extends EmitterBase<OpenFin.SystemEvent> {
15013
15189
  * ```
15014
15190
  */
15015
15191
  setDomainSettings(domainSettings: OpenFin.DefaultDomainSettings): Promise<void>;
15192
+ /**
15193
+ * Attempts to install and enable extensions for the security realm. Users may want to call this function in response
15194
+ * to an `extensions-install-failed` event. Only extensions allowed by every application on the current security realm
15195
+ * will be installed/enabled.
15196
+ */
15197
+ refreshExtensions(): Promise<string[] | undefined>;
15198
+ /**
15199
+ * Gets the currently-installed
15200
+ */
15201
+ getInstalledExtensions(): Promise<OpenFin.ExtensionInfo[]>;
15016
15202
  }
15017
15203
 
15018
15204
  /**
@@ -15043,6 +15229,14 @@ declare namespace SystemEvents {
15043
15229
  ApplicationCreatedEvent,
15044
15230
  DesktopIconClickedEvent,
15045
15231
  SystemShutdownEvent,
15232
+ ExtensionsEnabledEvent,
15233
+ ExtensionsDisabledEvent,
15234
+ ExtensionsExcludedEvent,
15235
+ ExtensionsInstalledEvent,
15236
+ ExtensionInstalledEvent,
15237
+ ExtensionsInstallFailedEvent,
15238
+ ExtensionInstallFailedEvent,
15239
+ ExtensionsInitializationFailedEvent,
15046
15240
  Event_11 as Event,
15047
15241
  SystemEvent,
15048
15242
  EventType_8 as EventType,
@@ -16330,6 +16524,9 @@ declare class ViewModule extends Base {
16330
16524
  */
16331
16525
  declare type ViewOptions = ConstViewOptions & MutableViewOptions;
16332
16526
 
16527
+ /**
16528
+ * @interface
16529
+ */
16333
16530
  declare type ViewShowAtOptions = {
16334
16531
  /**
16335
16532
  * Sets the view as the top level view. See {@link OpenFin.View.bringToFront} for more information.
@@ -2937,6 +2937,18 @@ declare type ChildWindowCreatedEvent = ContentCreationRulesEvent & {
2937
2937
  childOptions: OpenFin.WindowOptions;
2938
2938
  };
2939
2939
 
2940
+ /**
2941
+ * Control behavior for Chromium policies
2942
+ *
2943
+ * @interface
2944
+ */
2945
+ declare type ChromiumPolicies = {
2946
+ /**
2947
+ * Disable AutofillAddressEnabled policy for a Window or View.
2948
+ */
2949
+ AutofillAddressEnabled?: PolicyOptions;
2950
+ };
2951
+
2940
2952
  declare interface ClassicProtocolOffer extends ProtocolPacketBase {
2941
2953
  type: 'classic';
2942
2954
  }
@@ -3448,6 +3460,10 @@ declare type ConstViewOptions = {
3448
3460
  */
3449
3461
  enabled: boolean;
3450
3462
  };
3463
+ /**
3464
+ * Control which options to ignore when creating a Platform View.
3465
+ */
3466
+ excludeOptions: ExcludeOptions;
3451
3467
  };
3452
3468
 
3453
3469
  /**
@@ -3692,6 +3708,10 @@ declare type ConstWindowOptions = {
3692
3708
  * Controls whether an option is inherited from the parent application. The option is set as part of the window options for the parent application in either the {@link Manifest.startup_app} or {@link Manifest.platform} properties in the manifest or in {@link ApplicationOptions.mainWindowOptions} when calling {@link Application.ApplicationModule.start Application.start}. Use { [option]: false } to disable a specific [option]. All inheritable properties will be inherited by default if omitted.
3693
3709
  */
3694
3710
  inheritance?: Partial<InheritableOptions>;
3711
+ /**
3712
+ * Control which options to ignore when creating a Platform Window.
3713
+ */
3714
+ excludeOptions: ExcludeOptions;
3695
3715
  };
3696
3716
 
3697
3717
  /**
@@ -4726,7 +4746,7 @@ declare type Event_10 = ApplicationEvents.Event | ApiReadyEvent | SnapshotApplie
4726
4746
  * under the {@link OpenFin.SystemEvents} namespace (payloads inherited from propagated events are defined in the namespace
4727
4747
  * from which they propagate).
4728
4748
  */
4729
- declare type Event_11 = ExcludeRequested<WindowEvents.PropagatedEvent<'system'>> | ExcludeRequested<ViewEvents.PropagatedEvent<'system'>> | ExcludeRequested<ApplicationEvents.PropagatedEvent<'system'>> | ApplicationCreatedEvent | DesktopIconClickedEvent | IdleStateChangedEvent | MonitorInfoChangedEvent | SessionChangedEvent | AppVersionEventWithId | SystemShutdownEvent;
4749
+ 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;
4730
4750
 
4731
4751
  /**
4732
4752
  * [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.
@@ -4871,6 +4891,18 @@ declare type EventType_9 = Event_12['type'];
4871
4891
 
4872
4892
  /* Excluded from this release type: EventWithId */
4873
4893
 
4894
+ /**
4895
+ * @interface
4896
+ */
4897
+ declare type ExcludeOptions = {
4898
+ /**
4899
+ * @defaultValue false
4900
+ *
4901
+ * When true, will not merge default preload scripts from {@link ApplicationOptions.defaultWindowOptions} or {@link ApplicationOptions.defaultViewOptions}.
4902
+ */
4903
+ preloadScripts: boolean;
4904
+ };
4905
+
4874
4906
  /* Excluded from this release type: ExcludeRequested */
4875
4907
 
4876
4908
  declare type ExistingConnectConfig = ConfigWithUuid & {
@@ -4886,6 +4918,105 @@ declare type ExitCode = {
4886
4918
  exitCode: number;
4887
4919
  };
4888
4920
 
4921
+ declare type ExtensionEvent = SecurityRealmEvent & {
4922
+ /**
4923
+ * Runtime extension whose status has been (possibly) modified
4924
+ */
4925
+ extension: string;
4926
+ };
4927
+
4928
+ /**
4929
+ * @interface
4930
+ */
4931
+ declare type ExtensionInfo = {
4932
+ extensionId: string;
4933
+ name: string;
4934
+ enabled: boolean;
4935
+ };
4936
+
4937
+ /**
4938
+ * An event that fires when an extension is installed in the security realm.
4939
+ *
4940
+ * @interface
4941
+ */
4942
+ declare type ExtensionInstalledEvent = ExtensionEvent & {
4943
+ type: 'extension-installed';
4944
+ };
4945
+
4946
+ /**
4947
+ * An event that fires when an extension fails to install in the security realm.
4948
+ *
4949
+ * @interface
4950
+ */
4951
+ declare type ExtensionInstallFailedEvent = ExtensionEvent & {
4952
+ type: 'extension-install-failed';
4953
+ };
4954
+
4955
+ /**
4956
+ * An event that fires when extensions are disabled in the security realm.
4957
+ *
4958
+ * @interface
4959
+ */
4960
+ declare type ExtensionsDisabledEvent = ExtensionsEvent & {
4961
+ type: 'extensions-disabled';
4962
+ };
4963
+
4964
+ /**
4965
+ * An event that fires when extensions are enabled in the security realm.
4966
+ *
4967
+ * @interface
4968
+ */
4969
+ declare type ExtensionsEnabledEvent = ExtensionsEvent & {
4970
+ type: 'extensions-enabled';
4971
+ };
4972
+
4973
+ declare type ExtensionsEvent = SecurityRealmEvent & {
4974
+ /**
4975
+ * Runtime extensions whose status has been (possibly) modified
4976
+ */
4977
+ extensions: string[];
4978
+ };
4979
+
4980
+ /**
4981
+ * An event that fires when requested extensions are not allowed to be installed in the security realm.
4982
+ *
4983
+ * @interface
4984
+ */
4985
+ declare type ExtensionsExcludedEvent = ExtensionsEvent & {
4986
+ type: 'extensions-excluded';
4987
+ };
4988
+
4989
+ /**
4990
+ * An event that fires when extension initialization fails on initial app launch. Users may attempt to
4991
+ * re-initialize extensions by calling {@link System.refreshExtensions}. This event will not fire in response
4992
+ * to manual extension refreshes (users should catch the error normally).
4993
+ */
4994
+ declare type ExtensionsInitializationFailedEvent = Omit<ExtensionsEvent, 'extensions'> & {
4995
+ type: 'extensions-initialization-failed';
4996
+ /**
4997
+ * The error that caused the extension initialization failure
4998
+ */
4999
+ error: Error;
5000
+ };
5001
+
5002
+ /**
5003
+ * An event that fires when extensions are installed in the security realm.
5004
+ *
5005
+ * @interface
5006
+ */
5007
+ declare type ExtensionsInstalledEvent = ExtensionsEvent & {
5008
+ type: 'extensions-installed';
5009
+ };
5010
+
5011
+ /**
5012
+ * An event that fires when extensions fail to install in the security realm.
5013
+ *
5014
+ * @interface
5015
+ */
5016
+ declare type ExtensionsInstallFailedEvent = ExtensionsEvent & {
5017
+ type: 'extensions-install-failed';
5018
+ };
5019
+
4889
5020
  /**
4890
5021
  * An ExternalApplication object representing native language adapter connections to the runtime. Allows
4891
5022
  * the developer to listen to {@link OpenFin.ExternalApplicationEvents external application events}.
@@ -9011,6 +9142,10 @@ declare type MutableViewOptions = {
9011
9142
  * @defaultValue 'enabled'
9012
9143
  */
9013
9144
  throttling: ViewThrottling;
9145
+ /**
9146
+ * {@inheritDoc ChromiumPolicies}
9147
+ */
9148
+ chromiumPolicies: ChromiumPolicies;
9014
9149
  };
9015
9150
 
9016
9151
  /**
@@ -9268,6 +9403,10 @@ declare type MutableWindowOptions = {
9268
9403
  * @remarks If `throttling` option is present, the `backgroundThrottling` option is completely ignored for windows.
9269
9404
  */
9270
9405
  throttling: WindowThrottling;
9406
+ /**
9407
+ * {@inheritDoc ChromiumPolicies}
9408
+ */
9409
+ chromiumPolicies: ChromiumPolicies;
9271
9410
  };
9272
9411
 
9273
9412
  declare type NackHandler = (payloadOrMessage: RuntimeErrorPayload | string) => void;
@@ -9478,8 +9617,11 @@ declare namespace OpenFin {
9478
9617
  ViewVisibilityOptions,
9479
9618
  WindowState,
9480
9619
  AutoplayPolicyOptions,
9620
+ ExcludeOptions,
9481
9621
  ConstWindowOptions,
9482
9622
  InheritableOptions,
9623
+ PolicyOptions,
9624
+ ChromiumPolicies,
9483
9625
  MutableWindowOptions,
9484
9626
  WorkspacePlatformOptions,
9485
9627
  WebRequestHeader,
@@ -9761,6 +9903,7 @@ declare namespace OpenFin {
9761
9903
  RoutingInfo,
9762
9904
  DownloadShelfOptions,
9763
9905
  ViewShowAtOptions,
9906
+ ExtensionInfo,
9764
9907
  ApplicationEvents,
9765
9908
  BaseEvents,
9766
9909
  ExternalApplicationEvents,
@@ -9962,6 +10105,10 @@ declare type PerDomainSettings = {
9962
10105
  * {@link ContentRedirect} in {@link WindowOptions} and {@link ViewOptions} will be **ignored**.
9963
10106
  */
9964
10107
  content?: ContentPermission;
10108
+ /**
10109
+ * {@inheritdoc ChromiumPolicies}
10110
+ */
10111
+ chromiumPolicies?: ChromiumPolicies;
9965
10112
  };
9966
10113
 
9967
10114
  /**
@@ -11419,6 +11566,12 @@ declare type PointTopLeft = {
11419
11566
  left: number;
11420
11567
  };
11421
11568
 
11569
+ /**
11570
+ * When set to `disable`, disables the policy
11571
+ * When set to `defer-to-group-policy`, respects Group Policy settings
11572
+ */
11573
+ declare type PolicyOptions = 'disable' | 'defer-to-group-policy';
11574
+
11422
11575
  declare type PopupBaseBehavior = 'close' | 'hide';
11423
11576
 
11424
11577
  declare type PopupBlurBehavior = 'modal' | PopupBaseBehavior;
@@ -12434,6 +12587,14 @@ declare interface ProtocolMap extends ProtocolMapBase {
12434
12587
  }, void>;
12435
12588
  'system-register-shutdown-handler': VoidCall;
12436
12589
  'get-permissions': GetterCall<any>;
12590
+ 'refresh-extensions': {
12591
+ request: void;
12592
+ response: string[] | undefined;
12593
+ };
12594
+ 'get-installed-extensions': {
12595
+ request: void;
12596
+ response: OpenFin.ExtensionInfo[];
12597
+ };
12437
12598
  'fdc3-add-context-listener': VoidCall;
12438
12599
  'fdc3-add-intent-listener': VoidCall;
12439
12600
  'fdc3-raise-intent': VoidCall;
@@ -13122,6 +13283,21 @@ declare type ScreenshotPrintOptions = {
13122
13283
  content: 'screenshot';
13123
13284
  };
13124
13285
 
13286
+ /**
13287
+ * An event generated when an application modifies the runtime in a way that affects all other applications in the
13288
+ * application runtime/security realm.
13289
+ */
13290
+ declare type SecurityRealmEvent = BaseEvent_9 & {
13291
+ /**
13292
+ * Config URL of the application that modified the security realm's extensions
13293
+ */
13294
+ configUrl: string;
13295
+ /**
13296
+ * Identity of the application that modified the security realm's extensions
13297
+ */
13298
+ applicationIdentity: OpenFin.ApplicationIdentity;
13299
+ };
13300
+
13125
13301
  declare type SendActionResponse<T extends keyof ProtocolMap> = Message<{
13126
13302
  data: ProtocolMap[T]['response'];
13127
13303
  } & ProtocolMap[T]['specialResponse']>;
@@ -15013,6 +15189,16 @@ declare class System extends EmitterBase<OpenFin.SystemEvent> {
15013
15189
  * ```
15014
15190
  */
15015
15191
  setDomainSettings(domainSettings: OpenFin.DefaultDomainSettings): Promise<void>;
15192
+ /**
15193
+ * Attempts to install and enable extensions for the security realm. Users may want to call this function in response
15194
+ * to an `extensions-install-failed` event. Only extensions allowed by every application on the current security realm
15195
+ * will be installed/enabled.
15196
+ */
15197
+ refreshExtensions(): Promise<string[] | undefined>;
15198
+ /**
15199
+ * Gets the currently-installed
15200
+ */
15201
+ getInstalledExtensions(): Promise<OpenFin.ExtensionInfo[]>;
15016
15202
  }
15017
15203
 
15018
15204
  /**
@@ -15043,6 +15229,14 @@ declare namespace SystemEvents {
15043
15229
  ApplicationCreatedEvent,
15044
15230
  DesktopIconClickedEvent,
15045
15231
  SystemShutdownEvent,
15232
+ ExtensionsEnabledEvent,
15233
+ ExtensionsDisabledEvent,
15234
+ ExtensionsExcludedEvent,
15235
+ ExtensionsInstalledEvent,
15236
+ ExtensionInstalledEvent,
15237
+ ExtensionsInstallFailedEvent,
15238
+ ExtensionInstallFailedEvent,
15239
+ ExtensionsInitializationFailedEvent,
15046
15240
  Event_11 as Event,
15047
15241
  SystemEvent,
15048
15242
  EventType_8 as EventType,
@@ -16330,6 +16524,9 @@ declare class ViewModule extends Base {
16330
16524
  */
16331
16525
  declare type ViewOptions = ConstViewOptions & MutableViewOptions;
16332
16526
 
16527
+ /**
16528
+ * @interface
16529
+ */
16333
16530
  declare type ViewShowAtOptions = {
16334
16531
  /**
16335
16532
  * Sets the view as the top level view. See {@link OpenFin.View.bringToFront} for more information.
@@ -2937,6 +2937,18 @@ declare type ChildWindowCreatedEvent = ContentCreationRulesEvent & {
2937
2937
  childOptions: OpenFin.WindowOptions;
2938
2938
  };
2939
2939
 
2940
+ /**
2941
+ * Control behavior for Chromium policies
2942
+ *
2943
+ * @interface
2944
+ */
2945
+ declare type ChromiumPolicies = {
2946
+ /**
2947
+ * Disable AutofillAddressEnabled policy for a Window or View.
2948
+ */
2949
+ AutofillAddressEnabled?: PolicyOptions;
2950
+ };
2951
+
2940
2952
  declare interface ClassicProtocolOffer extends ProtocolPacketBase {
2941
2953
  type: 'classic';
2942
2954
  }
@@ -3448,6 +3460,10 @@ declare type ConstViewOptions = {
3448
3460
  */
3449
3461
  enabled: boolean;
3450
3462
  };
3463
+ /**
3464
+ * Control which options to ignore when creating a Platform View.
3465
+ */
3466
+ excludeOptions: ExcludeOptions;
3451
3467
  };
3452
3468
 
3453
3469
  /**
@@ -3692,6 +3708,10 @@ declare type ConstWindowOptions = {
3692
3708
  * Controls whether an option is inherited from the parent application. The option is set as part of the window options for the parent application in either the {@link Manifest.startup_app} or {@link Manifest.platform} properties in the manifest or in {@link ApplicationOptions.mainWindowOptions} when calling {@link Application.ApplicationModule.start Application.start}. Use { [option]: false } to disable a specific [option]. All inheritable properties will be inherited by default if omitted.
3693
3709
  */
3694
3710
  inheritance?: Partial<InheritableOptions>;
3711
+ /**
3712
+ * Control which options to ignore when creating a Platform Window.
3713
+ */
3714
+ excludeOptions: ExcludeOptions;
3695
3715
  };
3696
3716
 
3697
3717
  /**
@@ -4726,7 +4746,7 @@ declare type Event_10 = ApplicationEvents.Event | ApiReadyEvent | SnapshotApplie
4726
4746
  * under the {@link OpenFin.SystemEvents} namespace (payloads inherited from propagated events are defined in the namespace
4727
4747
  * from which they propagate).
4728
4748
  */
4729
- declare type Event_11 = ExcludeRequested<WindowEvents.PropagatedEvent<'system'>> | ExcludeRequested<ViewEvents.PropagatedEvent<'system'>> | ExcludeRequested<ApplicationEvents.PropagatedEvent<'system'>> | ApplicationCreatedEvent | DesktopIconClickedEvent | IdleStateChangedEvent | MonitorInfoChangedEvent | SessionChangedEvent | AppVersionEventWithId | SystemShutdownEvent;
4749
+ 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;
4730
4750
 
4731
4751
  /**
4732
4752
  * [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.
@@ -4871,6 +4891,18 @@ declare type EventType_9 = Event_12['type'];
4871
4891
 
4872
4892
  /* Excluded from this release type: EventWithId */
4873
4893
 
4894
+ /**
4895
+ * @interface
4896
+ */
4897
+ declare type ExcludeOptions = {
4898
+ /**
4899
+ * @defaultValue false
4900
+ *
4901
+ * When true, will not merge default preload scripts from {@link ApplicationOptions.defaultWindowOptions} or {@link ApplicationOptions.defaultViewOptions}.
4902
+ */
4903
+ preloadScripts: boolean;
4904
+ };
4905
+
4874
4906
  /* Excluded from this release type: ExcludeRequested */
4875
4907
 
4876
4908
  declare type ExistingConnectConfig = ConfigWithUuid & {
@@ -4886,6 +4918,105 @@ declare type ExitCode = {
4886
4918
  exitCode: number;
4887
4919
  };
4888
4920
 
4921
+ declare type ExtensionEvent = SecurityRealmEvent & {
4922
+ /**
4923
+ * Runtime extension whose status has been (possibly) modified
4924
+ */
4925
+ extension: string;
4926
+ };
4927
+
4928
+ /**
4929
+ * @interface
4930
+ */
4931
+ declare type ExtensionInfo = {
4932
+ extensionId: string;
4933
+ name: string;
4934
+ enabled: boolean;
4935
+ };
4936
+
4937
+ /**
4938
+ * An event that fires when an extension is installed in the security realm.
4939
+ *
4940
+ * @interface
4941
+ */
4942
+ declare type ExtensionInstalledEvent = ExtensionEvent & {
4943
+ type: 'extension-installed';
4944
+ };
4945
+
4946
+ /**
4947
+ * An event that fires when an extension fails to install in the security realm.
4948
+ *
4949
+ * @interface
4950
+ */
4951
+ declare type ExtensionInstallFailedEvent = ExtensionEvent & {
4952
+ type: 'extension-install-failed';
4953
+ };
4954
+
4955
+ /**
4956
+ * An event that fires when extensions are disabled in the security realm.
4957
+ *
4958
+ * @interface
4959
+ */
4960
+ declare type ExtensionsDisabledEvent = ExtensionsEvent & {
4961
+ type: 'extensions-disabled';
4962
+ };
4963
+
4964
+ /**
4965
+ * An event that fires when extensions are enabled in the security realm.
4966
+ *
4967
+ * @interface
4968
+ */
4969
+ declare type ExtensionsEnabledEvent = ExtensionsEvent & {
4970
+ type: 'extensions-enabled';
4971
+ };
4972
+
4973
+ declare type ExtensionsEvent = SecurityRealmEvent & {
4974
+ /**
4975
+ * Runtime extensions whose status has been (possibly) modified
4976
+ */
4977
+ extensions: string[];
4978
+ };
4979
+
4980
+ /**
4981
+ * An event that fires when requested extensions are not allowed to be installed in the security realm.
4982
+ *
4983
+ * @interface
4984
+ */
4985
+ declare type ExtensionsExcludedEvent = ExtensionsEvent & {
4986
+ type: 'extensions-excluded';
4987
+ };
4988
+
4989
+ /**
4990
+ * An event that fires when extension initialization fails on initial app launch. Users may attempt to
4991
+ * re-initialize extensions by calling {@link System.refreshExtensions}. This event will not fire in response
4992
+ * to manual extension refreshes (users should catch the error normally).
4993
+ */
4994
+ declare type ExtensionsInitializationFailedEvent = Omit<ExtensionsEvent, 'extensions'> & {
4995
+ type: 'extensions-initialization-failed';
4996
+ /**
4997
+ * The error that caused the extension initialization failure
4998
+ */
4999
+ error: Error;
5000
+ };
5001
+
5002
+ /**
5003
+ * An event that fires when extensions are installed in the security realm.
5004
+ *
5005
+ * @interface
5006
+ */
5007
+ declare type ExtensionsInstalledEvent = ExtensionsEvent & {
5008
+ type: 'extensions-installed';
5009
+ };
5010
+
5011
+ /**
5012
+ * An event that fires when extensions fail to install in the security realm.
5013
+ *
5014
+ * @interface
5015
+ */
5016
+ declare type ExtensionsInstallFailedEvent = ExtensionsEvent & {
5017
+ type: 'extensions-install-failed';
5018
+ };
5019
+
4889
5020
  /**
4890
5021
  * An ExternalApplication object representing native language adapter connections to the runtime. Allows
4891
5022
  * the developer to listen to {@link OpenFin.ExternalApplicationEvents external application events}.
@@ -9011,6 +9142,10 @@ declare type MutableViewOptions = {
9011
9142
  * @defaultValue 'enabled'
9012
9143
  */
9013
9144
  throttling: ViewThrottling;
9145
+ /**
9146
+ * {@inheritDoc ChromiumPolicies}
9147
+ */
9148
+ chromiumPolicies: ChromiumPolicies;
9014
9149
  };
9015
9150
 
9016
9151
  /**
@@ -9268,6 +9403,10 @@ declare type MutableWindowOptions = {
9268
9403
  * @remarks If `throttling` option is present, the `backgroundThrottling` option is completely ignored for windows.
9269
9404
  */
9270
9405
  throttling: WindowThrottling;
9406
+ /**
9407
+ * {@inheritDoc ChromiumPolicies}
9408
+ */
9409
+ chromiumPolicies: ChromiumPolicies;
9271
9410
  };
9272
9411
 
9273
9412
  declare type NackHandler = (payloadOrMessage: RuntimeErrorPayload | string) => void;
@@ -9478,8 +9617,11 @@ declare namespace OpenFin {
9478
9617
  ViewVisibilityOptions,
9479
9618
  WindowState,
9480
9619
  AutoplayPolicyOptions,
9620
+ ExcludeOptions,
9481
9621
  ConstWindowOptions,
9482
9622
  InheritableOptions,
9623
+ PolicyOptions,
9624
+ ChromiumPolicies,
9483
9625
  MutableWindowOptions,
9484
9626
  WorkspacePlatformOptions,
9485
9627
  WebRequestHeader,
@@ -9761,6 +9903,7 @@ declare namespace OpenFin {
9761
9903
  RoutingInfo,
9762
9904
  DownloadShelfOptions,
9763
9905
  ViewShowAtOptions,
9906
+ ExtensionInfo,
9764
9907
  ApplicationEvents,
9765
9908
  BaseEvents,
9766
9909
  ExternalApplicationEvents,
@@ -9962,6 +10105,10 @@ declare type PerDomainSettings = {
9962
10105
  * {@link ContentRedirect} in {@link WindowOptions} and {@link ViewOptions} will be **ignored**.
9963
10106
  */
9964
10107
  content?: ContentPermission;
10108
+ /**
10109
+ * {@inheritdoc ChromiumPolicies}
10110
+ */
10111
+ chromiumPolicies?: ChromiumPolicies;
9965
10112
  };
9966
10113
 
9967
10114
  /**
@@ -11419,6 +11566,12 @@ declare type PointTopLeft = {
11419
11566
  left: number;
11420
11567
  };
11421
11568
 
11569
+ /**
11570
+ * When set to `disable`, disables the policy
11571
+ * When set to `defer-to-group-policy`, respects Group Policy settings
11572
+ */
11573
+ declare type PolicyOptions = 'disable' | 'defer-to-group-policy';
11574
+
11422
11575
  declare type PopupBaseBehavior = 'close' | 'hide';
11423
11576
 
11424
11577
  declare type PopupBlurBehavior = 'modal' | PopupBaseBehavior;
@@ -12434,6 +12587,14 @@ declare interface ProtocolMap extends ProtocolMapBase {
12434
12587
  }, void>;
12435
12588
  'system-register-shutdown-handler': VoidCall;
12436
12589
  'get-permissions': GetterCall<any>;
12590
+ 'refresh-extensions': {
12591
+ request: void;
12592
+ response: string[] | undefined;
12593
+ };
12594
+ 'get-installed-extensions': {
12595
+ request: void;
12596
+ response: OpenFin.ExtensionInfo[];
12597
+ };
12437
12598
  'fdc3-add-context-listener': VoidCall;
12438
12599
  'fdc3-add-intent-listener': VoidCall;
12439
12600
  'fdc3-raise-intent': VoidCall;
@@ -13122,6 +13283,21 @@ declare type ScreenshotPrintOptions = {
13122
13283
  content: 'screenshot';
13123
13284
  };
13124
13285
 
13286
+ /**
13287
+ * An event generated when an application modifies the runtime in a way that affects all other applications in the
13288
+ * application runtime/security realm.
13289
+ */
13290
+ declare type SecurityRealmEvent = BaseEvent_9 & {
13291
+ /**
13292
+ * Config URL of the application that modified the security realm's extensions
13293
+ */
13294
+ configUrl: string;
13295
+ /**
13296
+ * Identity of the application that modified the security realm's extensions
13297
+ */
13298
+ applicationIdentity: OpenFin.ApplicationIdentity;
13299
+ };
13300
+
13125
13301
  declare type SendActionResponse<T extends keyof ProtocolMap> = Message<{
13126
13302
  data: ProtocolMap[T]['response'];
13127
13303
  } & ProtocolMap[T]['specialResponse']>;
@@ -15013,6 +15189,16 @@ declare class System extends EmitterBase<OpenFin.SystemEvent> {
15013
15189
  * ```
15014
15190
  */
15015
15191
  setDomainSettings(domainSettings: OpenFin.DefaultDomainSettings): Promise<void>;
15192
+ /**
15193
+ * Attempts to install and enable extensions for the security realm. Users may want to call this function in response
15194
+ * to an `extensions-install-failed` event. Only extensions allowed by every application on the current security realm
15195
+ * will be installed/enabled.
15196
+ */
15197
+ refreshExtensions(): Promise<string[] | undefined>;
15198
+ /**
15199
+ * Gets the currently-installed
15200
+ */
15201
+ getInstalledExtensions(): Promise<OpenFin.ExtensionInfo[]>;
15016
15202
  }
15017
15203
 
15018
15204
  /**
@@ -15043,6 +15229,14 @@ declare namespace SystemEvents {
15043
15229
  ApplicationCreatedEvent,
15044
15230
  DesktopIconClickedEvent,
15045
15231
  SystemShutdownEvent,
15232
+ ExtensionsEnabledEvent,
15233
+ ExtensionsDisabledEvent,
15234
+ ExtensionsExcludedEvent,
15235
+ ExtensionsInstalledEvent,
15236
+ ExtensionInstalledEvent,
15237
+ ExtensionsInstallFailedEvent,
15238
+ ExtensionInstallFailedEvent,
15239
+ ExtensionsInitializationFailedEvent,
15046
15240
  Event_11 as Event,
15047
15241
  SystemEvent,
15048
15242
  EventType_8 as EventType,
@@ -16330,6 +16524,9 @@ declare class ViewModule extends Base {
16330
16524
  */
16331
16525
  declare type ViewOptions = ConstViewOptions & MutableViewOptions;
16332
16526
 
16527
+ /**
16528
+ * @interface
16529
+ */
16333
16530
  declare type ViewShowAtOptions = {
16334
16531
  /**
16335
16532
  * Sets the view as the top level view. See {@link OpenFin.View.bringToFront} for more information.
package/out/fdc3-api.d.ts CHANGED
@@ -2993,6 +2993,18 @@ declare type ChildWindowCreatedEvent = ContentCreationRulesEvent & {
2993
2993
  childOptions: OpenFin.WindowOptions;
2994
2994
  };
2995
2995
 
2996
+ /**
2997
+ * Control behavior for Chromium policies
2998
+ *
2999
+ * @interface
3000
+ */
3001
+ declare type ChromiumPolicies = {
3002
+ /**
3003
+ * Disable AutofillAddressEnabled policy for a Window or View.
3004
+ */
3005
+ AutofillAddressEnabled?: PolicyOptions;
3006
+ };
3007
+
2996
3008
  declare interface ClassicProtocolOffer extends ProtocolPacketBase {
2997
3009
  type: 'classic';
2998
3010
  }
@@ -3507,6 +3519,10 @@ declare type ConstViewOptions = {
3507
3519
  */
3508
3520
  enabled: boolean;
3509
3521
  };
3522
+ /**
3523
+ * Control which options to ignore when creating a Platform View.
3524
+ */
3525
+ excludeOptions: ExcludeOptions;
3510
3526
  };
3511
3527
 
3512
3528
  /**
@@ -3751,6 +3767,10 @@ declare type ConstWindowOptions = {
3751
3767
  * Controls whether an option is inherited from the parent application. The option is set as part of the window options for the parent application in either the {@link Manifest.startup_app} or {@link Manifest.platform} properties in the manifest or in {@link ApplicationOptions.mainWindowOptions} when calling {@link Application.ApplicationModule.start Application.start}. Use { [option]: false } to disable a specific [option]. All inheritable properties will be inherited by default if omitted.
3752
3768
  */
3753
3769
  inheritance?: Partial<InheritableOptions>;
3770
+ /**
3771
+ * Control which options to ignore when creating a Platform Window.
3772
+ */
3773
+ excludeOptions: ExcludeOptions;
3754
3774
  };
3755
3775
 
3756
3776
  /**
@@ -4790,7 +4810,7 @@ declare type Event_10 = ApplicationEvents.Event | ApiReadyEvent | SnapshotApplie
4790
4810
  * under the {@link OpenFin.SystemEvents} namespace (payloads inherited from propagated events are defined in the namespace
4791
4811
  * from which they propagate).
4792
4812
  */
4793
- declare type Event_11 = ExcludeRequested<WindowEvents.PropagatedEvent<'system'>> | ExcludeRequested<ViewEvents.PropagatedEvent<'system'>> | ExcludeRequested<ApplicationEvents.PropagatedEvent<'system'>> | ApplicationCreatedEvent | DesktopIconClickedEvent | IdleStateChangedEvent | MonitorInfoChangedEvent | SessionChangedEvent | AppVersionEventWithId | SystemShutdownEvent;
4813
+ 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;
4794
4814
 
4795
4815
  /**
4796
4816
  * [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.
@@ -4944,6 +4964,18 @@ declare type EventWithId<Event extends AppVersionEvent> = Event extends infer E
4944
4964
  appVersionId: string;
4945
4965
  } : never;
4946
4966
 
4967
+ /**
4968
+ * @interface
4969
+ */
4970
+ declare type ExcludeOptions = {
4971
+ /**
4972
+ * @defaultValue false
4973
+ *
4974
+ * When true, will not merge default preload scripts from {@link ApplicationOptions.defaultWindowOptions} or {@link ApplicationOptions.defaultViewOptions}.
4975
+ */
4976
+ preloadScripts: boolean;
4977
+ };
4978
+
4947
4979
  /**
4948
4980
  * @internal
4949
4981
  *
@@ -4968,6 +5000,105 @@ declare type ExitCode = {
4968
5000
  exitCode: number;
4969
5001
  };
4970
5002
 
5003
+ declare type ExtensionEvent = SecurityRealmEvent & {
5004
+ /**
5005
+ * Runtime extension whose status has been (possibly) modified
5006
+ */
5007
+ extension: string;
5008
+ };
5009
+
5010
+ /**
5011
+ * @interface
5012
+ */
5013
+ declare type ExtensionInfo = {
5014
+ extensionId: string;
5015
+ name: string;
5016
+ enabled: boolean;
5017
+ };
5018
+
5019
+ /**
5020
+ * An event that fires when an extension is installed in the security realm.
5021
+ *
5022
+ * @interface
5023
+ */
5024
+ declare type ExtensionInstalledEvent = ExtensionEvent & {
5025
+ type: 'extension-installed';
5026
+ };
5027
+
5028
+ /**
5029
+ * An event that fires when an extension fails to install in the security realm.
5030
+ *
5031
+ * @interface
5032
+ */
5033
+ declare type ExtensionInstallFailedEvent = ExtensionEvent & {
5034
+ type: 'extension-install-failed';
5035
+ };
5036
+
5037
+ /**
5038
+ * An event that fires when extensions are disabled in the security realm.
5039
+ *
5040
+ * @interface
5041
+ */
5042
+ declare type ExtensionsDisabledEvent = ExtensionsEvent & {
5043
+ type: 'extensions-disabled';
5044
+ };
5045
+
5046
+ /**
5047
+ * An event that fires when extensions are enabled in the security realm.
5048
+ *
5049
+ * @interface
5050
+ */
5051
+ declare type ExtensionsEnabledEvent = ExtensionsEvent & {
5052
+ type: 'extensions-enabled';
5053
+ };
5054
+
5055
+ declare type ExtensionsEvent = SecurityRealmEvent & {
5056
+ /**
5057
+ * Runtime extensions whose status has been (possibly) modified
5058
+ */
5059
+ extensions: string[];
5060
+ };
5061
+
5062
+ /**
5063
+ * An event that fires when requested extensions are not allowed to be installed in the security realm.
5064
+ *
5065
+ * @interface
5066
+ */
5067
+ declare type ExtensionsExcludedEvent = ExtensionsEvent & {
5068
+ type: 'extensions-excluded';
5069
+ };
5070
+
5071
+ /**
5072
+ * An event that fires when extension initialization fails on initial app launch. Users may attempt to
5073
+ * re-initialize extensions by calling {@link System.refreshExtensions}. This event will not fire in response
5074
+ * to manual extension refreshes (users should catch the error normally).
5075
+ */
5076
+ declare type ExtensionsInitializationFailedEvent = Omit<ExtensionsEvent, 'extensions'> & {
5077
+ type: 'extensions-initialization-failed';
5078
+ /**
5079
+ * The error that caused the extension initialization failure
5080
+ */
5081
+ error: Error;
5082
+ };
5083
+
5084
+ /**
5085
+ * An event that fires when extensions are installed in the security realm.
5086
+ *
5087
+ * @interface
5088
+ */
5089
+ declare type ExtensionsInstalledEvent = ExtensionsEvent & {
5090
+ type: 'extensions-installed';
5091
+ };
5092
+
5093
+ /**
5094
+ * An event that fires when extensions fail to install in the security realm.
5095
+ *
5096
+ * @interface
5097
+ */
5098
+ declare type ExtensionsInstallFailedEvent = ExtensionsEvent & {
5099
+ type: 'extensions-install-failed';
5100
+ };
5101
+
4971
5102
  /**
4972
5103
  * An ExternalApplication object representing native language adapter connections to the runtime. Allows
4973
5104
  * the developer to listen to {@link OpenFin.ExternalApplicationEvents external application events}.
@@ -9311,6 +9442,10 @@ declare type MutableViewOptions = {
9311
9442
  * @defaultValue 'enabled'
9312
9443
  */
9313
9444
  throttling: ViewThrottling;
9445
+ /**
9446
+ * {@inheritDoc ChromiumPolicies}
9447
+ */
9448
+ chromiumPolicies: ChromiumPolicies;
9314
9449
  };
9315
9450
 
9316
9451
  /**
@@ -9576,6 +9711,10 @@ declare type MutableWindowOptions = {
9576
9711
  * @remarks If `throttling` option is present, the `backgroundThrottling` option is completely ignored for windows.
9577
9712
  */
9578
9713
  throttling: WindowThrottling;
9714
+ /**
9715
+ * {@inheritDoc ChromiumPolicies}
9716
+ */
9717
+ chromiumPolicies: ChromiumPolicies;
9579
9718
  };
9580
9719
 
9581
9720
  declare type NackHandler = (payloadOrMessage: RuntimeErrorPayload | string) => void;
@@ -9796,8 +9935,11 @@ declare namespace OpenFin {
9796
9935
  ViewVisibilityOptions,
9797
9936
  WindowState,
9798
9937
  AutoplayPolicyOptions,
9938
+ ExcludeOptions,
9799
9939
  ConstWindowOptions,
9800
9940
  InheritableOptions,
9941
+ PolicyOptions,
9942
+ ChromiumPolicies,
9801
9943
  MutableWindowOptions,
9802
9944
  WorkspacePlatformOptions,
9803
9945
  WebRequestHeader,
@@ -10079,6 +10221,7 @@ declare namespace OpenFin {
10079
10221
  RoutingInfo,
10080
10222
  DownloadShelfOptions,
10081
10223
  ViewShowAtOptions,
10224
+ ExtensionInfo,
10082
10225
  ApplicationEvents,
10083
10226
  BaseEvents,
10084
10227
  ExternalApplicationEvents,
@@ -10280,6 +10423,10 @@ declare type PerDomainSettings = {
10280
10423
  * {@link ContentRedirect} in {@link WindowOptions} and {@link ViewOptions} will be **ignored**.
10281
10424
  */
10282
10425
  content?: ContentPermission;
10426
+ /**
10427
+ * {@inheritdoc ChromiumPolicies}
10428
+ */
10429
+ chromiumPolicies?: ChromiumPolicies;
10283
10430
  };
10284
10431
 
10285
10432
  /**
@@ -11815,6 +11962,12 @@ declare type PointTopLeft = {
11815
11962
  left: number;
11816
11963
  };
11817
11964
 
11965
+ /**
11966
+ * When set to `disable`, disables the policy
11967
+ * When set to `defer-to-group-policy`, respects Group Policy settings
11968
+ */
11969
+ declare type PolicyOptions = 'disable' | 'defer-to-group-policy';
11970
+
11818
11971
  declare type PopupBaseBehavior = 'close' | 'hide';
11819
11972
 
11820
11973
  declare type PopupBlurBehavior = 'modal' | PopupBaseBehavior;
@@ -12830,6 +12983,14 @@ declare interface ProtocolMap extends ProtocolMapBase {
12830
12983
  }, void>;
12831
12984
  'system-register-shutdown-handler': VoidCall;
12832
12985
  'get-permissions': GetterCall<any>;
12986
+ 'refresh-extensions': {
12987
+ request: void;
12988
+ response: string[] | undefined;
12989
+ };
12990
+ 'get-installed-extensions': {
12991
+ request: void;
12992
+ response: OpenFin.ExtensionInfo[];
12993
+ };
12833
12994
  'fdc3-add-context-listener': VoidCall;
12834
12995
  'fdc3-add-intent-listener': VoidCall;
12835
12996
  'fdc3-raise-intent': VoidCall;
@@ -13518,6 +13679,21 @@ declare type ScreenshotPrintOptions = {
13518
13679
  content: 'screenshot';
13519
13680
  };
13520
13681
 
13682
+ /**
13683
+ * An event generated when an application modifies the runtime in a way that affects all other applications in the
13684
+ * application runtime/security realm.
13685
+ */
13686
+ declare type SecurityRealmEvent = BaseEvent_9 & {
13687
+ /**
13688
+ * Config URL of the application that modified the security realm's extensions
13689
+ */
13690
+ configUrl: string;
13691
+ /**
13692
+ * Identity of the application that modified the security realm's extensions
13693
+ */
13694
+ applicationIdentity: OpenFin.ApplicationIdentity;
13695
+ };
13696
+
13521
13697
  declare type SendActionResponse<T extends keyof ProtocolMap> = Message<{
13522
13698
  data: ProtocolMap[T]['response'];
13523
13699
  } & ProtocolMap[T]['specialResponse']>;
@@ -15415,6 +15591,16 @@ declare class System extends EmitterBase<OpenFin.SystemEvent> {
15415
15591
  * ```
15416
15592
  */
15417
15593
  setDomainSettings(domainSettings: OpenFin.DefaultDomainSettings): Promise<void>;
15594
+ /**
15595
+ * Attempts to install and enable extensions for the security realm. Users may want to call this function in response
15596
+ * to an `extensions-install-failed` event. Only extensions allowed by every application on the current security realm
15597
+ * will be installed/enabled.
15598
+ */
15599
+ refreshExtensions(): Promise<string[] | undefined>;
15600
+ /**
15601
+ * Gets the currently-installed
15602
+ */
15603
+ getInstalledExtensions(): Promise<OpenFin.ExtensionInfo[]>;
15418
15604
  }
15419
15605
 
15420
15606
  /**
@@ -15445,6 +15631,14 @@ declare namespace SystemEvents {
15445
15631
  ApplicationCreatedEvent,
15446
15632
  DesktopIconClickedEvent,
15447
15633
  SystemShutdownEvent,
15634
+ ExtensionsEnabledEvent,
15635
+ ExtensionsDisabledEvent,
15636
+ ExtensionsExcludedEvent,
15637
+ ExtensionsInstalledEvent,
15638
+ ExtensionInstalledEvent,
15639
+ ExtensionsInstallFailedEvent,
15640
+ ExtensionInstallFailedEvent,
15641
+ ExtensionsInitializationFailedEvent,
15448
15642
  Event_11 as Event,
15449
15643
  SystemEvent,
15450
15644
  EventType_8 as EventType,
@@ -16776,6 +16970,9 @@ declare class ViewModule extends Base {
16776
16970
  */
16777
16971
  declare type ViewOptions = ConstViewOptions & MutableViewOptions;
16778
16972
 
16973
+ /**
16974
+ * @interface
16975
+ */
16779
16976
  declare type ViewShowAtOptions = {
16780
16977
  /**
16781
16978
  * Sets the view as the top level view. See {@link OpenFin.View.bringToFront} for more information.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@openfin/fdc3-api",
3
- "version": "39.83.5",
3
+ "version": "39.83.7",
4
4
  "description": "OpenFin fdc3 module utilities and types.",
5
5
  "license": "SEE LICENSE IN LICENSE.MD",
6
6
  "private": false,