@openfin/node-adapter 34.78.52 → 34.78.56

package/out/node-adapter-public.d.ts

@@ -918,7 +918,6 @@ declare namespace ApplicationEvents {
         WindowRespondingEvent,
         WindowStartLoadEvent,
         ApplicationWindowEvent,
-        ApplicationWindowEventTypes,
         ClosedEvent,
         ConnectedEvent_2 as ConnectedEvent,
         ApplicationConnectedEvent,
@@ -1337,11 +1336,6 @@ declare type ApplicationType = {
  */
 declare type ApplicationWindowEvent = WindowAlertRequestedEvent | WindowCreatedEvent | WindowEndLoadEvent | WindowNotRespondingEvent | WindowRespondingEvent | WindowStartLoadEvent;
 
-/**
- * Array of valid `type` values for an {@link ApplicationWindowEvent}.
- */
-declare const ApplicationWindowEventTypes: readonly ["window-alert-requested", "window-created", "window-end-load", "window-not-responding", "window-responding", "window-start-load"];
-
 declare type ApplicationWindowInfo = OpenFin.ApplicationWindowInfo;
 
 /**
@@ -3646,7 +3640,7 @@ declare type ConstWindowOptions = {
     /**
      * @defaultValue true
      *
-     * Toggling off would keep the Window alive even if all its Views were closed.
+     * Setting this to false would keep the Window alive even if all its Views were closed.
      * This is meant for advanced users and should be used with caution.
      * Limitations - Once a Layout has been emptied out of all views it's not usable anymore, and certain API calls will fail.
      * Use `layout.replace` to create a fresh Layout instance in case you want to populate it with Views again.
@@ -3656,7 +3650,8 @@ declare type ConstWindowOptions = {
     /**
      * @defaultValue 'all'
      *
-     * Determines which views prevent close if `closeOnLastViewRemoved` is set to true. Defaults to `all`. You may want to switch this to `layout` if using View closeBehavior: 'hide'.
+     * When `closeOnLastViewRemoved` is set to true, determines which views prevent closing the window.
+     +    * Defaults to `all`. You may want to switch this to `layout` if using View closeBehavior: 'hide'.
      * **NOTE:** - This option is ignored in non-Platforms apps.
      */
     viewsPreventingClose: 'all' | 'layout';
@@ -4463,7 +4458,7 @@ declare type CreateViewPayload = {
 /**
  * @interface
  */
-declare type CreateViewTarget = LayoutIdentity & {
+declare type CreateViewTarget = (Identity_5 | LayoutIdentity) & {
     /**
      * If specified, view creation will not attach to a window and caller must
      * insert the view into the layout explicitly
@@ -4603,6 +4598,14 @@ declare type DestroyedEvent = BaseEvent_4 & {
     type: 'destroyed';
 };
 
+/**
+ * @interface
+ */
+declare type DeviceInfo = {
+    vendorId: string | number;
+    productId: string | number;
+};
+
 /**
  * Generated when a page's theme color changes. This is usually due to encountering a meta tag.
  * @interface
@@ -5063,9 +5066,10 @@ declare type EntityTypeHelpers<T extends EntityType_2> = T extends 'view' ? {
 } : never;
 
 declare interface Environment {
-    initLayout(fin: OpenFin.Fin<OpenFin.EntityType>, wire: Transport, options: OpenFin.InitLayoutOptions): Promise<OpenFin.LayoutManager<OpenFin.LayoutSnapshot>>;
+    initLayoutManager(fin: OpenFin.Fin<OpenFin.EntityType>, wire: Transport, options: OpenFin.InitLayoutOptions): Promise<OpenFin.LayoutManager<OpenFin.LayoutSnapshot>>;
     createLayout(layoutManager: OpenFin.LayoutManager<OpenFin.LayoutSnapshot>, options: OpenFin.CreateLayoutOptions): Promise<void>;
     destroyLayout(layoutManager: OpenFin.LayoutManager<OpenFin.LayoutSnapshot>, layoutIdentity: OpenFin.LayoutIdentity): Promise<void>;
+    resolveLayout(layoutManager: OpenFin.LayoutManager<OpenFin.LayoutSnapshot>, layoutIdentity: OpenFin.LayoutIdentity): Promise<any>;
     initPlatform(fin: OpenFin.Fin<OpenFin.EntityType>, ...args: Parameters<OpenFin.Fin['Platform']['init']>): ReturnType<OpenFin.Fin['Platform']['init']>;
     observeBounds(element: Element, onChange: (bounds: DOMRect) => Promise<void> | void): () => void;
     writeToken(path: string, token: string): Promise<string>;
@@ -5115,7 +5119,7 @@ declare type Event_10 = ApplicationEvents.Event | ApiReadyEvent | SnapshotApplie
  *  under the {@link OpenFin.SystemEvents} namespace (payloads inherited from propagated events are defined in the namespace
  *  from which they propagate).
  */
-declare type Event_11 = ExcludeRequested<WindowEvents.PropagatedEvent<'system'>> | ViewEvents.PropagatedEvent<'system'> | ApplicationEvents.PropagatedEvent<'system'> | ApplicationCreatedEvent | DesktopIconClickedEvent | IdleEvent | MonitorEvent | SessionChangedEvent | AppVersionEventWithId | SystemShutdownEvent;
+declare type Event_11 = ExcludeRequested<WindowEvents.PropagatedEvent<'system'>> | ExcludeRequested<ViewEvents.PropagatedEvent<'system'>> | ExcludeRequested<ApplicationEvents.PropagatedEvent<'system'>> | ApplicationCreatedEvent | DesktopIconClickedEvent | IdleStateChangedEvent | MonitorInfoChangedEvent | SessionChangedEvent | AppVersionEventWithId | SystemShutdownEvent;
 
 /**
  * [Union](https://www.typescriptlang.org/docs/handbook/2/everyday-types.html#union-types) containing every possible event that can be emitted by a {@link Channel}.  Events are
@@ -5653,7 +5657,7 @@ declare type FileDownloadEvent = {
  *
  * @interface
  */
-declare type FileDownloadLocationChangedEvent = BaseApplicationEvent & {
+declare type FileDownloadLocationChangedEvent = BaseEvent_3 & {
     type: 'file-download-location-changed';
 };
 
@@ -6660,6 +6664,11 @@ declare type IdentityEvent = BaseEvent & {
 
 /* Excluded from this release type: IdEventType */
 
+/**
+ * @deprecated Renamed to {@link IdleStateChangedEvent}.
+ */
+declare type IdleEvent = IdleStateChangedEvent;
+
 /**
  * Generated when a user enters or returns from idle state.
  * @remarks This method is continuously generated every minute while the user is in idle.
@@ -6667,7 +6676,7 @@ declare type IdentityEvent = BaseEvent & {
  * A user returns from idle state when the computer is unlocked or keyboard/mouse activity has resumed.
  * @interface
  */
-declare type IdleEvent = BaseEvent_8 & {
+declare type IdleStateChangedEvent = BaseEvent_8 & {
     type: 'idle-state-changed';
     elapsedTime: number;
     isIdle: boolean;
@@ -7442,7 +7451,7 @@ declare class InteropBroker extends Base {
      * // }
      * ```
      *
-     * More information on the IntentResolution type can be found in the [FDC3 documentation](https://fdc3.finos.org/docs/api/ref/IntentResolution).
+     * More information on the IntentResolution type can be found in the [FDC3 documentation](https://fdc3.finos.org/docs/api/ref/Metadata#intentresolution).
      *
      * @param contextForIntent Data passed between entities and applications.
      * @param clientIdentity Identity of the Client making the request.
@@ -8618,7 +8627,7 @@ declare type LaunchIntoPlatformPayload = {
 declare class Layout extends Base {
     #private;
     /* Excluded from this release type: init */
-    identity: OpenFin.LayoutIdentity;
+    identity: OpenFin.Identity | OpenFin.LayoutIdentity;
     private platform;
     wire: Transport;
     /* Excluded from this release type: __constructor */
@@ -8834,25 +8843,23 @@ declare type LayoutEntityTypes = Exclude<GoldenLayout.ItemType, 'component' | 'r
  */
 declare type LayoutIdentity = Identity_5 & {
     /**
-     * The name of the layout an action should be targeted to. When not provided,
-     * OpenFin attempts to resolve the instance via visibility checks.
+     * The name of the layout in a given window.
      */
-    layoutName?: string;
+    layoutName: string;
 };
 
 /**
- * Generated when a window and all of its layout's views have either finished or failed navigation.
+ * Generated when the window and all of its layout's views have either finished or failed navigation, once per layout.
  * @interface
  */
 declare type LayoutInitializedEvent = BaseEvent_5 & {
     type: 'layout-initialized';
+    layoutIdentity: OpenFin.LayoutIdentity;
     ofViews: (OpenFin.Identity & {
         entityType: 'view';
     })[];
 };
 
-/* Excluded from this release type: LayoutInstance */
-
 /**
  * Represents the arrangement of Views within a Platform window's Layout. We do not recommend trying
  * to build Layouts or LayoutItems by hand and instead use calls such as {@link Platform#getSnapshot getSnapshot}.
@@ -8880,7 +8887,7 @@ declare type LayoutItemConfig = {
  *
  * **NOTE**: Internal use only. This type is reserved for Workspace Browser implementation.
  *
- * Responsible for aggergating all layout snapshots and storing LayoutInstances
+ * Responsible for aggregating all layout snapshots and storing layout instances
  */
 declare interface LayoutManager<T extends LayoutSnapshot> {
     /**
@@ -8904,16 +8911,6 @@ declare interface LayoutManager<T extends LayoutSnapshot> {
      * @throws if Object.keys(snapshot).length > 1
      */
     applyLayoutSnapshot(snapshot: T): Promise<void>;
-    /**
-     * Called at the start of layout initialization. Adds a new LayoutInstance if the snapshot
-     * contains a single layout.
-     *
-     * Throws if the snapshot contains more than 1 layout, it is expected that the user handles calling
-     * fin.Platform.Layout.create() once for each layout to properly connect it to their UI state.
-     *
-     * @param snapshot
-     * @throws if Object.keys(snapshot).length > 1
-     */
     /**
      * @experimental
      *
@@ -8934,31 +8931,49 @@ declare interface LayoutManager<T extends LayoutSnapshot> {
     /**
      * @experimental
      *
-     * @param layoutIdentity
-     * @returns
+     * A hook provided to the consumer for controlling how OpenFin routes Layout API calls. Override
+     * this method to control the target layout for Layout API calls.
+     *
+     * Example use case: You have hidden all the layouts and are showing a dialog that will
+     * execute an API call (ex: Layout.replace()) - override this method and save the
+     * "last visible" layout identity and return it.
+     *
+     * By default, OpenFin will use a series of checks to determine which Layout the API
+     * call must route to in this order of precedence:
+     * - try to resolve the layout from the layoutIdentity, throws if missing
+     * - if there is only 1 layout, resolves that one
+     * - enumerates all layouts checks visibility via element offsetTop/Left + window.innerHeight/Width
+     * - returns undefined
+     *
+     * @param identity
+     * @returns LayoutIdentity | undefined
      */
-    resolveLayout(layoutIdentity?: LayoutIdentity): Promise<LayoutInstance>;
+    resolveLayoutIdentity(identity?: Identity_5 | LayoutIdentity): LayoutIdentity | undefined;
     /**
      * @experimental
      *
-     * Returns a LayoutInstance if one exists with the name layoutIdentity.layoutName.
-     * Throws if it does not exist.
-     * @param layoutName
-     * @returns
+     * A hook provided to the consumer when it's time to remove a layout. Use this hook to
+     * update your local state and remove the layout for the given LayoutIdentity. Note that
+     * this hook does not call `fin.Platform.Layout.destroy()` for you, instead it is to
+     * signify to your application it's time to destroy this layout.
+     *
+     * Note that if the Window Option {@link WindowOptions.closeOnLastViewRemoved} is true, and the last View in this layout is closed, this hook will be called before the window closes.
+     *
+     * @param LayoutIdentity
      */
-    getLayoutByName(layoutName: string): LayoutInstance;
+    removeLayout({ layoutName }: LayoutIdentity): Promise<void>;
     /**
      * @experimental
      */
-    getLayouts(): Record<string, LayoutInstance>;
+    getLayoutIdentityForView(viewIdentity: Identity_5): LayoutIdentity;
     /**
      * @experimental
      */
-    getLayoutIdentityForView(viewIdentity: Identity_5): LayoutIdentity;
+    isLayoutVisible({ layoutName }: LayoutIdentity): boolean;
     /**
      * @experimental
      */
-    isLayoutVisible({ layoutName }: LayoutIdentity): boolean;
+    size(): number;
 }
 
 /**
@@ -9005,7 +9020,7 @@ declare class LayoutModule extends Base {
      * const layoutConfig = await layout.getConfig();
      * ```
      */
-    wrap(identity: OpenFin.LayoutIdentity): Promise<OpenFin.Layout>;
+    wrap(identity: OpenFin.Identity | OpenFin.LayoutIdentity): Promise<OpenFin.Layout>;
     /**
      * Synchronously returns a Layout object that represents a Window's layout.
      *
@@ -9025,7 +9040,7 @@ declare class LayoutModule extends Base {
      * const layoutConfig = await layout.getConfig();
      * ```
      */
-    wrapSync(identity: OpenFin.LayoutIdentity): OpenFin.Layout;
+    wrapSync(identity: OpenFin.Identity | OpenFin.LayoutIdentity): OpenFin.Layout;
     /**
      * Asynchronously returns a Layout object that represents a Window's layout.
      *
@@ -9201,11 +9216,12 @@ declare type LayoutPosition = 'top' | 'bottom' | 'left' | 'right';
 declare type LayoutPresetType = 'columns' | 'grid' | 'rows' | 'tabs';
 
 /**
- * Generated when a window and all of its layout's views have been created and can receive API calls.
+ * Generated when the layout and all of the its views have been created and can receive API calls.
  * @interface
  */
 declare type LayoutReadyEvent = BaseEvent_5 & {
     type: 'layout-ready';
+    layoutIdentity: OpenFin.LayoutIdentity;
     views: (OpenFin.Identity & {
         success: boolean;
     })[];
@@ -9552,14 +9568,9 @@ declare type MonitorDetails = {
 };
 
 /**
- * Generated on changes of a monitor's size/location.
- * @remarks A monitor's size changes when the taskbar is resized or relocated.
- * The available space of a monitor defines a rectangle that is not occupied by the taskbar
- * @interface
+ * @deprecated Renamed to {@link MonitorInfoChangedEvent}.
  */
-declare type MonitorEvent = BaseEvent_8 & OpenFin.MonitorInfo & {
-    type: 'monitor-info-changed';
-};
+declare type MonitorEvent = MonitorInfoChangedEvent;
 
 /**
  * @interface
@@ -9583,6 +9594,16 @@ declare type MonitorInfo = {
     virtualScreen: DipRect;
 };
 
+/**
+ * Generated on changes of a monitor's size/location.
+ * @remarks A monitor's size changes when the taskbar is resized or relocated.
+ * The available space of a monitor defines a rectangle that is not occupied by the taskbar
+ * @interface
+ */
+declare type MonitorInfoChangedEvent = BaseEvent_8 & OpenFin.MonitorInfo & {
+    type: 'monitor-info-changed';
+};
+
 /**
  * @interface
  */
@@ -10138,6 +10159,7 @@ declare namespace OpenFin {
         WebPermission,
         VerboseWebPermission,
         OpenExternalPermission,
+        DeviceInfo,
         Permissions_2 as Permissions,
         PlatformWindowCreationOptions,
         PlatformWindowOptions,
@@ -10295,7 +10317,6 @@ declare namespace OpenFin {
         InitLayoutOptions,
         LayoutManagerConstructor,
         LayoutManagerOverride,
-        LayoutInstance,
         LayoutManager,
         CreateLayoutOptions,
         PresetLayoutOptions_2 as PresetLayoutOptions,
@@ -10487,6 +10508,7 @@ declare type Permissions_2 = {
     Application?: Partial<ApplicationPermissions>;
     System?: Partial<SystemPermissions>;
     webAPIs?: WebPermission[];
+    devices?: DeviceInfo[];
 };
 
 declare type PermissionState_2 = 'granted' | 'denied' | 'unavailable';
@@ -12827,7 +12849,7 @@ declare type ReplaceLayoutPayload = {
     /**
      * Identity of the window whose layout will be replaced.
      */
-    target: LayoutIdentity;
+    target: Identity_5 | LayoutIdentity;
 };
 
 /**
@@ -15178,7 +15200,9 @@ declare namespace SystemEvents {
         NotRequested,
         ExcludeRequested,
         BaseEvent_8 as BaseEvent,
+        IdleStateChangedEvent,
         IdleEvent,
+        MonitorInfoChangedEvent,
         MonitorEvent,
         SessionChangedEvent,
         AppVersionEvent,
@@ -16415,7 +16439,7 @@ declare type ViewCreationOrReference = OpenFin.Identity | OpenFin.PlatformViewCr
  */
 declare type ViewDetachedEvent = BaseEvent_5 & {
     type: 'view-detached';
-    target: OpenFin.Identity;
+    target: OpenFin.Identity | null;
     previousTarget: OpenFin.Identity;
     viewIdentity: OpenFin.Identity;
 };
@@ -17651,7 +17675,7 @@ declare namespace WebContentsEvents {
  * `clipboard-read`: Request access to read from the clipboard.<br>
  * `clipboard-sanitized-write`: Request access to write to the clipboard.
  */
-declare type WebPermission = 'audio' | 'video' | 'geolocation' | 'notifications' | 'midiSysex' | 'pointerLock' | 'fullscreen' | 'openExternal' | 'clipboard-read' | 'clipboard-sanitized-write' | OpenExternalPermission;
+declare type WebPermission = 'audio' | 'video' | 'geolocation' | 'notifications' | 'midiSysex' | 'pointerLock' | 'fullscreen' | 'openExternal' | 'clipboard-read' | 'clipboard-sanitized-write' | 'hid' | 'usb' | OpenExternalPermission;
 
 /**
  * Object representing headers and their values, where the
@@ -19253,7 +19277,7 @@ declare class _Window extends WebContents<OpenFin.WindowEvent> {
       * Generated when an alert is fired and suppressed due to the customWindowAlert flag being true.
       * @interface
       */
-     declare type WindowAlertRequestedEvent = BaseApplicationEvent & {
+     declare type WindowAlertRequestedEvent = BaseEvent_3 & {
          type: 'window-alert-requested';
      };
 
@@ -19301,7 +19325,7 @@ declare class _Window extends WebContents<OpenFin.WindowEvent> {
       * Generated when a child window is created.
       * @interface
       */
-     declare type WindowCreatedEvent = BaseApplicationEvent & {
+     declare type WindowCreatedEvent = BaseEvent_3 & {
          type: 'window-created';
      };
 
@@ -19358,7 +19382,7 @@ declare class _Window extends WebContents<OpenFin.WindowEvent> {
       * Generated when a child window ends loading.
       * @interface
       */
-     declare type WindowEndLoadEvent = BaseApplicationEvent & {
+     declare type WindowEndLoadEvent = BaseEvent_3 & {
          type: 'window-end-load';
      };
 
@@ -19572,7 +19596,7 @@ declare class _Window extends WebContents<OpenFin.WindowEvent> {
       * Generated when a child window is not responding.
       * @interface
       */
-     declare type WindowNotRespondingEvent = BaseApplicationEvent & {
+     declare type WindowNotRespondingEvent = BaseEvent_3 & {
          type: 'window-not-responding';
      };
 
@@ -19604,7 +19628,7 @@ declare class _Window extends WebContents<OpenFin.WindowEvent> {
       * Generated when a child window is responding.
       * @interface
       */
-     declare type WindowRespondingEvent = BaseApplicationEvent & {
+     declare type WindowRespondingEvent = BaseEvent_3 & {
          type: 'window-responding';
      };
 
@@ -19633,7 +19657,7 @@ declare class _Window extends WebContents<OpenFin.WindowEvent> {
       * Generated when a child window starts loading.
       * @interface
       */
-     declare type WindowStartLoadEvent = BaseApplicationEvent & {
+     declare type WindowStartLoadEvent = BaseEvent_3 & {
          type: 'window-start-load';
      };