@openfin/workspace 45.3.4 → 45.3.6

package/common/src/api/pages/shapes.d.ts

@@ -267,11 +267,15 @@ export interface CopyPagePayload {
     /** Specifies the trigger for creating a copy. */
     reason: 'save-as' | 'duplicate';
 }
+/** The user interaction that created a new page. Reported in the `Create Page` analytics event. */
+export type PageCreationOrigin = 'new-tab-button' | 'menu' | 'hotkey' | 'dock' | 'new-window';
 export type AddDefaultPagePayload = {
     /** The OF window identity to attach the pages to. */
     identity: OpenFin.Identity;
     /** The page to attach. */
     page: PageWithUpdatableRuntimeAttribs;
+    /** The user interaction that requested the page. */
+    origin?: PageCreationOrigin;
 };
 export type AddPagePayload = {
     /** The OF window identity to attach the pages to. */

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

@@ -0,0 +1,30 @@
+import type OpenFin from '@openfin/core';
+export declare enum InteropEventType {
+    JoinedContextGroup = "joined-context-group",
+    RemovedFromContextGroup = "removed-from-context-group"
+}
+type InteropEventPayload<E extends InteropEventType> = {
+    [InteropEventType.JoinedContextGroup]: {
+        viewIdentity: OpenFin.Identity;
+        contextGroupId: string;
+    };
+    [InteropEventType.RemovedFromContextGroup]: {
+        viewIdentity: OpenFin.Identity;
+    };
+}[E];
+export type InteropListener<EventType extends InteropEventType> = (payload: InteropEventPayload<EventType>) => void;
+/**
+ * Returns contextGroup data.
+ * @returns Promise<ContextGroup[]>
+ */
+export declare function getContextGroups(): Promise<OpenFin.ContextGroupInfo[]>;
+export declare const joinContextGroup: (viewIdentity: OpenFin.Identity, contextGroupId: string) => Promise<void>;
+export declare const removeFromGroup: (viewIdentity: OpenFin.Identity) => Promise<void>;
+export declare function getViewContextGroupId(viewIdentity: OpenFin.Identity): Promise<string | null | undefined>;
+/**
+ * Listen for interop events.
+ * @param event the interop event to listen for.
+ * @param listener the function to call when the event occurs.
+ */
+export declare const addInteropListener: <Event extends InteropEventType>(event: Event, listener: InteropListener<Event>) => Promise<void>;
+export {};

package/common/src/utils/usage-register.d.ts

@@ -1,4 +1,5 @@
 import type OpenFin from '@openfin/core';
+import type { Page, PageCreationOrigin } from '../../../common/src/api/pages/shapes';
 import { AttachedPage } from '../../../client-api-platform/src/shapes';
 export interface RegisterUsageStatus {
     apiVersion?: string;
@@ -63,6 +64,10 @@ export interface AnalyticsEventInternal extends AnalyticsEvent {
 export type AnalyticsEventRaise = Omit<AnalyticsEventInternal, 'source'>;
 export declare const raiseBrowserAnalytics: (payload: AnalyticsEventRaise) => Promise<void>;
 export declare const raiseBrowserPageAnalytics: (pages: AttachedPage[], action: string) => Promise<void>;
+/**
+ * Raised when a new page ID is minted, as opposed to `Open Page`, which also fires for restored pages.
+ */
+export declare const raiseCreatePageAnalytics: (page: Pick<Page, "pageId" | "title">, windowName: string, origin?: PageCreationOrigin) => Promise<void>;
 export declare const raiseHomeAnalytics: (platformIdentity: OpenFin.Identity, payload: AnalyticsEventRaise) => Promise<void>;
 export declare const raiseDockAnalytics: (platformIdentity: OpenFin.Identity, payload: AnalyticsEventRaise) => Promise<void>;
 export declare const raiseStorefrontAnalytics: (platformIdentity: OpenFin.Identity, payload: AnalyticsEventRaise) => Promise<void>;

package/externals.report.json

@@ -27,6 +27,12 @@
             "version": "3.0.3",
             "packageName": "common/package.json",
             "issuer": "common/src/utils/color-channels.ts"
+        },
+        {
+            "type": "explicit",
+            "version": "3.0.3",
+            "packageName": "client-api-platform/package.json",
+            "issuer": "client-api-platform/src/api/context-menu/browser-pagetab-handler.ts"
         }
     ],
     "lodash.debounce": [
@@ -43,14 +49,6 @@
             "issuer": "common/src/utils/layout.ts"
         }
     ],
-    "lodash.clonedeep": [
-        {
-            "type": "explicit",
-            "version": "4.5.0",
-            "packageName": "common/package.json",
-            "issuer": "common/src/utils/layout.ts"
-        }
-    ],
     "react-i18next": [
         {
             "type": "explicit",
@@ -100,5 +98,13 @@
             "packageName": "common/package.json",
             "issuer": "common/src/utils/create-and-migrate-ibd-store.ts"
         }
+    ],
+    "lodash.clonedeep": [
+        {
+            "type": "explicit",
+            "version": "4.5.0",
+            "packageName": "common/package.json",
+            "issuer": "common/src/utils/layout.ts"
+        }
     ]
 }