@openfin/remote-adapter 46.100.85 → 46.100.88

package/out/remote-adapter.js

@@ -2150,6 +2150,10 @@ class BrowserEnvironment extends BaseEnvironment {
     observeBounds(element, onChange) {
         throw new Error('Method not implemented.');
     }
+    onBFCacheRestore(listener) {
+        // Generic browser contexts do not participate in bfcache restoration handling.
+        return () => undefined;
+    }
     layoutAllowedInContext(_fin) {
         return false;
     }
@@ -5062,6 +5066,9 @@ class _Window extends WebContents {
     /**
      * Removes focus from the window.
      *
+     * @remarks On macOS, a modal window (created with `modalParentIdentity`) is hidden instead, because
+     * moving a modal sheet behind its parent would leave the parent unable to show other dialogs.
+     *
      * @example
      * ```js
      * async function blurWindow() {
@@ -7287,6 +7294,15 @@ class Transport extends events.EventEmitter {
         const { uuid, name } = config;
         const entityType = this.environment.getCurrentEntityType();
         this.me = getBaseMe(entityType, uuid, name);
+        // Registered here rather than per-caller so that a restoration is logged exactly once,
+        // however many parts of the adapter go on to subscribe.
+        this.environment.onBFCacheRestore(async () => {
+            await this.sendAction('write-to-log', {
+                level: 'verbose',
+                message: `Page restored from the back/forward cache for ${uuid}/${name}`,
+                target: {}
+            });
+        });
     }
     getFin() {
         if (!__classPrivateFieldGet$k(this, _Transport_fin, "f")) {
@@ -12059,16 +12075,21 @@ class InterApplicationBus extends Base {
      * Subscribes to messages from the specified application on the specified topic.
      * @param source This object is described in the Identity in the typedef
      * @param topic The topic on which the message is sent
-     * @param listener A function that is called when a message has
-     * been received. It is passed the message, uuid and name of the sending application.
+     * @param listener A function that is called when a message has been received. It is passed
+     * two arguments: the message, and the identity (`{ uuid, name }`) of the sender.
      * The message can be either a primitive data type (string, number, or boolean) or
      * composite data type (object, array) that is composed of other primitive or composite
      * data types
      *
+     * @remarks This differs from the legacy `fin.desktop.InterApplicationBus.subscribe` API,
+     * which passes `(message, uuid, name)` as separate arguments.
+     *
      * @example
      * ```js
      * // subscribe to a specified application
-     * fin.InterApplicationBus.subscribe(fin.me, 'topic', sub_msg => console.log(sub_msg)).then(() => console.log('Subscribed to the specified application')).catch(err => console.log(err));
+     * fin.InterApplicationBus.subscribe(fin.me, 'topic', (message, sender) => {
+     *     console.log(`Received from ${sender.uuid}/${sender.name}:`, message);
+     * }).then(() => console.log('Subscribed to the specified application')).catch(err => console.log(err));
      *
      * // subscribe to wildcard
      * fin.InterApplicationBus.subscribe({ uuid: '*' }, 'topic', sub_msg => console.log(sub_msg)).then(() => console.log('Subscribed to *')).catch(err => console.log(err));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openfin/remote-adapter",
-  "version": "46.100.85",
+  "version": "46.100.88",
   "description": "Establish intermachine runtime connections using webRTC.",
   "license": "SEE LICENSE IN LICENSE.md",
   "private": false,
@@ -16,7 +16,7 @@
   "dependencies": {
     "es-toolkit": "^1.39.3",
     "tslib": "2.8.1",
-    "@openfin/core": "46.100.85"
+    "@openfin/core": "46.100.88"
   },
   "scripts": {
     "prebuild": "rimraf ./out",