@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 +11 -11
- package/out/node-adapter-alpha.d.ts +5 -7
- package/out/node-adapter-beta.d.ts +5 -7
- package/out/node-adapter-public.d.ts +5 -7
- package/out/node-adapter.d.ts +5 -7
- package/out/node-adapter.js +6 -6
- package/package.json +1 -1
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
|
-
##
|
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
|
15
|
+
A `uuid` value must be provided to identify the connection. Multiple connections require distinct `uuid` values.
|
16
16
|
|
17
|
-
A
|
17
|
+
A Runtime version or manifest URL must also be specified.
|
18
18
|
|
19
|
-
Note
|
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
|
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
|
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
|
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
|
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
|
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`,
|
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
|
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}
|
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}
|
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
|
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
|
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
|
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}
|
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}
|
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
|
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
|
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
|
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}
|
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}
|
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
|
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
|
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
|
*
|
package/out/node-adapter.d.ts
CHANGED
@@ -4509,7 +4509,7 @@ declare namespace ExternalApplicationEvents {
|
|
4509
4509
|
}
|
4510
4510
|
|
4511
4511
|
/**
|
4512
|
-
* Union of possible `type` values for a {@link
|
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}
|
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}
|
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
|
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
|
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
|
*
|
package/out/node-adapter.js
CHANGED
@@ -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
|
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
|
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.
|
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 `
|
18478
|
-
* (e.g. {@link WindowEvents.
|
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
|
-
* `
|
18480
|
+
* `WindowEvents.Payload<'view-created'>`.
|
18481
18481
|
*
|
18482
18482
|
* @packageDocumentation
|
18483
18483
|
*/
|