@openfin/fdc3-api 39.82.13 → 39.83.2

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

@@ -99,7 +99,7 @@ declare type ApiInjection = DomainApiSettings;
  * Generated when a new Platform's API becomes responsive.
  * @interface
  */
-declare type ApiReadyEvent = BaseEvent & {
+declare type ApiReadyEvent = BaseEvents.BaseEvent & {
     topic: 'application';
     type: 'platform-api-ready';
 };
@@ -911,7 +911,7 @@ declare namespace ApplicationEvents {
         PropagatedApplicationEvent,
         PropagatedEventType_3 as PropagatedEventType,
         PropagatedApplicationEventType,
-        Payload_4 as Payload,
+        Payload_5 as Payload,
         ByType_3 as ByType
     }
 }
@@ -1704,7 +1704,7 @@ declare type BaseEvent_10 = Events.BaseEvents.BaseEvent;
  * A base Channel event.
  * @interface
  */
-declare type BaseEvent_2 = NamedEvent & {
+declare type BaseEvent_2 = BaseEvents.NamedEvent & {
     channelName: string;
     channelId: string;
 };
@@ -1774,6 +1774,7 @@ declare namespace BaseEvents {
         NotCloseRequested,
         PropagatedEventType,
         PropagatedEvent,
+        Payload_2 as Payload,
         EventHandler,
         BaseEvent,
         IdentityEvent,
@@ -1914,7 +1915,7 @@ declare type BrowserContentCreationRule = BaseContentCreationRule & {
  *
  * @typeParam Type String key specifying the event to extract
  */
-declare type ByType<Type extends EventType> = Payload_2<Type>;
+declare type ByType<Type extends EventType> = Payload_3<Type>;
 
 /**
  * Extracts a single event type matching the given key from the Window {@link Event} union.
@@ -1923,7 +1924,7 @@ declare type ByType<Type extends EventType> = Payload_2<Type>;
  *
  * @typeParam Type String key specifying the event to extract
  */
-declare type ByType_2<Type extends EventType_2> = Payload_3<Type>;
+declare type ByType_2<Type extends EventType_2> = Payload_4<Type>;
 
 /**
  * Extracts a single event type matching the given key from the Application {@link Event} union.
@@ -1932,7 +1933,7 @@ declare type ByType_2<Type extends EventType_2> = Payload_3<Type>;
  *
  * @typeParam Type String key specifying the event to extract
  */
-declare type ByType_3<Type extends EventType_3> = Payload_4<Type>;
+declare type ByType_3<Type extends EventType_3> = Payload_5<Type>;
 
 /**
  * Extracts a single event type matching the given key from the ExternalApplication {@link Event} union.
@@ -1941,7 +1942,7 @@ declare type ByType_3<Type extends EventType_3> = Payload_4<Type>;
  *
  * @typeParam Type String key specifying the event to extract
  */
-declare type ByType_4<Type extends EventType_4> = Payload_5<Type>;
+declare type ByType_4<Type extends EventType_4> = Payload_6<Type>;
 
 /**
  * Extracts a single event type matching the given key from the Frame {@link Event} union.
@@ -1950,7 +1951,7 @@ declare type ByType_4<Type extends EventType_4> = Payload_5<Type>;
  *
  * @typeParam Type String key specifying the event to extract
  */
-declare type ByType_5<Type extends EventType_5> = Payload_6<Type>;
+declare type ByType_5<Type extends EventType_5> = Payload_7<Type>;
 
 /**
  * Extracts a single event type matching the given key from the GlobalHotkey {@link Event} union.
@@ -1959,7 +1960,7 @@ declare type ByType_5<Type extends EventType_5> = Payload_6<Type>;
  *
  * @typeParam Type String key specifying the event to extract
  */
-declare type ByType_6<Type extends EventType_6> = Payload_7<Type>;
+declare type ByType_6<Type extends EventType_6> = Payload_8<Type>;
 
 /**
  * Extracts a single event type matching the given key from the Platform {@link Event} union.
@@ -1968,7 +1969,7 @@ declare type ByType_6<Type extends EventType_6> = Payload_7<Type>;
  *
  * @typeParam Type String key specifying the event to extract
  */
-declare type ByType_7<Type extends EventType_7> = Payload_8<Type>;
+declare type ByType_7<Type extends EventType_7> = Payload_9<Type>;
 
 /**
  * Extracts a single event type matching the given key from the System {@link Event} union.
@@ -1977,7 +1978,7 @@ declare type ByType_7<Type extends EventType_7> = Payload_8<Type>;
  *
  * @typeParam Type String key specifying the event to extract
  */
-declare type ByType_8<Type extends EventType_8> = Payload_9<Type>;
+declare type ByType_8<Type extends EventType_8> = Payload_10<Type>;
 
 /**
  * Extracts a single event type matching the given key from the Layout DOM {@link Event} union.
@@ -1986,7 +1987,7 @@ declare type ByType_8<Type extends EventType_8> = Payload_9<Type>;
  *
  * @typeParam Type String key specifying the event to extract
  */
-declare type ByType_9<Type extends EventType_9> = Payload_10<Type>;
+declare type ByType_9<Type extends EventType_9> = Payload_11<Type>;
 
 /**
  * Configuration for page capture.
@@ -3698,6 +3699,7 @@ declare type ContainerCreatedEvent = LayoutDOMEvent & {
 
 /**
  * Generated when content navigation or redirection is blocked by {@link OpenFin.DomainSettings}.
+ * @interface
  */
 declare type ContentBlockedEvent = NamedEvent & {
     type: 'content-blocked';
@@ -4802,9 +4804,7 @@ declare class EventAggregator extends EmitterMap {
  * @remarks Selects the correct type for the event
  * payload from the provided union based on the provided string literal type.
  */
-declare type EventHandler<EmitterEvent extends BaseEvent, EventType extends string> = (payload: Extract<EmitterEvent, {
-    type: EventType;
-}>, ...args: any[]) => void;
+declare type EventHandler<EmitterEvent extends BaseEvent, EventType extends string> = (payload: Payload_2<EmitterEvent, EventType>, ...args: any[]) => void;
 
 declare namespace Events {
     export {
@@ -4940,7 +4940,7 @@ declare namespace ExternalApplicationEvents {
         ExternalApplicationEvent,
         EventType_4 as EventType,
         ExternalApplicationEventType,
-        Payload_5 as Payload,
+        Payload_6 as Payload,
         ByType_4 as ByType
     }
 }
@@ -5737,7 +5737,7 @@ declare namespace FrameEvents {
         FrameEvent,
         EventType_5 as EventType,
         FrameEventType,
-        Payload_6 as Payload,
+        Payload_7 as Payload,
         ByType_5 as ByType
     }
 }
@@ -5977,7 +5977,7 @@ declare namespace GlobalHotkeyEvents {
         GlobalHotkeyEvent,
         EventType_6 as EventType,
         GlobalHotkeyEventType,
-        Payload_7 as Payload,
+        Payload_8 as Payload,
         ByType_6 as ByType
     }
 }
@@ -8057,7 +8057,7 @@ declare namespace LayoutDOMEvents {
         LayoutStateChangedEvent,
         Event_12 as Event,
         EventType_9 as EventType,
-        Payload_10 as Payload,
+        Payload_11 as Payload,
         ByType_9 as ByType
     }
 }
@@ -8563,6 +8563,23 @@ declare type LogLevel = OpenFin.LogLevel;
  */
 declare type LogLevel_2 = 'verbose' | 'info' | 'warning' | 'error' | 'fatal';
 
+declare type LogUploaderUIOptions = {
+    title?: string;
+    icon?: string;
+    header?: string;
+    description?: string;
+    email?: string;
+    website?: string;
+    websiteDescription?: string;
+};
+
+declare type LogUploadOptions = {
+    endpoint: string;
+    manifests?: string[];
+    logs?: string[];
+    ui?: LogUploaderUIOptions;
+};
+
 /**
  * @interface
  */
@@ -8621,6 +8638,7 @@ declare type Manifest = {
         enableErrorReporting?: boolean;
     };
     interopBrokerConfiguration: InteropBrokerOptions;
+    logUpload?: LogUploadOptions;
 };
 
 /**
@@ -9252,6 +9270,34 @@ declare type NavigationRules = {
 
 declare type NewConnectConfig = ConfigWithUuid & ConfigWithRuntime;
 
+declare interface NodeNetworkInterfaceBase {
+    address: string;
+    netmask: string;
+    mac: string;
+    internal: boolean;
+    cidr: string | null;
+}
+
+declare type NodeNetworkInterfaceInfo = NodeNetworkInterfaceInfoIPv4 | NodeNetworkInterfaceInfoIPv6;
+
+declare interface NodeNetworkInterfaceInfoIPv4 extends NodeNetworkInterfaceBase {
+    family: 'IPv4';
+    scopeid?: undefined;
+}
+
+declare interface NodeNetworkInterfaceInfoIPv6 extends NodeNetworkInterfaceBase {
+    family: 'IPv6';
+    scopeid: number;
+}
+
+declare interface NodeUserInfo {
+    username: string;
+    uid: number;
+    gid: number;
+    shell: string | null;
+    homedir: string;
+}
+
 /**
  * @interface
  */
@@ -9454,6 +9500,8 @@ declare namespace OpenFin {
         PlatformViewCreationOptions,
         ProcessAffinityStrategy,
         PlatformOptions,
+        LogUploaderUIOptions,
+        LogUploadOptions,
         Manifest,
         LayoutContent,
         LayoutItemConfig,
@@ -9481,6 +9529,7 @@ declare namespace OpenFin {
         Time,
         CpuInfo,
         GpuInfo,
+        OSInfo,
         HostSpecs,
         PrinterInfo_2 as PrinterInfo,
         Dpi,
@@ -9688,6 +9737,25 @@ declare type OptionsChangedEvent = BaseEvent_5 & {
     diff: OpenFin.WindowOptionDiff;
 };
 
+/**
+ * @interface
+ * The keys represent the output from calling individual Node `os` APIs.
+ * For example, `userInfo` will have the output of calling `os.userInfo()`. For more information
+ * see [Node `os` API docs](https://nodejs.org/docs/latest-v20.x/api/os.html)
+ */
+declare type OSInfo = {
+    platform: string;
+    release: string;
+    version: string;
+    /**
+     * Throws if a user has no username or homedir.
+     * See [Node os.userInfo docs for more info](https://nodejs.org/docs/latest-v20.x/api/os.html#osuserinfooptions)
+     */
+    userInfo: NodeUserInfo;
+    hostname: string;
+    networkInterfaces: Record<string, NodeNetworkInterfaceInfo[] | undefined>;
+};
+
 declare type OverrideCallback<T extends any = PlatformProvider, U extends T = T> = (arg: Constructor<T>) => U | Promise<U>;
 
 /**
@@ -9716,86 +9784,110 @@ declare type Payload<Success extends boolean = boolean, Data = any> = {
     error?: Success extends false ? ErrorPlainObject | undefined : never;
 };
 
+/**
+ * Extracts a single event type matching the given key from the System {@link Event} union.
+ *
+ * @see {@link ByType}
+ *
+ * @typeParam Type String key specifying the event to extract
+ */
+declare type Payload_10<Type extends EventType_8> = BaseEvents.Payload<Event_11, Type>;
+
 /**
  * Extracts a single event type matching the given key from the Layout DOM {@link Event} union.
  *
  * @typeParam Type String key specifying the event to extract
  */
-declare type Payload_10<Type extends EventType_9> = Extract<Event_12, {
+declare type Payload_11<Type extends EventType_9> = Extract<Event_12, {
     type: Type;
 }>;
 
+/**
+ * Extracts a single event type matching the given type key from the provided EmitterEvent union.
+ *
+ * @remarks Each event emitter namespace defines its own reduction of this type that fixes the Event parameter to
+ * the appropriate payload union for that namespace.
+ *
+ * @typeParam Event Union of payloads for events on the given emitter
+ * @see {@link ByType}
+ *
+ * @typeParam Type String key specifying the event to extract from the union
+ *
+ * @see {@link OpenFin.Events.ApplicationEvents.Payload}
+ * @see {@link OpenFin.Events.ExternalApplicationEvents.Payload}
+ * @see {@link OpenFin.Events.FrameEvents.Payload}
+ * @see {@link OpenFin.Events.GlobalHotkeyEvents.Payload}
+ * @see {@link OpenFin.Events.PlatformEvents.Payload}
+ * @see {@link OpenFin.Events.SystemEvents.Payload}
+ * @see {@link OpenFin.Events.ViewEvents.Payload}
+ * @see {@link OpenFin.Events.WindowEvents.Payload}
+ */
+declare type Payload_2<Event extends BaseEvent, EventType extends string> = Extract<Event, {
+    type: EventType;
+}>;
+
 /**
  * Extracts a single event type matching the given key from the View {@link Event} union.
  *
+ * @see {@link ByType}
+ *
  * @typeParam Type String key specifying the event to extract
  */
-declare type Payload_2<Type extends EventType> = Extract<Event_4, {
-    type: Type;
-}>;
+declare type Payload_3<Type extends EventType> = BaseEvents.Payload<Event_4, Type>;
 
 /**
  * Extracts a single event type matching the given key from the Window {@link Event} union.
  *
+ * @see {@link ByType}
+ *
  * @typeParam Type String key specifying the event to extract
  */
-declare type Payload_3<Type extends EventType_2> = Extract<Event_6, {
-    type: Type;
-}>;
+declare type Payload_4<Type extends EventType_2> = BaseEvents.Payload<Event_6, Type>;
 
 /**
  * Extracts a single event type matching the given key from the Application {@link Event} union.
  *
+ * @see {@link ByType}
+ *
  * @typeParam Type String key specifying the event to extract
  */
-declare type Payload_4<Type extends EventType_3> = Extract<Event_3, {
-    type: Type;
-}>;
+declare type Payload_5<Type extends EventType_3> = BaseEvents.Payload<Event_3, Type>;
 
 /**
  * Extracts a single event type matching the given key from the ExternalApplication {@link Event} union.
  *
+ * @see {@link ByType}
+ *
  * @typeParam Type String key specifying the event to extract
  */
-declare type Payload_5<Type extends EventType_4> = Extract<Event_7, {
-    type: Type;
-}>;
+declare type Payload_6<Type extends EventType_4> = BaseEvents.Payload<Event_7, Type>;
 
 /**
  * Extracts a single event type matching the given key from the Frame {@link Event} union.
  *
+ * @see {@link ByType}
+ *
  * @typeParam Type String key specifying the event to extract
  */
-declare type Payload_6<Type extends EventType_5> = Extract<Event_8, {
-    type: Type;
-}>;
+declare type Payload_7<Type extends EventType_5> = BaseEvents.Payload<Event_8, Type>;
 
 /**
  * Extracts a single event type matching the given key from the GlobalHotkey {@link Event} union.
  *
+ * @see {@link ByType}
+ *
  * @typeParam Type String key specifying the event to extract
  */
-declare type Payload_7<Type extends EventType_6> = Extract<Event_9, {
-    type: Type;
-}>;
+declare type Payload_8<Type extends EventType_6> = BaseEvents.Payload<Event_9, Type>;
 
 /**
  * Extracts a single event type matching the given key from the Platform {@link Event} union.
  *
- * @typeParam Type String key specifying the event to extract
- */
-declare type Payload_8<Type extends EventType_7> = Extract<Event_10, {
-    type: Type;
-}>;
-
-/**
- * Extracts a single event type matching the given key from the System {@link Event} union.
+ * @see {@link ByType}
  *
  * @typeParam Type String key specifying the event to extract
  */
-declare type Payload_9<Type extends EventType_8> = Extract<Event_11, {
-    type: Type;
-}>;
+declare type Payload_9<Type extends EventType_7> = BaseEvents.Payload<Event_10, Type>;
 
 /**
  * @interface
@@ -10490,7 +10582,7 @@ declare namespace PlatformEvents {
         PlatformEvent,
         EventType_7 as EventType,
         PlatformEventType,
-        Payload_8 as Payload,
+        Payload_9 as Payload,
         ByType_7 as ByType
     }
 }
@@ -11925,6 +12017,8 @@ declare interface ProtocolMap extends ProtocolMapBase {
         };
         response: void;
     };
+    'get-host-specs': GetterCall<OpenFin.HostSpecs>;
+    'get-os-info': GetterCall<OpenFin.OSInfo>;
     'system-get-printers': GetterCall<OpenFin.PrinterInfo[]>;
     'system-register-shutdown-handler': VoidCall;
     'get-domain-settings': ApiCall<OpenFin.ApplicationIdentity, OpenFin.DefaultDomainSettings>;
@@ -12781,7 +12875,7 @@ declare type Snapshot = {
  * _Note_ - In the case of using a custom provider, if a window has a layout property but does not call _Layout.init_ this event may not fire.
  * @interface
  */
-declare type SnapshotAppliedEvent = BaseEvent & {
+declare type SnapshotAppliedEvent = BaseEvents.BaseEvent & {
     topic: 'application';
     type: 'platform-snapshot-applied';
 };
@@ -13265,7 +13359,8 @@ declare class System extends EmitterBase<OpenFin.SystemEvent> {
      */
     getRvmInfo(): Promise<OpenFin.RVMInfo>;
     /**
-     * Retrieves system information.
+     * Retrieves general system information. If you need more detailed information about the
+     * OS and the currently logged in user, use `fin.System.getOSInfo()` instead.
      *
      * @example
      * ```js
@@ -13273,6 +13368,15 @@ declare class System extends EmitterBase<OpenFin.SystemEvent> {
      * ```
      */
     getHostSpecs(): Promise<OpenFin.HostSpecs>;
+    /**
+     * Retrieves information about the OS and the currently logged in user.
+     *
+     * @example
+     * ```js
+     * fin.System.getOSInfo().then(specs => console.log(specs)).catch(err => console.log(err));
+     * ```
+     */
+    getOSInfo(): Promise<OpenFin.OSInfo>;
     /**
      * Runs an executable or batch file. A path to the file must be included in options.
      * <br> A uuid may be optionally provided. If not provided, OpenFin will create a uuid for the new process.
@@ -14386,7 +14490,7 @@ declare namespace SystemEvents {
         SystemEvent,
         EventType_8 as EventType,
         SystemEventType,
-        Payload_9 as Payload,
+        Payload_10 as Payload,
         ByType_8 as ByType
     }
 }
@@ -14400,6 +14504,7 @@ declare type SystemEventType = EventType_8;
  * @interface
  */
 declare type SystemPermissions = {
+    getOSInfo: boolean;
     getAllExternalWindows: boolean;
     launchExternalProcess: boolean | {
         enabled: boolean;
@@ -15513,7 +15618,7 @@ declare namespace ViewEvents {
         PropagatedViewEvent,
         PropagatedEventType_2 as PropagatedEventType,
         PropagatedViewEventType,
-        Payload_2 as Payload,
+        Payload_3 as Payload,
         ByType
     }
 }
@@ -18034,7 +18139,7 @@ declare namespace WindowEvents {
         PropagatedEvent_3 as PropagatedEvent,
         PropagatedWindowEvent,
         PropagatedWindowEventType,
-        Payload_3 as Payload,
+        Payload_4 as Payload,
         ByType_2 as ByType
     }
 }