@openfin/core 42.100.80 → 42.100.82

package/out/mock-public.d.ts

@@ -88,6 +88,12 @@ declare type AlertRequestedEvent = BaseEvent_5 & {
     url: string;
 };
 
+declare type AnalyticsOnlyCalls = 'window-get-web-window' | 'layout-get-by-view-identity' | 'layout-get-stack-by-view' | 'layout-add-view' | 'layout-close-view' | 'view-get-parent-layout' | 'view-get-current-stack' | 'window-is-main-window' | 'window-get-parent-application' | 'window-get-parent-window' | 'window-create-window' | 'window-get-layout' | 'window-dispatch-popup-result' | `layout-controller-${string}`;
+
+declare type AnalyticsProtocolMap = {
+    [k in AnalyticsOnlyCalls]: VoidCall;
+};
+
 declare type AnchorType = 'top-left' | 'top-right' | 'bottom-left' | 'bottom-right';
 
 declare type AnyStrategy = ChannelStrategy<any>;
@@ -3253,6 +3259,7 @@ declare type ClipboardApiPermissions = {
     writeRtf: boolean;
     readRtf: boolean;
     write: boolean;
+    setClipboard: boolean;
 };
 
 /**
@@ -5215,6 +5222,19 @@ declare type ExtensionsInstallFailedEvent = ExtensionsEvent & {
     type: 'extensions-install-failed';
 };
 
+/**
+ * these api calls are not implemented in the javscript api, only in the external adapter
+ * If they don't exist in the external adapter they should be removed.
+ */
+declare type ExternalAdapterOnlyCalls = 'subscriber-added' | 'subscriber-removed' | 'clipboard-clear' | 'create-proxy-socket' | 'authenticate-proxy-socket' | 'convert-options' | 'generate-guid' | 'get-config' | 'get-remote-config' | 'get-nearest-display-root' | 'get-preload-scripts' | 'raise-event' | 'set-window-preload-state' | 'dock-window' | 'get-current-window-options' | 'redirect-window-to-url' | 'request-new-content' | 'raise-many-events' | 'show-menu' | 'resolve-proxy' | 'undock-window' | 'window-embedded' | 'window-get-cached-bounds' | 'resource-fetch-authenticate' | 'set-cookie';
+
+declare type ExternalAdapterOnlyCallsMap = {
+    [k in ExternalAdapterOnlyCalls]: {
+        request: any;
+        response: any;
+    };
+};
+
 /**
  * An ExternalApplication object representing native language adapter connections to the runtime. Allows
  * the developer to listen to {@link OpenFin.ExternalApplicationEvents external application events}.
@@ -9487,6 +9507,8 @@ declare namespace OpenFin_2 {
         TabStack,
         _Window as Window,
         _WindowModule,
+        Clipboard_2 as Clipboard,
+        InterApplicationBus,
         InteropClient,
         InteropBroker,
         InteropModule,
@@ -11515,6 +11537,10 @@ declare interface PlatformProvider {
      * @returns A promise resolving to `true` if the window should prevent the app from quitting, otherwise `false`.
      */
     shouldWindowPreventQuit(windowIdentity: OpenFin_2.Identity): Promise<boolean>;
+    /**
+     * Method that is called every time an error occurs when processing an action in the Platform Provider. It is meant to be overriden, as a means to debug Platform applications
+     */
+    onError(action: string, error: Error, callerIdentity: OpenFin_2.Identity): void;
 }
 
 /**
@@ -12081,7 +12107,7 @@ declare type PropagatedWindowEvent<TargetTopic extends string> = PropagatedEvent
  */
 declare type PropagatedWindowEventType = PropagatedEvent_3<string>['type'];
 
-declare interface ProtocolMap extends ProtocolMapBase {
+declare type ProtocolMap = ExternalAdapterOnlyCallsMap & AnalyticsProtocolMap & {
     'is-application-running': ApplicationIdentityCall<{}, boolean>;
     'destroy-application': ApplicationIdentityCall<{
         force: boolean;
@@ -12148,8 +12174,15 @@ declare interface ProtocolMap extends ProtocolMapBase {
             downloadLocation: string;
         };
         response: void;
+        secure: true;
+        namespace: 'Application';
+        apiPath: '.setFileDownloadLocation';
+    };
+    'get-file-download-location': ApplicationIdentityCall<{}, string> & {
+        secure: true;
+        namespace: 'Application';
+        apiPath: '.getFileDownloadLocation';
     };
-    'get-file-download-location': ApplicationIdentityCall<{}, string>;
     'show-tray-icon-popup-menu': {
         request: OpenFin_2.Identity & {
             options: OpenFin_2.ShowTrayIconPopupMenuOptions;
@@ -12189,44 +12222,79 @@ declare interface ProtocolMap extends ProtocolMapBase {
     'clipboard-read-image': {
         request: OpenFin_2.ReadImageClipboardRequest;
         response: string;
+        secure: true;
+        apiPath: '.readImage';
+        namespace: 'Clipboard';
     };
     'clipboard-read-text': {
         request: {
             type?: OpenFin_2.ClipboardSelectionType;
         };
         response: string;
+        secure: true;
+        apiPath: '.readText';
+        namespace: 'Clipboard';
     };
     'clipboard-read-html': {
         request: {
             type?: OpenFin_2.ClipboardSelectionType;
         };
         response: string;
+        secure: true;
+        apiPath: '.readHtml';
+        namespace: 'Clipboard';
     };
     'clipboard-read-rtf': {
         request: {
             type?: OpenFin_2.ClipboardSelectionType;
         };
         response: string;
+        secure: true;
+        apiPath: '.readRtf';
+        namespace: 'Clipboard';
     };
     'clipboard-write-image': {
         request: OpenFin_2.WriteImageClipboardRequest;
         response: void;
+        secure: true;
+        apiPath: '.writeImage';
+        namespace: 'Clipboard';
     };
     'clipboard-write': {
         request: OpenFin_2.WriteAnyRequestType;
         response: void;
+        secure: true;
+        apiPath: '.write';
+        namespace: 'Clipboard';
     };
     'clipboard-write-text': {
         request: OpenFin_2.WriteClipboardRequest;
         response: void;
+        secure: true;
+        apiPath: '.writeText';
+        namespace: 'Clipboard';
+        foo: '';
+    };
+    'set-clipboard': {
+        request: OpenFin_2.WriteClipboardRequest;
+        response: void;
+        secure: true;
+        apiPath: '.setClipboard';
+        namespace: 'Clipboard';
     };
     'clipboard-write-html': {
         request: OpenFin_2.WriteClipboardRequest;
         response: void;
+        secure: true;
+        apiPath: '.writeHtml';
+        namespace: 'Clipboard';
     };
     'clipboard-write-rtf': {
         request: OpenFin_2.WriteClipboardRequest;
         response: void;
+        secure: true;
+        apiPath: '.writeRtf';
+        namespace: 'Clipboard';
     };
     'get-view-window': IdentityCall<{}, OpenFin_2.Identity>;
     'create-view': IdentityCall<OpenFin_2.ViewCreationOptions & {
@@ -12441,6 +12509,10 @@ declare interface ProtocolMap extends ProtocolMapBase {
         request: any;
         response: any;
     };
+    'send-channel-result': {
+        request: any;
+        response: any;
+    };
     'get-version': GetterCall<string>;
     'clear-cache': ApiCall<OpenFin_2.ClearCacheOption, void>;
     'delete-cache-request': VoidCall;
@@ -12490,7 +12562,11 @@ declare interface ProtocolMap extends ProtocolMapBase {
         action: string;
         runtimes: string[];
     }>;
-    'get-installed-apps': GetterCall<OpenFin_2.InstalledApps>;
+    'get-installed-apps': GetterCall<OpenFin_2.InstalledApps> & {
+        secure: true;
+        apiPath: '.getInstalledApps';
+        namespace: 'System';
+    };
     'view-log': ApiCall<OpenFin_2.GetLogRequestType, string>;
     'get-machine-id': GetterCall<string>;
     'get-min-log-level': GetterCall<OpenFin_2.LogLevel>;
@@ -12503,8 +12579,16 @@ declare interface ProtocolMap extends ProtocolMapBase {
     'get-runtime-info': GetterCall<OpenFin_2.RuntimeInfo>;
     'get-rvm-info': GetterCall<OpenFin_2.RVMInfo>;
     'get-host-specs': GetterCall<OpenFin_2.HostSpecs>;
-    'get-os-info': GetterCall<OpenFin_2.OSInfo>;
-    'launch-external-process': ApiCall<OpenFin_2.ExternalProcessRequestType, OpenFin_2.Identity>;
+    'get-os-info': GetterCall<OpenFin_2.OSInfo> & {
+        secure: true;
+        apiPath: '.getOSInfo';
+        namespace: 'System';
+    };
+    'launch-external-process': ApiCall<OpenFin_2.ExternalProcessRequestType, OpenFin_2.Identity> & {
+        secure: true;
+        apiPath: '.launchExternalProcess';
+        namespace: 'System';
+    };
     'monitor-external-process': ApiCall<OpenFin_2.ExternalProcessInfo, OpenFin_2.Identity>;
     'write-to-log': ApiCall<{
         level: string;
@@ -12512,25 +12596,48 @@ declare interface ProtocolMap extends ProtocolMapBase {
     }, void>;
     'open-url-with-browser': ApiCall<{
         url: string;
-    }, void>;
-    'register-custom-protocol': ApiCall<OpenFin_2.CustomProtocolOptions, void>;
+    }, void> & {
+        secure: true;
+        apiPath: '.openUrlWithBrowser';
+        namespace: 'System';
+    };
+    'register-custom-protocol': ApiCall<OpenFin_2.CustomProtocolOptions, void> & {
+        secure: true;
+        apiPath: '.registerCustomProtocol';
+        namespace: 'System';
+    };
     'unregister-custom-protocol': ApiCall<{
         protocolName: string;
-    }, void>;
+    }, void> & {
+        secure: true;
+        apiPath: '.unregisterCustomProtocol';
+        namespace: 'System';
+    };
     'get-custom-protocol-state': ApiCall<{
         protocolName: string;
-    }, OpenFin_2.CustomProtocolState>;
+    }, OpenFin_2.CustomProtocolState> & {
+        secure: true;
+        apiPath: '.getCustomProtocolState';
+        namespace: 'System';
+    };
     'release-external-process': ApiCall<{
         uuid: string;
     }, void>;
     'show-developer-tools': ApiCall<OpenFin_2.Identity, void>;
-    'terminate-external-process': ApiCall<OpenFin_2.TerminateExternalRequestType, void>;
+    'terminate-external-process': ApiCall<OpenFin_2.TerminateExternalRequestType, void> & {
+        secure: true;
+        apiPath: '.terminateExternalProcess';
+        namespace: 'System';
+    };
     'update-proxy': ApiCall<OpenFin_2.ProxyConfig, void>;
     'download-asset': {
         request: OpenFin_2.AppAssetInfo & {
             downloadId: string;
         };
         response: void;
+        secure: true;
+        apiPath: '.downloadAsset';
+        namespace: 'System';
     };
     'download-runtime': {
         request: OpenFin_2.RuntimeDownloadOptions & {
@@ -12559,7 +12666,11 @@ declare interface ProtocolMap extends ProtocolMapBase {
         rootKey: string;
         subkey: string;
         value: string;
-    }, OpenFin_2.RegistryInfo>;
+    }, OpenFin_2.RegistryInfo> & {
+        secure: true;
+        apiPath: '.readRegistryValue';
+        namespace: 'System';
+    };
     'register-external-connection': ApiCall<{
         uuid: string;
     }, OpenFin_2.ExternalConnection>;
@@ -12593,25 +12704,48 @@ declare interface ProtocolMap extends ProtocolMapBase {
             permissions: any;
         };
         response: OpenFin_2.NativeWindowIntegrationProviderAuthorization;
+        secure: true;
+        apiPath: '.enableNativeWindowIntegrationProvider';
+        namespace: 'System';
     };
     'register-usage': ApiCall<OpenFin_2.RegisterUsageData, void>;
     'system-get-printers': GetterCall<OpenFin_2.PrinterInfo[]>;
     'system-update-process-logging-options': ApiCall<{
         options: OpenFin_2.ProcessLoggingOptions;
     }, void>;
-    'get-domain-settings': ApiCall<void, OpenFin_2.DomainSettings>;
+    'get-domain-settings': ApiCall<void, OpenFin_2.DomainSettings> & {
+        secure: true;
+        apiPath: '.getDomainSettings';
+        namespace: 'System';
+    };
     'serve-asset': ApiCall<{
         options: OpenFin_2.ServeAssetOptions;
-    }, OpenFin_2.ServedAssetInfo>;
+    }, OpenFin_2.ServedAssetInfo> & {
+        secure: true;
+        apiPath: '.serveAsset';
+        namespace: 'System';
+    };
     'set-domain-settings': ApiCall<{
         domainSettings: OpenFin_2.DomainSettings;
-    }, void>;
+    }, void> & {
+        secure: true;
+        apiPath: '.setDomainSettings';
+        namespace: 'System';
+    };
     'get-current-domain-settings': ApiCall<{
         identity: OpenFin_2.Identity;
-    }, OpenFin_2.ResolvedDomainSettings>;
+    }, OpenFin_2.ResolvedDomainSettings> & {
+        secure: true;
+        apiPath: '.getCurrentDomainSettings';
+        namespace: 'System';
+    };
     'resolve-domain-settings': ApiCall<{
         url: string;
-    }, OpenFin_2.ResolvedDomainSettings>;
+    }, OpenFin_2.ResolvedDomainSettings> & {
+        secure: true;
+        apiPath: '.resolveDomainSettings';
+        namespace: 'System';
+    };
     'system-register-shutdown-handler': VoidCall;
     'get-permissions': GetterCall<any>;
     'refresh-extensions': {
@@ -12797,15 +12931,27 @@ declare interface ProtocolMap extends ProtocolMapBase {
         };
         response: void;
     };
-}
-
-declare interface ProtocolMapBase {
-    [action: string]: {
-        request: any;
-        response: any;
-        specialResponse?: any;
+    'subscribe-to-desktop-event': {
+        request: {
+            topic: string;
+            type: string;
+            uuid?: string;
+            name?: string;
+            timestamp?: number;
+        };
+        response: void;
     };
-}
+    'unsubscribe-to-desktop-event': {
+        request: {
+            topic: string;
+            type: string;
+            uuid?: string;
+            name?: string;
+            timestamp?: number;
+        };
+        response: void;
+    };
+};
 
 declare type ProtocolOffer = ClassicProtocolOffer | RTCProtocolOffer;
 
@@ -13371,7 +13517,9 @@ declare type SecurityRealmEvent = BaseEvent_9 & {
 
 declare type SendActionResponse<T extends keyof ProtocolMap> = Message<{
     data: ProtocolMap[T]['response'];
-} & ProtocolMap[T]['specialResponse']>;
+} & (ProtocolMap[T] extends {
+    specialResponse: infer U;
+} ? U : {})>;
 
 /**
  * @interface
@@ -15384,7 +15532,6 @@ declare type SystemEventType = EventType_8;
  */
 declare type SystemPermissions = {
     getOSInfo: boolean;
-    getAllExternalWindows: boolean;
     setDomainSettings: boolean;
     getDomainSettings: boolean;
     getCurrentDomainSettings: boolean;
@@ -15424,6 +15571,10 @@ declare type SystemPermissions = {
         enabled: boolean;
         protocols: string[];
     };
+    getInstalledApps: boolean;
+    downloadAsset: boolean;
+    serveAsset: boolean;
+    enableNativeWindowIntegrationProvider: boolean;
 };
 
 /**
@@ -15735,7 +15886,7 @@ declare class Transport<MeType extends EntityType = EntityType> extends EventEmi
     private connectRemote;
     connectByPort(config: ExistingConnectConfig): Promise<void>;
     private authorize;
-    sendAction<T extends keyof ProtocolMap = string>(action: T, payload?: ProtocolMap[T]['request'], uncorrelated?: boolean): SentMessage<SendActionResponse<T>>;
+    sendAction<T extends keyof ProtocolMap>(action: T, payload?: ProtocolMap[T]['request'], uncorrelated?: boolean): SentMessage<SendActionResponse<T>>;
     protected nackHandler(payloadOrMessage: RuntimeErrorPayload | string, reject: Function, callSites?: NodeJS.CallSite[]): void;
     ferryAction(origData: any): Promise<Message<any>>;
     registerMessageHandler(handler: MessageHandler): void;