@openfin/core 29.73.3 → 29.73.5

package/OpenFin.d.ts

@@ -105,6 +105,7 @@ declare namespace OpenFin {
 
     type InteropBrokerOptions = {
         contextGroups?: ContextGroupInfo;
+        logging?: InteropLoggingOptions;
     };
 
     export type ContextGroupInfo = {
@@ -529,6 +530,13 @@ declare namespace OpenFin {
         accelerator?: Partial<OpenFin.Accelerator>;
     };
 
+    export type ViewState = ViewCreationOptions & {
+        backgroundThrottling: boolean;
+        componentName: 'view';
+        initialUrl: string;
+        minWidth?: number;
+    };
+
     export type Certificate = {
         data: string;
         fingerprint: string;
@@ -615,9 +623,28 @@ declare namespace OpenFin {
         setFileDownloadLocation: boolean;
     };
 
+    export type LaunchExternalProcessRule = {
+        behavior: 'allow' | 'block';
+        match: string[]; // could be url match or path match
+    };
+
     export type SystemPermissions = {
         getAllExternalWindows: boolean;
-        launchExternalProcess: boolean;
+        launchExternalProcess:
+            | boolean
+            | {
+                  assets: {
+                      enabled: boolean;
+                      srcRules?: LaunchExternalProcessRule[];
+                  };
+                  downloads: {
+                      enabled: boolean;
+                  };
+                  executables: {
+                      enabled: boolean;
+                      pathRules?: LaunchExternalProcessRule[];
+                  };
+              };
         readRegistryValue:
             | boolean
             | {
@@ -728,6 +755,7 @@ declare namespace OpenFin {
             forwardErrorReports?: boolean;
             enableErrorReporting?: boolean;
         };
+        interopBrokerConfiguration: InteropBrokerOptions;
     };
 
     export type LayoutContent = (LayoutItemConfig | LayoutRow | LayoutColumn | LayoutComponent)[];
@@ -815,6 +843,13 @@ declare namespace OpenFin {
          */
         getSnapshot(payload: undefined, identity: OpenFin.Identity): Promise<OpenFin.Snapshot>;
 
+        /**
+         * Gets the current state of a single view and returns an object with the options needed to restore that view as part of a snapshot.
+         * @param { Identity } payload Identity of the view.
+         * @return { Promise<ViewState> }
+         */
+        getViewSnapshot(payload: { viewIdentity: Identity }): Promise<ViewState>;
+
         /**
          * Called when a snapshot is being applied and some windows in that snapshot would be fully or partially off-screen.
          * Returns an array of windows with modified positions, such that any off-screen windows are positioned in the top left
@@ -1145,10 +1180,44 @@ declare namespace OpenFin {
         'working-dir': string;
     };
 
+    export type AppVersionProgress = {
+        manifest: string | null; // A manifest in the fallbackManifest list
+        srcManifest: string; // To keep track of the original manifest url
+    };
+
+    export type AppVersionError = {
+        error: string;
+        srcManifest: string; // To keep track of the original manifest url
+    };
+
+    export type AppVersionRuntimeInfo = {
+        version: string | null; // will be null if a manifest url is not reachable
+        exists: boolean | null;
+        writeAccess: boolean | null;
+        reachable: boolean | null;
+        healthCheck: boolean | null;
+        error: string | null;
+    };
+
+    export type AppVersionProgressEvent = { type: 'app-version-progress' } & AppVersionProgress;
+    export type AppVersionErrorEvent = { type: 'app-version-error' } & AppVersionError;
+    export type AppVersionCompleteEvent = { type: 'app-version-complete' } & AppVersionProgress;
+    export type AppVersionRuntimeStatusEvent = { type: 'runtime-status' } & AppVersionRuntimeInfo;
+
+    export type AppVersionEvents =
+        | AppVersionProgressEvent
+        | AppVersionRuntimeStatusEvent
+        | AppVersionCompleteEvent
+        | AppVersionErrorEvent;
+
+    export type AppVersionEventNames = AppVersionEvents['type'];
+    export type LaunchEmitter = import('./src/api/events/typedEventEmitter').TypedEventEmitter<AppVersionEvents>;
+
     export type RvmLaunchOptions = {
         noUi?: boolean;
         userAppConfigArgs?: object;
         timeToLive?: number;
+        subscribe?: (launch: LaunchEmitter) => void;
     };
 
     export type ShortCutConfig = {
@@ -1254,6 +1323,7 @@ declare namespace OpenFin {
         lifetime?: string;
         certificate?: CertificationInfo;
         uuid?: string;
+        fileUuid?: string;
         initialWindowState?: string;
         cwd?: string;
     };
@@ -1749,4 +1819,12 @@ declare namespace OpenFin {
     export type InteropClientOnDisconnectionListener = (
         InteropBrokerDisconnectionEvent: InteropBrokerDisconnectionEvent
     ) => any;
+
+    export interface InteropActionLoggingOption {
+        enabled: boolean;
+    }
+
+    export type InteropLoggingActions = 'beforeAction' | 'afterAction';
+
+    export type InteropLoggingOptions = Record<InteropLoggingActions, InteropActionLoggingOption>;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@openfin/core",
-    "version": "29.73.3",
+    "version": "29.73.5",
     "license": "Apache-2.0",
     "main": "./src/mock.js",
     "types": "./src/mock.d.ts",