@openfin/core 29.72.13 → 29.72.14

package/src/api/interop/fdc3/fdc3-2.0.js

@@ -1,19 +1,171 @@
 "use strict";
-// THIS IS NOT PRODUCTION-READY. Until we implement the missing features: getResult, Private Channels and Instance Management we should not document this.
 Object.defineProperty(exports, "__esModule", { value: true });
 const base_1 = require("../../base");
 const utils_1 = require("../utils");
 const InteropClient_1 = require("../InteropClient");
 const fdc3_1_2_1 = require("./fdc3-1.2");
+/**
+ * @typedef { object } AppIdentifier
+ * @summary Identifies an application, or instance of an application, and is used to target FDC3 API calls at specific applications.
+ * @property { string } appId The unique application identifier located within a specific application directory instance. An example of an appId might be 'app@sub.root'.
+ * @property { string } [instancedId] An optional instance identifier, indicating that this object represents a specific instance of the application described. The endpointId should be used as the instanceId. The most convenient way to get this would be to use the InteropBroker.getAllClientInfo API.
+ */
+/**
+ * @typedef { Context | Channel } IntentResult
+ * @summary Describes results that an Intent handler may optionally return that should be communicated back to the app that raised the intent, via the IntentResolution.
+ */
+/**
+ * @typedef { object } Icon
+ * @summary Metadata relating to a single icon image at a remote URL, used to represent an application in a user interface.
+ * @property { string } src The fully qualified url to the icon.
+ * @property { string } [size] The dimensions of the Icon formatted as <height>x<width>.
+ * @property { string } [type] The media type of the icon. If not provided the Desktop Agent may refer to the src file extension.
+ */
+/**
+ * @typedef { object } Image
+ * @summary Metadata relating to a single image at a remote URL, used to represent screenshot images.
+ * @property { string } src The fully qualified url to the image.
+ * @property { string } [size] The dimensions of the image formatted as <height>x<width>.
+ * @property { string } [type] The media type of the image. If not provided the Desktop Agent may refer to the src file extension.
+ * @property { string } [label]
+ */
+/**
+ * @typedef { object } AppMetadata
+ * @variation 2
+ * @summary Extends an AppIdentifier, describing an application or instance of an application, with additional descriptive metadata that is usually provided by an FDC3 App Directory that the desktop agent connects to.
+ * @property { string } appId The unique application identifier located within a specific application directory instance. An example of an appId might be 'app@sub.root'.
+ * @property { string } [instanceId] An optional instance identifier, indicating that this object represents a specific instance of the application described. The endpointId should be used as the instanceId. The most convenient way to get this would be to use the InteropBroker.getAllClientInfo API.
+ * @property { string } [name] The 'friendly' app name. This field was used with the `open` and `raiseIntent` calls in FDC3 <2.0, which now require an `AppIdentifier` with `appId` set. Note that for display purposes the `title` field should be used, if set, in preference to this field.
+ * @property { string } [version] The version of the application.
+ * @property { Record<string, any> } [instanceMetadata]
+ * @property { string } [title] A more user-friendly application title that can be used to render UI elements.
+ * @property { string } [tooltip] A tooltip for the application that can be used to render UI elements.
+ * @property { string } [description] A longer, multi-paragraph description for the application that could include mark-up.
+ * @property { Array<Icon> } [icons] A list of icon URLs for the application that can be used to render UI elements.
+ * @property { Array<Image> } [screenshots] Images representing the app in common usage scenarios that can be used to render UI elements.
+ * @property { string | null } [resultType] The type of result returned for any intent specified during resolution. May express a particular context type (e.g. "fdc3.instrument"), channel (e.g. "channel") or a channel that will receive a specified type (e.g. "channel<fdc3.instrument>").
+ */
+/**
+ * @typedef { object } ContextMetadata
+ * @summary Metadata relating to a context or intent & context received through the addContextListener and addIntentListener functions. Currently identifies the app that originated the context or intent message.
+ * @property { AppIdentifier } source Identifier for the app instance that sent the context and/or intent.
+ */
+/**
+ * @typedef { object } ImplementationMetadataOptionalFeatures
+ * @property { boolean } originatingAppMetadata Used to indicate whether the exposure of 'originating app metadata' for context and intent messages is supported by the Desktop Agent.
+ * @property { boolean } userChannelMembershipAPIs Used to indicate whether the optional `fdc3.joinUserChannel`, `fdc3.getCurrentChannel` and `fdc3.leaveCurrentChannel` are implemented by the Desktop Agent.
+ */
+/**
+ * @typedef { object } ImplementationMetadata
+ * @variation 2
+ * @summary Metadata relating to the FDC3 DesktopAgent object and its provider, including the supported version of the FDC3 specification, the name of the provider of the implementation, its own version number and the metadata of the calling application according to the desktop agent.
+ * @property { string } fdc3Version The FDC3 version
+ * @property { string } provider The provider's uuid prepended with 'openfin' (e.g. 'openfin-myUuid').
+ * @property { string } [providerVersion] The provider runtime version
+ * @property { ImplementationMetadataOptionalFeatures } optionalFeatures
+ * @property { AppMetadata } appMetadata The calling application instance's own metadata, according to the Desktop Agent (MUST include at least the `appId` and `instanceId`).
+ */
+/**
+ * @callback ContextHandler
+ * @variation 2
+ * @param { Context } context
+ * @param { ContextMetadata } [contextMetadata]
+ * @returns { void }
+ */
+/**
+ * @callback IntentHandler
+ * @variation 2
+ * @param { Context } context
+ * @param { ContextMetadata } [contextMetadata]
+ * @returns { Promise<IntentResult> | void }
+ */
+/**
+ * @typedef { object } IntentMetadata
+ * @summary The interface used to describe an intent within the platform.
+ * @property { string } name The unique name of the intent that can be invoked by the raiseIntent call.
+ * @property { string } displayName A friendly display name for the intent that should be used to render UI elements.
+ */
+/**
+ * @typedef { object } AppIntent
+ * @variation 2
+ * @summary An interface that represents the binding of an intent to apps, returned as part of intent discovery. For each intent, it references the applications that support that intent.
+ * @property { IntentMetadata } intent Details of the intent whose relationship to resolving applications is being described
+ * @property { Array<AppMetadata> } apps
+ */
+/**
+ * @name getResult
+ * @function
+ * @returns { Promise<IntentResult> }
+ */
+/**
+ * @typedef { object } IntentResolution
+ * @variation 2
+ * @summary Provides a standard format for data returned upon resolving an intent.
+ * @property { AppIdentifier } source Identifier for the app instance that was selected (or started) to resolve the intent.
+ * @property { string } Intent Intent name
+ * @property { string } [version] The version number of the Intents schema being used.
+ * @property { Function } getResult {@link getResult Function} that returns a promise that will resolve to either `Context` data returned by the application that resolves the raised intent or a `Channel` established and returned by the app resolving the intent.
+ */
+/**
+ * @class
+ * @alias fdc3v2
+ * @version 2.0
+ * @hideconstructor
+ * @desc The FDC3 Client Library provides a set APIs to be used for FDC3 compliance,
+ * while using our Interop API under the hood. In order to use this set of APIs
+ * you will need to set up your own {@link InteropBroker InteropBroker} or use a Platform application, which does the setup for you. Refer to our documentation on
+ * our {@link https://developers.openfin.co/of-docs/docs/enable-context-sharing Interop API}.
+ *
+ * To enable the FDC3 APIs in a {@link Window Window} or {@link View View}, add the fdc3InteropApi
+ * property to its options:
+ *
+ * ```js
+ * {
+ *     autoShow: false,
+ *     saveWindowState: true,
+ *     url: 'https://openfin.co',
+ *     fdc3InteropApi: '2.0'
+ * }
+ * ```
+ *
+ * If using a {@link Platform Platform } application, you can set this property in defaultWindowOptions and defaultViewOptions.
+ *
+ * In order to ensure that the FDC3 Api is ready before use, you can use the 'fdc3Ready' event fired on the DOM Window object:
+ *
+ * ```js
+ * function fdc3Action() {
+ *     // Make some fdc3 API calls here
+ * }
+ *
+ * if (window.fdc3) {
+ *    fdc3Action();
+ * } else {
+ *    window.addEventListener('fdc3Ready', fdc3Action);
+ * }
+ * ```
+ */
 class Fdc3Module2 extends base_1.Base {
     constructor(wire) {
         super(wire);
         // we get the module for fdc 1.2 here so we can reuse it wherever we can
         this.fdc3Module = new fdc3_1_2_1.default(this.wire);
     }
+    /**
+     * Launches an app, specified via an AppIdentifier object.
+     * @param { AppIdentifier | TargetApp } app
+     * @param { Context } [context]
+     * @returns { Promise<AppIdentifier> }
+     * @tutorial fdc3.open
+     */
     async open(app, context) {
         return this.fdc3Module.open(app, context);
     }
+    /**
+     * Find all the available instances for a particular application.
+     * @param { AppIdentifier } app
+     * @returns { Promise<Array<AppIdentifier>> }
+     * @tutorial fdc3v2.findInstances
+     */
     async findInstances(app) {
         this.wire.sendAction('fdc3-find-instances').catch((e) => {
             // we do not want to expose this error, just continue if this analytics-only call fails
@@ -26,6 +178,12 @@ class Fdc3Module2 extends base_1.Base {
             throw new Error(errorToThrow);
         }
     }
+    /**
+     * Retrieves the AppMetadata for an AppIdentifier, which provides additional metadata (such as icons, a title and description) from the App Directory record for the application, that may be used for display purposes.
+     * @param { AppIdentifier } app
+     * @returns { Promise<AppMetadata(2)> }
+     * @tutorial fdc3v2.getAppMetadata
+     */
     async getAppMetadata(app) {
         this.wire.sendAction('fdc3-get-app-metadata').catch((e) => {
             // we do not want to expose this error, just continue if this analytics-only call fails
@@ -38,23 +196,53 @@ class Fdc3Module2 extends base_1.Base {
             throw new Error(errorToThrow);
         }
     }
+    /**
+     * Broadcasts a context for the channel of the current entity.
+     * @param { Context } context - New context to set.
+     * @returns { Promise<void> }
+     * @tutorial fdc3.broadcast
+     */
     async broadcast(context) {
         return this.fdc3Module.broadcast(context);
     }
+    /**
+     * Add a context handler for incoming context. If an entity is part of a context group, and then sets its context handler, it will receive all of its declared contexts. If you wish to listen for all incoming contexts, pass `null` for the contextType argument.
+     * @param { string | null } contextType
+     * @param { ContextHandler(2) } handler
+     * @returns { Listener }
+     * @tutorial fdc3.addContextListener
+     */
     async addContextListener(contextType, handler) {
         this.wire.sendAction('fdc3-add-context-listener').catch((e) => {
             // we do not want to expose this error, just continue if this analytics-only call fails
         });
-        let listener;
+        // The FDC3 ContextHandler only expects the context and optional ContextMetadata, so we wrap the handler
+        // here so it only gets passed these parameters
+        const getWrappedHandler = (handlerToWrap) => {
+            return (context) => {
+                const { contextMetadata, ...rest } = context;
+                const args = contextMetadata ? [{ ...rest }, contextMetadata] : [context, null];
+                handlerToWrap(...args);
+            };
+        };
+        let actualHandler = handler;
+        let wrappedHandler = getWrappedHandler(actualHandler);
         if (typeof contextType === 'function') {
             console.warn('addContextListener(handler) has been deprecated. Please use addContextListener(null, handler)');
-            listener = await this.fin.me.interop.addContextHandler(contextType);
-        }
-        else {
-            listener = await this.fin.me.interop.addContextHandler(handler, contextType === null ? undefined : contextType);
+            actualHandler = contextType;
+            wrappedHandler = getWrappedHandler(actualHandler);
+            return this.fin.me.interop.addContextHandler(wrappedHandler);
         }
-        return listener;
+        return this.fin.me.interop.addContextHandler(wrappedHandler, contextType === null ? undefined : contextType);
     }
+    /**
+     * Find out more information about a particular intent by passing its name, and optionally its context and resultType.
+     * @param { string } intent Name of the Intent
+     * @param { Context } [context] Context
+     * @param { string } [resultType] The type of result returned for any intent specified during resolution.
+     * @returns { Promise<AppIntent(2)> }
+     * @tutorial fdc3.findIntent
+     */
     async findIntent(intent, context, resultType) {
         this.wire.sendAction('fdc3-find-intent').catch((e) => {
             // we do not want to expose this error, just continue if this analytics-only call fails
@@ -67,36 +255,74 @@ class Fdc3Module2 extends base_1.Base {
             throw new Error(errorToThrow);
         }
     }
+    /**
+     * Find all the available intents for a particular context.
+     * @param { Context } context
+     * @param { string } [resultType] The type of result returned for any intent specified during resolution.
+     * @returns { Promise<Array<AppIntent(2)>> }
+     * @tutorial fdc3v2.findIntentsByContext
+     */
     async findIntentsByContext(context, resultType) {
         this.wire.sendAction('fdc3-find-intents-by-context').catch((e) => {
             // we do not want to expose this error, just continue if this analytics-only call fails
         });
+        const payload = resultType ? { context, metadata: { resultType } } : context;
         try {
-            return await InteropClient_1.InteropClient.ferryFdc3Call(fin.me.interop, 'fdc3v2FindIntentsByContext', {
-                context,
-                resultType
-            });
+            return await InteropClient_1.InteropClient.ferryFdc3Call(fin.me.interop, 'fdc3v2FindIntentsByContext', payload);
         }
         catch (error) {
             const errorToThrow = error.message === utils_1.BROKER_ERRORS.getInfoForIntentsByContext ? 'ResolverUnavailable' : error;
             throw new Error(errorToThrow);
         }
     }
+    /**
+     * Raises a specific intent for resolution against apps registered with the desktop agent.
+     * @param { string } intent Name of the Intent
+     * @param { Context } context Context associated with the Intent
+     * @param { AppIdentifier | TargetApp } [app]
+     * @returns { Promise<IntentResolution(2)> }
+     * @tutorial fdc3.raiseIntent
+     */
     async raiseIntent(intent, context, app) {
         return this.fdc3Module.raiseIntent(intent, context, app);
     }
+    /**
+     * Finds and raises an intent against apps registered with the desktop agent based purely on the type of the context data.
+     * @param { Context } context Context associated with the Intent
+     * @param { AppIdentifier | TargetApp } [app]
+     * @returns { Promise<IntentResolution(2)> }
+     * @tutorial fdc3.raiseIntentForContext
+     */
     async raiseIntentForContext(context, app) {
         return this.fdc3Module.raiseIntentForContext(context, app);
     }
+    /**
+     * Adds a listener for incoming intents.
+     * @param { string } intent  Name of the Intent
+     * @param { IntentHandler(2) } handler A callback that handles a context event and may return a promise of a Context or Channel object to be returned to the application that raised the intent.
+     * @returns { Promise<Listener> }
+     * @tutorial fdc3.addIntentListener
+     */
     async addIntentListener(intent, handler) {
         this.wire.sendAction('fdc3-add-intent-listener').catch((e) => {
             // we do not want to expose this error, just continue if this analytics-only call fails
         });
+        // The FDC3 Intenter handler only expects the context and contextMetadata to be passed to the handler,
+        // so we wrap it here and only pass those paramaters.
         const contextHandler = (raisedIntent) => {
-            handler(raisedIntent.context);
+            const { context } = raisedIntent;
+            const { contextMetadata, ...rest } = context;
+            const args = contextMetadata ? [{ ...rest }, contextMetadata] : [context, null];
+            handler(...args);
         };
         return this.fin.me.interop.registerIntentHandler(contextHandler, intent, { fdc3Version: '2.0' });
     }
+    /**
+     * Returns a Channel object for the specified channel, creating it as an App Channel if it does not exist.
+     * @param channelId
+     * @returns { Promise<Channel> }
+     * @tutorial fdc3.getOrCreateChannel
+     */
     async getOrCreateChannel(channelId) {
         return this.fdc3Module.getOrCreateChannel(channelId);
     }
@@ -104,23 +330,72 @@ class Fdc3Module2 extends base_1.Base {
     async createPrivateChannel() {
         // private channels will be implemented in another PR
     }
+    /**
+     * Retrieves a list of the User Channels available for the app to join.
+     * @returns { Promise<Channel[]>}
+     * @tutorial fdc3v2.getUserChannels
+     */
     async getUserChannels() {
         return this.fdc3Module.getSystemChannels();
     }
+    /**
+     * Retrieves a list of the User Channels available for the app to join.
+     * @returns { Promise<Channel[]>}
+     * @deprecated Please use {@link fdc3.getUserChannels fdc3.getUserChannels} instead
+     * @tutorial fdc3.getSystemChannels
+     */
     async getSystemChannels() {
         return this.fdc3Module.getSystemChannels();
     }
+    /**
+     * Join an app to a specified User channel.
+     * @param { string } channelId Channel name
+     * @returns { Promise<void> }
+     * @tutorial fdc3v2.joinUserChannel
+     */
     async joinUserChannel(channelId) {
         return this.fdc3Module.joinChannel(channelId);
     }
+    /**
+     * Join an app to a specified User channel.
+     * @param { string } channelId Channel name
+     * @deprecated Please use {@link fdc3.joinUserChannel fdc3.joinUserChannel} instead
+     * @returns { Promise<void> }
+     * @tutorial fdc3.joinChannel
+     */
+    async joinChannel(channelId) {
+        return this.fdc3Module.joinChannel(channelId);
+    }
+    /**
+     * Returns the Channel object for the current User channel membership
+     * @returns { Promise<FDC3.Channel | null> }
+     */
     async getCurrentChannel() {
         return this.fdc3Module.getCurrentChannel();
     }
+    /**
+     * Removes the app from any User channel membership.
+     * @returns { Promise<void> }
+     * @tutorial fdc3.leaveCurrentChannel
+     */
     async leaveCurrentChannel() {
-        return this.leaveCurrentChannel();
+        return this.fdc3Module.leaveCurrentChannel();
     }
+    /**
+     * Retrieves information about the FDC3 implementation, including the supported version of the FDC3 specification, the name of the provider of the implementation, its own version number, details of whether optional API features are implemented and the metadata of the calling application according to the desktop agent.
+     * @returns { Promise<ImplementationMetadata(2)> }
+     * @tutorial fdc3v2.getInfo
+     */
     async getInfo() {
-        return this.fdc3Module.getInfo();
+        try {
+            const result = await InteropClient_1.InteropClient.ferryFdc3Call(fin.me.interop, 'fdc3v2GetInfo', {});
+            const partialInfo = this.fdc3Module.getInfo();
+            return { ...partialInfo, ...result };
+        }
+        catch (error) {
+            const errorToThrow = error.message === utils_1.BROKER_ERRORS.fdc3GetInfo ? 'ResolverUnavailable' : error;
+            throw new Error(errorToThrow);
+        }
     }
 }
 exports.default = Fdc3Module2;

package/src/api/interop/fdc3/fdc3.js

@@ -1,12 +1,16 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.registerFdc3Shim = exports.versionMap = void 0;
+exports.getFdc3 = exports.registerFdc3Shim = exports.versionMap = void 0;
+/* eslint-disable no-console */
+/* eslint-disable no-param-reassign */
+/* eslint-disable @typescript-eslint/no-non-null-assertion */
 const fdc3_1_2_1 = require("./fdc3-1.2");
 const fdc3_2_0_1 = require("./fdc3-2.0");
 exports.versionMap = {
     '1.2': fdc3_1_2_1.default,
     '2.0': fdc3_2_0_1.default
 };
+const latestVersion = '2.0';
 function registerFdc3Shim(version, transport) {
     if (Object.keys(exports.versionMap).includes(version)) {
         const Api = exports.versionMap[version];
@@ -18,3 +22,14 @@ function registerFdc3Shim(version, transport) {
     }
 }
 exports.registerFdc3Shim = registerFdc3Shim;
+function getFdc3(transport, version = latestVersion) {
+    if (!(version in exports.versionMap)) {
+        console.warn(`FDC3 API version: ${version} is not supported. Defaulting to latest version: ${latestVersion}.`);
+        version = latestVersion;
+    }
+    const Fdc3Api = exports.versionMap[version];
+    const fdc3 = new Fdc3Api(transport);
+    window.dispatchEvent(new CustomEvent('fdc3Ready'));
+    return fdc3;
+}
+exports.getFdc3 = getFdc3;

package/src/api/interop/utils.d.ts

@@ -12,5 +12,6 @@ export declare const BROKER_ERRORS: {
     fdc3Open: string;
     fdc3FindInstances: string;
     fdc3GetAppMetadata: string;
+    fdc3GetInfo: string;
 };
 export declare const wrapIntentHandler: (handler: OpenFin.IntentHandler, handlerId: string) => (intent: OpenFin.Intent) => Promise<void>;

package/src/api/interop/utils.js

@@ -39,7 +39,8 @@ exports.BROKER_ERRORS = {
     joinSessionContextGroupWithJoinContextGroup: 'The Context Group you have tried to join is a Session Context Group. Custom Context Groups can only be defined by the Interop Broker through code or manifest configuration. Please use joinSessionContextGroup.',
     fdc3Open: exports.generateOverrideError('fdc3.open', 'fdc3HandleOpen'),
     fdc3FindInstances: exports.generateOverrideError('fdc3.findInstances', 'fdc3HandleFindInstances'),
-    fdc3GetAppMetadata: exports.generateOverrideError('fdc3.getAppMetadata', 'fdc3HandleGetAppMetadata')
+    fdc3GetAppMetadata: exports.generateOverrideError('fdc3.getAppMetadata', 'fdc3HandleGetAppMetadata'),
+    fdc3GetInfo: exports.generateOverrideError('fdc3.getInfo', 'fdc3HandleGetInfo')
 };
 exports.wrapIntentHandler = (handler, handlerId) => {
     return async (intent) => {

package/src/api/me.js

@@ -116,6 +116,11 @@ function getMe(wire) {
                 interop: fallbackInterop,
                 isOpenFin: true
             });
+        case 'external connection':
+            return Object.assign(new window_1._Window(wire, { uuid, name }), getBaseMe(entityType, uuid, name), {
+                interop: fallbackInterop,
+                isOpenFin: false
+            });
         default:
             return {
                 ...getBaseMe(entityType, uuid, name),

package/src/browser.d.ts

@@ -0,0 +1,10 @@
+import { FinApi } from './api/fin';
+import { RemoteConfig } from './transport/wire';
+interface GetRemoteConnectionPayload extends RemoteConfig {
+    interopProviderId: string;
+    withInterop: boolean;
+}
+export declare function getRemoteConnectionPayload(fin: FinApi<OpenFin.EntityType>, uuid?: string, interopProviderId?: string): Promise<GetRemoteConnectionPayload>;
+export declare function remoteConnect({ uuid, token, address, interopProviderId, withInterop }: GetRemoteConnectionPayload): Promise<FinApi<'external connection'>>;
+export declare function remoteConnectInterop(fin: FinApi<OpenFin.EntityType>, interopProviderId: string): Promise<FinApi<OpenFin.EntityType>>;
+export {};

package/src/browser.js

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.remoteConnectInterop = exports.remoteConnect = exports.getRemoteConnectionPayload = void 0;
+const fin_1 = require("./api/fin");
+const browser_1 = require("./environment/browser");
+const transport_1 = require("./transport/transport");
+const websocket_1 = require("./transport/websocket");
+async function getRemoteConnectionPayload(fin, uuid = `browser-connection-${Math.random().toString().slice(2)}`, interopProviderId = fin.me.uuid) {
+    var _a;
+    const { token } = await fin.System.registerExternalConnection(uuid);
+    const { port } = await fin.System.getRuntimeInfo();
+    const ip = '127.0.0.1';
+    const address = `ws://${ip}:${port}`;
+    // @ts-expect-error
+    return { uuid, token, address, interopProviderId, withInterop: ((_a = fin === null || fin === void 0 ? void 0 : fin.__internal_) === null || _a === void 0 ? void 0 : _a.isPlatform) || false };
+}
+exports.getRemoteConnectionPayload = getRemoteConnectionPayload;
+async function remoteConnect({ uuid, token, address, interopProviderId, withInterop }) {
+    const wire = new transport_1.default(websocket_1.default, new browser_1.BrowserEnvironment(), {
+        uuid,
+        name: uuid
+    });
+    await wire.connect({ uuid, address, token });
+    if (withInterop) {
+        return remoteConnectInterop(new fin_1.default(wire), interopProviderId);
+    }
+    return new fin_1.default(wire);
+}
+exports.remoteConnect = remoteConnect;
+async function remoteConnectInterop(fin, interopProviderId) {
+    if (interopProviderId) {
+        fin.me.interop = fin.Interop.connectSync(interopProviderId, {});
+    }
+    return fin;
+}
+exports.remoteConnectInterop = remoteConnectInterop;

package/src/environment/browser.d.ts

@@ -0,0 +1,25 @@
+import { NewConnectConfig } from '../transport/wire';
+import { ChildContentOptions, Environment } from './environment';
+import EntityType = OpenFin.EntityType;
+export declare class BrowserEnvironment implements Environment {
+    getManagerConstructor(): Promise<any>;
+    getProviderInitializer(): Promise<any>;
+    writeToken(path: string, token: string): Promise<string>;
+    retrievePort(config: NewConnectConfig): Promise<number>;
+    getNextMessageId(): string;
+    getRandomId: () => string;
+    createChildContent(options: ChildContentOptions): Promise<any>;
+    getWebWindow(identity: OpenFin.Identity): Window;
+    getCurrentEntityIdentity(): OpenFin.EntityInfo;
+    getCurrentEntityType(): EntityType;
+    raiseEvent(eventName: string, eventArgs: any): void;
+    childViews: boolean;
+    getUrl(): string;
+    getDefaultChannelOptions(): {
+        create: OpenFin.ChannelCreateOptions;
+        connect: OpenFin.ChannelConnectOptions;
+    };
+    getRtcPeer(): RTCPeerConnection;
+    getWsConstructor(): typeof WebSocket;
+    whenReady(): Promise<void>;
+}

package/src/environment/browser.js

@@ -0,0 +1,57 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BrowserEnvironment = void 0;
+class BrowserEnvironment {
+    constructor() {
+        this.getRandomId = () => {
+            const intArray = new Uint32Array(1);
+            return window.crypto.getRandomValues(intArray)[0].toString(32);
+        };
+    }
+    getManagerConstructor() {
+        throw new Error('Method not implemented.');
+    }
+    getProviderInitializer() {
+        throw new Error('Method not implemented.');
+    }
+    writeToken(path, token) {
+        return Promise.resolve('');
+    }
+    retrievePort(config) {
+        throw new Error('Method not implemented.');
+    }
+    getNextMessageId() {
+        return this.getRandomId();
+    }
+    createChildContent(options) {
+        throw new Error('Method not implemented.');
+    }
+    getWebWindow(identity) {
+        throw new Error('Method not implemented.');
+    }
+    getCurrentEntityIdentity() {
+        throw new Error('Method not implemented.');
+    }
+    getCurrentEntityType() {
+        return 'external connection';
+    }
+    raiseEvent(eventName, eventArgs) {
+        throw new Error('Method not implemented.');
+    }
+    getUrl() {
+        return location.href;
+    }
+    getDefaultChannelOptions() {
+        return { create: {}, connect: {} };
+    }
+    getRtcPeer() {
+        return new RTCPeerConnection();
+    }
+    getWsConstructor() {
+        return WebSocket;
+    }
+    whenReady() {
+        return Promise.resolve();
+    }
+}
+exports.BrowserEnvironment = BrowserEnvironment;

package/src/environment/environment.d.ts

@@ -19,6 +19,7 @@ export interface Environment {
         connect: OpenFin.ChannelConnectOptions;
     };
     getRtcPeer(): RTCPeerConnection;
+    getWsConstructor(): typeof WebSocket;
     whenReady(): Promise<void>;
 }
 export interface ChildContentOptions {

package/src/environment/node-env.d.ts

@@ -22,4 +22,5 @@ export default class NodeEnvironment implements Environment {
     getCurrentEntityType: () => EntityType;
     raiseEvent: (eventName: string, eventArgs: any) => void;
     getUrl: () => string;
+    getWsConstructor(): typeof WebSocket;
 }

package/src/environment/node-env.js

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 /* eslint-disable class-methods-use-this */
 const fs_1 = require("fs");
 const crypto_1 = require("crypto");
+const WS = require("ws");
 const environment_1 = require("./environment");
 const port_discovery_1 = require("../transport/port-discovery");
 const transport_errors_1 = require("../transport/transport-errors");
@@ -60,5 +61,9 @@ class NodeEnvironment {
     createChildContent(options) {
         throw new transport_errors_1.NotImplementedError('Not Implemented');
     }
+    getWsConstructor() {
+        // @ts-expect-error
+        return WS;
+    }
 }
 exports.default = NodeEnvironment;

package/src/environment/openfin-env.d.ts

@@ -1,7 +1,8 @@
 import { ChildContentOptions, Environment } from './environment';
 import { NewConnectConfig } from '../transport/wire';
+import { BrowserEnvironment } from './browser';
 import EntityType = OpenFin.EntityType;
-export default class OpenFinEnvironment implements Environment {
+export default class OpenFinEnvironment extends BrowserEnvironment implements Environment {
     #private;
     private raiseEventAsync;
     childViews: boolean;
@@ -10,7 +11,6 @@ export default class OpenFinEnvironment implements Environment {
         create: OpenFin.ChannelCreateOptions;
         connect: OpenFin.ChannelConnectOptions;
     };
-    getRtcPeer(): RTCPeerConnection;
     getManagerConstructor(): Promise<any>;
     getProviderInitializer(): Promise<any>;
     writeToken: (path: string, token: string) => Promise<string>;
@@ -18,12 +18,10 @@ export default class OpenFinEnvironment implements Environment {
     getNextMessageId: () => any;
     createChildContent: ({ options, entityType }: ChildContentOptions) => Promise<unknown>;
     private normalizeOptions;
-    getRandomId: () => string;
     private resolveUrl;
     getWebWindow: (identity: OpenFin.Identity) => globalThis.Window;
     getCurrentEntityIdentity: () => OpenFin.EntityInfo;
     getCurrentEntityType: () => EntityType;
     raiseEvent: (eventName: string, eventArgs: any) => void;
-    getUrl: () => string;
     whenReady(): Promise<void>;
 }