@openfin/workspace-platform 14.1.0 → 14.1.1

package/README.md

@@ -14,7 +14,7 @@ Run `npm i -E @openfin/workspace-platform`.
 
 ## Code examples
 
-### Initilaize a Workspace Platform
+### Initialize a Workspace Platform
 
 ```typescript
 import * as WorkspacePlatform from '@openfin/workspace-platform';
@@ -23,10 +23,10 @@ const customThemes: WorkspacePlatform.CustomThemes = [
     {
         label: "OpenFin's Custom Theme",
         palette: {
-            brandPrimary: ‘#F51F63, // required
-            brandSecondary: ‘#1FF58A’, // required
-            backgroundPrimary: ‘#F8E71C’, // required - hex, rgb/rgba, hsl/hsla only - no string colors: ‘red’
-            background2: ‘#7D808A’ // any of the optional colors
+            brandPrimary: '#F51F63', // required
+            brandSecondary: '#1FF58A', // required
+            backgroundPrimary: '#F8E71C', // required - hex, rgb/rgba, hsl/hsla only - no string colors: ‘red’
+            background2: '#7D808A' // any of the optional colors
         }
     }
 ];
@@ -42,7 +42,7 @@ const overrideCallback: WorkspacePlatform.WorkspacePlatformOverrideCallback = as
 
 await WorkspacePlatform.init({
     browser: {
-        title: "My Browser"
+        title: 'My Browser'
     },
     overrideCallback,
     theme: customThemes

package/client-api/src/dock.d.ts

@@ -1,5 +1,5 @@
 import type { DockProvider } from './shapes/dock';
-import { DockProviderRegistration } from './shapes/dock';
+import { type DockProviderRegistration } from './shapes/dock';
 export * from './shapes/dock';
 /**
  * API function to register a Dock provider.

package/client-api/src/internal/home/handlers/index.d.ts

@@ -1,5 +1,6 @@
+import { withDisconnectListener } from '../../../../../common/src/utils/channels';
 import { SearchAPIClientChannelClient } from '../../../../../common/src/api/protocol/shapes/search';
-type HomeWorkspaceAPIClientChannelClient = SearchAPIClientChannelClient & {
+type HomeWorkspaceAPIClientChannelClient = withDisconnectListener<SearchAPIClientChannelClient> & {
     homeChannelActionsRegistered?: boolean;
 };
 export declare function registerHomeChannelClientActions(channel: HomeWorkspaceAPIClientChannelClient): void;

package/client-api-platform/src/init/browser-base-url.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Get the browser base url override if it exists
+ *
+ * @returns The browser base url override if it exists, otherwise null
+ */
+export declare function getBrowserBaseUrl(): Promise<string | null>;

package/client-api-platform/src/init/browser-base-url.test.d.ts

@@ -0,0 +1 @@
+export {};

package/client-api-platform/src/shapes.d.ts

@@ -1455,6 +1455,8 @@ export interface WorkspacePlatformInitConfig {
     /**
      * Customize the Looks and Feel of the Workspace Platform by providing a custom palette.
      *
+     * The `backgroundPrimary` color **must** be either a hex, rgb, rgba, hsl, or hsla value.
+     *
      * Two palettes are provided by default: `light` and `dark`.
      * The `dark` palette is used by default.
      *

package/common/src/api/overrides.d.ts

@@ -14,6 +14,7 @@ export interface Overrides {
         [key: string]: boolean;
     };
     disableRuntimeValidation: boolean;
+    browserBaseUrl: string;
     disableOpenFinAnalytics: boolean;
     analyticsEndpoint: string;
 }

package/common/src/api/protocol/browser.d.ts

@@ -1,7 +1,7 @@
 import type OpenFin from '@openfin/core';
 export declare const getWindowChannelId: (identity: OpenFin.Identity) => string;
 export interface ChannelClient extends OpenFin.ChannelClient {
-    dispatch: (action: typeof BrowserChannelAction[keyof BrowserChannelAction], payload?: any) => Promise<any>;
+    dispatch: (action: (typeof BrowserChannelAction)[keyof BrowserChannelAction], payload?: any) => Promise<any>;
 }
 export declare const getChannelClient: (identity: OpenFin.Identity) => Promise<ChannelClient>;
 /**
@@ -29,7 +29,8 @@ declare enum GeneralBrowserChannelActions {
     RemoveFromChannel = "remove-from-channel",
     OpenSaveModalInternal = "open-save-modal-internal",
     DuplicatePage = "duplicate-page",
-    SetSelectedScheme = "set-selected-scheme"
+    SetSelectedScheme = "set-selected-scheme",
+    ShowBrowserIndicator = "show-browser-indicator"
 }
 /**
  * All of the remote procedures that can be called in the
@@ -68,6 +69,7 @@ export declare const BrowserChannelAction: {
     OpenSaveModalInternal: GeneralBrowserChannelActions.OpenSaveModalInternal;
     DuplicatePage: GeneralBrowserChannelActions.DuplicatePage;
     SetSelectedScheme: GeneralBrowserChannelActions.SetSelectedScheme;
+    ShowBrowserIndicator: GeneralBrowserChannelActions.ShowBrowserIndicator;
 };
 export type BrowserChannelAction = typeof BrowserChannelAction;
 export {};

package/common/src/api/protocol/workspace.d.ts

@@ -1,3 +1,4 @@
+import { withDisconnectListener } from '../../../../common/src/utils/channels';
 import { SearchAPIClientChannelClient } from '../../../../common/src/api/protocol/shapes/search';
 import type { WorkspaceAPIClientChannelClient, WorkspaceChannelProvider, WorkspaceComponentChannelClient } from './shapes/workspace';
 export type { WorkspaceAPIClientChannelClient, WorkspaceComponentChannelClient, WorkspaceChannelProvider };
@@ -5,7 +6,7 @@ export type { WorkspaceAPIClientChannelClient, WorkspaceComponentChannelClient,
 export declare const channelName: "__of_workspace_protocol__";
 export declare const getChannelClient: () => Promise<WorkspaceComponentChannelClient>;
 export declare const getClientAPIChannelClient: () => Promise<WorkspaceAPIClientChannelClient>;
-export declare const getSearchClientAPIChannelClient: () => Promise<SearchAPIClientChannelClient>;
+export declare const getSearchClientAPIChannelClient: () => Promise<withDisconnectListener<SearchAPIClientChannelClient>>;
 /**
  * Launches the Workspace Provider.
  * If the Workspace Provider is already running, does nothing.

package/common/src/api/search/common.d.ts

@@ -6,7 +6,7 @@ export interface InternalSearchListenerResponse {
     getRevokedBuffer(): string[];
     setRevokedBuffer(resultIds: string[]): void;
     getUpdatedContext(): any;
-    setUpdatedContext(context: any): void;
+    setUpdatedContext(context: any | null): void;
     onChange(): void;
     getStatus(): InternalSearchListenerResponseStatus;
     res: HomeSearchListenerResponse;

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

@@ -1,4 +1,7 @@
 import type OpenFin from '@openfin/core';
+export type withDisconnectListener<T> = T & {
+    addDisconnectionListener: (listener: () => void) => void;
+};
 /**
  * Make a function that connects to a channel.
  * If already connected to the channel, will return the channel connection.
@@ -6,4 +9,4 @@ import type OpenFin from '@openfin/core';
  * @param channelName the name of the channel to connect to.
  * @returns the function to connect to the channel.
  */
-export default function makeGetChannelClient(channelName: string): () => Promise<OpenFin.ChannelClient>;
+export default function makeGetChannelClient(channelName: string): () => Promise<withDisconnectListener<OpenFin.ChannelClient>>;

package/common/src/utils/indicators/browser.d.ts

@@ -1,16 +1,27 @@
+import { IndicatorType } from '../../../../common/src/components/Indicator/Indicator.constants';
 export declare enum BrowserIndicatorIcon {
     Locked = "LockClosedIcon",
     Unlocked = "LockOpen1Icon"
 }
+export interface ShowBrowserIndicatorPayload {
+    type: IndicatorType;
+    message: string;
+    parentBrowserName?: string;
+    icon?: BrowserIndicatorIcon;
+}
+/**
+ * Creates a window containing a visual indicator
+ */
+export declare function showBrowserIndicator(type: IndicatorType, message: string, parentBrowserName?: string, icon?: BrowserIndicatorIcon): Promise<any>;
 /**
  * Creates a window containing an error indicator
  */
-export declare function showBrowserError(message: string, parentBrowserName?: string, icon?: BrowserIndicatorIcon): Promise<void>;
+export declare function showBrowserError(message: string, parentBrowserName?: string, icon?: BrowserIndicatorIcon): Promise<any>;
 /**
  * Creates a window containing a success indicator
  */
-export declare function showBrowserSuccess(message: string, parentBrowserName?: string, icon?: BrowserIndicatorIcon): Promise<void>;
+export declare function showBrowserSuccess(message: string, parentBrowserName?: string, icon?: BrowserIndicatorIcon): Promise<any>;
 /**
  * Creates a window containing an info indicator
  */
-export declare function showBrowserInfo(message: string, parentBrowserName?: string, icon?: BrowserIndicatorIcon): Promise<void>;
+export declare function showBrowserInfo(message: string, parentBrowserName?: string, icon?: BrowserIndicatorIcon): Promise<any>;

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

@@ -0,0 +1,18 @@
+type WorkspacePerformanceMarks = 'home-registration' | 'dock-registration' | 'store-registration';
+/**
+ * @classdesc
+ * WorkspacePerformance is a class that provides a set of methods to measure performance of workspace
+ *
+ */
+declare class WorkspacePerformance {
+    markStart(markName: WorkspacePerformanceMarks): void;
+    markEnd(markName: WorkspacePerformanceMarks): void;
+    markEndAndMeasure(markName: WorkspacePerformanceMarks): void;
+    reportWorkspacePerformanceEntries(): PerformanceEntry[];
+    reportWorkspacePerformance(): {
+        name: string;
+        duration: number;
+    }[];
+}
+declare const workspacePerformance: WorkspacePerformance;
+export default workspacePerformance;