@openfin/fdc3-api 44.100.109 → 44.101.2

package/out/fdc3-api-beta.d.ts

@@ -85,7 +85,7 @@ declare type AlertRequestedEvent = BaseEvent_5 & {
     url: string;
 };
 
-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}`;
+declare type AnalyticsOnlyCalls = 'layout-get-stack-by-view' | 'layout-add-view' | 'layout-close-view' | `layout-controller-${string}`;
 
 declare type AnalyticsProtocolMap = {
     [k in AnalyticsOnlyCalls]: VoidCall;
@@ -1754,6 +1754,7 @@ declare type BaseConfig = {
     devToolsPort?: number;
     installerUI?: boolean;
     runtime?: RuntimeConfig;
+    apiDiagnostics?: boolean;
     appAssets?: [
         {
         src: string;
@@ -6985,6 +6986,16 @@ declare type IntentMetadata<TargetType = any> = {
  */
 declare class InterApplicationBus extends Base {
     Channel: Channel;
+    /**
+     * Event types for the InterApplicationBus.
+     *
+     * @remarks The `subscriber-added` and `subscriber-removed` events are disabled by default.
+     * To re-enable them, launch the runtime with the `--emit-legacy-iab-events` flag.
+     * These events will be removed in a future version. Use {@link Channel} for connection
+     * lifecycle management instead.
+     *
+     * @deprecated Use {@link Channel} `onConnection` / `onDisconnection` instead.
+     */
     events: {
         subscriberAdded: string;
         subscriberRemoved: string;
@@ -10659,6 +10670,9 @@ declare namespace OpenFin {
         SystemProcessInfo,
         ClearCacheOption,
         ClearDataOptions,
+        TraceConfig,
+        TraceCategoriesAndOptions,
+        TraceBufferUsage,
         CookieInfo,
         CookieOption,
         CrashReporterOptions,
@@ -13249,19 +13263,17 @@ declare type ProtocolMap = ExternalAdapterOnlyCallsMap & AnalyticsProtocolMap &
         response: OpenFin.MenuResult;
     };
     'close-tray-icon-popup-menu': IdentityCall<{}, void>;
-    'wrap-application': VoidCall;
-    'wrap-application-sync': VoidCall;
     'create-application': ApiCall<OpenFin.ApplicationCreationOptions, void>;
-    'application-create': VoidCall;
-    'start-application': VoidCall;
     'run-applications': ApiCall<{
         applications: Array<OpenFin.ManifestInfo>;
         opts?: OpenFin.RvmLaunchOptions;
     }, void>;
-    'get-current-application': VoidCall;
-    'get-current-application-sync': VoidCall;
-    'application-start-from-manifest': VoidCall;
-    'application-create-from-manifest': VoidCall;
+    'send-analytics-batch': {
+        request: {
+            counts: Record<string, number>;
+        };
+        response: void;
+    };
     'request-external-authorization': {
         request: any;
         response: void;
@@ -13380,10 +13392,6 @@ declare type ProtocolMap = ExternalAdapterOnlyCallsMap & AnalyticsProtocolMap &
         options: OpenFin.UpdatableViewOptions;
     }>;
     'trigger-before-unload': IdentityCall<{}, boolean>;
-    'view-wrap-sync': VoidCall;
-    'view-wrap': VoidCall;
-    'view-get-current': VoidCall;
-    'view-get-current-sync': VoidCall;
     'animate-window': IdentityCall<{
         transitions: OpenFin.Transition;
         options: OpenFin.TransitionOptions;
@@ -13475,11 +13483,6 @@ declare type ProtocolMap = ExternalAdapterOnlyCallsMap & AnalyticsProtocolMap &
         };
         response: void;
     };
-    'window-wrap': VoidCall;
-    'window-wrap-sync': VoidCall;
-    'create-window': VoidCall;
-    'get-current-window': VoidCall;
-    'get-current-window-sync': VoidCall;
     'show-download-bubble': IdentityCall<{
         anchor?: OpenFin.Anchor;
     }, void>;
@@ -13487,14 +13490,8 @@ declare type ProtocolMap = ExternalAdapterOnlyCallsMap & AnalyticsProtocolMap &
         anchor: OpenFin.Anchor;
     }, void>;
     'get-external-application-info': ApiCall<OpenFin.ApplicationIdentity, OpenFin.ExternalApplicationInfo>;
-    'external-application-wrap': VoidCall;
-    'external-application-wrap-sync': VoidCall;
     'get-frame-info': ApiCall<OpenFin.Identity, OpenFin.FrameInfo>;
     'get-parent-window': ApiCall<OpenFin.Identity, OpenFin.FrameInfo>;
-    'frame-wrap': VoidCall;
-    'frame-wrap-sync': VoidCall;
-    'frame-get-current': VoidCall;
-    'frame-get-current-sync': VoidCall;
     'global-hotkey-register': {
         request: {
             hotkey: string;
@@ -13587,6 +13584,12 @@ declare type ProtocolMap = ExternalAdapterOnlyCallsMap & AnalyticsProtocolMap &
     }, OpenFin.NativeTheme>;
     'get-theme-preferences': GetterCall<OpenFin.NativeTheme>;
     'get-version': GetterCall<string>;
+    'content-tracing-get-categories': GetterCall<string[]>;
+    'content-tracing-start-recording': ApiCall<{
+        options: OpenFin.TraceConfig | OpenFin.TraceCategoriesAndOptions;
+    }, void>;
+    'content-tracing-stop-recording': GetterCall<string>;
+    'content-tracing-get-trace-buffer-usage': GetterCall<OpenFin.TraceBufferUsage>;
     'clear-cache': ApiCall<OpenFin.ClearCacheOption, void>;
     'clear-http-cache': VoidCall;
     'clear-cache-data': ApiCall<OpenFin.ClearDataOptions, void>;
@@ -13831,7 +13834,6 @@ declare type ProtocolMap = ExternalAdapterOnlyCallsMap & AnalyticsProtocolMap &
         apiPath: '.resolveDomainSettings';
         namespace: 'System';
     };
-    'system-register-shutdown-handler': VoidCall;
     'get-permissions': GetterCall<any>;
     'refresh-extensions': {
         request: void;
@@ -13850,24 +13852,6 @@ declare type ProtocolMap = ExternalAdapterOnlyCallsMap & AnalyticsProtocolMap &
         request: void;
         response: Array<OpenFin.ThemePalette>;
     };
-    'fdc3-add-context-listener': VoidCall;
-    'fdc3-add-intent-listener': VoidCall;
-    'fdc3-raise-intent': VoidCall;
-    'fdc3-find-intent': VoidCall;
-    'fdc3-find-intents-by-context': VoidCall;
-    'fdc3-raise-intent-for-context': VoidCall;
-    'fdc3-get-info': VoidCall;
-    'fdc3-find-instances': VoidCall;
-    'fdc3-get-app-metadata': VoidCall;
-    'fdc3-broadcast': VoidCall;
-    'fdc3-open': VoidCall;
-    'fdc3-get-or-create-channel': VoidCall;
-    'fdc3-get-system-channels': VoidCall;
-    'fdc3-join-channel': VoidCall;
-    'fdc3-get-current-channel': VoidCall;
-    'fdc3-leave-current-channel': VoidCall;
-    'interop-init': VoidCall;
-    'interop-connect-sync': VoidCall;
     'interop-client-set-context': VoidCall;
     'interop-client-add-context-handler': VoidCall;
     'interop-client-get-context-groups': VoidCall;
@@ -13898,12 +13882,6 @@ declare type ProtocolMap = ExternalAdapterOnlyCallsMap & AnalyticsProtocolMap &
     'interop-session-context-group-set-context': VoidCall;
     'interop-session-context-group-get-context': VoidCall;
     'interop-session-context-group-add-handler': VoidCall;
-    'platform-wrap': VoidCall;
-    'platform-wrap-sync': VoidCall;
-    'platform-get-current': VoidCall;
-    'platform-get-current-sync': VoidCall;
-    'platform-start': VoidCall;
-    'platform-start-from-manifest': VoidCall;
     'platform-get-client': ApplicationIdentityCall<{}, void>;
     'platform-create-view': ApplicationIdentityCall<{}, void>;
     'platform-create-window': ApplicationIdentityCall<{}, void>;
@@ -13916,11 +13894,6 @@ declare type ProtocolMap = ExternalAdapterOnlyCallsMap & AnalyticsProtocolMap &
     'platform-set-window-context': ApplicationIdentityCall<{}, void>;
     'platform-get-window-context': ApplicationIdentityCall<{}, void>;
     'platform-close-window': ApplicationIdentityCall<{}, void>;
-    'layout-wrap': VoidCall;
-    'layout-wrap-sync': VoidCall;
-    'layout-get-current': VoidCall;
-    'layout-get-current-sync': VoidCall;
-    'layout-init': VoidCall;
     'layout-get-config': VoidCall;
     'layout-get-views': VoidCall;
     'layout-replace': VoidCall;
@@ -13939,12 +13912,6 @@ declare type ProtocolMap = ExternalAdapterOnlyCallsMap & AnalyticsProtocolMap &
     'layout-controller-create-adjacent-stack': VoidCall;
     'layout-controller-get-adjacent-stacks': VoidCall;
     'layout-controller-set-stack-active-view': VoidCall;
-    'snapshot-source-init': VoidCall;
-    'snapshot-source-wrap-sync': VoidCall;
-    'snapshot-source-wrap': VoidCall;
-    'snapshot-source-ready': VoidCall;
-    'snapshot-source-get-snapshot': VoidCall;
-    'snapshot-source-apply-snapshot': VoidCall;
     'capture-page': IdentityCall<{
         options?: OpenFin.CapturePageOptions;
     }, string>;
@@ -15176,6 +15143,10 @@ declare type SubscriptionOptions = {
  *
  */
 declare class System extends EmitterBase<OpenFin.SystemEvent> {
+    /**
+     * Chromium content tracing APIs.
+     */
+    readonly ContentTracing: SystemContentTracing;
     /* Excluded from this release type: __constructor */
     private sendExternalProcessRequest;
     /**
@@ -16809,6 +16780,83 @@ declare class System extends EmitterBase<OpenFin.SystemEvent> {
     getThemePalette(): Promise<Array<OpenFin.ThemePalette>>;
 }
 
+/**
+ * Chromium content tracing APIs exposed under `fin.System.ContentTracing`.
+ */
+declare class SystemContentTracing extends Base {
+    /**
+     * Gets the currently known tracing category groups.
+     *
+     * @example
+     * ```ts
+     * const categories = await fin.System.ContentTracing.getCategories();
+     * const sorted = [...new Set(categories)].sort((a, b) => a.localeCompare(b));
+     * console.log(`Loaded ${sorted.length} tracing categories`);
+     * ```
+     */
+    getCategories(): Promise<string[]>;
+    /**
+     * Starts content tracing across runtime processes.
+     *
+     * Only one content tracing session may be active across the runtime at a time.
+     * This method rejects if another identity already owns the active session.
+     *
+     * @example
+     * ```ts
+     * await fin.System.ContentTracing.startRecording({
+     *     recording_mode: 'record-as-much-as-possible',
+     *     included_categories: [
+     *         '*',
+     *         'disabled-by-default-blink.invalidation',
+     *         'disabled-by-default-cc.debug',
+     *         'disabled-by-default-viz.surface_id_flow'
+     *     ]
+     * });
+     *
+     * console.log('Content tracing started. Call stopRecording() when ready to collect the trace.');
+     * ```
+     *
+     * @example
+     * ```ts
+     * await fin.System.ContentTracing.startRecording({
+     *     categoryFilter: 'electron,blink,cc',
+     *     traceOptions: 'record-until-full,enable-sampling'
+     * });
+     * ```
+     */
+    startRecording(options: OpenFin.TraceConfig | OpenFin.TraceCategoriesAndOptions): Promise<void>;
+    /**
+     * Stops the active content tracing session and writes the trace to the runtime-managed cache folder.
+     *
+     * The calling identity must match the identity that started the active tracing session.
+     * This method rejects if tracing is not active or is owned by another identity.
+     *
+     * @example
+     * ```ts
+     * const tracePath = await fin.System.ContentTracing.stopRecording();
+     * console.log('Trace written to:', tracePath);
+     * // Load the file in chrome://tracing or https://ui.perfetto.dev/
+     * ```
+     */
+    stopRecording(): Promise<string>;
+    /**
+     * Returns the current maximum trace buffer usage across processes.
+     *
+     * This method is not supported on macOS and rejects on that platform.
+     *
+     * @example
+     * ```ts
+     * try {
+     *     const usage = await fin.System.ContentTracing.getTraceBufferUsage();
+     *     console.log(`Buffer usage: ${usage.percentage}% (${usage.value})`);
+     * } catch (error) {
+     *     console.warn('Trace buffer usage is not available on this platform.', error);
+     * }
+     * ```
+     */
+    getTraceBufferUsage(): Promise<OpenFin.TraceBufferUsage>;
+}
+
 /**
  * @deprecated Renamed to {@link Event}.
  */
@@ -17248,6 +17296,76 @@ declare type Time = {
 
 declare type TimeZones = 'utc' | 'local';
 
+/**
+ * @interface
+ * Current maximum usage across trace buffers.
+ */
+declare type TraceBufferUsage = {
+    value: number;
+    percentage: number;
+};
+
+/**
+ * @interface
+ * Shorthand tracing configuration based on Electron's contentTracing.startRecording() API.
+ */
+declare type TraceCategoriesAndOptions = {
+    /**
+     * Filter that controls which category groups should be traced.
+     * 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.
+     */
+    categoryFilter: string;
+    /**
+     * 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.
+     */
+    traceOptions: string;
+};
+
+/**
+ * @interface
+ * Structured tracing configuration based on Electron's contentTracing.startRecording() API.
+ */
+declare type TraceConfig = {
+    /**
+     * Can be `record-until-full`, `record-continuously`, `record-as-much-as-possible` or `trace-to-console`.
+     * Defaults to `record-until-full`, which will record until the trace buffer is full and then stop recording.
+     */
+    recording_mode?: 'record-until-full' | 'record-continuously' | 'record-as-much-as-possible' | 'trace-to-console';
+    /**
+     * Maximum size of the trace recording buffer in kilobytes.
+     */
+    trace_buffer_size_in_kb?: number;
+    /**
+     * Maximum size of the trace recording buffer in events.
+     * Defaults to 100MB
+     */
+    trace_buffer_size_in_events?: number;
+    /**
+     * Filters event data according to Chromium's vetted allowlist.
+     */
+    enable_argument_filter?: boolean;
+    /**
+     * A list of tracing categories to include.
+     */
+    included_categories?: string[];
+    /**
+     * A list of tracing categories to exclude.
+     */
+    excluded_categories?: string[];
+    /**
+     * A list of process IDs to include in the trace.
+     */
+    included_process_ids?: number[];
+    /**
+     * A list of histogram names to report with the trace.
+     */
+    histogram_names?: string[];
+    /**
+     * Additional configuration for memory tracing when memory-infra tracing is enabled.
+     */
+    memory_dump_config?: Record<string, any>;
+};
+
 /**
  * @interface
  */
@@ -17316,9 +17434,12 @@ declare class Transport<MeType extends EntityType = EntityType> extends EventEmi
     sendRaw: Wire['send'];
     eventAggregator: EventAggregator;
     protected messageHandlers: MessageHandler[];
-    constructor(factory: WireFactory, environment: Environment, config: OpenFin.Identity);
+    constructor(factory: WireFactory, environment: Environment, config: OpenFin.Identity & {
+        apiDiagnostics?: boolean;
+    });
     getFin(): OpenFin.Fin<MeType>;
     registerFin(_fin: OpenFin.Fin<MeType>): void;
+    recordAnalytic(action: string): void;
     connectSync: () => void;
     getPort: () => string;
     shutdown(): Promise<void>;