@openfin/core 44.100.108 → 44.101.1

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.
@@ -88,7 +88,7 @@ declare type AlertRequestedEvent = BaseEvent_5 & {
88
88
  url: string;
89
89
  };
90
90
 
91
- declare type AnalyticsOnlyCalls = 'window-get-web-window' | 'layout-get-by-view-identity' | 'layout-get-stack-by-view' | 'layout-add-view' | 'layout-close-view' | 'view-get-parent-layout' | 'view-get-current-stack' | 'window-is-main-window' | 'window-get-parent-application' | 'window-get-parent-window' | 'window-create-window' | 'window-get-layout' | 'window-dispatch-popup-result' | `layout-controller-${string}`;
91
+ declare type AnalyticsOnlyCalls = 'layout-get-stack-by-view' | 'layout-add-view' | 'layout-close-view' | `layout-controller-${string}`;
92
92
 
93
93
  declare type AnalyticsProtocolMap = {
94
94
  [k in AnalyticsOnlyCalls]: VoidCall;
@@ -1757,6 +1757,7 @@ declare type BaseConfig = {
1757
1757
  devToolsPort?: number;
1758
1758
  installerUI?: boolean;
1759
1759
  runtime?: RuntimeConfig;
1760
+ apiDiagnostics?: boolean;
1760
1761
  appAssets?: [
1761
1762
  {
1762
1763
  src: string;
@@ -6643,6 +6644,16 @@ declare type IntentMetadata<TargetType = any> = {
6643
6644
  */
6644
6645
  declare class InterApplicationBus extends Base {
6645
6646
  Channel: Channel;
6647
+ /**
6648
+ * Event types for the InterApplicationBus.
6649
+ *
6650
+ * @remarks The `subscriber-added` and `subscriber-removed` events are disabled by default.
6651
+ * To re-enable them, launch the runtime with the `--emit-legacy-iab-events` flag.
6652
+ * These events will be removed in a future version. Use {@link Channel} for connection
6653
+ * lifecycle management instead.
6654
+ *
6655
+ * @deprecated Use {@link Channel} `onConnection` / `onDisconnection` instead.
6656
+ */
6646
6657
  events: {
6647
6658
  subscriberAdded: string;
6648
6659
  subscriberRemoved: string;
@@ -10317,6 +10328,9 @@ declare namespace OpenFin_2 {
10317
10328
  SystemProcessInfo,
10318
10329
  ClearCacheOption,
10319
10330
  ClearDataOptions,
10331
+ TraceConfig,
10332
+ TraceCategoriesAndOptions,
10333
+ TraceBufferUsage,
10320
10334
  CookieInfo,
10321
10335
  CookieOption,
10322
10336
  CrashReporterOptions,
@@ -12909,19 +12923,17 @@ declare type ProtocolMap = ExternalAdapterOnlyCallsMap & AnalyticsProtocolMap &
12909
12923
  response: OpenFin_2.MenuResult;
12910
12924
  };
12911
12925
  'close-tray-icon-popup-menu': IdentityCall<{}, void>;
12912
- 'wrap-application': VoidCall;
12913
- 'wrap-application-sync': VoidCall;
12914
12926
  'create-application': ApiCall<OpenFin_2.ApplicationCreationOptions, void>;
12915
- 'application-create': VoidCall;
12916
- 'start-application': VoidCall;
12917
12927
  'run-applications': ApiCall<{
12918
12928
  applications: Array<OpenFin_2.ManifestInfo>;
12919
12929
  opts?: OpenFin_2.RvmLaunchOptions;
12920
12930
  }, void>;
12921
- 'get-current-application': VoidCall;
12922
- 'get-current-application-sync': VoidCall;
12923
- 'application-start-from-manifest': VoidCall;
12924
- 'application-create-from-manifest': VoidCall;
12931
+ 'send-analytics-batch': {
12932
+ request: {
12933
+ counts: Record<string, number>;
12934
+ };
12935
+ response: void;
12936
+ };
12925
12937
  'request-external-authorization': {
12926
12938
  request: any;
12927
12939
  response: void;
@@ -13040,10 +13052,6 @@ declare type ProtocolMap = ExternalAdapterOnlyCallsMap & AnalyticsProtocolMap &
13040
13052
  options: OpenFin_2.UpdatableViewOptions;
13041
13053
  }>;
13042
13054
  'trigger-before-unload': IdentityCall<{}, boolean>;
13043
- 'view-wrap-sync': VoidCall;
13044
- 'view-wrap': VoidCall;
13045
- 'view-get-current': VoidCall;
13046
- 'view-get-current-sync': VoidCall;
13047
13055
  'animate-window': IdentityCall<{
13048
13056
  transitions: OpenFin_2.Transition;
13049
13057
  options: OpenFin_2.TransitionOptions;
@@ -13135,11 +13143,6 @@ declare type ProtocolMap = ExternalAdapterOnlyCallsMap & AnalyticsProtocolMap &
13135
13143
  };
13136
13144
  response: void;
13137
13145
  };
13138
- 'window-wrap': VoidCall;
13139
- 'window-wrap-sync': VoidCall;
13140
- 'create-window': VoidCall;
13141
- 'get-current-window': VoidCall;
13142
- 'get-current-window-sync': VoidCall;
13143
13146
  'show-download-bubble': IdentityCall<{
13144
13147
  anchor?: OpenFin_2.Anchor;
13145
13148
  }, void>;
@@ -13147,14 +13150,8 @@ declare type ProtocolMap = ExternalAdapterOnlyCallsMap & AnalyticsProtocolMap &
13147
13150
  anchor: OpenFin_2.Anchor;
13148
13151
  }, void>;
13149
13152
  'get-external-application-info': ApiCall<OpenFin_2.ApplicationIdentity, OpenFin_2.ExternalApplicationInfo>;
13150
- 'external-application-wrap': VoidCall;
13151
- 'external-application-wrap-sync': VoidCall;
13152
13153
  'get-frame-info': ApiCall<OpenFin_2.Identity, OpenFin_2.FrameInfo>;
13153
13154
  'get-parent-window': ApiCall<OpenFin_2.Identity, OpenFin_2.FrameInfo>;
13154
- 'frame-wrap': VoidCall;
13155
- 'frame-wrap-sync': VoidCall;
13156
- 'frame-get-current': VoidCall;
13157
- 'frame-get-current-sync': VoidCall;
13158
13155
  'global-hotkey-register': {
13159
13156
  request: {
13160
13157
  hotkey: string;
@@ -13247,6 +13244,12 @@ declare type ProtocolMap = ExternalAdapterOnlyCallsMap & AnalyticsProtocolMap &
13247
13244
  }, OpenFin_2.NativeTheme>;
13248
13245
  'get-theme-preferences': GetterCall<OpenFin_2.NativeTheme>;
13249
13246
  'get-version': GetterCall<string>;
13247
+ 'content-tracing-get-categories': GetterCall<string[]>;
13248
+ 'content-tracing-start-recording': ApiCall<{
13249
+ options: OpenFin_2.TraceConfig | OpenFin_2.TraceCategoriesAndOptions;
13250
+ }, void>;
13251
+ 'content-tracing-stop-recording': GetterCall<string>;
13252
+ 'content-tracing-get-trace-buffer-usage': GetterCall<OpenFin_2.TraceBufferUsage>;
13250
13253
  'clear-cache': ApiCall<OpenFin_2.ClearCacheOption, void>;
13251
13254
  'clear-http-cache': VoidCall;
13252
13255
  'clear-cache-data': ApiCall<OpenFin_2.ClearDataOptions, void>;
@@ -13491,7 +13494,6 @@ declare type ProtocolMap = ExternalAdapterOnlyCallsMap & AnalyticsProtocolMap &
13491
13494
  apiPath: '.resolveDomainSettings';
13492
13495
  namespace: 'System';
13493
13496
  };
13494
- 'system-register-shutdown-handler': VoidCall;
13495
13497
  'get-permissions': GetterCall<any>;
13496
13498
  'refresh-extensions': {
13497
13499
  request: void;
@@ -13510,24 +13512,6 @@ declare type ProtocolMap = ExternalAdapterOnlyCallsMap & AnalyticsProtocolMap &
13510
13512
  request: void;
13511
13513
  response: Array<OpenFin_2.ThemePalette>;
13512
13514
  };
13513
- 'fdc3-add-context-listener': VoidCall;
13514
- 'fdc3-add-intent-listener': VoidCall;
13515
- 'fdc3-raise-intent': VoidCall;
13516
- 'fdc3-find-intent': VoidCall;
13517
- 'fdc3-find-intents-by-context': VoidCall;
13518
- 'fdc3-raise-intent-for-context': VoidCall;
13519
- 'fdc3-get-info': VoidCall;
13520
- 'fdc3-find-instances': VoidCall;
13521
- 'fdc3-get-app-metadata': VoidCall;
13522
- 'fdc3-broadcast': VoidCall;
13523
- 'fdc3-open': VoidCall;
13524
- 'fdc3-get-or-create-channel': VoidCall;
13525
- 'fdc3-get-system-channels': VoidCall;
13526
- 'fdc3-join-channel': VoidCall;
13527
- 'fdc3-get-current-channel': VoidCall;
13528
- 'fdc3-leave-current-channel': VoidCall;
13529
- 'interop-init': VoidCall;
13530
- 'interop-connect-sync': VoidCall;
13531
13515
  'interop-client-set-context': VoidCall;
13532
13516
  'interop-client-add-context-handler': VoidCall;
13533
13517
  'interop-client-get-context-groups': VoidCall;
@@ -13558,12 +13542,6 @@ declare type ProtocolMap = ExternalAdapterOnlyCallsMap & AnalyticsProtocolMap &
13558
13542
  'interop-session-context-group-set-context': VoidCall;
13559
13543
  'interop-session-context-group-get-context': VoidCall;
13560
13544
  'interop-session-context-group-add-handler': VoidCall;
13561
- 'platform-wrap': VoidCall;
13562
- 'platform-wrap-sync': VoidCall;
13563
- 'platform-get-current': VoidCall;
13564
- 'platform-get-current-sync': VoidCall;
13565
- 'platform-start': VoidCall;
13566
- 'platform-start-from-manifest': VoidCall;
13567
13545
  'platform-get-client': ApplicationIdentityCall<{}, void>;
13568
13546
  'platform-create-view': ApplicationIdentityCall<{}, void>;
13569
13547
  'platform-create-window': ApplicationIdentityCall<{}, void>;
@@ -13576,11 +13554,6 @@ declare type ProtocolMap = ExternalAdapterOnlyCallsMap & AnalyticsProtocolMap &
13576
13554
  'platform-set-window-context': ApplicationIdentityCall<{}, void>;
13577
13555
  'platform-get-window-context': ApplicationIdentityCall<{}, void>;
13578
13556
  'platform-close-window': ApplicationIdentityCall<{}, void>;
13579
- 'layout-wrap': VoidCall;
13580
- 'layout-wrap-sync': VoidCall;
13581
- 'layout-get-current': VoidCall;
13582
- 'layout-get-current-sync': VoidCall;
13583
- 'layout-init': VoidCall;
13584
13557
  'layout-get-config': VoidCall;
13585
13558
  'layout-get-views': VoidCall;
13586
13559
  'layout-replace': VoidCall;
@@ -13599,12 +13572,6 @@ declare type ProtocolMap = ExternalAdapterOnlyCallsMap & AnalyticsProtocolMap &
13599
13572
  'layout-controller-create-adjacent-stack': VoidCall;
13600
13573
  'layout-controller-get-adjacent-stacks': VoidCall;
13601
13574
  'layout-controller-set-stack-active-view': VoidCall;
13602
- 'snapshot-source-init': VoidCall;
13603
- 'snapshot-source-wrap-sync': VoidCall;
13604
- 'snapshot-source-wrap': VoidCall;
13605
- 'snapshot-source-ready': VoidCall;
13606
- 'snapshot-source-get-snapshot': VoidCall;
13607
- 'snapshot-source-apply-snapshot': VoidCall;
13608
13575
  'capture-page': IdentityCall<{
13609
13576
  options?: OpenFin_2.CapturePageOptions;
13610
13577
  }, string>;
@@ -14836,6 +14803,10 @@ declare type SubscriptionOptions = {
14836
14803
  *
14837
14804
  */
14838
14805
  declare class System extends EmitterBase<OpenFin_2.SystemEvent> {
14806
+ /**
14807
+ * Chromium content tracing APIs.
14808
+ */
14809
+ readonly ContentTracing: SystemContentTracing;
14839
14810
  /* Excluded from this release type: __constructor */
14840
14811
  private sendExternalProcessRequest;
14841
14812
  /**
@@ -16469,6 +16440,36 @@ declare class System extends EmitterBase<OpenFin_2.SystemEvent> {
16469
16440
  getThemePalette(): Promise<Array<OpenFin_2.ThemePalette>>;
16470
16441
  }
16471
16442
 
16443
+ /**
16444
+ * Chromium content tracing APIs exposed under `fin.System.ContentTracing`.
16445
+ */
16446
+ declare class SystemContentTracing extends Base {
16447
+ /**
16448
+ * Gets the currently known tracing category groups.
16449
+ */
16450
+ getCategories(): Promise<string[]>;
16451
+ /**
16452
+ * Starts content tracing across runtime processes.
16453
+ *
16454
+ * Only one content tracing session may be active across the runtime at a time.
16455
+ * This method rejects if another identity already owns the active session.
16456
+ */
16457
+ startRecording(options: OpenFin_2.TraceConfig | OpenFin_2.TraceCategoriesAndOptions): Promise<void>;
16458
+ /**
16459
+ * Stops the active content tracing session and writes the trace to the runtime-managed cache folder.
16460
+ *
16461
+ * The calling identity must match the identity that started the active tracing session.
16462
+ * This method rejects if tracing is not active or is owned by another identity.
16463
+ */
16464
+ stopRecording(): Promise<string>;
16465
+ /**
16466
+ * Returns the current maximum trace buffer usage across processes.
16467
+ *
16468
+ * This method is not supported on macOS and rejects on that platform.
16469
+ */
16470
+ getTraceBufferUsage(): Promise<OpenFin_2.TraceBufferUsage>;
16471
+ }
16472
+
16472
16473
  /**
16473
16474
  * @deprecated Renamed to {@link Event}.
16474
16475
  */
@@ -16908,6 +16909,76 @@ declare type Time = {
16908
16909
 
16909
16910
  declare type TimeZones = 'utc' | 'local';
16910
16911
 
16912
+ /**
16913
+ * @interface
16914
+ * Current maximum usage across trace buffers.
16915
+ */
16916
+ declare type TraceBufferUsage = {
16917
+ value: number;
16918
+ percentage: number;
16919
+ };
16920
+
16921
+ /**
16922
+ * @interface
16923
+ * Shorthand tracing configuration based on Electron's contentTracing.startRecording() API.
16924
+ */
16925
+ declare type TraceCategoriesAndOptions = {
16926
+ /**
16927
+ * Filter that controls which category groups should be traced.
16928
+ * A filter can have an optional '-' prefix to exclude category groups that contain a matching category. Having both included and excluded category patterns in the same list is not supported. Examples: test_MyTest*, test_MyTest*,test_OtherStuff, -excluded_category1,-excluded_category2.
16929
+ */
16930
+ categoryFilter: string;
16931
+ /**
16932
+ * Comma-delimited string controlling recording mode and extra trace options. valid strings; record-until-full, record-continuously, trace-to-console, enable-sampling, enable-systrace, e.g. 'record-until-full,enable-sampling'. The first 3 options are trace recording modes and hence mutually exclusive. If more than one trace recording modes appear in the traceOptions string, the last one takes precedence. If none of the trace recording modes are specified, recording mode is record-until-full. The trace option will first be reset to the default option (record_mode set to record-until-full, enable_sampling and enable_systrace set to false) before options parsed from traceOptions are applied on it.
16933
+ */
16934
+ traceOptions: string;
16935
+ };
16936
+
16937
+ /**
16938
+ * @interface
16939
+ * Structured tracing configuration based on Electron's contentTracing.startRecording() API.
16940
+ */
16941
+ declare type TraceConfig = {
16942
+ /**
16943
+ * Can be `record-until-full`, `record-continuously`, `record-as-much-as-possible` or `trace-to-console`.
16944
+ * Defaults to `record-until-full`, which will record until the trace buffer is full and then stop recording.
16945
+ */
16946
+ recording_mode?: 'record-until-full' | 'record-continuously' | 'record-as-much-as-possible' | 'trace-to-console';
16947
+ /**
16948
+ * Maximum size of the trace recording buffer in kilobytes.
16949
+ */
16950
+ trace_buffer_size_in_kb?: number;
16951
+ /**
16952
+ * Maximum size of the trace recording buffer in events.
16953
+ * Defaults to 100MB
16954
+ */
16955
+ trace_buffer_size_in_events?: number;
16956
+ /**
16957
+ * Filters event data according to Chromium's vetted allowlist.
16958
+ */
16959
+ enable_argument_filter?: boolean;
16960
+ /**
16961
+ * A list of tracing categories to include.
16962
+ */
16963
+ included_categories?: string[];
16964
+ /**
16965
+ * A list of tracing categories to exclude.
16966
+ */
16967
+ excluded_categories?: string[];
16968
+ /**
16969
+ * A list of process IDs to include in the trace.
16970
+ */
16971
+ included_process_ids?: number[];
16972
+ /**
16973
+ * A list of histogram names to report with the trace.
16974
+ */
16975
+ histogram_names?: string[];
16976
+ /**
16977
+ * Additional configuration for memory tracing when memory-infra tracing is enabled.
16978
+ */
16979
+ memory_dump_config?: Record<string, any>;
16980
+ };
16981
+
16911
16982
  /**
16912
16983
  * @interface
16913
16984
  */
@@ -16976,9 +17047,12 @@ declare class Transport<MeType extends EntityType = EntityType> extends EventEmi
16976
17047
  sendRaw: Wire['send'];
16977
17048
  eventAggregator: EventAggregator;
16978
17049
  protected messageHandlers: MessageHandler[];
16979
- constructor(factory: WireFactory, environment: Environment, config: OpenFin_2.Identity);
17050
+ constructor(factory: WireFactory, environment: Environment, config: OpenFin_2.Identity & {
17051
+ apiDiagnostics?: boolean;
17052
+ });
16980
17053
  getFin(): OpenFin_2.Fin<MeType>;
16981
17054
  registerFin(_fin: OpenFin_2.Fin<MeType>): void;
17055
+ recordAnalytic(action: string): void;
16982
17056
  connectSync: () => void;
16983
17057
  getPort: () => string;
16984
17058
  shutdown(): Promise<void>;
package/out/stub.d.ts CHANGED
@@ -88,7 +88,7 @@ declare type AlertRequestedEvent = BaseEvent_5 & {
88
88
  url: string;
89
89
  };
90
90
 
91
- declare type AnalyticsOnlyCalls = 'window-get-web-window' | 'layout-get-by-view-identity' | 'layout-get-stack-by-view' | 'layout-add-view' | 'layout-close-view' | 'view-get-parent-layout' | 'view-get-current-stack' | 'window-is-main-window' | 'window-get-parent-application' | 'window-get-parent-window' | 'window-create-window' | 'window-get-layout' | 'window-dispatch-popup-result' | `layout-controller-${string}`;
91
+ declare type AnalyticsOnlyCalls = 'layout-get-stack-by-view' | 'layout-add-view' | 'layout-close-view' | `layout-controller-${string}`;
92
92
 
93
93
  declare type AnalyticsProtocolMap = {
94
94
  [k in AnalyticsOnlyCalls]: VoidCall;
@@ -1789,6 +1789,7 @@ declare type BaseConfig = {
1789
1789
  devToolsPort?: number;
1790
1790
  installerUI?: boolean;
1791
1791
  runtime?: RuntimeConfig;
1792
+ apiDiagnostics?: boolean;
1792
1793
  appAssets?: [
1793
1794
  {
1794
1795
  src: string;
@@ -6737,6 +6738,16 @@ declare type IntentMetadata<TargetType = any> = {
6737
6738
  */
6738
6739
  declare class InterApplicationBus extends Base {
6739
6740
  Channel: Channel;
6741
+ /**
6742
+ * Event types for the InterApplicationBus.
6743
+ *
6744
+ * @remarks The `subscriber-added` and `subscriber-removed` events are disabled by default.
6745
+ * To re-enable them, launch the runtime with the `--emit-legacy-iab-events` flag.
6746
+ * These events will be removed in a future version. Use {@link Channel} for connection
6747
+ * lifecycle management instead.
6748
+ *
6749
+ * @deprecated Use {@link Channel} `onConnection` / `onDisconnection` instead.
6750
+ */
6740
6751
  events: {
6741
6752
  subscriberAdded: string;
6742
6753
  subscriberRemoved: string;
@@ -10651,6 +10662,9 @@ declare namespace OpenFin_2 {
10651
10662
  SystemProcessInfo,
10652
10663
  ClearCacheOption,
10653
10664
  ClearDataOptions,
10665
+ TraceConfig,
10666
+ TraceCategoriesAndOptions,
10667
+ TraceBufferUsage,
10654
10668
  CookieInfo,
10655
10669
  CookieOption,
10656
10670
  CrashReporterOptions,
@@ -13326,19 +13340,17 @@ declare type ProtocolMap = ExternalAdapterOnlyCallsMap & AnalyticsProtocolMap &
13326
13340
  response: OpenFin_2.MenuResult;
13327
13341
  };
13328
13342
  'close-tray-icon-popup-menu': IdentityCall<{}, void>;
13329
- 'wrap-application': VoidCall;
13330
- 'wrap-application-sync': VoidCall;
13331
13343
  'create-application': ApiCall<OpenFin_2.ApplicationCreationOptions, void>;
13332
- 'application-create': VoidCall;
13333
- 'start-application': VoidCall;
13334
13344
  'run-applications': ApiCall<{
13335
13345
  applications: Array<OpenFin_2.ManifestInfo>;
13336
13346
  opts?: OpenFin_2.RvmLaunchOptions;
13337
13347
  }, void>;
13338
- 'get-current-application': VoidCall;
13339
- 'get-current-application-sync': VoidCall;
13340
- 'application-start-from-manifest': VoidCall;
13341
- 'application-create-from-manifest': VoidCall;
13348
+ 'send-analytics-batch': {
13349
+ request: {
13350
+ counts: Record<string, number>;
13351
+ };
13352
+ response: void;
13353
+ };
13342
13354
  'request-external-authorization': {
13343
13355
  request: any;
13344
13356
  response: void;
@@ -13457,10 +13469,6 @@ declare type ProtocolMap = ExternalAdapterOnlyCallsMap & AnalyticsProtocolMap &
13457
13469
  options: OpenFin_2.UpdatableViewOptions;
13458
13470
  }>;
13459
13471
  'trigger-before-unload': IdentityCall<{}, boolean>;
13460
- 'view-wrap-sync': VoidCall;
13461
- 'view-wrap': VoidCall;
13462
- 'view-get-current': VoidCall;
13463
- 'view-get-current-sync': VoidCall;
13464
13472
  'animate-window': IdentityCall<{
13465
13473
  transitions: OpenFin_2.Transition;
13466
13474
  options: OpenFin_2.TransitionOptions;
@@ -13552,11 +13560,6 @@ declare type ProtocolMap = ExternalAdapterOnlyCallsMap & AnalyticsProtocolMap &
13552
13560
  };
13553
13561
  response: void;
13554
13562
  };
13555
- 'window-wrap': VoidCall;
13556
- 'window-wrap-sync': VoidCall;
13557
- 'create-window': VoidCall;
13558
- 'get-current-window': VoidCall;
13559
- 'get-current-window-sync': VoidCall;
13560
13563
  'show-download-bubble': IdentityCall<{
13561
13564
  anchor?: OpenFin_2.Anchor;
13562
13565
  }, void>;
@@ -13564,14 +13567,8 @@ declare type ProtocolMap = ExternalAdapterOnlyCallsMap & AnalyticsProtocolMap &
13564
13567
  anchor: OpenFin_2.Anchor;
13565
13568
  }, void>;
13566
13569
  'get-external-application-info': ApiCall<OpenFin_2.ApplicationIdentity, OpenFin_2.ExternalApplicationInfo>;
13567
- 'external-application-wrap': VoidCall;
13568
- 'external-application-wrap-sync': VoidCall;
13569
13570
  'get-frame-info': ApiCall<OpenFin_2.Identity, OpenFin_2.FrameInfo>;
13570
13571
  'get-parent-window': ApiCall<OpenFin_2.Identity, OpenFin_2.FrameInfo>;
13571
- 'frame-wrap': VoidCall;
13572
- 'frame-wrap-sync': VoidCall;
13573
- 'frame-get-current': VoidCall;
13574
- 'frame-get-current-sync': VoidCall;
13575
13572
  'global-hotkey-register': {
13576
13573
  request: {
13577
13574
  hotkey: string;
@@ -13664,6 +13661,12 @@ declare type ProtocolMap = ExternalAdapterOnlyCallsMap & AnalyticsProtocolMap &
13664
13661
  }, OpenFin_2.NativeTheme>;
13665
13662
  'get-theme-preferences': GetterCall<OpenFin_2.NativeTheme>;
13666
13663
  'get-version': GetterCall<string>;
13664
+ 'content-tracing-get-categories': GetterCall<string[]>;
13665
+ 'content-tracing-start-recording': ApiCall<{
13666
+ options: OpenFin_2.TraceConfig | OpenFin_2.TraceCategoriesAndOptions;
13667
+ }, void>;
13668
+ 'content-tracing-stop-recording': GetterCall<string>;
13669
+ 'content-tracing-get-trace-buffer-usage': GetterCall<OpenFin_2.TraceBufferUsage>;
13667
13670
  'clear-cache': ApiCall<OpenFin_2.ClearCacheOption, void>;
13668
13671
  'clear-http-cache': VoidCall;
13669
13672
  'clear-cache-data': ApiCall<OpenFin_2.ClearDataOptions, void>;
@@ -13908,7 +13911,6 @@ declare type ProtocolMap = ExternalAdapterOnlyCallsMap & AnalyticsProtocolMap &
13908
13911
  apiPath: '.resolveDomainSettings';
13909
13912
  namespace: 'System';
13910
13913
  };
13911
- 'system-register-shutdown-handler': VoidCall;
13912
13914
  'get-permissions': GetterCall<any>;
13913
13915
  'refresh-extensions': {
13914
13916
  request: void;
@@ -13927,24 +13929,6 @@ declare type ProtocolMap = ExternalAdapterOnlyCallsMap & AnalyticsProtocolMap &
13927
13929
  request: void;
13928
13930
  response: Array<OpenFin_2.ThemePalette>;
13929
13931
  };
13930
- 'fdc3-add-context-listener': VoidCall;
13931
- 'fdc3-add-intent-listener': VoidCall;
13932
- 'fdc3-raise-intent': VoidCall;
13933
- 'fdc3-find-intent': VoidCall;
13934
- 'fdc3-find-intents-by-context': VoidCall;
13935
- 'fdc3-raise-intent-for-context': VoidCall;
13936
- 'fdc3-get-info': VoidCall;
13937
- 'fdc3-find-instances': VoidCall;
13938
- 'fdc3-get-app-metadata': VoidCall;
13939
- 'fdc3-broadcast': VoidCall;
13940
- 'fdc3-open': VoidCall;
13941
- 'fdc3-get-or-create-channel': VoidCall;
13942
- 'fdc3-get-system-channels': VoidCall;
13943
- 'fdc3-join-channel': VoidCall;
13944
- 'fdc3-get-current-channel': VoidCall;
13945
- 'fdc3-leave-current-channel': VoidCall;
13946
- 'interop-init': VoidCall;
13947
- 'interop-connect-sync': VoidCall;
13948
13932
  'interop-client-set-context': VoidCall;
13949
13933
  'interop-client-add-context-handler': VoidCall;
13950
13934
  'interop-client-get-context-groups': VoidCall;
@@ -13975,12 +13959,6 @@ declare type ProtocolMap = ExternalAdapterOnlyCallsMap & AnalyticsProtocolMap &
13975
13959
  'interop-session-context-group-set-context': VoidCall;
13976
13960
  'interop-session-context-group-get-context': VoidCall;
13977
13961
  'interop-session-context-group-add-handler': VoidCall;
13978
- 'platform-wrap': VoidCall;
13979
- 'platform-wrap-sync': VoidCall;
13980
- 'platform-get-current': VoidCall;
13981
- 'platform-get-current-sync': VoidCall;
13982
- 'platform-start': VoidCall;
13983
- 'platform-start-from-manifest': VoidCall;
13984
13962
  'platform-get-client': ApplicationIdentityCall<{}, void>;
13985
13963
  'platform-create-view': ApplicationIdentityCall<{}, void>;
13986
13964
  'platform-create-window': ApplicationIdentityCall<{}, void>;
@@ -13993,11 +13971,6 @@ declare type ProtocolMap = ExternalAdapterOnlyCallsMap & AnalyticsProtocolMap &
13993
13971
  'platform-set-window-context': ApplicationIdentityCall<{}, void>;
13994
13972
  'platform-get-window-context': ApplicationIdentityCall<{}, void>;
13995
13973
  'platform-close-window': ApplicationIdentityCall<{}, void>;
13996
- 'layout-wrap': VoidCall;
13997
- 'layout-wrap-sync': VoidCall;
13998
- 'layout-get-current': VoidCall;
13999
- 'layout-get-current-sync': VoidCall;
14000
- 'layout-init': VoidCall;
14001
13974
  'layout-get-config': VoidCall;
14002
13975
  'layout-get-views': VoidCall;
14003
13976
  'layout-replace': VoidCall;
@@ -14016,12 +13989,6 @@ declare type ProtocolMap = ExternalAdapterOnlyCallsMap & AnalyticsProtocolMap &
14016
13989
  'layout-controller-create-adjacent-stack': VoidCall;
14017
13990
  'layout-controller-get-adjacent-stacks': VoidCall;
14018
13991
  'layout-controller-set-stack-active-view': VoidCall;
14019
- 'snapshot-source-init': VoidCall;
14020
- 'snapshot-source-wrap-sync': VoidCall;
14021
- 'snapshot-source-wrap': VoidCall;
14022
- 'snapshot-source-ready': VoidCall;
14023
- 'snapshot-source-get-snapshot': VoidCall;
14024
- 'snapshot-source-apply-snapshot': VoidCall;
14025
13992
  'capture-page': IdentityCall<{
14026
13993
  options?: OpenFin_2.CapturePageOptions;
14027
13994
  }, string>;
@@ -15256,6 +15223,10 @@ declare type SubscriptionOptions = {
15256
15223
  *
15257
15224
  */
15258
15225
  declare class System extends EmitterBase<OpenFin_2.SystemEvent> {
15226
+ /**
15227
+ * Chromium content tracing APIs.
15228
+ */
15229
+ readonly ContentTracing: SystemContentTracing;
15259
15230
  /**
15260
15231
  * @internal
15261
15232
  */
@@ -16892,6 +16863,36 @@ declare class System extends EmitterBase<OpenFin_2.SystemEvent> {
16892
16863
  getThemePalette(): Promise<Array<OpenFin_2.ThemePalette>>;
16893
16864
  }
16894
16865
 
16866
+ /**
16867
+ * Chromium content tracing APIs exposed under `fin.System.ContentTracing`.
16868
+ */
16869
+ declare class SystemContentTracing extends Base {
16870
+ /**
16871
+ * Gets the currently known tracing category groups.
16872
+ */
16873
+ getCategories(): Promise<string[]>;
16874
+ /**
16875
+ * Starts content tracing across runtime processes.
16876
+ *
16877
+ * Only one content tracing session may be active across the runtime at a time.
16878
+ * This method rejects if another identity already owns the active session.
16879
+ */
16880
+ startRecording(options: OpenFin_2.TraceConfig | OpenFin_2.TraceCategoriesAndOptions): Promise<void>;
16881
+ /**
16882
+ * Stops the active content tracing session and writes the trace to the runtime-managed cache folder.
16883
+ *
16884
+ * The calling identity must match the identity that started the active tracing session.
16885
+ * This method rejects if tracing is not active or is owned by another identity.
16886
+ */
16887
+ stopRecording(): Promise<string>;
16888
+ /**
16889
+ * Returns the current maximum trace buffer usage across processes.
16890
+ *
16891
+ * This method is not supported on macOS and rejects on that platform.
16892
+ */
16893
+ getTraceBufferUsage(): Promise<OpenFin_2.TraceBufferUsage>;
16894
+ }
16895
+
16895
16896
  /**
16896
16897
  * @deprecated Renamed to {@link Event}.
16897
16898
  */
@@ -17338,6 +17339,76 @@ declare type Time = {
17338
17339
 
17339
17340
  declare type TimeZones = 'utc' | 'local';
17340
17341
 
17342
+ /**
17343
+ * @interface
17344
+ * Current maximum usage across trace buffers.
17345
+ */
17346
+ declare type TraceBufferUsage = {
17347
+ value: number;
17348
+ percentage: number;
17349
+ };
17350
+
17351
+ /**
17352
+ * @interface
17353
+ * Shorthand tracing configuration based on Electron's contentTracing.startRecording() API.
17354
+ */
17355
+ declare type TraceCategoriesAndOptions = {
17356
+ /**
17357
+ * Filter that controls which category groups should be traced.
17358
+ * A filter can have an optional '-' prefix to exclude category groups that contain a matching category. Having both included and excluded category patterns in the same list is not supported. Examples: test_MyTest*, test_MyTest*,test_OtherStuff, -excluded_category1,-excluded_category2.
17359
+ */
17360
+ categoryFilter: string;
17361
+ /**
17362
+ * Comma-delimited string controlling recording mode and extra trace options. valid strings; record-until-full, record-continuously, trace-to-console, enable-sampling, enable-systrace, e.g. 'record-until-full,enable-sampling'. The first 3 options are trace recording modes and hence mutually exclusive. If more than one trace recording modes appear in the traceOptions string, the last one takes precedence. If none of the trace recording modes are specified, recording mode is record-until-full. The trace option will first be reset to the default option (record_mode set to record-until-full, enable_sampling and enable_systrace set to false) before options parsed from traceOptions are applied on it.
17363
+ */
17364
+ traceOptions: string;
17365
+ };
17366
+
17367
+ /**
17368
+ * @interface
17369
+ * Structured tracing configuration based on Electron's contentTracing.startRecording() API.
17370
+ */
17371
+ declare type TraceConfig = {
17372
+ /**
17373
+ * Can be `record-until-full`, `record-continuously`, `record-as-much-as-possible` or `trace-to-console`.
17374
+ * Defaults to `record-until-full`, which will record until the trace buffer is full and then stop recording.
17375
+ */
17376
+ recording_mode?: 'record-until-full' | 'record-continuously' | 'record-as-much-as-possible' | 'trace-to-console';
17377
+ /**
17378
+ * Maximum size of the trace recording buffer in kilobytes.
17379
+ */
17380
+ trace_buffer_size_in_kb?: number;
17381
+ /**
17382
+ * Maximum size of the trace recording buffer in events.
17383
+ * Defaults to 100MB
17384
+ */
17385
+ trace_buffer_size_in_events?: number;
17386
+ /**
17387
+ * Filters event data according to Chromium's vetted allowlist.
17388
+ */
17389
+ enable_argument_filter?: boolean;
17390
+ /**
17391
+ * A list of tracing categories to include.
17392
+ */
17393
+ included_categories?: string[];
17394
+ /**
17395
+ * A list of tracing categories to exclude.
17396
+ */
17397
+ excluded_categories?: string[];
17398
+ /**
17399
+ * A list of process IDs to include in the trace.
17400
+ */
17401
+ included_process_ids?: number[];
17402
+ /**
17403
+ * A list of histogram names to report with the trace.
17404
+ */
17405
+ histogram_names?: string[];
17406
+ /**
17407
+ * Additional configuration for memory tracing when memory-infra tracing is enabled.
17408
+ */
17409
+ memory_dump_config?: Record<string, any>;
17410
+ };
17411
+
17341
17412
  /**
17342
17413
  * @interface
17343
17414
  */
@@ -17406,9 +17477,12 @@ declare class Transport<MeType extends EntityType = EntityType> extends EventEmi
17406
17477
  sendRaw: Wire['send'];
17407
17478
  eventAggregator: EventAggregator;
17408
17479
  protected messageHandlers: MessageHandler[];
17409
- constructor(factory: WireFactory, environment: Environment, config: OpenFin_2.Identity);
17480
+ constructor(factory: WireFactory, environment: Environment, config: OpenFin_2.Identity & {
17481
+ apiDiagnostics?: boolean;
17482
+ });
17410
17483
  getFin(): OpenFin_2.Fin<MeType>;
17411
17484
  registerFin(_fin: OpenFin_2.Fin<MeType>): void;
17485
+ recordAnalytic(action: string): void;
17412
17486
  connectSync: () => void;
17413
17487
  getPort: () => string;
17414
17488
  shutdown(): Promise<void>;