@openfin/core 39.82.12 → 40.82.1

package/out/mock.d.ts

@@ -102,7 +102,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';
 };
@@ -920,7 +920,7 @@ declare namespace ApplicationEvents {
         PropagatedApplicationEvent,
         PropagatedEventType_3 as PropagatedEventType,
         PropagatedApplicationEventType,
-        Payload_4 as Payload,
+        Payload_5 as Payload,
         ByType_3 as ByType
     }
 }
@@ -1739,7 +1739,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;
 };
@@ -1809,6 +1809,7 @@ declare namespace BaseEvents {
         NotCloseRequested,
         PropagatedEventType,
         PropagatedEvent,
+        Payload_2 as Payload,
         EventHandler,
         BaseEvent,
         IdentityEvent,
@@ -1949,7 +1950,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.
@@ -1958,7 +1959,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.
@@ -1967,7 +1968,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.
@@ -1976,7 +1977,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.
@@ -1985,7 +1986,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.
@@ -1994,7 +1995,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.
@@ -2003,7 +2004,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.
@@ -2012,7 +2013,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.
@@ -2021,7 +2022,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.
@@ -4416,6 +4417,10 @@ declare type DomainSettingsRule = {
      * Settings applied when a webcontents has been navigated to a matched domain.
      */
     options: PerDomainSettings;
+    /**
+     * Options to use when comparing URIs to the `match` patterns.
+     */
+    matchOptions?: RuleMatchOptions;
 };
 
 /**
@@ -4865,9 +4870,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 {
@@ -5024,7 +5027,7 @@ declare namespace ExternalApplicationEvents {
         ExternalApplicationEvent,
         EventType_4 as EventType,
         ExternalApplicationEventType,
-        Payload_5 as Payload,
+        Payload_6 as Payload,
         ByType_4 as ByType
     }
 }
@@ -5479,7 +5482,7 @@ declare namespace FrameEvents {
         FrameEvent,
         EventType_5 as EventType,
         FrameEventType,
-        Payload_6 as Payload,
+        Payload_7 as Payload,
         ByType_5 as ByType
     }
 }
@@ -5722,7 +5725,7 @@ declare namespace GlobalHotkeyEvents {
         GlobalHotkeyEvent,
         EventType_6 as EventType,
         GlobalHotkeyEventType,
-        Payload_7 as Payload,
+        Payload_8 as Payload,
         ByType_6 as ByType
     }
 }
@@ -7834,7 +7837,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
     }
 }
@@ -9203,6 +9206,10 @@ declare type NavigationRules = {
     allowlist?: string[];
     /** Forbidden URLs for navigation. */
     denylist?: string[];
+    /**
+     * Options to use when comparing URIs to the `allowlist` and `denylist` patterns.
+     */
+    matchOptions?: RuleMatchOptions;
 };
 
 declare type NewConnectConfig = ConfigWithUuid & ConfigWithRuntime;
@@ -9362,6 +9369,7 @@ declare namespace OpenFin_2 {
         Api,
         ApiSettings,
         InjectionType,
+        RuleMatchOptions,
         NavigationRules,
         ContentNavigation,
         ContentRedirect,
@@ -9682,86 +9690,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
@@ -10486,7 +10518,7 @@ declare namespace PlatformEvents {
         PlatformEvent,
         EventType_7 as EventType,
         PlatformEventType,
-        Payload_8 as Payload,
+        Payload_9 as Payload,
         ByType_7 as ByType
     }
 }
@@ -12362,6 +12394,17 @@ declare interface RTCProtocolOffer extends ProtocolPacketBase {
     };
 }
 
+/**
+ * Controls the behavior of the navigation URI pattern matching algorithm.
+ */
+declare type RuleMatchOptions = {
+    /**
+     * Matches all schemes rather than just http and https when a wild card is specified. For example, `'*://*.site.com'` will
+     * only match urls which begin with `'http:'` or `'https:'` unless this setting is `true`.
+     */
+    matchAllSchemes?: boolean;
+};
+
 declare type RunRequestedEvent = OpenFin_2.ApplicationEvents.RunRequestedEvent;
 
 /**
@@ -12814,7 +12857,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';
 };
@@ -14425,7 +14468,7 @@ declare namespace SystemEvents {
         SystemEvent,
         EventType_8 as EventType,
         SystemEventType,
-        Payload_9 as Payload,
+        Payload_10 as Payload,
         ByType_8 as ByType
     }
 }
@@ -15490,7 +15533,7 @@ declare namespace ViewEvents {
         PropagatedViewEvent,
         PropagatedEventType_2 as PropagatedEventType,
         PropagatedViewEventType,
-        Payload_2 as Payload,
+        Payload_3 as Payload,
         ByType
     }
 }
@@ -18014,7 +18057,7 @@ declare namespace WindowEvents {
         PropagatedEvent_3 as PropagatedEvent,
         PropagatedWindowEvent,
         PropagatedWindowEventType,
-        Payload_3 as Payload,
+        Payload_4 as Payload,
         ByType_2 as ByType
     }
 }

package/out/mock.js

@@ -38,6 +38,8 @@ var application$1 = {};
  * For example, a view's "attached" event will fire as 'window-view-attached' at the application level.
  *
  * Event payloads are documented as interfaces, while algebraic helper types and derived types are documented as type aliases.
+ * Events gain metadata as they propagate, which is *not* present on the explicit payload interfaces.  To refer to the full type
+ * of an event as it would be raised on this emitter, use {@link Payload}.
  *
  * This namespace contains only payload shapes for events that are unique to `Application`.  Events that propagate to `Application` from
  * child {@link OpenFin.Window windows} and {@link OpenFin.View views} are defined in the {@link OpenFin.WindowEvents} and
@@ -69,6 +71,8 @@ var externalApplication$1 = {};
  * Namespace for events that can be transmitted by an {@link OpenFin.ExternalApplication}.
  *
  * Event payloads are documented as interfaces, while algebraic helper types and derived types are documented as type aliases.
+ * Events gain metadata as they propagate, which is *not* present on the explicit payload interfaces.  To refer to the full type
+ * of an event as it would be raised on this emitter, use {@link Payload}.
  *
  * For a list of valid string keys for external application events, see {@link ExternalApplication.on ExternalApplication.on}.
  *
@@ -87,6 +91,8 @@ var globalHotkey$1 = {};
  * Namespace for events that can be transmitted by {@link GlobalHotkey.GlobalHotkey}.
  *
  * Event payloads are documented as interfaces, while algebraic helper types and derived types are documented as type aliases.
+ * Events gain metadata as they propagate, which is *not* present on the explicit payload interfaces.  To refer to the full type
+ * of an event as it would be raised on this emitter, use {@link Payload}.
  *
  * For a list of valid string keys for global hotkey events, see {@link GlobalHotkey.GlobalHotkey.on GlobalHotkey.on}.
  *
@@ -101,6 +107,8 @@ var platform$1 = {};
  * Namespace for events that can emitted by a {@link OpenFin.Platform}.
  *
  * Event payloads are documented as interfaces, while algebraic helper types and derived types are documented as type aliases.
+ * Events gain metadata as they propagate, which is *not* present on the explicit payload interfaces.  To refer to the full type
+ * of an event as it would be raised on this emitter, use {@link Payload}.
  *
  * The Platform `EventEmitter` is a superset of the {@link OpenFin.Application} `EventEmitter`,
  * meaning it can listen to all {@link OpenFin.ApplicationEvents Application events} in addition to the
@@ -122,6 +130,8 @@ var system$1 = {};
  * will be visible as 'view-shown' at the system level, but *not* as `application-window-view-shown`.
  *
  * Event payloads are documented as interfaces, while algebraic helper types and derived types are documented as type aliases.
+ * Events gain metadata as they propagate, which is *not* present on the explicit payload interfaces.  To refer to the full type
+ * of an event as it would be raised on this emitter, use {@link Payload}.
  *
  * This namespace contains only payload shapes for events that are unique to `System`.  Events that propagate to `System` from
  * child {@link OpenFin.Application applications}, {@link OpenFin.Window windows}, and {@link OpenFin.View views} are defined in the
@@ -138,6 +148,8 @@ var view$1 = {};
  * Namespace for events that can be emitted by a {@link OpenFin.View}.
  *
  * Event payloads are documented as interfaces, while algebraic helper types and derived types are documented as type aliases.
+ * Events gain metadata as they propagate, which is *not* present on the explicit payload interfaces.  To refer to the full type
+ * of an event as it would be raised on this emitter, use {@link Payload}.
  *
  * This namespace contains only payload shapes for events that are unique to `View`.  Events that are shared between all `WebContents`
  * (i.e. {@link OpenFin.Window}, {@link OpenFin.View}) are defined in {@link OpenFin.WebContentsEvents}.  For a list
@@ -169,6 +181,8 @@ var window$2 = {};
  * Namespace for events that can be emitted by a {@link OpenFin.Window}.
  *
  * Event payloads are documented as interfaces, while algebraic helper types and derived types are documented as type aliases.
+ * Events gain metadata as they propagate, which is *not* present on the explicit payload interfaces.  To refer to the full type
+ * of an event as it would be raised on this emitter, use {@link Payload}.
  *
  * This namespace contains only payload shapes for events that are unique to `Window`.  Events that are shared between all `WebContents`
  * (i.e. {@link OpenFin.Window}, {@link OpenFin.View}) are defined in {@link OpenFin.WebContentsEvents}. Events that

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@openfin/core",
-    "version": "39.82.12",
+    "version": "40.82.1",
     "description": "The core renderer entry point of OpenFin",
     "license": "SEE LICENSE IN LICENSE.md",
     "main": "out/mock.js",