@openfin/fdc3-api 40.82.1 → 40.82.3

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

@@ -3699,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';
@@ -8562,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
  */
@@ -8620,6 +8638,7 @@ declare type Manifest = {
         enableErrorReporting?: boolean;
     };
     interopBrokerConfiguration: InteropBrokerOptions;
+    logUpload?: LogUploadOptions;
 };
 
 /**
@@ -9251,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
  */
@@ -9453,6 +9500,8 @@ declare namespace OpenFin {
         PlatformViewCreationOptions,
         ProcessAffinityStrategy,
         PlatformOptions,
+        LogUploaderUIOptions,
+        LogUploadOptions,
         Manifest,
         LayoutContent,
         LayoutItemConfig,
@@ -9480,6 +9529,7 @@ declare namespace OpenFin {
         Time,
         CpuInfo,
         GpuInfo,
+        OSInfo,
         HostSpecs,
         PrinterInfo_2 as PrinterInfo,
         Dpi,
@@ -9687,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>;
 
 /**
@@ -11948,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>;
@@ -13288,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
@@ -13296,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.
@@ -14423,6 +14504,7 @@ declare type SystemEventType = EventType_8;
  * @interface
  */
 declare type SystemPermissions = {
+    getOSInfo: boolean;
     getAllExternalWindows: boolean;
     launchExternalProcess: boolean | {
         enabled: boolean;

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

@@ -3699,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';
@@ -8562,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
  */
@@ -8620,6 +8638,7 @@ declare type Manifest = {
         enableErrorReporting?: boolean;
     };
     interopBrokerConfiguration: InteropBrokerOptions;
+    logUpload?: LogUploadOptions;
 };
 
 /**
@@ -9251,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
  */
@@ -9453,6 +9500,8 @@ declare namespace OpenFin {
         PlatformViewCreationOptions,
         ProcessAffinityStrategy,
         PlatformOptions,
+        LogUploaderUIOptions,
+        LogUploadOptions,
         Manifest,
         LayoutContent,
         LayoutItemConfig,
@@ -9480,6 +9529,7 @@ declare namespace OpenFin {
         Time,
         CpuInfo,
         GpuInfo,
+        OSInfo,
         HostSpecs,
         PrinterInfo_2 as PrinterInfo,
         Dpi,
@@ -9687,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>;
 
 /**
@@ -11948,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>;
@@ -13288,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
@@ -13296,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.
@@ -14423,6 +14504,7 @@ declare type SystemEventType = EventType_8;
  * @interface
  */
 declare type SystemPermissions = {
+    getOSInfo: boolean;
     getAllExternalWindows: boolean;
     launchExternalProcess: boolean | {
         enabled: boolean;

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

@@ -3699,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';
@@ -8562,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
  */
@@ -8620,6 +8638,7 @@ declare type Manifest = {
         enableErrorReporting?: boolean;
     };
     interopBrokerConfiguration: InteropBrokerOptions;
+    logUpload?: LogUploadOptions;
 };
 
 /**
@@ -9251,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
  */
@@ -9453,6 +9500,8 @@ declare namespace OpenFin {
         PlatformViewCreationOptions,
         ProcessAffinityStrategy,
         PlatformOptions,
+        LogUploaderUIOptions,
+        LogUploadOptions,
         Manifest,
         LayoutContent,
         LayoutItemConfig,
@@ -9480,6 +9529,7 @@ declare namespace OpenFin {
         Time,
         CpuInfo,
         GpuInfo,
+        OSInfo,
         HostSpecs,
         PrinterInfo_2 as PrinterInfo,
         Dpi,
@@ -9687,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>;
 
 /**
@@ -11948,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>;
@@ -13288,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
@@ -13296,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.
@@ -14423,6 +14504,7 @@ declare type SystemEventType = EventType_8;
  * @interface
  */
 declare type SystemPermissions = {
+    getOSInfo: boolean;
     getAllExternalWindows: boolean;
     launchExternalProcess: boolean | {
         enabled: boolean;

package/out/fdc3-api.d.ts

@@ -3758,6 +3758,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';
@@ -8855,6 +8856,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
  */
@@ -8913,6 +8931,7 @@ declare type Manifest = {
         enableErrorReporting?: boolean;
     };
     interopBrokerConfiguration: InteropBrokerOptions;
+    logUpload?: LogUploadOptions;
 };
 
 /**
@@ -9556,6 +9575,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
  */
@@ -9768,6 +9815,8 @@ declare namespace OpenFin {
         PlatformViewCreationOptions,
         ProcessAffinityStrategy,
         PlatformOptions,
+        LogUploaderUIOptions,
+        LogUploadOptions,
         Manifest,
         LayoutContent,
         LayoutItemConfig,
@@ -9795,6 +9844,7 @@ declare namespace OpenFin {
         Time,
         CpuInfo,
         GpuInfo,
+        OSInfo,
         HostSpecs,
         PrinterInfo_2 as PrinterInfo,
         Dpi,
@@ -10002,6 +10052,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>;
 
 /**
@@ -12341,6 +12410,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>;
@@ -13687,7 +13758,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
@@ -13695,6 +13767,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.
@@ -14822,6 +14903,7 @@ declare type SystemEventType = EventType_8;
  * @interface
  */
 declare type SystemPermissions = {
+    getOSInfo: boolean;
     getAllExternalWindows: boolean;
     launchExternalProcess: boolean | {
         enabled: boolean;

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@openfin/fdc3-api",
-    "version": "40.82.1",
+    "version": "40.82.3",
     "description": "OpenFin fdc3 module utilities and types.",
     "license": "SEE LICENSE IN LICENSE.MD",
     "private": false,