@openfin/fdc3-api 36.79.13 → 36.79.17

package/out/fdc3-api-alpha.d.ts

@@ -88,12 +88,21 @@ declare type Api = {
     iframe?: {
         /**
          * Inject OpenFin API into cross-origin iframes
+         *
+         * @defaultValue false
          */
         crossOriginInjection?: boolean;
         /**
          * Inject OpenFin API into same-origin iframes
+         *
+         * @defaultValue true
          */
         sameOriginInjection?: boolean;
+        /**
+         * @deprecated Shared names should not be used; support is provided purely for back-compat reasons.
+         *
+         * When `true`, iframes will have the same name as their parent WebContents.
+         */
         enableDeprecatedSharedName?: boolean;
     };
     /**
@@ -1668,9 +1677,9 @@ declare class Base {
      * on the context in which the devtools panel was opened.
      */
     get me(): Identity;
-    protected isNodeEnvironment: () => boolean;
-    protected isOpenFinEnvironment: () => boolean;
-    protected isBrowserEnvironment: () => boolean;
+    /* Excluded from this release type: isNodeEnvironment */
+    /* Excluded from this release type: isOpenFinEnvironment */
+    /* Excluded from this release type: isBrowserEnvironment */
 }
 
 /**
@@ -4466,6 +4475,32 @@ declare type CreateLayoutOptions = {
     container: HTMLElement;
     layoutName: string;
     layout: LayoutOptions;
+    /**
+     * @defaultValue 'default'
+     *
+     * Controls the View behavior for the given `layout` property. Note
+     * that the selected behavior only applies to unnamed Views or
+     * Views with the prefix `internal-generated-`. In all cases, if any
+     * View in the `layout` does not already exist, it will be created
+     * with a name that starts with `internal-generated-`.
+     *
+     * When set to `reparent`, Views prefixed with `internal-generated-` will
+     * be reparented to the current Window and added to this new Layout.
+     * Use this option when you need to transfer an existing Layout between Windows.
+     *
+     * When set to 'duplicate', Views prefixed with `internal-generated-` will
+     * be duplicated with new generated names. Use this option when you need
+     * to clone a Layout to any Window.
+     *
+     * When set to `default` or omitted, the Layout will attempt to re-use
+     * existing Views only if they are attached to the current Window or
+     * the Provider Window. Set to `default` or omit this option when creating
+     * Layouts as part of implementing the LayoutManager::applyLayoutSnapshot
+     * override. Note that during applyLayoutSnapshot, Views are created and
+     * attached to the Provider while the Window is being created, so it's
+     * important to not 'duplicate' Views in this workflow.
+     */
+    multiInstanceViewBehavior?: MultiInstanceViewBehavior;
 };
 
 /**
@@ -5176,8 +5211,14 @@ declare interface Environment {
     getRtcPeer(): RTCPeerConnection;
     getWsConstructor(): typeof WebSocket;
     whenReady(): Promise<void>;
+    getInteropInfo(fin: OpenFin.Fin<OpenFin.EntityType>): Promise<InternalInteropBrokerOptions & {
+        fdc3Version?: Fdc3Version;
+    }>;
+    readonly type: EnvironmentType;
 }
 
+declare type EnvironmentType = 'node' | 'openfin' | 'other';
+
 declare type ErrorMiddleware = OpenFin.ErrorMiddleware;
 
 declare type ErrorMiddleware_2 = (topic: string, error: Error, id: ProviderIdentity_7 | ClientIdentity) => unknown;
@@ -7294,6 +7335,15 @@ declare class InterApplicationBus extends Base {
 
 declare type InternalConnectConfig = ExistingConnectConfig | NewConnectConfig;
 
+declare type InternalFDC3Info = {
+    providerVersion: string;
+    provider: string;
+};
+
+declare type InternalInteropBrokerOptions = OpenFin.InteropBrokerOptions & {
+    fdc3Info: InternalFDC3Info;
+};
+
 /**
  * Define whether to enable interop action logging.
  *
@@ -7422,6 +7472,7 @@ declare type InteropActionLoggingOption = {
  *
  */
 declare class InteropBroker extends Base {
+    #private;
     private getProvider;
     private interopClients;
     private contextGroupsById;
@@ -9737,6 +9788,13 @@ declare type MonitorInfoChangedEvent = BaseEvent_9 & OpenFin.MonitorInfo & {
     type: 'monitor-info-changed';
 };
 
+/**
+ * @experimental
+ *
+ * Used to control view behavior for Layout.create API
+ */
+declare type MultiInstanceViewBehavior = 'reparent' | 'duplicate' | 'default';
+
 /**
  * @interface
  */
@@ -10457,6 +10515,7 @@ declare namespace OpenFin {
         LayoutManagerOverride,
         LayoutManager,
         CreateLayoutOptions,
+        MultiInstanceViewBehavior,
         PresetLayoutOptions_2 as PresetLayoutOptions,
         ResultBehavior,
         PopupBaseBehavior,

package/out/fdc3-api-beta.d.ts

@@ -88,12 +88,21 @@ declare type Api = {
     iframe?: {
         /**
          * Inject OpenFin API into cross-origin iframes
+         *
+         * @defaultValue false
          */
         crossOriginInjection?: boolean;
         /**
          * Inject OpenFin API into same-origin iframes
+         *
+         * @defaultValue true
          */
         sameOriginInjection?: boolean;
+        /**
+         * @deprecated Shared names should not be used; support is provided purely for back-compat reasons.
+         *
+         * When `true`, iframes will have the same name as their parent WebContents.
+         */
         enableDeprecatedSharedName?: boolean;
     };
     /**
@@ -1668,9 +1677,9 @@ declare class Base {
      * on the context in which the devtools panel was opened.
      */
     get me(): Identity;
-    protected isNodeEnvironment: () => boolean;
-    protected isOpenFinEnvironment: () => boolean;
-    protected isBrowserEnvironment: () => boolean;
+    /* Excluded from this release type: isNodeEnvironment */
+    /* Excluded from this release type: isOpenFinEnvironment */
+    /* Excluded from this release type: isBrowserEnvironment */
 }
 
 /**
@@ -4466,6 +4475,32 @@ declare type CreateLayoutOptions = {
     container: HTMLElement;
     layoutName: string;
     layout: LayoutOptions;
+    /**
+     * @defaultValue 'default'
+     *
+     * Controls the View behavior for the given `layout` property. Note
+     * that the selected behavior only applies to unnamed Views or
+     * Views with the prefix `internal-generated-`. In all cases, if any
+     * View in the `layout` does not already exist, it will be created
+     * with a name that starts with `internal-generated-`.
+     *
+     * When set to `reparent`, Views prefixed with `internal-generated-` will
+     * be reparented to the current Window and added to this new Layout.
+     * Use this option when you need to transfer an existing Layout between Windows.
+     *
+     * When set to 'duplicate', Views prefixed with `internal-generated-` will
+     * be duplicated with new generated names. Use this option when you need
+     * to clone a Layout to any Window.
+     *
+     * When set to `default` or omitted, the Layout will attempt to re-use
+     * existing Views only if they are attached to the current Window or
+     * the Provider Window. Set to `default` or omit this option when creating
+     * Layouts as part of implementing the LayoutManager::applyLayoutSnapshot
+     * override. Note that during applyLayoutSnapshot, Views are created and
+     * attached to the Provider while the Window is being created, so it's
+     * important to not 'duplicate' Views in this workflow.
+     */
+    multiInstanceViewBehavior?: MultiInstanceViewBehavior;
 };
 
 /**
@@ -5176,8 +5211,14 @@ declare interface Environment {
     getRtcPeer(): RTCPeerConnection;
     getWsConstructor(): typeof WebSocket;
     whenReady(): Promise<void>;
+    getInteropInfo(fin: OpenFin.Fin<OpenFin.EntityType>): Promise<InternalInteropBrokerOptions & {
+        fdc3Version?: Fdc3Version;
+    }>;
+    readonly type: EnvironmentType;
 }
 
+declare type EnvironmentType = 'node' | 'openfin' | 'other';
+
 declare type ErrorMiddleware = OpenFin.ErrorMiddleware;
 
 declare type ErrorMiddleware_2 = (topic: string, error: Error, id: ProviderIdentity_7 | ClientIdentity) => unknown;
@@ -7294,6 +7335,15 @@ declare class InterApplicationBus extends Base {
 
 declare type InternalConnectConfig = ExistingConnectConfig | NewConnectConfig;
 
+declare type InternalFDC3Info = {
+    providerVersion: string;
+    provider: string;
+};
+
+declare type InternalInteropBrokerOptions = OpenFin.InteropBrokerOptions & {
+    fdc3Info: InternalFDC3Info;
+};
+
 /**
  * Define whether to enable interop action logging.
  *
@@ -7422,6 +7472,7 @@ declare type InteropActionLoggingOption = {
  *
  */
 declare class InteropBroker extends Base {
+    #private;
     private getProvider;
     private interopClients;
     private contextGroupsById;
@@ -9737,6 +9788,13 @@ declare type MonitorInfoChangedEvent = BaseEvent_9 & OpenFin.MonitorInfo & {
     type: 'monitor-info-changed';
 };
 
+/**
+ * @experimental
+ *
+ * Used to control view behavior for Layout.create API
+ */
+declare type MultiInstanceViewBehavior = 'reparent' | 'duplicate' | 'default';
+
 /**
  * @interface
  */
@@ -10457,6 +10515,7 @@ declare namespace OpenFin {
         LayoutManagerOverride,
         LayoutManager,
         CreateLayoutOptions,
+        MultiInstanceViewBehavior,
         PresetLayoutOptions_2 as PresetLayoutOptions,
         ResultBehavior,
         PopupBaseBehavior,

package/out/fdc3-api-public.d.ts

@@ -88,12 +88,21 @@ declare type Api = {
     iframe?: {
         /**
          * Inject OpenFin API into cross-origin iframes
+         *
+         * @defaultValue false
          */
         crossOriginInjection?: boolean;
         /**
          * Inject OpenFin API into same-origin iframes
+         *
+         * @defaultValue true
          */
         sameOriginInjection?: boolean;
+        /**
+         * @deprecated Shared names should not be used; support is provided purely for back-compat reasons.
+         *
+         * When `true`, iframes will have the same name as their parent WebContents.
+         */
         enableDeprecatedSharedName?: boolean;
     };
     /**
@@ -1668,9 +1677,9 @@ declare class Base {
      * on the context in which the devtools panel was opened.
      */
     get me(): Identity;
-    protected isNodeEnvironment: () => boolean;
-    protected isOpenFinEnvironment: () => boolean;
-    protected isBrowserEnvironment: () => boolean;
+    /* Excluded from this release type: isNodeEnvironment */
+    /* Excluded from this release type: isOpenFinEnvironment */
+    /* Excluded from this release type: isBrowserEnvironment */
 }
 
 /**
@@ -4466,6 +4475,32 @@ declare type CreateLayoutOptions = {
     container: HTMLElement;
     layoutName: string;
     layout: LayoutOptions;
+    /**
+     * @defaultValue 'default'
+     *
+     * Controls the View behavior for the given `layout` property. Note
+     * that the selected behavior only applies to unnamed Views or
+     * Views with the prefix `internal-generated-`. In all cases, if any
+     * View in the `layout` does not already exist, it will be created
+     * with a name that starts with `internal-generated-`.
+     *
+     * When set to `reparent`, Views prefixed with `internal-generated-` will
+     * be reparented to the current Window and added to this new Layout.
+     * Use this option when you need to transfer an existing Layout between Windows.
+     *
+     * When set to 'duplicate', Views prefixed with `internal-generated-` will
+     * be duplicated with new generated names. Use this option when you need
+     * to clone a Layout to any Window.
+     *
+     * When set to `default` or omitted, the Layout will attempt to re-use
+     * existing Views only if they are attached to the current Window or
+     * the Provider Window. Set to `default` or omit this option when creating
+     * Layouts as part of implementing the LayoutManager::applyLayoutSnapshot
+     * override. Note that during applyLayoutSnapshot, Views are created and
+     * attached to the Provider while the Window is being created, so it's
+     * important to not 'duplicate' Views in this workflow.
+     */
+    multiInstanceViewBehavior?: MultiInstanceViewBehavior;
 };
 
 /**
@@ -5176,8 +5211,14 @@ declare interface Environment {
     getRtcPeer(): RTCPeerConnection;
     getWsConstructor(): typeof WebSocket;
     whenReady(): Promise<void>;
+    getInteropInfo(fin: OpenFin.Fin<OpenFin.EntityType>): Promise<InternalInteropBrokerOptions & {
+        fdc3Version?: Fdc3Version;
+    }>;
+    readonly type: EnvironmentType;
 }
 
+declare type EnvironmentType = 'node' | 'openfin' | 'other';
+
 declare type ErrorMiddleware = OpenFin.ErrorMiddleware;
 
 declare type ErrorMiddleware_2 = (topic: string, error: Error, id: ProviderIdentity_7 | ClientIdentity) => unknown;
@@ -7294,6 +7335,15 @@ declare class InterApplicationBus extends Base {
 
 declare type InternalConnectConfig = ExistingConnectConfig | NewConnectConfig;
 
+declare type InternalFDC3Info = {
+    providerVersion: string;
+    provider: string;
+};
+
+declare type InternalInteropBrokerOptions = OpenFin.InteropBrokerOptions & {
+    fdc3Info: InternalFDC3Info;
+};
+
 /**
  * Define whether to enable interop action logging.
  *
@@ -7422,6 +7472,7 @@ declare type InteropActionLoggingOption = {
  *
  */
 declare class InteropBroker extends Base {
+    #private;
     private getProvider;
     private interopClients;
     private contextGroupsById;
@@ -9737,6 +9788,13 @@ declare type MonitorInfoChangedEvent = BaseEvent_9 & OpenFin.MonitorInfo & {
     type: 'monitor-info-changed';
 };
 
+/**
+ * @experimental
+ *
+ * Used to control view behavior for Layout.create API
+ */
+declare type MultiInstanceViewBehavior = 'reparent' | 'duplicate' | 'default';
+
 /**
  * @interface
  */
@@ -10457,6 +10515,7 @@ declare namespace OpenFin {
         LayoutManagerOverride,
         LayoutManager,
         CreateLayoutOptions,
+        MultiInstanceViewBehavior,
         PresetLayoutOptions_2 as PresetLayoutOptions,
         ResultBehavior,
         PopupBaseBehavior,

package/out/fdc3-api.d.ts

@@ -88,12 +88,21 @@ declare type Api = {
     iframe?: {
         /**
          * Inject OpenFin API into cross-origin iframes
+         *
+         * @defaultValue false
          */
         crossOriginInjection?: boolean;
         /**
          * Inject OpenFin API into same-origin iframes
+         *
+         * @defaultValue true
          */
         sameOriginInjection?: boolean;
+        /**
+         * @deprecated Shared names should not be used; support is provided purely for back-compat reasons.
+         *
+         * When `true`, iframes will have the same name as their parent WebContents.
+         */
         enableDeprecatedSharedName?: boolean;
     };
     /**
@@ -1688,8 +1697,20 @@ declare class Base {
      * on the context in which the devtools panel was opened.
      */
     get me(): Identity;
+    /**
+     * @internal
+     * @deprecated
+     */
     protected isNodeEnvironment: () => boolean;
+    /**
+     * @internal
+     * @deprecated
+     */
     protected isOpenFinEnvironment: () => boolean;
+    /**
+     * @internal
+     * @deprecated
+     */
     protected isBrowserEnvironment: () => boolean;
 }
 
@@ -4509,6 +4530,32 @@ declare type CreateLayoutOptions = {
     container: HTMLElement;
     layoutName: string;
     layout: LayoutOptions;
+    /**
+     * @defaultValue 'default'
+     *
+     * Controls the View behavior for the given `layout` property. Note
+     * that the selected behavior only applies to unnamed Views or
+     * Views with the prefix `internal-generated-`. In all cases, if any
+     * View in the `layout` does not already exist, it will be created
+     * with a name that starts with `internal-generated-`.
+     *
+     * When set to `reparent`, Views prefixed with `internal-generated-` will
+     * be reparented to the current Window and added to this new Layout.
+     * Use this option when you need to transfer an existing Layout between Windows.
+     *
+     * When set to 'duplicate', Views prefixed with `internal-generated-` will
+     * be duplicated with new generated names. Use this option when you need
+     * to clone a Layout to any Window.
+     *
+     * When set to `default` or omitted, the Layout will attempt to re-use
+     * existing Views only if they are attached to the current Window or
+     * the Provider Window. Set to `default` or omit this option when creating
+     * Layouts as part of implementing the LayoutManager::applyLayoutSnapshot
+     * override. Note that during applyLayoutSnapshot, Views are created and
+     * attached to the Provider while the Window is being created, so it's
+     * important to not 'duplicate' Views in this workflow.
+     */
+    multiInstanceViewBehavior?: MultiInstanceViewBehavior;
 };
 
 /**
@@ -5224,8 +5271,14 @@ declare interface Environment {
     getRtcPeer(): RTCPeerConnection;
     getWsConstructor(): typeof WebSocket;
     whenReady(): Promise<void>;
+    getInteropInfo(fin: OpenFin.Fin<OpenFin.EntityType>): Promise<InternalInteropBrokerOptions & {
+        fdc3Version?: Fdc3Version;
+    }>;
+    readonly type: EnvironmentType;
 }
 
+declare type EnvironmentType = 'node' | 'openfin' | 'other';
+
 declare type ErrorMiddleware = OpenFin.ErrorMiddleware;
 
 declare type ErrorMiddleware_2 = (topic: string, error: Error, id: ProviderIdentity_7 | ClientIdentity) => unknown;
@@ -7384,6 +7437,15 @@ declare class InterAppPayload {
 
 declare type InternalConnectConfig = ExistingConnectConfig | NewConnectConfig;
 
+declare type InternalFDC3Info = {
+    providerVersion: string;
+    provider: string;
+};
+
+declare type InternalInteropBrokerOptions = OpenFin.InteropBrokerOptions & {
+    fdc3Info: InternalFDC3Info;
+};
+
 /**
  * Define whether to enable interop action logging.
  *
@@ -7512,6 +7574,7 @@ declare type InteropActionLoggingOption = {
  *
  */
 declare class InteropBroker extends Base {
+    #private;
     private getProvider;
     private interopClients;
     private contextGroupsById;
@@ -7523,7 +7586,7 @@ declare class InteropBroker extends Base {
     /**
      * @internal
      */
-    constructor(wire: Transport, getProvider: () => Promise<OpenFin.ChannelProvider>, options?: any);
+    constructor(wire: Transport, getProvider: () => Promise<OpenFin.ChannelProvider>, options: InternalInteropBrokerOptions);
     static createClosedConstructor(...args: ConstructorParameters<typeof InteropBroker>): {
         new (): InteropBroker;
     };
@@ -10014,6 +10077,13 @@ declare type MonitorInfoChangedEvent = BaseEvent_9 & OpenFin.MonitorInfo & {
     type: 'monitor-info-changed';
 };
 
+/**
+ * @experimental
+ *
+ * Used to control view behavior for Layout.create API
+ */
+declare type MultiInstanceViewBehavior = 'reparent' | 'duplicate' | 'default';
+
 /**
  * @interface
  */
@@ -10756,6 +10826,7 @@ declare namespace OpenFin {
         LayoutManagerOverride,
         LayoutManager,
         CreateLayoutOptions,
+        MultiInstanceViewBehavior,
         PresetLayoutOptions_2 as PresetLayoutOptions,
         ResultBehavior,
         PopupBaseBehavior,

package/out/fdc3-api.js

@@ -57,14 +57,26 @@ class Base {
      * @internal
      */
     constructor(wire) {
+        /**
+         * @internal
+         * @deprecated
+         */
         this.isNodeEnvironment = () => {
-            return this.wire.environment.constructor.name === 'NodeEnvironment';
+            return this.wire.environment.type === 'node';
         };
+        /**
+         * @internal
+         * @deprecated
+         */
         this.isOpenFinEnvironment = () => {
-            return this.wire.environment.constructor.name === 'OpenFinEnvironment';
+            return this.wire.environment.type === 'openfin';
         };
+        /**
+         * @internal
+         * @deprecated
+         */
         this.isBrowserEnvironment = () => {
-            return this.wire.environment.constructor.name === 'BrowserEnvironment';
+            return this.wire.environment.type === 'other';
         };
         this.wire = wire;
     }
@@ -622,12 +634,12 @@ PrivateChannelClient$1.PrivateChannelClient = PrivateChannelClient;
 	const getIntentResolution = async (interopModule, context, app, intent) => {
 	    // Generate an ID to make a session context group with. We will pass that ID to the Broker.
 	    // The broker will then setContext on that session context group later with our Intent Result,
-	    const guid = (0, utils_1.generateId)();
+	    const guid = (0, utils_1.generateId)(); // TODO make this undefined in web
 	    // Promise we'll use in getResult
-	    const getResultPromise = new Promise((resolve) => {
+	    const getResultPromise = new Promise((resolve, reject) => {
 	        fin.InterApplicationBus.subscribe({ uuid: '*' }, guid, (intentResult) => {
 	            resolve(intentResult);
-	        });
+	        }).catch(() => reject(new Error('getResult is not supported in this environment')));
 	    });
 	    // Adding the intentResolutionResultId to the intentObj. Because fireIntent only accepts a single arg, we have to slap it in here.
 	    const metadata = app ? { target: app, intentResolutionResultId: guid } : { intentResolutionResultId: guid };
@@ -1526,7 +1538,7 @@ class Fdc3Module extends base_1$1.Base {
             const { metadata } = context;
             const intentResolutionResultId = intentMetadata?.intentResolutionResultId || metadata?.intentResolutionResultId;
             if (intentResolutionResultId) {
-                this.fin.InterApplicationBus.publish(intentResolutionResultId, null);
+                this.fin.InterApplicationBus.publish(intentResolutionResultId, null).catch(() => null);
             }
             handler(raisedIntent.context);
         };
@@ -2017,7 +2029,7 @@ class Fdc3Module2 extends base_1.Base {
                 intentResultToSend = { error: true };
             }
             if (intentResolutionResultId) {
-                this.fin.InterApplicationBus.publish(intentResolutionResultId, intentResultToSend);
+                this.fin.InterApplicationBus.publish(intentResolutionResultId, intentResultToSend).catch(() => null);
             }
             if (intentResult instanceof Error) {
                 throw new Error(intentResult.message);

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@openfin/fdc3-api",
-    "version": "36.79.13",
+    "version": "36.79.17",
     "description": "OpenFin fdc3 module utilities and types.",
     "license": "SEE LICENSE IN LICENSE.MD",
     "private": false,