@openfin/node-adapter 33.77.6 → 33.77.8

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -1,8 +1,8 @@
1
1
  # OpenFin Node.js adapter
2
2
 
3
- Allows the use of the OpenFin API from node.js. Please note the launch and connect methods are specific to a node environment.
3
+ Allows the use of the OpenFin API from node.js. Please note that the `launch` and `connect` methods are specific to a node environment.
4
4
 
5
- ## Requirements
5
+ ## Prerequisites
6
6
 
7
7
  - Node.js 16 or greater
8
8
 
@@ -12,11 +12,11 @@ Allows the use of the OpenFin API from node.js. Please note the launch and conne
12
12
 
13
13
  `connect` can be used to establish a connection to an OpenFin runtime from node.
14
14
 
15
- A uuid must be provided to identify the connection. Multiple connections will require distinct uuids.
15
+ A `uuid` value must be provided to identify the connection. Multiple connections require distinct `uuid` values.
16
16
 
17
- A runtime version or manifest url must also be specified.
17
+ A Runtime version or manifest URL must also be specified.
18
18
 
19
- Note - `connect` will instantiate a runtime instance if one does not exist for the given configuration. If the runtime is already running, connect will simply establish a new connection.
19
+ > Note: `connect` instantiates a Runtime instance if one does not exist for the given configuration. If a Runtime is already running, `connect` simply establishes a new connection.
20
20
 
21
21
  ### Connecting via Runtime Version
22
22
 
@@ -34,7 +34,7 @@ import { connect } from '@openfin/node-adapter';
34
34
  })();
35
35
  ```
36
36
 
37
- ### Connecting via Manifest Url
37
+ ### Connecting via Manifest URL
38
38
 
39
39
  ```javascript
40
40
  import { connect } from '@openfin/node-adapter';
@@ -53,9 +53,9 @@ import { connect } from '@openfin/node-adapter';
53
53
 
54
54
  Unlike `connect`, `launch` starts an OpenFin application if not running and returns a port number instead of a `fin` object.
55
55
 
56
- This can be provided to connect to create a `fin` object for the runtime that has been created on the specific port.
56
+ This port number can be provided to connect to create a `fin` object for the Runtime that has been created on the specific port.
57
57
 
58
- `launch` can be called multiple times for a given application, however launches for an application that is already running will result in a [run-requested](https://developer.openfin.co/jsdocs/stable/tutorial-application.addEventListener.html#run-requested) event being triggered instead of a relaunch. If the application is an OpenFin platform, this will result in the layout windows reloading.
58
+ `launch` can be called multiple times for a given application; however launches for an application that is already running result in a [run-requested](https://developer.openfin.co/jsdocs/stable/tutorial-application.addEventListener.html#run-requested) event being triggered instead of a relaunch. If the application is an OpenFin platform, this scenario results in the layout windows reloading.
59
59
 
60
60
  ### Launching and Connecting via Port
61
61
 
@@ -80,9 +80,9 @@ import { launch, connect } from '@openfin/node-adapter';
80
80
 
81
81
  ## Types
82
82
 
83
- `@openfin/node-adapter` comes bundled with its own types types.
83
+ `@openfin/node-adapter` comes bundled with its own types.
84
84
 
85
- If you wish to explicitly reference OpenFin types, the `OpenFin` namespace export may be used as follows:
85
+ If you wish to explicitly reference OpenFin types, the `OpenFin` namespace export can be used as follows:
86
86
 
87
87
  ### Type Usage Example
88
88
 
@@ -105,7 +105,7 @@ import OpenFin, { connect } from '@openfin/node-adapter';
105
105
 
106
106
  For users of the `connect` and `launch` functions in `openfin-adapter`, no changes are necessary, other than updating the dependency name.
107
107
 
108
- If using the exported types from `openfin-adapter`, an `OpenFin` export has been created that encapsualates them.
108
+ If you are using the exported types from `openfin-adapter`, you can now use the `OpenFin` export that encapsualates them.
109
109
 
110
110
  ### Before
111
111
 
@@ -4391,7 +4391,7 @@ declare namespace ExternalApplicationEvents {
4391
4391
  }
4392
4392
 
4393
4393
  /**
4394
- * Union of possible `type` values for a {@link OpenFin.ApplicationEvents.ApplicationEvent}.
4394
+ * Union of possible `type` values for a {@link ApplicationEvent}.
4395
4395
  */
4396
4396
  declare type ExternalApplicationEventType = ExternalApplicationEvent['type'];
4397
4397
 
@@ -7271,8 +7271,7 @@ declare type LayoutInitializedEvent = BaseWindowEvent & {
7271
7271
 
7272
7272
  /**
7273
7273
  * Represents the arrangement of Views within a Platform window's Layout. We do not recommend trying
7274
- * to build Layouts or LayoutItems by hand and instead use calls such as {@link Platform#getSnapshot getSnapshot} or our
7275
- * {@link https://openfin.github.io/golden-prototype/config-gen Layout Config Generation Tool }.
7274
+ * to build Layouts or LayoutItems by hand and instead use calls such as {@link Platform#getSnapshot getSnapshot}.
7276
7275
  *
7277
7276
  * @interface
7278
7277
  */
@@ -7574,8 +7573,7 @@ declare type LayoutOptions = {
7574
7573
  };
7575
7574
  /**
7576
7575
  * Content of the layout. There can only be one top-level LayoutItem in the content array.
7577
- * We do not recommend trying to build Layouts or LayoutItems by hand and instead use calls such as {@link Platform#getSnapshot getSnapshot} or our
7578
- * {@link https://openfin.github.io/golden-prototype/config-gen Layout Config Generation Tool }.
7576
+ * We do not recommend trying to build Layouts or LayoutItems by hand and instead use calls such as {@link Platform#getSnapshot getSnapshot}.
7579
7577
  */
7580
7578
  content?: LayoutContent;
7581
7579
  dimensions?: {
@@ -10623,7 +10621,7 @@ declare type PropagatedEventType<Topic extends string, Type extends string> = `$
10623
10621
 
10624
10622
  /**
10625
10623
  * A view event that has propagated to a parent {@link OpenFin.WindowEvents Window}, {@link OpenFin.ApplicationEvents Application},
10626
- * or {@link Openfin.SystemEvents System}), adding a `viewIdentity` property (since the `Identity` property of the propagated event refers to the `Window`) and prefixing the
10624
+ * or {@link OpenFin.SystemEvents System}), adding a `viewIdentity` property (since the `Identity` property of the propagated event refers to the `Window`) and prefixing the
10627
10625
  * event type key with `'view-'`.
10628
10626
  */
10629
10627
  declare type PropagatedViewEvent<TargetTopic extends string> = PropagatedEvent<'view', TargetTopic, ViewEvent> & {
@@ -10637,7 +10635,7 @@ declare type PropagatedViewEventType = PropagatedViewEvent<string>['type'];
10637
10635
 
10638
10636
  /**
10639
10637
  * A Window event that has propagated to the parent {@link OpenFin.ApplicationEvents Application} and {@link OpenFin.SystemEvents System},
10640
- * prefixing the type string with `'window-'`. Only {@link NativeWindowEvent native window events} will propagate
10638
+ * prefixing the type string with `'window-'`. Only {@link WindowSourcedEvent window-sourced events} will propagate
10641
10639
  * this way; those that have {@link OpenFin.ViewEvents.PropagatedViewEvent propagated} from {@link OpenFin.ViewEvents}
10642
10640
  * will *not* re-propagate.
10643
10641
  *
@@ -4391,7 +4391,7 @@ declare namespace ExternalApplicationEvents {
4391
4391
  }
4392
4392
 
4393
4393
  /**
4394
- * Union of possible `type` values for a {@link OpenFin.ApplicationEvents.ApplicationEvent}.
4394
+ * Union of possible `type` values for a {@link ApplicationEvent}.
4395
4395
  */
4396
4396
  declare type ExternalApplicationEventType = ExternalApplicationEvent['type'];
4397
4397
 
@@ -7271,8 +7271,7 @@ declare type LayoutInitializedEvent = BaseWindowEvent & {
7271
7271
 
7272
7272
  /**
7273
7273
  * Represents the arrangement of Views within a Platform window's Layout. We do not recommend trying
7274
- * to build Layouts or LayoutItems by hand and instead use calls such as {@link Platform#getSnapshot getSnapshot} or our
7275
- * {@link https://openfin.github.io/golden-prototype/config-gen Layout Config Generation Tool }.
7274
+ * to build Layouts or LayoutItems by hand and instead use calls such as {@link Platform#getSnapshot getSnapshot}.
7276
7275
  *
7277
7276
  * @interface
7278
7277
  */
@@ -7574,8 +7573,7 @@ declare type LayoutOptions = {
7574
7573
  };
7575
7574
  /**
7576
7575
  * Content of the layout. There can only be one top-level LayoutItem in the content array.
7577
- * We do not recommend trying to build Layouts or LayoutItems by hand and instead use calls such as {@link Platform#getSnapshot getSnapshot} or our
7578
- * {@link https://openfin.github.io/golden-prototype/config-gen Layout Config Generation Tool }.
7576
+ * We do not recommend trying to build Layouts or LayoutItems by hand and instead use calls such as {@link Platform#getSnapshot getSnapshot}.
7579
7577
  */
7580
7578
  content?: LayoutContent;
7581
7579
  dimensions?: {
@@ -10623,7 +10621,7 @@ declare type PropagatedEventType<Topic extends string, Type extends string> = `$
10623
10621
 
10624
10622
  /**
10625
10623
  * A view event that has propagated to a parent {@link OpenFin.WindowEvents Window}, {@link OpenFin.ApplicationEvents Application},
10626
- * or {@link Openfin.SystemEvents System}), adding a `viewIdentity` property (since the `Identity` property of the propagated event refers to the `Window`) and prefixing the
10624
+ * or {@link OpenFin.SystemEvents System}), adding a `viewIdentity` property (since the `Identity` property of the propagated event refers to the `Window`) and prefixing the
10627
10625
  * event type key with `'view-'`.
10628
10626
  */
10629
10627
  declare type PropagatedViewEvent<TargetTopic extends string> = PropagatedEvent<'view', TargetTopic, ViewEvent> & {
@@ -10637,7 +10635,7 @@ declare type PropagatedViewEventType = PropagatedViewEvent<string>['type'];
10637
10635
 
10638
10636
  /**
10639
10637
  * A Window event that has propagated to the parent {@link OpenFin.ApplicationEvents Application} and {@link OpenFin.SystemEvents System},
10640
- * prefixing the type string with `'window-'`. Only {@link NativeWindowEvent native window events} will propagate
10638
+ * prefixing the type string with `'window-'`. Only {@link WindowSourcedEvent window-sourced events} will propagate
10641
10639
  * this way; those that have {@link OpenFin.ViewEvents.PropagatedViewEvent propagated} from {@link OpenFin.ViewEvents}
10642
10640
  * will *not* re-propagate.
10643
10641
  *
@@ -4391,7 +4391,7 @@ declare namespace ExternalApplicationEvents {
4391
4391
  }
4392
4392
 
4393
4393
  /**
4394
- * Union of possible `type` values for a {@link OpenFin.ApplicationEvents.ApplicationEvent}.
4394
+ * Union of possible `type` values for a {@link ApplicationEvent}.
4395
4395
  */
4396
4396
  declare type ExternalApplicationEventType = ExternalApplicationEvent['type'];
4397
4397
 
@@ -7271,8 +7271,7 @@ declare type LayoutInitializedEvent = BaseWindowEvent & {
7271
7271
 
7272
7272
  /**
7273
7273
  * Represents the arrangement of Views within a Platform window's Layout. We do not recommend trying
7274
- * to build Layouts or LayoutItems by hand and instead use calls such as {@link Platform#getSnapshot getSnapshot} or our
7275
- * {@link https://openfin.github.io/golden-prototype/config-gen Layout Config Generation Tool }.
7274
+ * to build Layouts or LayoutItems by hand and instead use calls such as {@link Platform#getSnapshot getSnapshot}.
7276
7275
  *
7277
7276
  * @interface
7278
7277
  */
@@ -7574,8 +7573,7 @@ declare type LayoutOptions = {
7574
7573
  };
7575
7574
  /**
7576
7575
  * Content of the layout. There can only be one top-level LayoutItem in the content array.
7577
- * We do not recommend trying to build Layouts or LayoutItems by hand and instead use calls such as {@link Platform#getSnapshot getSnapshot} or our
7578
- * {@link https://openfin.github.io/golden-prototype/config-gen Layout Config Generation Tool }.
7576
+ * We do not recommend trying to build Layouts or LayoutItems by hand and instead use calls such as {@link Platform#getSnapshot getSnapshot}.
7579
7577
  */
7580
7578
  content?: LayoutContent;
7581
7579
  dimensions?: {
@@ -10623,7 +10621,7 @@ declare type PropagatedEventType<Topic extends string, Type extends string> = `$
10623
10621
 
10624
10622
  /**
10625
10623
  * A view event that has propagated to a parent {@link OpenFin.WindowEvents Window}, {@link OpenFin.ApplicationEvents Application},
10626
- * or {@link Openfin.SystemEvents System}), adding a `viewIdentity` property (since the `Identity` property of the propagated event refers to the `Window`) and prefixing the
10624
+ * or {@link OpenFin.SystemEvents System}), adding a `viewIdentity` property (since the `Identity` property of the propagated event refers to the `Window`) and prefixing the
10627
10625
  * event type key with `'view-'`.
10628
10626
  */
10629
10627
  declare type PropagatedViewEvent<TargetTopic extends string> = PropagatedEvent<'view', TargetTopic, ViewEvent> & {
@@ -10637,7 +10635,7 @@ declare type PropagatedViewEventType = PropagatedViewEvent<string>['type'];
10637
10635
 
10638
10636
  /**
10639
10637
  * A Window event that has propagated to the parent {@link OpenFin.ApplicationEvents Application} and {@link OpenFin.SystemEvents System},
10640
- * prefixing the type string with `'window-'`. Only {@link NativeWindowEvent native window events} will propagate
10638
+ * prefixing the type string with `'window-'`. Only {@link WindowSourcedEvent window-sourced events} will propagate
10641
10639
  * this way; those that have {@link OpenFin.ViewEvents.PropagatedViewEvent propagated} from {@link OpenFin.ViewEvents}
10642
10640
  * will *not* re-propagate.
10643
10641
  *
@@ -4509,7 +4509,7 @@ declare namespace ExternalApplicationEvents {
4509
4509
  }
4510
4510
 
4511
4511
  /**
4512
- * Union of possible `type` values for a {@link OpenFin.ApplicationEvents.ApplicationEvent}.
4512
+ * Union of possible `type` values for a {@link ApplicationEvent}.
4513
4513
  */
4514
4514
  declare type ExternalApplicationEventType = ExternalApplicationEvent['type'];
4515
4515
 
@@ -7558,8 +7558,7 @@ declare type LayoutInitializedEvent = BaseWindowEvent & {
7558
7558
 
7559
7559
  /**
7560
7560
  * Represents the arrangement of Views within a Platform window's Layout. We do not recommend trying
7561
- * to build Layouts or LayoutItems by hand and instead use calls such as {@link Platform#getSnapshot getSnapshot} or our
7562
- * {@link https://openfin.github.io/golden-prototype/config-gen Layout Config Generation Tool }.
7561
+ * to build Layouts or LayoutItems by hand and instead use calls such as {@link Platform#getSnapshot getSnapshot}.
7563
7562
  *
7564
7563
  * @interface
7565
7564
  */
@@ -8022,8 +8021,7 @@ declare type LayoutOptions = {
8022
8021
  };
8023
8022
  /**
8024
8023
  * Content of the layout. There can only be one top-level LayoutItem in the content array.
8025
- * We do not recommend trying to build Layouts or LayoutItems by hand and instead use calls such as {@link Platform#getSnapshot getSnapshot} or our
8026
- * {@link https://openfin.github.io/golden-prototype/config-gen Layout Config Generation Tool }.
8024
+ * We do not recommend trying to build Layouts or LayoutItems by hand and instead use calls such as {@link Platform#getSnapshot getSnapshot}.
8027
8025
  */
8028
8026
  content?: LayoutContent;
8029
8027
  dimensions?: {
@@ -11151,7 +11149,7 @@ declare type PropagatedEventType<Topic extends string, Type extends string> = `$
11151
11149
 
11152
11150
  /**
11153
11151
  * A view event that has propagated to a parent {@link OpenFin.WindowEvents Window}, {@link OpenFin.ApplicationEvents Application},
11154
- * or {@link Openfin.SystemEvents System}), adding a `viewIdentity` property (since the `Identity` property of the propagated event refers to the `Window`) and prefixing the
11152
+ * or {@link OpenFin.SystemEvents System}), adding a `viewIdentity` property (since the `Identity` property of the propagated event refers to the `Window`) and prefixing the
11155
11153
  * event type key with `'view-'`.
11156
11154
  */
11157
11155
  declare type PropagatedViewEvent<TargetTopic extends string> = PropagatedEvent<'view', TargetTopic, ViewEvent> & {
@@ -11165,7 +11163,7 @@ declare type PropagatedViewEventType = PropagatedViewEvent<string>['type'];
11165
11163
 
11166
11164
  /**
11167
11165
  * A Window event that has propagated to the parent {@link OpenFin.ApplicationEvents Application} and {@link OpenFin.SystemEvents System},
11168
- * prefixing the type string with `'window-'`. Only {@link NativeWindowEvent native window events} will propagate
11166
+ * prefixing the type string with `'window-'`. Only {@link WindowSourcedEvent window-sourced events} will propagate
11169
11167
  * this way; those that have {@link OpenFin.ViewEvents.PropagatedViewEvent propagated} from {@link OpenFin.ViewEvents}
11170
11168
  * will *not* re-propagate.
11171
11169
  *
@@ -18304,9 +18304,9 @@ var application = {};
18304
18304
  * child {@link OpenFin.Window windows} and {@link OpenFin.View views} are defined in the {@link OpenFin.WindowEvents} and
18305
18305
  * {@link OpenFin.ViewEvents} namespaces. For a list of valid string keys for *all* application events, see {@link Application.on Application.on}.
18306
18306
  *
18307
- * {@link NativeApplicationEvent Native application events} (i.e. those that have not propagated from {@link OpenFin.ViewEvents Views}
18307
+ * {@link ApplicationSourcedEvent Application-sourced events} (i.e. those that have not propagated from {@link OpenFin.ViewEvents Views}
18308
18308
  * or {@link OpenFin.WindowEvents Windows} re-propagate to {@link OpenFin.SystemEvents System} with their type string prefixed with `application-`.
18309
- * {@link OpenFin.ApplicationEvents.ApplicationWindowEvent Application events that are tied to Windows but do not propagate from them}
18309
+ * {@link ApplicationWindowEvent Application events that are tied to Windows but do not propagate from them}
18310
18310
  * are propagated to `System` without any type string prefixing.
18311
18311
  *
18312
18312
  * "Requested" events (e.g. {@link RunRequestedEvent}) do not propagate.
@@ -18429,7 +18429,7 @@ var window$1 = {};
18429
18429
  * propagate from `View` are defined in {@link OpenFin.ViewEvents}. For a list of valid string keys for *all* Window events, see
18430
18430
  * {@link Window.on Window.on}
18431
18431
  *
18432
- * {@link OpenFin.WindowEvents.NativeWindowEvent Native window events} (i.e. those that are not propagated from a
18432
+ * {@link OpenFin.WindowEvents.WindowSourcedEvent Window-sourced events} (i.e. those that are not propagated from a
18433
18433
  * {@link OpenFin.ViewEvents View}) propagate to their parent {@link OpenFin.ApplicationEvents Application} and
18434
18434
  * {@link OpenFin.SystemEvents System} with their event types prefixed with `'window-'`).
18435
18435
  *
@@ -18474,10 +18474,10 @@ Object.defineProperty(window$1, "__esModule", { value: true });
18474
18474
  * finally to the OpenFin runtime itself at the "system" level. For details on propagation semantics, see the namespace for
18475
18475
  * the propagating (or propagated-to) entity.
18476
18476
  *
18477
- * If you need the payload type for a specific type of event (especially propagated events), use the emitting topic's `EventPayload`
18478
- * (e.g. {@link WindowEvents.WindowEventPayload}) generic with the event's `type` string. For example, the payload of
18477
+ * If you need the payload type for a specific type of event (especially propagated events), use the emitting topic's `Payload` generic
18478
+ * (e.g. {@link WindowEvents.Payload}) with the event's `type` string. For example, the payload of
18479
18479
  * a {@link ViewEvents.CreatedEvent} after it has propagated to its parent {@link WindowEvents Window} can be found with
18480
- * `WindowEventPayload<'view-created'>`.
18480
+ * `WindowEvents.Payload<'view-created'>`.
18481
18481
  *
18482
18482
  * @packageDocumentation
18483
18483
  */
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@openfin/node-adapter",
3
- "version": "33.77.6",
3
+ "version": "33.77.8",
4
4
  "description": "See README.md",
5
5
  "main": "out/node-adapter.js",
6
6
  "types": "out/node-adapter.d.ts",