@openfin/workspace 14.1.2 → 14.1.3

package/README.md

@@ -4,8 +4,8 @@ The Workspace Client APIs enable custom integrations with OpenFin Workspace.
 
 ## Prerequisites
 
--   [Node.js](https://nodejs.org/en/) v16.0.0 or higher
--   [npm](https://www.npmjs.com/)
+- [Node.js](https://nodejs.org/en/) v16.0.0 or higher
+- [npm](https://www.npmjs.com/)
 
 ## Install
 
@@ -27,8 +27,8 @@ Prior to using Workspace, a Workspace Platform must be initialized.
 
 ### Home API
 
--   [Overview](https://developers.openfin.co/of-docs/docs/cli-providers)
--   [API Reference](https://developer.openfin.co/workspace/docs/api/latest/modules/home.html)
+- [Overview](https://developers.openfin.co/of-docs/docs/cli-providers)
+- [API Reference](https://developer.openfin.co/workspace/docs/api/latest/modules/home.html)
 
 ```ts
 import Home, CLIProvider from '@openfin/workspace';
@@ -64,8 +64,8 @@ searchButton.addEventListener('click', () => {
 
 ### Storefront API
 
--   [Overview](https://developers.openfin.co/of-docs/docs/provide-storefront-content)
--   [API Reference](https://developer.openfin.co/workspace/docs/api/latest/modules/store.html)
+- [Overview](https://developers.openfin.co/of-docs/docs/provide-storefront-content)
+- [API Reference](https://developer.openfin.co/workspace/docs/api/latest/modules/store.html)
 
 ```ts
 import { Storefront, StorefrontProvider } from "@openfin/workspace";
@@ -97,8 +97,8 @@ await Storefront.show();
 
 ### Dock API
 
--   [Overview](https://developers.openfin.co/of-docs/docs/dock-overview)
--   [API Reference](https://developer.openfin.co/workspace/docs/api/latest/modules/dock.html)
+- [Overview](https://developers.openfin.co/of-docs/docs/dock-overview)
+- [API Reference](https://developer.openfin.co/workspace/docs/api/latest/modules/dock.html)
 
 ```ts
 const provider: DockProvider = {
@@ -154,7 +154,7 @@ await Dock.show();
 
 ## For more information
 
--   [Developer guide](https://developers.openfin.co/of-docs/docs/overview-of-workspace).
--   [API reference](https://developer.openfin.co/workspace/docs/api/latest/index.html).
--   See the [workspace-starter](https://github.com/built-on-openfin/workspace-starter) project for example code.
--   See the [versions page](https://developer.openfin.co/versions/#/?product=Workspace) for a list of all available versions.
+- [Developer guide](https://developers.openfin.co/of-docs/docs/overview-of-workspace).
+- [API reference](https://developer.openfin.co/workspace/docs/api/latest/index.html).
+- See the [workspace-starter](https://github.com/built-on-openfin/workspace-starter) project for example code.
+- See the [versions page](https://developer.openfin.co/versions/#/?product=Workspace) for a list of all available versions.

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

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

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

@@ -1,12 +1,12 @@
-import * as Notifications from 'openfin-notifications/dist/client/without-auto-launch';
-import type { NotificationsPlatform, NotificationsRegisterOptions } from './shapes/notifications';
-export * from 'openfin-notifications/dist/client/without-auto-launch';
+import type { NotificationsPlatform, NotificationsRegistration } from './shapes/notifications';
+export * from 'openfin-notifications';
 export * from './shapes/notifications';
 /**
- * @deprecated
+ * Registers notifications platform. Throws if workspace platform is not initialized or if you run version of notifications-service which doesn't support platforms.
+ *
+ * @param platform {@link NotificationsPlatform} object
  */
-export declare function register(platform?: NotificationsPlatform): Promise<Notifications.NotificationsRegistration>;
-export declare function register(platform?: NotificationsRegisterOptions): Promise<Notifications.NotificationsRegistration>;
+export declare const register: (platform: NotificationsPlatform) => Promise<NotificationsRegistration>;
 /**
  * Deregisters notifications platform. Throws if you run version of notifications-service which doesn't support platforms.
  * @param platformId id of the platform to deregister

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

@@ -1,6 +1,7 @@
 /**
  * This module exports only notifications types that are not defined in 'openfin-notifications' npm package
  */
+import type { NotificationPlatform as NotificationsPlatformInternal } from 'openfin-notifications';
 /**
  * Platform object to pass to `register` function.
  *
@@ -16,24 +17,11 @@
  * await register(platform);
  * ```
  */
-export interface NotificationsPlatform {
-    /**
-     * Unique identifier of the platform.
-     */
-    id: string;
-    /**
-     * Stream title.
-     *
-     * Providing a different displayName for an existing stream id will update the
-     * displayName of the stream stored in Notification Center.
-     *
-     */
-    title: string;
-    /**
-     * URL of the icon to be displayed for this platform.
-     */
-    icon: string;
-}
-export interface NotificationsRegisterOptions {
-    notificationsPlatformOptions?: NotificationsPlatform;
-}
+export type NotificationsPlatform = Omit<NotificationsPlatformInternal, 'theme'>;
+/**
+ * Registration meta info returned by {@link register}
+ */
+export type NotificationsRegistration = {
+    clientAPIVersion: string;
+    notificationsVersion: string;
+};

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

@@ -1,8 +1,6 @@
 export interface ProviderInfo {
     /**
      * Unique identifier for the provider.
-     *
-     * @remarks A non-zero length string.
      */
     id: string;
     /**

package/client-api-platform/src/api/browser/index.d.ts

@@ -1,6 +1,6 @@
 import type OpenFin from '@openfin/core';
 import type { AttachedPage } from '../../../../common/src/api/pages/shapes';
-import { type BrowserCreateWindowRequest, type BrowserWindowModule } from '../../shapes';
+import type { BrowserCreateWindowRequest, BrowserWindowModule } from '../../shapes';
 export declare const getBrowserApi: (identity: OpenFin.ApplicationIdentity) => {
     wrapSync: (windowIdentity: OpenFin.Identity) => BrowserWindowModule;
     createWindow: (options: BrowserCreateWindowRequest) => Promise<BrowserWindowModule>;

package/client-api-platform/src/api/context-menu/utils.d.ts

@@ -14,7 +14,6 @@ export declare const savePageHandler: (identity: OpenFin.Identity, pageId?: stri
 export declare const savePageAsHandler: (identity: OpenFin.Identity, pageId?: string) => Promise<void>;
 export declare const switchWorkspaceHandler: (winIdentity: OpenFin.Identity, workspaceItemData: WorkspaceContextMenuItemData) => Promise<void>;
 export declare const deleteWorkspaceHandler: (winIdentity: OpenFin.Identity, workspaceItemData: WorkspaceContextMenuItemData) => Promise<void>;
-export declare const downloadsHandler: (identity: OpenFin.Identity) => Promise<void>;
 /**
  * @param viewIdentities Array of views to execute print on.
  */

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

@@ -1,6 +1,6 @@
 import type OpenFin from '@openfin/core';
 import type { CustomThemeOptions, CustomThemeOptionsWithScheme } from '../../../common/src/api/theming';
-import { BrowserInitConfig } from '../../../client-api-platform/src/shapes';
+import type { BrowserInitConfig } from '..';
 /**
  * Applies default options to the creation of browser windows.
  */

package/client-api-platform/src/init/override-callback.d.ts

@@ -1,3 +1,4 @@
 import type OpenFin from '@openfin/core';
-import { BrowserInitConfig, WorkspacePlatformOverrideCallback, WorkspacePlatformProvider } from '../../../client-api-platform/src/shapes';
+import type { BrowserInitConfig } from '../../../client-api-platform/src/shapes';
+import { WorkspacePlatformOverrideCallback, WorkspacePlatformProvider } from '..';
 export declare const getOverrideCallback: (browserInitOptions: BrowserInitConfig | null, overrideCallback?: WorkspacePlatformOverrideCallback) => OpenFin.OverrideCallback<WorkspacePlatformProvider>;

package/client-api-platform/src/init/utils.d.ts

@@ -29,12 +29,12 @@ type LegacyWindowOptions = Omit<OpenFin.PlatformWindowCreationOptions, 'workspac
 export declare const initWorkspacePlatformOptions: (options: LegacyWindowOptions | OpenFin.PlatformWindowCreationOptions) => OpenFin.PlatformWindowCreationOptions;
 export type WindowType = 'browser' | 'platform' | 'classic' | 'mixed';
 /**
- * checkHasBrowserWindows
- * Determines whether the snapshot has browser windows.
+ * checkSnapshotWindowTypes
+ * Determines what type of windows are contained within a snapshot.
  *
  * @param snapshot - The snapshot to check.
  *
- * @returns - Whether the snapshot has browser windows.
+ * @returns - The type of windows contained within the snapshot.
  */
-export declare function checkHasBrowserWindows(snapshot: BrowserSnapshot): boolean;
+export declare function checkSnapshotWindowTypes(snapshot: BrowserSnapshot): WindowType | null;
 export {};

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

@@ -72,7 +72,6 @@ export declare enum GlobalContextMenuOptionType {
     RenameWorkspace = "RenameWorkspace",
     SwitchWorkspace = "SwitchWorkspace",
     DeleteWorkspace = "DeleteWorkspace",
-    Downloads = "Downloads",
     OpenStorefront = "OpenStorefront",
     Appearance = "Appearance",
     Quit = "Quit",
@@ -450,75 +449,59 @@ export interface OpenSaveContextMenuOptionActionPayload {
     /** Id of the page on which the context menu is invoked */
     pageId: string;
 }
-export declare enum WindowType {
-    Browser = "browser",
-    Platform = "platform"
-}
-export interface BrowserWorkspacePlatformWindowOptions {
-    /** For internal usage.  Defaults to 'browser' when Browser is enabled when the WorkspacePlatform is initialized.  In order to use
-     * non-Browser layout windows ('platform' windows) in a Browser-enabled workspace platform, set windowType to `platform`. In that instance, the other properties
-     * in the workspacePlatform object are not relevant.
-     * */
-    windowType?: WindowType;
-    /** The initial set of pages to add to the created browser window. */
-    pages: Page[];
-    /** The favicon to display on the top left of the created browser window. */
-    favicon?: string;
-    /** A UI friendly title for the created browser window. */
-    title?: string;
-    /**
-     * Landing page that shows up when you add a new tab from the plus button that exists in the tabstrip.
-     * If you do not provide a newTabUrl, then the plus button in the tabstrip will not be shown and users cannot create a new empty tab.
-     */
-    newTabUrl?: string;
-    /**
-     * Landing page that shows up when you add a new page from the plus button that exists in the window frame where the page selector is shown.
-     * If you do not provide a newPageUrl, then the new Page plus button will not be shown and you cannot create a new empty Page or Window.
-     */
-    newPageUrl?: string;
-    toolbarOptions?: ToolbarOptions;
-    windowStateButtonOptions?: WindowStateButtonOptions;
-    /**
-     * Remove the Page UI and only allow a single page in the browser window.
-     * Must be set to true for this behavior.  If this is not set to false,
-     * then an empty `pages` option will be populated with a single page.
-     */
-    disableMultiplePages?: boolean;
-    /**
-     * When true, disables the ability to drag pages into the window. False by default.
-     */
-    preventPageDragIn?: boolean;
-    /**
-     * When true, disables the ability to close pages, drag pages within the window,
-     * and drag pages into/out of the window. False by default.
-     */
-    isLocked?: boolean;
-    /**
-     * When true, disables the ability to drag pages out of a window. False by default.
-     */
-    preventPageDragOut?: boolean;
-    /**
-     * When true, page tabs in the window will not be draggable.
-     * This includes reordering pages and dragging them out of the window.
-     * False by default.
-     */
-    preventPageDrag?: boolean;
-    /**
-     * When true, disables the ability to close pages in the window. False by default.
-     */
-    preventPageClose?: boolean;
-}
 /**
  * Request for creating a browser window.
  */
 export interface BrowserCreateWindowRequest extends Omit<OpenFin.PlatformWindowCreationOptions, 'workspacePlatform'> {
     /** WorkspacePlatform specific window options. These options will not work unless a workspace platform has been initialized. */
-    workspacePlatform: BrowserWorkspacePlatformWindowOptions | {
-        /** For internal usage.  Defaults to 'browser' when Browser is enabled when the WorkspacePlatform is initialized.  In order to use
-         * non-Browser layout windows ('platform' windows) in a Browser-enabled workspace platform, set windowType to `platform`. In that instance, the other properties
-         * in the workspacePlatform object are not relevant.
-         * */
-        windowType: WindowType.Platform;
+    workspacePlatform: {
+        /** The initial set of pages to add to the created browser window. */
+        pages: Page[];
+        /** The favicon to display on the top left of the created browser window. */
+        favicon?: string;
+        /** A UI friendly title for the created browser window. */
+        title?: string;
+        /**
+         * Landing page that shows up when you add a new tab from the plus button that exists in the tabstrip.
+         * If you do not provide a newTabUrl, then the plus button in the tabstrip will not be shown and users cannot create a new empty tab.
+         */
+        newTabUrl?: string;
+        /**
+         * Landing page that shows up when you add a new page from the plus button that exists in the window frame where the page selector is shown.
+         * If you do not provide a newPageUrl, then the new Page plus button will not be shown and you cannot create a new empty Page or Window.
+         */
+        newPageUrl?: string;
+        toolbarOptions?: ToolbarOptions;
+        windowStateButtonOptions?: WindowStateButtonOptions;
+        /**
+         * Remove the Page UI and only allow a single page in the browser window.
+         * Must be set to true for this behavior.  If this is not set to false,
+         * then an empty `pages` option will be populated with a single page.
+         */
+        disableMultiplePages?: boolean;
+        /**
+         * When true, disables the ability to drag pages into the window. False by default.
+         */
+        preventPageDragIn?: boolean;
+        /**
+         * When true, disables the ability to close pages, drag pages within the window,
+         * and drag pages into/out of the window. False by default.
+         */
+        isLocked?: boolean;
+        /**
+         * When true, disables the ability to drag pages out of a window. False by default.
+         */
+        preventPageDragOut?: boolean;
+        /**
+         * When true, page tabs in the window will not be draggable.
+         * This includes reordering pages and dragging them out of the window.
+         * False by default.
+         */
+        preventPageDrag?: boolean;
+        /**
+         * When true, disables the ability to close pages in the window. False by default.
+         */
+        preventPageClose?: boolean;
     };
 }
 /**
@@ -1487,28 +1470,9 @@ export type ApplyWorkspacePayload = Workspace & {
 export interface CustomActionsMap {
     [actionId: string]: (payload: CustomActionPayload) => any;
 }
-/**
- * Configuration object of the Workspace Platform's Analytics Config.
- */
 export interface AnalyticsConfig {
     /**
      * Enable sending of Analytics data to OpenFin
-     *
-     * @default false
-     *
-     * @remarks OpenFin workspace utilizes a [HTML iframe](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/iframe) in order to send analytics data to OpenFin. In order to facilitate this, and allow for the use of `fin` APIs within the iframe, you must enable injection of the OpenFin API into cross-origin iframes. This can be configured within the [manifest](https://developers.openfin.co/of-docs/docs/application-configuration) like so:
-     * ```json
-     * {
-     *     "platform": {
-     *         "api": {
-     *             "iframe": {
-     *                 "crossOriginInjection": true
-     *             }
-     *         },
-     *         // The rest of the manifest configuration is omitted for brevity
-     *     }
-     * }
-     * ```
      */
     sendToOpenFin: boolean;
 }
@@ -1525,8 +1489,6 @@ 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.
      *
@@ -1752,8 +1714,7 @@ export type BrowserOverrideCallback = WorkspacePlatformOverrideCallback;
  */
 export interface BrowserInitConfig {
     /**
-     * Default options for creating a new Browser window. These options are not applied on any non-Browser windows that get created.  These default options will take precedence over
-     * defaultWindowOptions included in the manifest.  Any option not included in WorkspacePlatform.getCurrentSync().Browser.createWindow(options) call will default to the value provided in this field.
+     * Default options for creating a new browser window. Any option not included in WorkspacePlatform.getCurrentSync().Browser.createWindow(options) call will default to the value provided in this field.
      */
     defaultWindowOptions?: Partial<BrowserCreateWindowRequest>;
     /** Default options when creating a new page. If `iconUrl`, `unsavedIconUrl`, `panels` or `closeButton` are not defined when creating a page, setting will default to `defaultPageOptions`. */

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

@@ -14,7 +14,6 @@ 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,8 +29,7 @@ declare enum GeneralBrowserChannelActions {
     RemoveFromChannel = "remove-from-channel",
     OpenSaveModalInternal = "open-save-modal-internal",
     DuplicatePage = "duplicate-page",
-    SetSelectedScheme = "set-selected-scheme",
-    ShowBrowserIndicator = "show-browser-indicator"
+    SetSelectedScheme = "set-selected-scheme"
 }
 /**
  * All of the remote procedures that can be called in the
@@ -69,7 +68,6 @@ 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/search/common.d.ts

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

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

@@ -1,5 +1,5 @@
-import { HomeProviderInternal } from '../../../../common/src/api/provider';
 import { DispatchedSearchResult, HomeSearchListenerRequest, HomeSearchResult } from '../../../../client-api/src/shapes';
+import { HomeProviderInternal } from '../../../../common/src/api/provider';
 /**
  * The ids of home providers that are built into Home.
  */

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

@@ -1,27 +1,16 @@
-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<any>;
+export declare function showBrowserError(message: string, parentBrowserName?: string, icon?: BrowserIndicatorIcon): Promise<void>;
 /**
  * Creates a window containing a success indicator
  */
-export declare function showBrowserSuccess(message: string, parentBrowserName?: string, icon?: BrowserIndicatorIcon): Promise<any>;
+export declare function showBrowserSuccess(message: string, parentBrowserName?: string, icon?: BrowserIndicatorIcon): Promise<void>;
 /**
  * Creates a window containing an info indicator
  */
-export declare function showBrowserInfo(message: string, parentBrowserName?: string, icon?: BrowserIndicatorIcon): Promise<any>;
+export declare function showBrowserInfo(message: string, parentBrowserName?: string, icon?: BrowserIndicatorIcon): Promise<void>;