@openfin/core 36.79.4 → 36.79.9

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.
@@ -97,7 +97,10 @@ declare type Api = {
97
97
  enableDeprecatedSharedName?: boolean;
98
98
  };
99
99
  /**
100
- * Prevent fin API injection. If 'none', `fin` won't be available in this context.
100
+ * Configure injection of the `fin` API in this context.
101
+ *
102
+ * * 'none': The `fin` API will be not available in this context.
103
+ * * 'global': The entire `fin` API will be available in this context.
101
104
  */
102
105
  fin?: InjectionType;
103
106
  };
@@ -113,8 +116,18 @@ declare type ApiClient<T extends Record<any, any>> = {
113
116
 
114
117
  /**
115
118
  * @interface
119
+ *
120
+ * Rules for domain-conditional `fin` API injection.
116
121
  */
117
122
  declare type ApiInjection = {
123
+ /**
124
+ * Injection setting for the `fin` API for contexts on a matched domain.
125
+ *
126
+ * * 'none': The `fin` API will be not available.
127
+ * * 'global': The entire `fin` API will be available.
128
+ *
129
+ * @defaultValue 'global'
130
+ */
118
131
  fin: InjectionType;
119
132
  };
120
133
 
@@ -1712,7 +1725,7 @@ declare type BaseConfig = {
1712
1725
  */
1713
1726
  declare type BaseContentCreationRule = {
1714
1727
  /**
1715
- * List of [match patterns](https://developer.chrome.com/extensions/match_patterns) that indicate the specified
1728
+ * List of [match patterns](https://developer.chrome.com/docs/extensions/develop/concepts/match-patterns) that indicate the specified
1716
1729
  * behavior should be used
1717
1730
  */
1718
1731
  match: MatchPattern[];
@@ -3608,13 +3621,13 @@ declare type ConstWindowOptions = {
3608
3621
  /**
3609
3622
  * Restrict navigation to URLs that match an allowed pattern.
3610
3623
  * In the lack of an allowlist, navigation to URLs that match a denied pattern would be prohibited.
3611
- * See [here](https://developer.chrome.com/extensions/match_patterns) for more details.
3624
+ * See [here](https://developer.chrome.com/docs/extensions/develop/concepts/match-patterns) for more details.
3612
3625
  */
3613
3626
  contentNavigation: ContentNavigation;
3614
3627
  /**
3615
3628
  * Restrict redirects to URLs that match an allowed pattern.
3616
3629
  * In the lack of an allowlist, redirects to URLs that match a denied pattern would be prohibited.
3617
- * See [here](https://developer.chrome.com/extensions/match_patterns) for more details.
3630
+ * See [here](https://developer.chrome.com/docs/extensions/develop/concepts/match-patterns) for more details.
3618
3631
  */
3619
3632
  contentRedirect: Partial<ContentRedirect>;
3620
3633
  /**
@@ -4159,7 +4172,7 @@ declare interface ContentItem extends EventEmitter_2 {
4159
4172
  /**
4160
4173
  * Restrict navigation to URLs that match an allowed pattern.
4161
4174
  * In the lack of an allowlist, navigation to URLs that match a denied pattern would be prohibited.
4162
- * See [here](https://developer.chrome.com/extensions/match_patterns) for more details.
4175
+ * See [here](https://developer.chrome.com/docs/extensions/develop/concepts/match-patterns) for more details.
4163
4176
  *
4164
4177
  * @interface
4165
4178
  */
@@ -4168,7 +4181,7 @@ declare type ContentNavigation = NavigationRules;
4168
4181
  /**
4169
4182
  * Restrict redirects to URLs that match an allowed pattern.
4170
4183
  * In the lack of an allowlist, redirects to URLs that match a denied pattern would be prohibited.
4171
- * See [here](https://developer.chrome.com/extensions/match_patterns) for more details.
4184
+ * See [here](https://developer.chrome.com/docs/extensions/develop/concepts/match-patterns) for more details.
4172
4185
  *
4173
4186
  * @interface
4174
4187
  */
@@ -4772,19 +4785,42 @@ declare type DisplayMetadata_3 = {
4772
4785
 
4773
4786
  /**
4774
4787
  * @interface
4775
- * Define the {@link https://developers.openfin.co/of-docs/docs/file-download#manifest-properties-for-file-downloads file download rules} and domain-based api injection rules.
4788
+ * Defines application settings that vary by the domain of the current context.
4789
+ *
4790
+ * @remarks Only the first rule in the array that matches the current URL is applied. Multiple behaviors for the same
4791
+ * domain should be represented with a single rule.
4776
4792
  */
4777
4793
  declare type DomainSettings = {
4794
+ /**
4795
+ * {@inheritDoc DomainSettingsRule}
4796
+ */
4778
4797
  rules: DomainSettingsRule[];
4779
4798
  };
4780
4799
 
4781
4800
  /**
4782
4801
  * @interface
4802
+ *
4803
+ * Defines domain-conditional settings for an OpenFin application.
4783
4804
  */
4784
4805
  declare type DomainSettingsRule = {
4806
+ /**
4807
+ * Array of [match patterns](https://developer.chrome.com/docs/extensions/develop/concepts/match-patterns) specifying
4808
+ * the domain(s) for which the rule applies.
4809
+ */
4785
4810
  match: string[];
4811
+ /**
4812
+ * Settings applied when a webcontents has been navigated to a matched domain.
4813
+ */
4786
4814
  options: {
4815
+ /**
4816
+ * {@inheritDoc FileDownloadSettings}
4817
+ *
4818
+ * @remarks See: https://developers.openfin.co/of-docs/docs/file-download#manifest-properties-for-file-downloads
4819
+ */
4787
4820
  downloadSettings?: FileDownloadSettings;
4821
+ /**
4822
+ * {@inheritDoc ApiInjection}
4823
+ */
4788
4824
  api?: ApiInjection;
4789
4825
  };
4790
4826
  };
@@ -4823,9 +4859,20 @@ declare type DownloadPreloadOption = {
4823
4859
 
4824
4860
  /**
4825
4861
  * @interface
4862
+ *
4863
+ * A rule governing domain-conditional download behavior.
4826
4864
  */
4827
4865
  declare type DownloadRule = {
4866
+ /**
4867
+ * {@inheritDoc FileDownloadBehaviorNames}
4868
+ */
4828
4869
  behavior: FileDownloadBehaviorNames;
4870
+ /**
4871
+ * Array of [match patterns](https://developer.chrome.com/docs/extensions/develop/concepts/match-patterns) specifying
4872
+ * the domain(s) for which the rule applies.
4873
+ *
4874
+ * @remarks The match is evaluated against the URL of the *download*.
4875
+ */
4829
4876
  match: string[];
4830
4877
  };
4831
4878
 
@@ -5521,6 +5568,9 @@ declare type FetchManifestPayload = {
5521
5568
  manifestUrl: string;
5522
5569
  };
5523
5570
 
5571
+ /**
5572
+ * Whether file downloads raise a user prompt.
5573
+ */
5524
5574
  declare type FileDownloadBehaviorNames = 'prompt' | 'no-prompt';
5525
5575
 
5526
5576
  /**
@@ -5603,9 +5653,14 @@ declare type FileDownloadProgressEvent = FileDownloadEvent & {
5603
5653
  };
5604
5654
 
5605
5655
  /**
5606
- * @interface
5656
+ * Domain-conditional rules for file downloads.
5657
+ *
5658
+ * @remarks See: https://developers.openfin.co/of-docs/docs/file-download#manifest-properties-for-file-downloads
5607
5659
  */
5608
5660
  declare type FileDownloadSettings = {
5661
+ /**
5662
+ * {@inheritDoc DownloadRule}
5663
+ */
5609
5664
  rules: DownloadRule[];
5610
5665
  };
5611
5666
 
@@ -6670,9 +6725,10 @@ declare type InitPlatformOptions = {
6670
6725
  };
6671
6726
 
6672
6727
  /**
6673
- * * 'none': The `fin` API will be not available from within this context.
6674
- * * 'global': The entire `fin` API will be available from within this context.
6675
- * @defaultValue 'global'
6728
+ * Injection setting for the `fin` API.
6729
+ *
6730
+ * * 'none': The `fin` API will be not available.
6731
+ * * 'global': The entire `fin` API will be available.
6676
6732
  */
6677
6733
  declare type InjectionType = 'none' | 'global';
6678
6734
 
@@ -9373,7 +9429,7 @@ declare type MutableViewOptions = {
9373
9429
  /**
9374
9430
  * Restrict navigation to URLs that match an allowed pattern.
9375
9431
  * In the lack of an allowlist, navigation to URLs that match a denylisted pattern would be prohibited.
9376
- * See [here](https://developer.chrome.com/extensions/match_patterns) for more details.
9432
+ * See [here](https://developer.chrome.com/docs/extensions/develop/concepts/match-patterns) for more details.
9377
9433
  */
9378
9434
  contentNavigation: ContentNavigation;
9379
9435
  contentRedirect: ContentRedirect;
@@ -97,7 +97,10 @@ declare type Api = {
97
97
  enableDeprecatedSharedName?: boolean;
98
98
  };
99
99
  /**
100
- * Prevent fin API injection. If 'none', `fin` won't be available in this context.
100
+ * Configure injection of the `fin` API in this context.
101
+ *
102
+ * * 'none': The `fin` API will be not available in this context.
103
+ * * 'global': The entire `fin` API will be available in this context.
101
104
  */
102
105
  fin?: InjectionType;
103
106
  };
@@ -113,8 +116,18 @@ declare type ApiClient<T extends Record<any, any>> = {
113
116
 
114
117
  /**
115
118
  * @interface
119
+ *
120
+ * Rules for domain-conditional `fin` API injection.
116
121
  */
117
122
  declare type ApiInjection = {
123
+ /**
124
+ * Injection setting for the `fin` API for contexts on a matched domain.
125
+ *
126
+ * * 'none': The `fin` API will be not available.
127
+ * * 'global': The entire `fin` API will be available.
128
+ *
129
+ * @defaultValue 'global'
130
+ */
118
131
  fin: InjectionType;
119
132
  };
120
133
 
@@ -1712,7 +1725,7 @@ declare type BaseConfig = {
1712
1725
  */
1713
1726
  declare type BaseContentCreationRule = {
1714
1727
  /**
1715
- * List of [match patterns](https://developer.chrome.com/extensions/match_patterns) that indicate the specified
1728
+ * List of [match patterns](https://developer.chrome.com/docs/extensions/develop/concepts/match-patterns) that indicate the specified
1716
1729
  * behavior should be used
1717
1730
  */
1718
1731
  match: MatchPattern[];
@@ -3608,13 +3621,13 @@ declare type ConstWindowOptions = {
3608
3621
  /**
3609
3622
  * Restrict navigation to URLs that match an allowed pattern.
3610
3623
  * In the lack of an allowlist, navigation to URLs that match a denied pattern would be prohibited.
3611
- * See [here](https://developer.chrome.com/extensions/match_patterns) for more details.
3624
+ * See [here](https://developer.chrome.com/docs/extensions/develop/concepts/match-patterns) for more details.
3612
3625
  */
3613
3626
  contentNavigation: ContentNavigation;
3614
3627
  /**
3615
3628
  * Restrict redirects to URLs that match an allowed pattern.
3616
3629
  * In the lack of an allowlist, redirects to URLs that match a denied pattern would be prohibited.
3617
- * See [here](https://developer.chrome.com/extensions/match_patterns) for more details.
3630
+ * See [here](https://developer.chrome.com/docs/extensions/develop/concepts/match-patterns) for more details.
3618
3631
  */
3619
3632
  contentRedirect: Partial<ContentRedirect>;
3620
3633
  /**
@@ -4159,7 +4172,7 @@ declare interface ContentItem extends EventEmitter_2 {
4159
4172
  /**
4160
4173
  * Restrict navigation to URLs that match an allowed pattern.
4161
4174
  * In the lack of an allowlist, navigation to URLs that match a denied pattern would be prohibited.
4162
- * See [here](https://developer.chrome.com/extensions/match_patterns) for more details.
4175
+ * See [here](https://developer.chrome.com/docs/extensions/develop/concepts/match-patterns) for more details.
4163
4176
  *
4164
4177
  * @interface
4165
4178
  */
@@ -4168,7 +4181,7 @@ declare type ContentNavigation = NavigationRules;
4168
4181
  /**
4169
4182
  * Restrict redirects to URLs that match an allowed pattern.
4170
4183
  * In the lack of an allowlist, redirects to URLs that match a denied pattern would be prohibited.
4171
- * See [here](https://developer.chrome.com/extensions/match_patterns) for more details.
4184
+ * See [here](https://developer.chrome.com/docs/extensions/develop/concepts/match-patterns) for more details.
4172
4185
  *
4173
4186
  * @interface
4174
4187
  */
@@ -4772,19 +4785,42 @@ declare type DisplayMetadata_3 = {
4772
4785
 
4773
4786
  /**
4774
4787
  * @interface
4775
- * Define the {@link https://developers.openfin.co/of-docs/docs/file-download#manifest-properties-for-file-downloads file download rules} and domain-based api injection rules.
4788
+ * Defines application settings that vary by the domain of the current context.
4789
+ *
4790
+ * @remarks Only the first rule in the array that matches the current URL is applied. Multiple behaviors for the same
4791
+ * domain should be represented with a single rule.
4776
4792
  */
4777
4793
  declare type DomainSettings = {
4794
+ /**
4795
+ * {@inheritDoc DomainSettingsRule}
4796
+ */
4778
4797
  rules: DomainSettingsRule[];
4779
4798
  };
4780
4799
 
4781
4800
  /**
4782
4801
  * @interface
4802
+ *
4803
+ * Defines domain-conditional settings for an OpenFin application.
4783
4804
  */
4784
4805
  declare type DomainSettingsRule = {
4806
+ /**
4807
+ * Array of [match patterns](https://developer.chrome.com/docs/extensions/develop/concepts/match-patterns) specifying
4808
+ * the domain(s) for which the rule applies.
4809
+ */
4785
4810
  match: string[];
4811
+ /**
4812
+ * Settings applied when a webcontents has been navigated to a matched domain.
4813
+ */
4786
4814
  options: {
4815
+ /**
4816
+ * {@inheritDoc FileDownloadSettings}
4817
+ *
4818
+ * @remarks See: https://developers.openfin.co/of-docs/docs/file-download#manifest-properties-for-file-downloads
4819
+ */
4787
4820
  downloadSettings?: FileDownloadSettings;
4821
+ /**
4822
+ * {@inheritDoc ApiInjection}
4823
+ */
4788
4824
  api?: ApiInjection;
4789
4825
  };
4790
4826
  };
@@ -4823,9 +4859,20 @@ declare type DownloadPreloadOption = {
4823
4859
 
4824
4860
  /**
4825
4861
  * @interface
4862
+ *
4863
+ * A rule governing domain-conditional download behavior.
4826
4864
  */
4827
4865
  declare type DownloadRule = {
4866
+ /**
4867
+ * {@inheritDoc FileDownloadBehaviorNames}
4868
+ */
4828
4869
  behavior: FileDownloadBehaviorNames;
4870
+ /**
4871
+ * Array of [match patterns](https://developer.chrome.com/docs/extensions/develop/concepts/match-patterns) specifying
4872
+ * the domain(s) for which the rule applies.
4873
+ *
4874
+ * @remarks The match is evaluated against the URL of the *download*.
4875
+ */
4829
4876
  match: string[];
4830
4877
  };
4831
4878
 
@@ -5521,6 +5568,9 @@ declare type FetchManifestPayload = {
5521
5568
  manifestUrl: string;
5522
5569
  };
5523
5570
 
5571
+ /**
5572
+ * Whether file downloads raise a user prompt.
5573
+ */
5524
5574
  declare type FileDownloadBehaviorNames = 'prompt' | 'no-prompt';
5525
5575
 
5526
5576
  /**
@@ -5603,9 +5653,14 @@ declare type FileDownloadProgressEvent = FileDownloadEvent & {
5603
5653
  };
5604
5654
 
5605
5655
  /**
5606
- * @interface
5656
+ * Domain-conditional rules for file downloads.
5657
+ *
5658
+ * @remarks See: https://developers.openfin.co/of-docs/docs/file-download#manifest-properties-for-file-downloads
5607
5659
  */
5608
5660
  declare type FileDownloadSettings = {
5661
+ /**
5662
+ * {@inheritDoc DownloadRule}
5663
+ */
5609
5664
  rules: DownloadRule[];
5610
5665
  };
5611
5666
 
@@ -6670,9 +6725,10 @@ declare type InitPlatformOptions = {
6670
6725
  };
6671
6726
 
6672
6727
  /**
6673
- * * 'none': The `fin` API will be not available from within this context.
6674
- * * 'global': The entire `fin` API will be available from within this context.
6675
- * @defaultValue 'global'
6728
+ * Injection setting for the `fin` API.
6729
+ *
6730
+ * * 'none': The `fin` API will be not available.
6731
+ * * 'global': The entire `fin` API will be available.
6676
6732
  */
6677
6733
  declare type InjectionType = 'none' | 'global';
6678
6734
 
@@ -9373,7 +9429,7 @@ declare type MutableViewOptions = {
9373
9429
  /**
9374
9430
  * Restrict navigation to URLs that match an allowed pattern.
9375
9431
  * In the lack of an allowlist, navigation to URLs that match a denylisted pattern would be prohibited.
9376
- * See [here](https://developer.chrome.com/extensions/match_patterns) for more details.
9432
+ * See [here](https://developer.chrome.com/docs/extensions/develop/concepts/match-patterns) for more details.
9377
9433
  */
9378
9434
  contentNavigation: ContentNavigation;
9379
9435
  contentRedirect: ContentRedirect;
@@ -97,7 +97,10 @@ declare type Api = {
97
97
  enableDeprecatedSharedName?: boolean;
98
98
  };
99
99
  /**
100
- * Prevent fin API injection. If 'none', `fin` won't be available in this context.
100
+ * Configure injection of the `fin` API in this context.
101
+ *
102
+ * * 'none': The `fin` API will be not available in this context.
103
+ * * 'global': The entire `fin` API will be available in this context.
101
104
  */
102
105
  fin?: InjectionType;
103
106
  };
@@ -113,8 +116,18 @@ declare type ApiClient<T extends Record<any, any>> = {
113
116
 
114
117
  /**
115
118
  * @interface
119
+ *
120
+ * Rules for domain-conditional `fin` API injection.
116
121
  */
117
122
  declare type ApiInjection = {
123
+ /**
124
+ * Injection setting for the `fin` API for contexts on a matched domain.
125
+ *
126
+ * * 'none': The `fin` API will be not available.
127
+ * * 'global': The entire `fin` API will be available.
128
+ *
129
+ * @defaultValue 'global'
130
+ */
118
131
  fin: InjectionType;
119
132
  };
120
133
 
@@ -1712,7 +1725,7 @@ declare type BaseConfig = {
1712
1725
  */
1713
1726
  declare type BaseContentCreationRule = {
1714
1727
  /**
1715
- * List of [match patterns](https://developer.chrome.com/extensions/match_patterns) that indicate the specified
1728
+ * List of [match patterns](https://developer.chrome.com/docs/extensions/develop/concepts/match-patterns) that indicate the specified
1716
1729
  * behavior should be used
1717
1730
  */
1718
1731
  match: MatchPattern[];
@@ -3608,13 +3621,13 @@ declare type ConstWindowOptions = {
3608
3621
  /**
3609
3622
  * Restrict navigation to URLs that match an allowed pattern.
3610
3623
  * In the lack of an allowlist, navigation to URLs that match a denied pattern would be prohibited.
3611
- * See [here](https://developer.chrome.com/extensions/match_patterns) for more details.
3624
+ * See [here](https://developer.chrome.com/docs/extensions/develop/concepts/match-patterns) for more details.
3612
3625
  */
3613
3626
  contentNavigation: ContentNavigation;
3614
3627
  /**
3615
3628
  * Restrict redirects to URLs that match an allowed pattern.
3616
3629
  * In the lack of an allowlist, redirects to URLs that match a denied pattern would be prohibited.
3617
- * See [here](https://developer.chrome.com/extensions/match_patterns) for more details.
3630
+ * See [here](https://developer.chrome.com/docs/extensions/develop/concepts/match-patterns) for more details.
3618
3631
  */
3619
3632
  contentRedirect: Partial<ContentRedirect>;
3620
3633
  /**
@@ -4159,7 +4172,7 @@ declare interface ContentItem extends EventEmitter_2 {
4159
4172
  /**
4160
4173
  * Restrict navigation to URLs that match an allowed pattern.
4161
4174
  * In the lack of an allowlist, navigation to URLs that match a denied pattern would be prohibited.
4162
- * See [here](https://developer.chrome.com/extensions/match_patterns) for more details.
4175
+ * See [here](https://developer.chrome.com/docs/extensions/develop/concepts/match-patterns) for more details.
4163
4176
  *
4164
4177
  * @interface
4165
4178
  */
@@ -4168,7 +4181,7 @@ declare type ContentNavigation = NavigationRules;
4168
4181
  /**
4169
4182
  * Restrict redirects to URLs that match an allowed pattern.
4170
4183
  * In the lack of an allowlist, redirects to URLs that match a denied pattern would be prohibited.
4171
- * See [here](https://developer.chrome.com/extensions/match_patterns) for more details.
4184
+ * See [here](https://developer.chrome.com/docs/extensions/develop/concepts/match-patterns) for more details.
4172
4185
  *
4173
4186
  * @interface
4174
4187
  */
@@ -4772,19 +4785,42 @@ declare type DisplayMetadata_3 = {
4772
4785
 
4773
4786
  /**
4774
4787
  * @interface
4775
- * Define the {@link https://developers.openfin.co/of-docs/docs/file-download#manifest-properties-for-file-downloads file download rules} and domain-based api injection rules.
4788
+ * Defines application settings that vary by the domain of the current context.
4789
+ *
4790
+ * @remarks Only the first rule in the array that matches the current URL is applied. Multiple behaviors for the same
4791
+ * domain should be represented with a single rule.
4776
4792
  */
4777
4793
  declare type DomainSettings = {
4794
+ /**
4795
+ * {@inheritDoc DomainSettingsRule}
4796
+ */
4778
4797
  rules: DomainSettingsRule[];
4779
4798
  };
4780
4799
 
4781
4800
  /**
4782
4801
  * @interface
4802
+ *
4803
+ * Defines domain-conditional settings for an OpenFin application.
4783
4804
  */
4784
4805
  declare type DomainSettingsRule = {
4806
+ /**
4807
+ * Array of [match patterns](https://developer.chrome.com/docs/extensions/develop/concepts/match-patterns) specifying
4808
+ * the domain(s) for which the rule applies.
4809
+ */
4785
4810
  match: string[];
4811
+ /**
4812
+ * Settings applied when a webcontents has been navigated to a matched domain.
4813
+ */
4786
4814
  options: {
4815
+ /**
4816
+ * {@inheritDoc FileDownloadSettings}
4817
+ *
4818
+ * @remarks See: https://developers.openfin.co/of-docs/docs/file-download#manifest-properties-for-file-downloads
4819
+ */
4787
4820
  downloadSettings?: FileDownloadSettings;
4821
+ /**
4822
+ * {@inheritDoc ApiInjection}
4823
+ */
4788
4824
  api?: ApiInjection;
4789
4825
  };
4790
4826
  };
@@ -4823,9 +4859,20 @@ declare type DownloadPreloadOption = {
4823
4859
 
4824
4860
  /**
4825
4861
  * @interface
4862
+ *
4863
+ * A rule governing domain-conditional download behavior.
4826
4864
  */
4827
4865
  declare type DownloadRule = {
4866
+ /**
4867
+ * {@inheritDoc FileDownloadBehaviorNames}
4868
+ */
4828
4869
  behavior: FileDownloadBehaviorNames;
4870
+ /**
4871
+ * Array of [match patterns](https://developer.chrome.com/docs/extensions/develop/concepts/match-patterns) specifying
4872
+ * the domain(s) for which the rule applies.
4873
+ *
4874
+ * @remarks The match is evaluated against the URL of the *download*.
4875
+ */
4829
4876
  match: string[];
4830
4877
  };
4831
4878
 
@@ -5521,6 +5568,9 @@ declare type FetchManifestPayload = {
5521
5568
  manifestUrl: string;
5522
5569
  };
5523
5570
 
5571
+ /**
5572
+ * Whether file downloads raise a user prompt.
5573
+ */
5524
5574
  declare type FileDownloadBehaviorNames = 'prompt' | 'no-prompt';
5525
5575
 
5526
5576
  /**
@@ -5603,9 +5653,14 @@ declare type FileDownloadProgressEvent = FileDownloadEvent & {
5603
5653
  };
5604
5654
 
5605
5655
  /**
5606
- * @interface
5656
+ * Domain-conditional rules for file downloads.
5657
+ *
5658
+ * @remarks See: https://developers.openfin.co/of-docs/docs/file-download#manifest-properties-for-file-downloads
5607
5659
  */
5608
5660
  declare type FileDownloadSettings = {
5661
+ /**
5662
+ * {@inheritDoc DownloadRule}
5663
+ */
5609
5664
  rules: DownloadRule[];
5610
5665
  };
5611
5666
 
@@ -6670,9 +6725,10 @@ declare type InitPlatformOptions = {
6670
6725
  };
6671
6726
 
6672
6727
  /**
6673
- * * 'none': The `fin` API will be not available from within this context.
6674
- * * 'global': The entire `fin` API will be available from within this context.
6675
- * @defaultValue 'global'
6728
+ * Injection setting for the `fin` API.
6729
+ *
6730
+ * * 'none': The `fin` API will be not available.
6731
+ * * 'global': The entire `fin` API will be available.
6676
6732
  */
6677
6733
  declare type InjectionType = 'none' | 'global';
6678
6734
 
@@ -9373,7 +9429,7 @@ declare type MutableViewOptions = {
9373
9429
  /**
9374
9430
  * Restrict navigation to URLs that match an allowed pattern.
9375
9431
  * In the lack of an allowlist, navigation to URLs that match a denylisted pattern would be prohibited.
9376
- * See [here](https://developer.chrome.com/extensions/match_patterns) for more details.
9432
+ * See [here](https://developer.chrome.com/docs/extensions/develop/concepts/match-patterns) for more details.
9377
9433
  */
9378
9434
  contentNavigation: ContentNavigation;
9379
9435
  contentRedirect: ContentRedirect;
package/out/mock.d.ts CHANGED
@@ -97,7 +97,10 @@ declare type Api = {
97
97
  enableDeprecatedSharedName?: boolean;
98
98
  };
99
99
  /**
100
- * Prevent fin API injection. If 'none', `fin` won't be available in this context.
100
+ * Configure injection of the `fin` API in this context.
101
+ *
102
+ * * 'none': The `fin` API will be not available in this context.
103
+ * * 'global': The entire `fin` API will be available in this context.
101
104
  */
102
105
  fin?: InjectionType;
103
106
  };
@@ -113,8 +116,18 @@ declare type ApiClient<T extends Record<any, any>> = {
113
116
 
114
117
  /**
115
118
  * @interface
119
+ *
120
+ * Rules for domain-conditional `fin` API injection.
116
121
  */
117
122
  declare type ApiInjection = {
123
+ /**
124
+ * Injection setting for the `fin` API for contexts on a matched domain.
125
+ *
126
+ * * 'none': The `fin` API will be not available.
127
+ * * 'global': The entire `fin` API will be available.
128
+ *
129
+ * @defaultValue 'global'
130
+ */
118
131
  fin: InjectionType;
119
132
  };
120
133
 
@@ -1732,7 +1745,7 @@ declare type BaseConfig = {
1732
1745
  */
1733
1746
  declare type BaseContentCreationRule = {
1734
1747
  /**
1735
- * List of [match patterns](https://developer.chrome.com/extensions/match_patterns) that indicate the specified
1748
+ * List of [match patterns](https://developer.chrome.com/docs/extensions/develop/concepts/match-patterns) that indicate the specified
1736
1749
  * behavior should be used
1737
1750
  */
1738
1751
  match: MatchPattern[];
@@ -3651,13 +3664,13 @@ declare type ConstWindowOptions = {
3651
3664
  /**
3652
3665
  * Restrict navigation to URLs that match an allowed pattern.
3653
3666
  * In the lack of an allowlist, navigation to URLs that match a denied pattern would be prohibited.
3654
- * See [here](https://developer.chrome.com/extensions/match_patterns) for more details.
3667
+ * See [here](https://developer.chrome.com/docs/extensions/develop/concepts/match-patterns) for more details.
3655
3668
  */
3656
3669
  contentNavigation: ContentNavigation;
3657
3670
  /**
3658
3671
  * Restrict redirects to URLs that match an allowed pattern.
3659
3672
  * In the lack of an allowlist, redirects to URLs that match a denied pattern would be prohibited.
3660
- * See [here](https://developer.chrome.com/extensions/match_patterns) for more details.
3673
+ * See [here](https://developer.chrome.com/docs/extensions/develop/concepts/match-patterns) for more details.
3661
3674
  */
3662
3675
  contentRedirect: Partial<ContentRedirect>;
3663
3676
  /**
@@ -4202,7 +4215,7 @@ declare interface ContentItem extends EventEmitter_2 {
4202
4215
  /**
4203
4216
  * Restrict navigation to URLs that match an allowed pattern.
4204
4217
  * In the lack of an allowlist, navigation to URLs that match a denied pattern would be prohibited.
4205
- * See [here](https://developer.chrome.com/extensions/match_patterns) for more details.
4218
+ * See [here](https://developer.chrome.com/docs/extensions/develop/concepts/match-patterns) for more details.
4206
4219
  *
4207
4220
  * @interface
4208
4221
  */
@@ -4211,7 +4224,7 @@ declare type ContentNavigation = NavigationRules;
4211
4224
  /**
4212
4225
  * Restrict redirects to URLs that match an allowed pattern.
4213
4226
  * In the lack of an allowlist, redirects to URLs that match a denied pattern would be prohibited.
4214
- * See [here](https://developer.chrome.com/extensions/match_patterns) for more details.
4227
+ * See [here](https://developer.chrome.com/docs/extensions/develop/concepts/match-patterns) for more details.
4215
4228
  *
4216
4229
  * @interface
4217
4230
  */
@@ -4815,19 +4828,42 @@ declare type DisplayMetadata_3 = {
4815
4828
 
4816
4829
  /**
4817
4830
  * @interface
4818
- * Define the {@link https://developers.openfin.co/of-docs/docs/file-download#manifest-properties-for-file-downloads file download rules} and domain-based api injection rules.
4831
+ * Defines application settings that vary by the domain of the current context.
4832
+ *
4833
+ * @remarks Only the first rule in the array that matches the current URL is applied. Multiple behaviors for the same
4834
+ * domain should be represented with a single rule.
4819
4835
  */
4820
4836
  declare type DomainSettings = {
4837
+ /**
4838
+ * {@inheritDoc DomainSettingsRule}
4839
+ */
4821
4840
  rules: DomainSettingsRule[];
4822
4841
  };
4823
4842
 
4824
4843
  /**
4825
4844
  * @interface
4845
+ *
4846
+ * Defines domain-conditional settings for an OpenFin application.
4826
4847
  */
4827
4848
  declare type DomainSettingsRule = {
4849
+ /**
4850
+ * Array of [match patterns](https://developer.chrome.com/docs/extensions/develop/concepts/match-patterns) specifying
4851
+ * the domain(s) for which the rule applies.
4852
+ */
4828
4853
  match: string[];
4854
+ /**
4855
+ * Settings applied when a webcontents has been navigated to a matched domain.
4856
+ */
4829
4857
  options: {
4858
+ /**
4859
+ * {@inheritDoc FileDownloadSettings}
4860
+ *
4861
+ * @remarks See: https://developers.openfin.co/of-docs/docs/file-download#manifest-properties-for-file-downloads
4862
+ */
4830
4863
  downloadSettings?: FileDownloadSettings;
4864
+ /**
4865
+ * {@inheritDoc ApiInjection}
4866
+ */
4831
4867
  api?: ApiInjection;
4832
4868
  };
4833
4869
  };
@@ -4866,9 +4902,20 @@ declare type DownloadPreloadOption = {
4866
4902
 
4867
4903
  /**
4868
4904
  * @interface
4905
+ *
4906
+ * A rule governing domain-conditional download behavior.
4869
4907
  */
4870
4908
  declare type DownloadRule = {
4909
+ /**
4910
+ * {@inheritDoc FileDownloadBehaviorNames}
4911
+ */
4871
4912
  behavior: FileDownloadBehaviorNames;
4913
+ /**
4914
+ * Array of [match patterns](https://developer.chrome.com/docs/extensions/develop/concepts/match-patterns) specifying
4915
+ * the domain(s) for which the rule applies.
4916
+ *
4917
+ * @remarks The match is evaluated against the URL of the *download*.
4918
+ */
4872
4919
  match: string[];
4873
4920
  };
4874
4921
 
@@ -5590,6 +5637,9 @@ declare type FetchManifestPayload = {
5590
5637
  manifestUrl: string;
5591
5638
  };
5592
5639
 
5640
+ /**
5641
+ * Whether file downloads raise a user prompt.
5642
+ */
5593
5643
  declare type FileDownloadBehaviorNames = 'prompt' | 'no-prompt';
5594
5644
 
5595
5645
  /**
@@ -5672,9 +5722,14 @@ declare type FileDownloadProgressEvent = FileDownloadEvent & {
5672
5722
  };
5673
5723
 
5674
5724
  /**
5675
- * @interface
5725
+ * Domain-conditional rules for file downloads.
5726
+ *
5727
+ * @remarks See: https://developers.openfin.co/of-docs/docs/file-download#manifest-properties-for-file-downloads
5676
5728
  */
5677
5729
  declare type FileDownloadSettings = {
5730
+ /**
5731
+ * {@inheritDoc DownloadRule}
5732
+ */
5678
5733
  rules: DownloadRule[];
5679
5734
  };
5680
5735
 
@@ -6748,9 +6803,10 @@ declare type InitPlatformOptions = {
6748
6803
  };
6749
6804
 
6750
6805
  /**
6751
- * * 'none': The `fin` API will be not available from within this context.
6752
- * * 'global': The entire `fin` API will be available from within this context.
6753
- * @defaultValue 'global'
6806
+ * Injection setting for the `fin` API.
6807
+ *
6808
+ * * 'none': The `fin` API will be not available.
6809
+ * * 'global': The entire `fin` API will be available.
6754
6810
  */
6755
6811
  declare type InjectionType = 'none' | 'global';
6756
6812
 
@@ -9650,7 +9706,7 @@ declare type MutableViewOptions = {
9650
9706
  /**
9651
9707
  * Restrict navigation to URLs that match an allowed pattern.
9652
9708
  * In the lack of an allowlist, navigation to URLs that match a denylisted pattern would be prohibited.
9653
- * See [here](https://developer.chrome.com/extensions/match_patterns) for more details.
9709
+ * See [here](https://developer.chrome.com/docs/extensions/develop/concepts/match-patterns) for more details.
9654
9710
  */
9655
9711
  contentNavigation: ContentNavigation;
9656
9712
  contentRedirect: ContentRedirect;
package/out/mock.js CHANGED
@@ -257,7 +257,7 @@ events.WindowEvents = WindowEvents;
257
257
  __exportStar(events, exports);
258
258
  } (OpenFin$1));
259
259
 
260
- var fin = {};
260
+ var fin$1 = {};
261
261
 
262
262
  var system = {};
263
263
 
@@ -12262,6 +12262,9 @@ class PlatformModule extends base_1$4.Base {
12262
12262
  * @experimental
12263
12263
  */
12264
12264
  async init(options) {
12265
+ if (!fin.__internal_.isPlatform || fin.me.name !== fin.me.uuid) {
12266
+ throw new Error('fin.Platform.init should only be called from a custom platform provider running in the main window of the application.');
12267
+ }
12265
12268
  return this.wire.environment.initPlatform(this.fin, options);
12266
12269
  }
12267
12270
  /**
@@ -15529,8 +15532,8 @@ Factory.SnapshotSourceModule = SnapshotSourceModule;
15529
15532
  __exportStar(Instance, exports);
15530
15533
  } (snapshotSource));
15531
15534
 
15532
- Object.defineProperty(fin, "__esModule", { value: true });
15533
- fin.Fin = void 0;
15535
+ Object.defineProperty(fin$1, "__esModule", { value: true });
15536
+ fin$1.Fin = void 0;
15534
15537
  const events_1$3 = require$$0;
15535
15538
  // Import from the file rather than the directory in case someone consuming types is using module resolution other than "node"
15536
15539
  const index_1 = system;
@@ -15576,7 +15579,7 @@ class Fin extends events_1$3.EventEmitter {
15576
15579
  });
15577
15580
  }
15578
15581
  }
15579
- fin.Fin = Fin;
15582
+ fin$1.Fin = Fin;
15580
15583
 
15581
15584
  var transport = {};
15582
15585
 
@@ -16028,7 +16031,7 @@ mockWire.MockWire = MockWire;
16028
16031
  Object.defineProperty(mock, "__esModule", { value: true });
16029
16032
  exports.fin = mock.fin = void 0;
16030
16033
  const OpenFin = OpenFin$1;
16031
- const fin_1 = fin;
16034
+ const fin_1 = fin$1;
16032
16035
  const transport_1 = transport;
16033
16036
  const mockEnvironment_1 = mockEnvironment;
16034
16037
  const mockWire_1 = mockWire;
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@openfin/core",
3
- "version": "36.79.4",
3
+ "version": "36.79.9",
4
4
  "description": "The core renderer entry point of OpenFin",
5
5
  "license": "SEE LICENSE IN LICENSE.md",
6
6
  "main": "out/mock.js",