@openfin/node-adapter 37.81.19 → 38.81.22

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

@@ -2018,6 +2018,15 @@ declare type ByType_7<Type extends EventType_7> = Payload_8<Type>;
  */
 declare type ByType_8<Type extends EventType_8> = Payload_9<Type>;
 
+/**
+ * Extracts a single event type matching the given key from the Layout DOM {@link Event} union.
+ *
+ * Alias for {@link Payload}, which may read better in source.
+ *
+ * @typeParam Type String key specifying the event to extract
+ */
+declare type ByType_9<Type extends EventType_9> = Payload_10<Type>;
+
 /**
  * Configuration for page capture.
  *
@@ -3820,6 +3829,14 @@ declare interface Container extends EventEmitter_2 {
     close(): boolean;
 }
 
+/**
+ * Generated when a Layout Container Component was created.
+ * @interface
+ */
+declare type ContainerCreatedEvent = LayoutDOMEvent & {
+    type: 'container-created';
+};
+
 /**
  * Generated when content navigation or redirection is blocked by {@link OpenFin.DomainSettings}.
  */
@@ -4664,7 +4681,14 @@ declare type DomainApiSettings = {
      *
      * @defaultValue 'global'
      */
-    fin: InjectionType;
+    fin?: InjectionType;
+    /**
+     * API permissions for domains matched to the current {@link DomainSettingsRule}.
+     *
+     * @remarks If an application manifest includes this property in {@link DomainSettings.default},
+     * then {@link WindowOptions.permissions} and {@link ViewOptions.permissions} will be **ignored**.
+     */
+    permissions?: Permissions_2;
 };
 
 /**
@@ -4998,6 +5022,7 @@ declare type EntityTypeHelpers<T extends EntityType_2> = T extends 'view' ? {
 } : never;
 
 declare interface Environment {
+    layoutAllowedInContext(fin: OpenFin.Fin<OpenFin.EntityType>): boolean;
     initLayoutManager(fin: OpenFin.Fin<OpenFin.EntityType>, wire: Transport, options: OpenFin.InitLayoutOptions): Promise<OpenFin.LayoutManager<OpenFin.LayoutSnapshot>>;
     applyLayoutSnapshot(fin: OpenFin.Fin<OpenFin.EntityType>, layoutManager: OpenFin.LayoutManager<OpenFin.LayoutSnapshot>, options: OpenFin.InitLayoutOptions): Promise<void>;
     createLayout(layoutManager: OpenFin.LayoutManager<OpenFin.LayoutSnapshot>, options: OpenFin.CreateLayoutOptions): Promise<void>;
@@ -5060,6 +5085,12 @@ declare type Event_10 = ApplicationEvents.Event | ApiReadyEvent | SnapshotApplie
  */
 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 the HTMLElement Layout container.
+ * Events are discriminated by {@link LayoutDOMEvent.type}.
+ */
+declare type Event_12 = TabCreatedEvent | TabClosedEvent | TabDroppedEvent | ContainerCreatedEvent | LayoutStateChangedEvent;
+
 /**
  * [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
  * discriminated by {@link BaseEvents.BaseEvent.type | their type}.  Event payloads unique to `Channel` can be found
@@ -5229,6 +5260,11 @@ declare type EventType_7 = Event_10['type'];
  */
 declare type EventType_8 = Event_11['type'];
 
+/**
+ * Union of possible `type` values for a {@link LayoutDOMEvent}.
+ */
+declare type EventType_9 = Event_12['type'];
+
 /* Excluded from this release type: EventWithId */
 
 /* Excluded from this release type: ExcludeRequested */
@@ -8421,6 +8457,32 @@ declare type LayoutComponent = LayoutItemConfig & {
 
 declare type LayoutContent = Array<LayoutItemConfig | LayoutRow | LayoutColumn | LayoutComponent>;
 
+/**
+ * The base payload for the CustomEvent.detail property for Layout events emitted on the layout container element.
+ */
+declare type LayoutDOMEvent = Identity_5 & {
+    type: string;
+    topic: 'openfin-DOM-event';
+    tabSelector: string;
+    containerSelector: string;
+};
+
+declare type LayoutDOMEvent_2 = LayoutDOMEvents.Event;
+
+declare namespace LayoutDOMEvents {
+    export {
+        TabCreatedEvent,
+        TabClosedEvent,
+        TabDroppedEvent,
+        ContainerCreatedEvent,
+        LayoutStateChangedEvent,
+        Event_12 as Event,
+        EventType_9 as EventType,
+        Payload_10 as Payload,
+        ByType_9 as ByType
+    }
+}
+
 declare type LayoutEntitiesClient = ApiClient<LayoutEntitiesController>;
 
 declare type LayoutEntitiesController = {
@@ -8866,6 +8928,14 @@ declare type LayoutSnapshot = {
     layouts: Record<string, LayoutOptions>;
 };
 
+/**
+ * Generated when the Layout experiences a state change, for example tabs added/removed.
+ * @interface
+ */
+declare type LayoutStateChangedEvent = LayoutDOMEvent & {
+    type: 'layout-state-changed';
+};
+
 /**
  * @interface
  */
@@ -9953,6 +10023,7 @@ declare namespace OpenFin {
         AppVersionCompleteEvent,
         AppVersionRuntimeStatusEvent,
         Events,
+        LayoutDOMEvents,
         BaseEvent_10 as BaseEvent,
         WebContentsEvent_2 as WebContentsEvent,
         SystemEvent_2 as SystemEvent,
@@ -9961,6 +10032,7 @@ declare namespace OpenFin {
         ViewEvent_2 as ViewEvent,
         GlobalHotkeyEvent_2 as GlobalHotkeyEvent,
         FrameEvent_2 as FrameEvent,
+        LayoutDOMEvent_2 as LayoutDOMEvent,
         PlatformEvent_2 as PlatformEvent,
         ExternalApplicationEvent_2 as ExternalApplicationEvent,
         ContextMenuOptions,
@@ -10034,6 +10106,15 @@ 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 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, {
+    type: Type;
+}>;
+
 /**
  * Extracts a single event type matching the given key from the View {@link Event} union.
  *
@@ -10141,6 +10222,14 @@ declare type PerformanceReportEvent = Performance & BaseEvent_5 & {
 
 /**
  * @interface
+ *
+ * Governs access to OpenFin APIs.  Property paths of this literal match call
+ * paths for OpenFin API functions (e.g. `System.launchExternalProcess`), and can
+ * take a value of `true`, `false`, or in some cases an object literal for more-complicated
+ * semantics.
+ *
+ * For a list of APIs that are secure by default (and thus must be granted access via
+ * `permissions`), see https://developers.openfin.co/of-docs/docs/api-security#secured-apis.
  */
 declare type Permissions_2 = {
     Application?: Partial<ApplicationPermissions>;
@@ -14876,6 +14965,23 @@ declare interface Tab {
     setActive(isActive: boolean): void;
 }
 
+/**
+ * Generated when a Layout Tab Component was closed.
+ * @interface
+ */
+declare type TabClosedEvent = LayoutDOMEvent & {
+    type: 'tab-closed';
+    url: string;
+};
+
+/**
+ * Generated when a Layout Tab Component was created.
+ * @interface
+ */
+declare type TabCreatedEvent = LayoutDOMEvent & {
+    type: 'tab-created';
+};
+
 declare interface TabDragListener extends EventEmitter_2 {
     /**
      * A reference to the content item this tab relates to
@@ -14883,6 +14989,15 @@ declare interface TabDragListener extends EventEmitter_2 {
     contentItem: ContentItem;
 }
 
+/**
+ * Generated when a Layout Tab Component was dropped.
+ * @interface
+ */
+declare type TabDroppedEvent = LayoutDOMEvent & {
+    type: 'tab-dropped';
+    url: string;
+};
+
 /**
  * A TabStack is used to manage the state of a stack of tabs within an OpenFin Layout.
  */

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

@@ -2018,6 +2018,15 @@ declare type ByType_7<Type extends EventType_7> = Payload_8<Type>;
  */
 declare type ByType_8<Type extends EventType_8> = Payload_9<Type>;
 
+/**
+ * Extracts a single event type matching the given key from the Layout DOM {@link Event} union.
+ *
+ * Alias for {@link Payload}, which may read better in source.
+ *
+ * @typeParam Type String key specifying the event to extract
+ */
+declare type ByType_9<Type extends EventType_9> = Payload_10<Type>;
+
 /**
  * Configuration for page capture.
  *
@@ -3820,6 +3829,14 @@ declare interface Container extends EventEmitter_2 {
     close(): boolean;
 }
 
+/**
+ * Generated when a Layout Container Component was created.
+ * @interface
+ */
+declare type ContainerCreatedEvent = LayoutDOMEvent & {
+    type: 'container-created';
+};
+
 /**
  * Generated when content navigation or redirection is blocked by {@link OpenFin.DomainSettings}.
  */
@@ -4664,7 +4681,14 @@ declare type DomainApiSettings = {
      *
      * @defaultValue 'global'
      */
-    fin: InjectionType;
+    fin?: InjectionType;
+    /**
+     * API permissions for domains matched to the current {@link DomainSettingsRule}.
+     *
+     * @remarks If an application manifest includes this property in {@link DomainSettings.default},
+     * then {@link WindowOptions.permissions} and {@link ViewOptions.permissions} will be **ignored**.
+     */
+    permissions?: Permissions_2;
 };
 
 /**
@@ -4998,6 +5022,7 @@ declare type EntityTypeHelpers<T extends EntityType_2> = T extends 'view' ? {
 } : never;
 
 declare interface Environment {
+    layoutAllowedInContext(fin: OpenFin.Fin<OpenFin.EntityType>): boolean;
     initLayoutManager(fin: OpenFin.Fin<OpenFin.EntityType>, wire: Transport, options: OpenFin.InitLayoutOptions): Promise<OpenFin.LayoutManager<OpenFin.LayoutSnapshot>>;
     applyLayoutSnapshot(fin: OpenFin.Fin<OpenFin.EntityType>, layoutManager: OpenFin.LayoutManager<OpenFin.LayoutSnapshot>, options: OpenFin.InitLayoutOptions): Promise<void>;
     createLayout(layoutManager: OpenFin.LayoutManager<OpenFin.LayoutSnapshot>, options: OpenFin.CreateLayoutOptions): Promise<void>;
@@ -5060,6 +5085,12 @@ declare type Event_10 = ApplicationEvents.Event | ApiReadyEvent | SnapshotApplie
  */
 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 the HTMLElement Layout container.
+ * Events are discriminated by {@link LayoutDOMEvent.type}.
+ */
+declare type Event_12 = TabCreatedEvent | TabClosedEvent | TabDroppedEvent | ContainerCreatedEvent | LayoutStateChangedEvent;
+
 /**
  * [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
  * discriminated by {@link BaseEvents.BaseEvent.type | their type}.  Event payloads unique to `Channel` can be found
@@ -5229,6 +5260,11 @@ declare type EventType_7 = Event_10['type'];
  */
 declare type EventType_8 = Event_11['type'];
 
+/**
+ * Union of possible `type` values for a {@link LayoutDOMEvent}.
+ */
+declare type EventType_9 = Event_12['type'];
+
 /* Excluded from this release type: EventWithId */
 
 /* Excluded from this release type: ExcludeRequested */
@@ -8421,6 +8457,32 @@ declare type LayoutComponent = LayoutItemConfig & {
 
 declare type LayoutContent = Array<LayoutItemConfig | LayoutRow | LayoutColumn | LayoutComponent>;
 
+/**
+ * The base payload for the CustomEvent.detail property for Layout events emitted on the layout container element.
+ */
+declare type LayoutDOMEvent = Identity_5 & {
+    type: string;
+    topic: 'openfin-DOM-event';
+    tabSelector: string;
+    containerSelector: string;
+};
+
+declare type LayoutDOMEvent_2 = LayoutDOMEvents.Event;
+
+declare namespace LayoutDOMEvents {
+    export {
+        TabCreatedEvent,
+        TabClosedEvent,
+        TabDroppedEvent,
+        ContainerCreatedEvent,
+        LayoutStateChangedEvent,
+        Event_12 as Event,
+        EventType_9 as EventType,
+        Payload_10 as Payload,
+        ByType_9 as ByType
+    }
+}
+
 declare type LayoutEntitiesClient = ApiClient<LayoutEntitiesController>;
 
 declare type LayoutEntitiesController = {
@@ -8866,6 +8928,14 @@ declare type LayoutSnapshot = {
     layouts: Record<string, LayoutOptions>;
 };
 
+/**
+ * Generated when the Layout experiences a state change, for example tabs added/removed.
+ * @interface
+ */
+declare type LayoutStateChangedEvent = LayoutDOMEvent & {
+    type: 'layout-state-changed';
+};
+
 /**
  * @interface
  */
@@ -9953,6 +10023,7 @@ declare namespace OpenFin {
         AppVersionCompleteEvent,
         AppVersionRuntimeStatusEvent,
         Events,
+        LayoutDOMEvents,
         BaseEvent_10 as BaseEvent,
         WebContentsEvent_2 as WebContentsEvent,
         SystemEvent_2 as SystemEvent,
@@ -9961,6 +10032,7 @@ declare namespace OpenFin {
         ViewEvent_2 as ViewEvent,
         GlobalHotkeyEvent_2 as GlobalHotkeyEvent,
         FrameEvent_2 as FrameEvent,
+        LayoutDOMEvent_2 as LayoutDOMEvent,
         PlatformEvent_2 as PlatformEvent,
         ExternalApplicationEvent_2 as ExternalApplicationEvent,
         ContextMenuOptions,
@@ -10034,6 +10106,15 @@ 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 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, {
+    type: Type;
+}>;
+
 /**
  * Extracts a single event type matching the given key from the View {@link Event} union.
  *
@@ -10141,6 +10222,14 @@ declare type PerformanceReportEvent = Performance & BaseEvent_5 & {
 
 /**
  * @interface
+ *
+ * Governs access to OpenFin APIs.  Property paths of this literal match call
+ * paths for OpenFin API functions (e.g. `System.launchExternalProcess`), and can
+ * take a value of `true`, `false`, or in some cases an object literal for more-complicated
+ * semantics.
+ *
+ * For a list of APIs that are secure by default (and thus must be granted access via
+ * `permissions`), see https://developers.openfin.co/of-docs/docs/api-security#secured-apis.
  */
 declare type Permissions_2 = {
     Application?: Partial<ApplicationPermissions>;
@@ -14876,6 +14965,23 @@ declare interface Tab {
     setActive(isActive: boolean): void;
 }
 
+/**
+ * Generated when a Layout Tab Component was closed.
+ * @interface
+ */
+declare type TabClosedEvent = LayoutDOMEvent & {
+    type: 'tab-closed';
+    url: string;
+};
+
+/**
+ * Generated when a Layout Tab Component was created.
+ * @interface
+ */
+declare type TabCreatedEvent = LayoutDOMEvent & {
+    type: 'tab-created';
+};
+
 declare interface TabDragListener extends EventEmitter_2 {
     /**
      * A reference to the content item this tab relates to
@@ -14883,6 +14989,15 @@ declare interface TabDragListener extends EventEmitter_2 {
     contentItem: ContentItem;
 }
 
+/**
+ * Generated when a Layout Tab Component was dropped.
+ * @interface
+ */
+declare type TabDroppedEvent = LayoutDOMEvent & {
+    type: 'tab-dropped';
+    url: string;
+};
+
 /**
  * A TabStack is used to manage the state of a stack of tabs within an OpenFin Layout.
  */

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

@@ -2018,6 +2018,15 @@ declare type ByType_7<Type extends EventType_7> = Payload_8<Type>;
  */
 declare type ByType_8<Type extends EventType_8> = Payload_9<Type>;
 
+/**
+ * Extracts a single event type matching the given key from the Layout DOM {@link Event} union.
+ *
+ * Alias for {@link Payload}, which may read better in source.
+ *
+ * @typeParam Type String key specifying the event to extract
+ */
+declare type ByType_9<Type extends EventType_9> = Payload_10<Type>;
+
 /**
  * Configuration for page capture.
  *
@@ -3820,6 +3829,14 @@ declare interface Container extends EventEmitter_2 {
     close(): boolean;
 }
 
+/**
+ * Generated when a Layout Container Component was created.
+ * @interface
+ */
+declare type ContainerCreatedEvent = LayoutDOMEvent & {
+    type: 'container-created';
+};
+
 /**
  * Generated when content navigation or redirection is blocked by {@link OpenFin.DomainSettings}.
  */
@@ -4664,7 +4681,14 @@ declare type DomainApiSettings = {
      *
      * @defaultValue 'global'
      */
-    fin: InjectionType;
+    fin?: InjectionType;
+    /**
+     * API permissions for domains matched to the current {@link DomainSettingsRule}.
+     *
+     * @remarks If an application manifest includes this property in {@link DomainSettings.default},
+     * then {@link WindowOptions.permissions} and {@link ViewOptions.permissions} will be **ignored**.
+     */
+    permissions?: Permissions_2;
 };
 
 /**
@@ -4998,6 +5022,7 @@ declare type EntityTypeHelpers<T extends EntityType_2> = T extends 'view' ? {
 } : never;
 
 declare interface Environment {
+    layoutAllowedInContext(fin: OpenFin.Fin<OpenFin.EntityType>): boolean;
     initLayoutManager(fin: OpenFin.Fin<OpenFin.EntityType>, wire: Transport, options: OpenFin.InitLayoutOptions): Promise<OpenFin.LayoutManager<OpenFin.LayoutSnapshot>>;
     applyLayoutSnapshot(fin: OpenFin.Fin<OpenFin.EntityType>, layoutManager: OpenFin.LayoutManager<OpenFin.LayoutSnapshot>, options: OpenFin.InitLayoutOptions): Promise<void>;
     createLayout(layoutManager: OpenFin.LayoutManager<OpenFin.LayoutSnapshot>, options: OpenFin.CreateLayoutOptions): Promise<void>;
@@ -5060,6 +5085,12 @@ declare type Event_10 = ApplicationEvents.Event | ApiReadyEvent | SnapshotApplie
  */
 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 the HTMLElement Layout container.
+ * Events are discriminated by {@link LayoutDOMEvent.type}.
+ */
+declare type Event_12 = TabCreatedEvent | TabClosedEvent | TabDroppedEvent | ContainerCreatedEvent | LayoutStateChangedEvent;
+
 /**
  * [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
  * discriminated by {@link BaseEvents.BaseEvent.type | their type}.  Event payloads unique to `Channel` can be found
@@ -5229,6 +5260,11 @@ declare type EventType_7 = Event_10['type'];
  */
 declare type EventType_8 = Event_11['type'];
 
+/**
+ * Union of possible `type` values for a {@link LayoutDOMEvent}.
+ */
+declare type EventType_9 = Event_12['type'];
+
 /* Excluded from this release type: EventWithId */
 
 /* Excluded from this release type: ExcludeRequested */
@@ -8421,6 +8457,32 @@ declare type LayoutComponent = LayoutItemConfig & {
 
 declare type LayoutContent = Array<LayoutItemConfig | LayoutRow | LayoutColumn | LayoutComponent>;
 
+/**
+ * The base payload for the CustomEvent.detail property for Layout events emitted on the layout container element.
+ */
+declare type LayoutDOMEvent = Identity_5 & {
+    type: string;
+    topic: 'openfin-DOM-event';
+    tabSelector: string;
+    containerSelector: string;
+};
+
+declare type LayoutDOMEvent_2 = LayoutDOMEvents.Event;
+
+declare namespace LayoutDOMEvents {
+    export {
+        TabCreatedEvent,
+        TabClosedEvent,
+        TabDroppedEvent,
+        ContainerCreatedEvent,
+        LayoutStateChangedEvent,
+        Event_12 as Event,
+        EventType_9 as EventType,
+        Payload_10 as Payload,
+        ByType_9 as ByType
+    }
+}
+
 declare type LayoutEntitiesClient = ApiClient<LayoutEntitiesController>;
 
 declare type LayoutEntitiesController = {
@@ -8866,6 +8928,14 @@ declare type LayoutSnapshot = {
     layouts: Record<string, LayoutOptions>;
 };
 
+/**
+ * Generated when the Layout experiences a state change, for example tabs added/removed.
+ * @interface
+ */
+declare type LayoutStateChangedEvent = LayoutDOMEvent & {
+    type: 'layout-state-changed';
+};
+
 /**
  * @interface
  */
@@ -9953,6 +10023,7 @@ declare namespace OpenFin {
         AppVersionCompleteEvent,
         AppVersionRuntimeStatusEvent,
         Events,
+        LayoutDOMEvents,
         BaseEvent_10 as BaseEvent,
         WebContentsEvent_2 as WebContentsEvent,
         SystemEvent_2 as SystemEvent,
@@ -9961,6 +10032,7 @@ declare namespace OpenFin {
         ViewEvent_2 as ViewEvent,
         GlobalHotkeyEvent_2 as GlobalHotkeyEvent,
         FrameEvent_2 as FrameEvent,
+        LayoutDOMEvent_2 as LayoutDOMEvent,
         PlatformEvent_2 as PlatformEvent,
         ExternalApplicationEvent_2 as ExternalApplicationEvent,
         ContextMenuOptions,
@@ -10034,6 +10106,15 @@ 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 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, {
+    type: Type;
+}>;
+
 /**
  * Extracts a single event type matching the given key from the View {@link Event} union.
  *
@@ -10141,6 +10222,14 @@ declare type PerformanceReportEvent = Performance & BaseEvent_5 & {
 
 /**
  * @interface
+ *
+ * Governs access to OpenFin APIs.  Property paths of this literal match call
+ * paths for OpenFin API functions (e.g. `System.launchExternalProcess`), and can
+ * take a value of `true`, `false`, or in some cases an object literal for more-complicated
+ * semantics.
+ *
+ * For a list of APIs that are secure by default (and thus must be granted access via
+ * `permissions`), see https://developers.openfin.co/of-docs/docs/api-security#secured-apis.
  */
 declare type Permissions_2 = {
     Application?: Partial<ApplicationPermissions>;
@@ -14876,6 +14965,23 @@ declare interface Tab {
     setActive(isActive: boolean): void;
 }
 
+/**
+ * Generated when a Layout Tab Component was closed.
+ * @interface
+ */
+declare type TabClosedEvent = LayoutDOMEvent & {
+    type: 'tab-closed';
+    url: string;
+};
+
+/**
+ * Generated when a Layout Tab Component was created.
+ * @interface
+ */
+declare type TabCreatedEvent = LayoutDOMEvent & {
+    type: 'tab-created';
+};
+
 declare interface TabDragListener extends EventEmitter_2 {
     /**
      * A reference to the content item this tab relates to
@@ -14883,6 +14989,15 @@ declare interface TabDragListener extends EventEmitter_2 {
     contentItem: ContentItem;
 }
 
+/**
+ * Generated when a Layout Tab Component was dropped.
+ * @interface
+ */
+declare type TabDroppedEvent = LayoutDOMEvent & {
+    type: 'tab-dropped';
+    url: string;
+};
+
 /**
  * A TabStack is used to manage the state of a stack of tabs within an OpenFin Layout.
  */

package/out/node-adapter.d.ts

@@ -2050,6 +2050,15 @@ declare type ByType_7<Type extends EventType_7> = Payload_8<Type>;
  */
 declare type ByType_8<Type extends EventType_8> = Payload_9<Type>;
 
+/**
+ * Extracts a single event type matching the given key from the Layout DOM {@link Event} union.
+ *
+ * Alias for {@link Payload}, which may read better in source.
+ *
+ * @typeParam Type String key specifying the event to extract
+ */
+declare type ByType_9<Type extends EventType_9> = Payload_10<Type>;
+
 /**
  * Configuration for page capture.
  *
@@ -3879,6 +3888,14 @@ declare interface Container extends EventEmitter_2 {
     close(): boolean;
 }
 
+/**
+ * Generated when a Layout Container Component was created.
+ * @interface
+ */
+declare type ContainerCreatedEvent = LayoutDOMEvent & {
+    type: 'container-created';
+};
+
 /**
  * Generated when content navigation or redirection is blocked by {@link OpenFin.DomainSettings}.
  */
@@ -4723,7 +4740,14 @@ declare type DomainApiSettings = {
      *
      * @defaultValue 'global'
      */
-    fin: InjectionType;
+    fin?: InjectionType;
+    /**
+     * API permissions for domains matched to the current {@link DomainSettingsRule}.
+     *
+     * @remarks If an application manifest includes this property in {@link DomainSettings.default},
+     * then {@link WindowOptions.permissions} and {@link ViewOptions.permissions} will be **ignored**.
+     */
+    permissions?: Permissions_2;
 };
 
 /**
@@ -5062,6 +5086,7 @@ declare type EntityTypeHelpers<T extends EntityType_2> = T extends 'view' ? {
 } : never;
 
 declare interface Environment {
+    layoutAllowedInContext(fin: OpenFin.Fin<OpenFin.EntityType>): boolean;
     initLayoutManager(fin: OpenFin.Fin<OpenFin.EntityType>, wire: Transport, options: OpenFin.InitLayoutOptions): Promise<OpenFin.LayoutManager<OpenFin.LayoutSnapshot>>;
     applyLayoutSnapshot(fin: OpenFin.Fin<OpenFin.EntityType>, layoutManager: OpenFin.LayoutManager<OpenFin.LayoutSnapshot>, options: OpenFin.InitLayoutOptions): Promise<void>;
     createLayout(layoutManager: OpenFin.LayoutManager<OpenFin.LayoutSnapshot>, options: OpenFin.CreateLayoutOptions): Promise<void>;
@@ -5124,6 +5149,12 @@ declare type Event_10 = ApplicationEvents.Event | ApiReadyEvent | SnapshotApplie
  */
 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 the HTMLElement Layout container.
+ * Events are discriminated by {@link LayoutDOMEvent.type}.
+ */
+declare type Event_12 = TabCreatedEvent | TabClosedEvent | TabDroppedEvent | ContainerCreatedEvent | LayoutStateChangedEvent;
+
 /**
  * [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
  * discriminated by {@link BaseEvents.BaseEvent.type | their type}.  Event payloads unique to `Channel` can be found
@@ -5293,6 +5324,11 @@ declare type EventType_7 = Event_10['type'];
  */
 declare type EventType_8 = Event_11['type'];
 
+/**
+ * Union of possible `type` values for a {@link LayoutDOMEvent}.
+ */
+declare type EventType_9 = Event_12['type'];
+
 /**
  * @internal
  */
@@ -8566,6 +8602,32 @@ declare type LayoutComponent = LayoutItemConfig & {
 
 declare type LayoutContent = Array<LayoutItemConfig | LayoutRow | LayoutColumn | LayoutComponent>;
 
+/**
+ * The base payload for the CustomEvent.detail property for Layout events emitted on the layout container element.
+ */
+declare type LayoutDOMEvent = Identity_5 & {
+    type: string;
+    topic: 'openfin-DOM-event';
+    tabSelector: string;
+    containerSelector: string;
+};
+
+declare type LayoutDOMEvent_2 = LayoutDOMEvents.Event;
+
+declare namespace LayoutDOMEvents {
+    export {
+        TabCreatedEvent,
+        TabClosedEvent,
+        TabDroppedEvent,
+        ContainerCreatedEvent,
+        LayoutStateChangedEvent,
+        Event_12 as Event,
+        EventType_9 as EventType,
+        Payload_10 as Payload,
+        ByType_9 as ByType
+    }
+}
+
 declare type LayoutEntitiesClient = ApiClient<LayoutEntitiesController>;
 
 declare type LayoutEntitiesController = {
@@ -9181,6 +9243,14 @@ declare type LayoutSnapshot = {
     layouts: Record<string, LayoutOptions>;
 };
 
+/**
+ * Generated when the Layout experiences a state change, for example tabs added/removed.
+ * @interface
+ */
+declare type LayoutStateChangedEvent = LayoutDOMEvent & {
+    type: 'layout-state-changed';
+};
+
 /**
  * @interface
  */
@@ -10290,6 +10360,7 @@ declare namespace OpenFin {
         AppVersionCompleteEvent,
         AppVersionRuntimeStatusEvent,
         Events,
+        LayoutDOMEvents,
         BaseEvent_10 as BaseEvent,
         WebContentsEvent_2 as WebContentsEvent,
         SystemEvent_2 as SystemEvent,
@@ -10298,6 +10369,7 @@ declare namespace OpenFin {
         ViewEvent_2 as ViewEvent,
         GlobalHotkeyEvent_2 as GlobalHotkeyEvent,
         FrameEvent_2 as FrameEvent,
+        LayoutDOMEvent_2 as LayoutDOMEvent,
         PlatformEvent_2 as PlatformEvent,
         ExternalApplicationEvent_2 as ExternalApplicationEvent,
         ContextMenuOptions,
@@ -10371,6 +10443,15 @@ 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 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, {
+    type: Type;
+}>;
+
 /**
  * Extracts a single event type matching the given key from the View {@link Event} union.
  *
@@ -10478,6 +10559,14 @@ declare type PerformanceReportEvent = Performance & BaseEvent_5 & {
 
 /**
  * @interface
+ *
+ * Governs access to OpenFin APIs.  Property paths of this literal match call
+ * paths for OpenFin API functions (e.g. `System.launchExternalProcess`), and can
+ * take a value of `true`, `false`, or in some cases an object literal for more-complicated
+ * semantics.
+ *
+ * For a list of APIs that are secure by default (and thus must be granted access via
+ * `permissions`), see https://developers.openfin.co/of-docs/docs/api-security#secured-apis.
  */
 declare type Permissions_2 = {
     Application?: Partial<ApplicationPermissions>;
@@ -15303,6 +15392,23 @@ declare interface Tab {
     setActive(isActive: boolean): void;
 }
 
+/**
+ * Generated when a Layout Tab Component was closed.
+ * @interface
+ */
+declare type TabClosedEvent = LayoutDOMEvent & {
+    type: 'tab-closed';
+    url: string;
+};
+
+/**
+ * Generated when a Layout Tab Component was created.
+ * @interface
+ */
+declare type TabCreatedEvent = LayoutDOMEvent & {
+    type: 'tab-created';
+};
+
 declare interface TabDragListener extends EventEmitter_2 {
     /**
      * A reference to the content item this tab relates to
@@ -15310,6 +15416,15 @@ declare interface TabDragListener extends EventEmitter_2 {
     contentItem: ContentItem;
 }
 
+/**
+ * Generated when a Layout Tab Component was dropped.
+ * @interface
+ */
+declare type TabDroppedEvent = LayoutDOMEvent & {
+    type: 'tab-dropped';
+    url: string;
+};
+
 /**
  * A TabStack is used to manage the state of a stack of tabs within an OpenFin Layout.
  */

package/out/node-adapter.js

@@ -11880,24 +11880,24 @@ class LayoutModule extends base_1$4.Base {
             this.wire.sendAction('layout-init').catch((e) => {
                 // don't expose
             });
-            if (!this.fin.me.isWindow) {
+            if (!this.wire.environment.layoutAllowedInContext(this.fin)) {
                 throw new Error('Layout.init can only be called from a Window context.');
             }
-            else if (__classPrivateFieldGet$3(this, _LayoutModule_layoutInitializationAttempted, "f")) {
+            if (__classPrivateFieldGet$3(this, _LayoutModule_layoutInitializationAttempted, "f")) {
                 throw new Error('Layout.init was already called, please use Layout.create to add additional layouts.');
             }
             __classPrivateFieldSet$3(this, _LayoutModule_layoutInitializationAttempted, true, "f");
-            // preload the client
-            await this.fin.Platform.getCurrentSync().getClient();
+            // TODO: rename to createLayoutManager
             __classPrivateFieldSet$3(this, _LayoutModule_layoutManager, await this.wire.environment.initLayoutManager(this.fin, this.wire, options), "f");
             await this.wire.environment.applyLayoutSnapshot(this.fin, __classPrivateFieldGet$3(this, _LayoutModule_layoutManager, "f"), options);
+            const meIdentity = { name: this.fin.me.name, uuid: this.fin.me.uuid };
             if (!options.layoutManagerOverride) {
                 // CORE-1081 to be removed when we actually delete the `layoutManager` prop
                 // in single-layout case, we return the undocumented layoutManager type
-                const layoutIdentity = { layoutName: layout_constants_1.DEFAULT_LAYOUT_KEY, ...this.fin.me.identity };
+                const layoutIdentity = { layoutName: layout_constants_1.DEFAULT_LAYOUT_KEY, ...meIdentity };
                 return __classPrivateFieldGet$3(this, _LayoutModule_getLayoutManagerSpy, "f").call(this, layoutIdentity);
             }
-            return this.wrapSync(this.fin.me.identity);
+            return this.wrapSync(meIdentity);
         };
         _LayoutModule_getLayoutManagerSpy.set(this, (layoutIdentity) => {
             const msg = '[Layout] You are using a deprecated property `layoutManager` - it will throw if you access it starting in v37.';
@@ -17578,6 +17578,9 @@ function requireNodeEnv () {
 	    getRtcPeer() {
 	        throw new Error('Method not implemented.');
 	    }
+	    layoutAllowedInContext(_fin) {
+	        throw new Error('Method not implemented.');
+	    }
 	    async initLayoutManager() {
 	        throw new Error('Method not implemented.');
 	    }

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@openfin/node-adapter",
-    "version": "37.81.19",
+    "version": "38.81.22",
     "description": "See README.md",
     "main": "out/node-adapter.js",
     "types": "out/node-adapter.d.ts",