@openfin/node-adapter 35.79.3 → 35.79.5

package/out/node-adapter-alpha.d.ts

@@ -1192,6 +1192,10 @@ declare type ApplicationOptions = LegacyWinOptionsInAppOptions & {
      * Define the {@link https://developers.openfin.co/of-docs/docs/file-download#manifest-properties-for-file-downloads file download rules} and domain-based api injection rules.
      */
     domainSettings: DomainSettings;
+    /**
+     * The permissions for secured APIs.
+     */
+    permissions?: Partial<Permissions_2>;
     /**
      * @defaultValue false
      *
@@ -3726,6 +3730,10 @@ declare type ConstWindowOptions = {
      * _Platform Windows Only_. Controls behavior for showing views when they are being resized by the user.
      */
     viewVisibility?: ViewVisibilityOptions;
+    /**
+     * Controls whether an option is inherited from the parent application. Use { <option>: false } to disable a specific <option>. All inheritable properties will be inherited by default if omitted."
+     */
+    inheritance?: Partial<InheritableOptions>;
 };
 
 declare interface Container extends EventEmitter_2 {
@@ -4366,6 +4374,32 @@ declare type CreateLayoutOptions = {
     container: HTMLElement;
     layoutName: string;
     layout: LayoutOptions;
+    /**
+     * @defaultValue 'default'
+     *
+     * Controls the View behavior for the given `layout` property. Note
+     * that the selected behavior only applies to unnamed Views or
+     * Views with the prefix `internal-generated-`. In all cases, if any
+     * View in the `layout` does not already exist, it will be created
+     * with a name that starts with `internal-generated-`.
+     *
+     * When set to `reparent`, Views prefixed with `internal-generated-` will
+     * be reparented to the current Window and added to this new Layout.
+     * Use this option when you need to transfer an existing Layout between Windows.
+     *
+     * When set to 'duplicate', Views prefixed with `internal-generated-` will
+     * be duplicated with new generated names. Use this option when you need
+     * to clone a Layout to any Window.
+     *
+     * When set to `default` or omitted, the Layout will attempt to re-use
+     * existing Views only if they are attached to the current Window or
+     * the Provider Window. Set to `default` or omit this option when creating
+     * Layouts as part of implementing the LayoutManager::applyLayoutSnapshot
+     * override. Note that during applyLayoutSnapshot, Views are created and
+     * attached to the Provider while the Window is being created, so it's
+     * important to not 'duplicate' Views in this workflow.
+     */
+    multiInstanceViewBehavior?: MultiInstanceViewBehavior;
 };
 
 /**
@@ -6555,6 +6589,13 @@ declare type InfoForIntentOptions<MetadataType = IntentMetadata_3> = {
     metadata?: MetadataType;
 };
 
+declare type InheritableOptions = {
+    customContext: boolean;
+    customData: boolean;
+    icon: boolean;
+    preloadScripts: boolean;
+};
+
 /**
  * Generated when an application has initialized.
  * @interface
@@ -7458,7 +7499,7 @@ declare type InteropBrokerDisconnectionEvent = {
  * @interface
  */
 declare type InteropBrokerOptions = {
-    contextGroups?: ContextGroupInfo;
+    contextGroups?: ContextGroupInfo[];
     logging?: InteropLoggingOptions;
 };
 
@@ -9268,6 +9309,13 @@ declare type MonitorInfoChangedEvent = BaseEvent_8 & OpenFin.MonitorInfo & {
     type: 'monitor-info-changed';
 };
 
+/**
+ * @experimental
+ *
+ * Used to control view behavior for Layout.create API
+ */
+declare type MultiInstanceViewBehavior = 'reparent' | 'duplicate' | 'default';
+
 /**
  * @interface
  */
@@ -9770,6 +9818,7 @@ declare namespace OpenFin {
         WindowState,
         AutoplayPolicyOptions,
         ConstWindowOptions,
+        InheritableOptions,
         MutableWindowOptions,
         WorkspacePlatformOptions,
         WebRequestHeader,
@@ -9987,6 +10036,7 @@ declare namespace OpenFin {
         LayoutManagerOverride,
         LayoutManager,
         CreateLayoutOptions,
+        MultiInstanceViewBehavior,
         PresetLayoutOptions_2 as PresetLayoutOptions,
         ResultBehavior,
         PopupBaseBehavior,
@@ -11004,10 +11054,6 @@ declare type PlatformOptions = ApplicationCreationOptions & {
      * The provider url.
      */
     providerUrl?: string;
-    /**
-     * The permissions for secured APIs.
-     */
-    permissions?: Partial<Permissions_2>;
 };
 
 /**

package/out/node-adapter-beta.d.ts

@@ -1192,6 +1192,10 @@ declare type ApplicationOptions = LegacyWinOptionsInAppOptions & {
      * Define the {@link https://developers.openfin.co/of-docs/docs/file-download#manifest-properties-for-file-downloads file download rules} and domain-based api injection rules.
      */
     domainSettings: DomainSettings;
+    /**
+     * The permissions for secured APIs.
+     */
+    permissions?: Partial<Permissions_2>;
     /**
      * @defaultValue false
      *
@@ -3726,6 +3730,10 @@ declare type ConstWindowOptions = {
      * _Platform Windows Only_. Controls behavior for showing views when they are being resized by the user.
      */
     viewVisibility?: ViewVisibilityOptions;
+    /**
+     * Controls whether an option is inherited from the parent application. Use { <option>: false } to disable a specific <option>. All inheritable properties will be inherited by default if omitted."
+     */
+    inheritance?: Partial<InheritableOptions>;
 };
 
 declare interface Container extends EventEmitter_2 {
@@ -4366,6 +4374,32 @@ declare type CreateLayoutOptions = {
     container: HTMLElement;
     layoutName: string;
     layout: LayoutOptions;
+    /**
+     * @defaultValue 'default'
+     *
+     * Controls the View behavior for the given `layout` property. Note
+     * that the selected behavior only applies to unnamed Views or
+     * Views with the prefix `internal-generated-`. In all cases, if any
+     * View in the `layout` does not already exist, it will be created
+     * with a name that starts with `internal-generated-`.
+     *
+     * When set to `reparent`, Views prefixed with `internal-generated-` will
+     * be reparented to the current Window and added to this new Layout.
+     * Use this option when you need to transfer an existing Layout between Windows.
+     *
+     * When set to 'duplicate', Views prefixed with `internal-generated-` will
+     * be duplicated with new generated names. Use this option when you need
+     * to clone a Layout to any Window.
+     *
+     * When set to `default` or omitted, the Layout will attempt to re-use
+     * existing Views only if they are attached to the current Window or
+     * the Provider Window. Set to `default` or omit this option when creating
+     * Layouts as part of implementing the LayoutManager::applyLayoutSnapshot
+     * override. Note that during applyLayoutSnapshot, Views are created and
+     * attached to the Provider while the Window is being created, so it's
+     * important to not 'duplicate' Views in this workflow.
+     */
+    multiInstanceViewBehavior?: MultiInstanceViewBehavior;
 };
 
 /**
@@ -6555,6 +6589,13 @@ declare type InfoForIntentOptions<MetadataType = IntentMetadata_3> = {
     metadata?: MetadataType;
 };
 
+declare type InheritableOptions = {
+    customContext: boolean;
+    customData: boolean;
+    icon: boolean;
+    preloadScripts: boolean;
+};
+
 /**
  * Generated when an application has initialized.
  * @interface
@@ -7458,7 +7499,7 @@ declare type InteropBrokerDisconnectionEvent = {
  * @interface
  */
 declare type InteropBrokerOptions = {
-    contextGroups?: ContextGroupInfo;
+    contextGroups?: ContextGroupInfo[];
     logging?: InteropLoggingOptions;
 };
 
@@ -9268,6 +9309,13 @@ declare type MonitorInfoChangedEvent = BaseEvent_8 & OpenFin.MonitorInfo & {
     type: 'monitor-info-changed';
 };
 
+/**
+ * @experimental
+ *
+ * Used to control view behavior for Layout.create API
+ */
+declare type MultiInstanceViewBehavior = 'reparent' | 'duplicate' | 'default';
+
 /**
  * @interface
  */
@@ -9770,6 +9818,7 @@ declare namespace OpenFin {
         WindowState,
         AutoplayPolicyOptions,
         ConstWindowOptions,
+        InheritableOptions,
         MutableWindowOptions,
         WorkspacePlatformOptions,
         WebRequestHeader,
@@ -9987,6 +10036,7 @@ declare namespace OpenFin {
         LayoutManagerOverride,
         LayoutManager,
         CreateLayoutOptions,
+        MultiInstanceViewBehavior,
         PresetLayoutOptions_2 as PresetLayoutOptions,
         ResultBehavior,
         PopupBaseBehavior,
@@ -11004,10 +11054,6 @@ declare type PlatformOptions = ApplicationCreationOptions & {
      * The provider url.
      */
     providerUrl?: string;
-    /**
-     * The permissions for secured APIs.
-     */
-    permissions?: Partial<Permissions_2>;
 };
 
 /**

package/out/node-adapter-public.d.ts

@@ -1192,6 +1192,10 @@ declare type ApplicationOptions = LegacyWinOptionsInAppOptions & {
      * Define the {@link https://developers.openfin.co/of-docs/docs/file-download#manifest-properties-for-file-downloads file download rules} and domain-based api injection rules.
      */
     domainSettings: DomainSettings;
+    /**
+     * The permissions for secured APIs.
+     */
+    permissions?: Partial<Permissions_2>;
     /**
      * @defaultValue false
      *
@@ -3726,6 +3730,10 @@ declare type ConstWindowOptions = {
      * _Platform Windows Only_. Controls behavior for showing views when they are being resized by the user.
      */
     viewVisibility?: ViewVisibilityOptions;
+    /**
+     * Controls whether an option is inherited from the parent application. Use { <option>: false } to disable a specific <option>. All inheritable properties will be inherited by default if omitted."
+     */
+    inheritance?: Partial<InheritableOptions>;
 };
 
 declare interface Container extends EventEmitter_2 {
@@ -4366,6 +4374,32 @@ declare type CreateLayoutOptions = {
     container: HTMLElement;
     layoutName: string;
     layout: LayoutOptions;
+    /**
+     * @defaultValue 'default'
+     *
+     * Controls the View behavior for the given `layout` property. Note
+     * that the selected behavior only applies to unnamed Views or
+     * Views with the prefix `internal-generated-`. In all cases, if any
+     * View in the `layout` does not already exist, it will be created
+     * with a name that starts with `internal-generated-`.
+     *
+     * When set to `reparent`, Views prefixed with `internal-generated-` will
+     * be reparented to the current Window and added to this new Layout.
+     * Use this option when you need to transfer an existing Layout between Windows.
+     *
+     * When set to 'duplicate', Views prefixed with `internal-generated-` will
+     * be duplicated with new generated names. Use this option when you need
+     * to clone a Layout to any Window.
+     *
+     * When set to `default` or omitted, the Layout will attempt to re-use
+     * existing Views only if they are attached to the current Window or
+     * the Provider Window. Set to `default` or omit this option when creating
+     * Layouts as part of implementing the LayoutManager::applyLayoutSnapshot
+     * override. Note that during applyLayoutSnapshot, Views are created and
+     * attached to the Provider while the Window is being created, so it's
+     * important to not 'duplicate' Views in this workflow.
+     */
+    multiInstanceViewBehavior?: MultiInstanceViewBehavior;
 };
 
 /**
@@ -6555,6 +6589,13 @@ declare type InfoForIntentOptions<MetadataType = IntentMetadata_3> = {
     metadata?: MetadataType;
 };
 
+declare type InheritableOptions = {
+    customContext: boolean;
+    customData: boolean;
+    icon: boolean;
+    preloadScripts: boolean;
+};
+
 /**
  * Generated when an application has initialized.
  * @interface
@@ -7458,7 +7499,7 @@ declare type InteropBrokerDisconnectionEvent = {
  * @interface
  */
 declare type InteropBrokerOptions = {
-    contextGroups?: ContextGroupInfo;
+    contextGroups?: ContextGroupInfo[];
     logging?: InteropLoggingOptions;
 };
 
@@ -9268,6 +9309,13 @@ declare type MonitorInfoChangedEvent = BaseEvent_8 & OpenFin.MonitorInfo & {
     type: 'monitor-info-changed';
 };
 
+/**
+ * @experimental
+ *
+ * Used to control view behavior for Layout.create API
+ */
+declare type MultiInstanceViewBehavior = 'reparent' | 'duplicate' | 'default';
+
 /**
  * @interface
  */
@@ -9770,6 +9818,7 @@ declare namespace OpenFin {
         WindowState,
         AutoplayPolicyOptions,
         ConstWindowOptions,
+        InheritableOptions,
         MutableWindowOptions,
         WorkspacePlatformOptions,
         WebRequestHeader,
@@ -9987,6 +10036,7 @@ declare namespace OpenFin {
         LayoutManagerOverride,
         LayoutManager,
         CreateLayoutOptions,
+        MultiInstanceViewBehavior,
         PresetLayoutOptions_2 as PresetLayoutOptions,
         ResultBehavior,
         PopupBaseBehavior,
@@ -11004,10 +11054,6 @@ declare type PlatformOptions = ApplicationCreationOptions & {
      * The provider url.
      */
     providerUrl?: string;
-    /**
-     * The permissions for secured APIs.
-     */
-    permissions?: Partial<Permissions_2>;
 };
 
 /**

package/out/node-adapter.d.ts

@@ -1198,6 +1198,10 @@ declare type ApplicationOptions = LegacyWinOptionsInAppOptions & {
      * Define the {@link https://developers.openfin.co/of-docs/docs/file-download#manifest-properties-for-file-downloads file download rules} and domain-based api injection rules.
      */
     domainSettings: DomainSettings;
+    /**
+     * The permissions for secured APIs.
+     */
+    permissions?: Partial<Permissions_2>;
     /**
      * @defaultValue false
      *
@@ -3769,6 +3773,10 @@ declare type ConstWindowOptions = {
      * _Platform Windows Only_. Controls behavior for showing views when they are being resized by the user.
      */
     viewVisibility?: ViewVisibilityOptions;
+    /**
+     * Controls whether an option is inherited from the parent application. Use { <option>: false } to disable a specific <option>. All inheritable properties will be inherited by default if omitted."
+     */
+    inheritance?: Partial<InheritableOptions>;
 };
 
 declare interface Container extends EventEmitter_2 {
@@ -4409,6 +4417,32 @@ declare type CreateLayoutOptions = {
     container: HTMLElement;
     layoutName: string;
     layout: LayoutOptions;
+    /**
+     * @defaultValue 'default'
+     *
+     * Controls the View behavior for the given `layout` property. Note
+     * that the selected behavior only applies to unnamed Views or
+     * Views with the prefix `internal-generated-`. In all cases, if any
+     * View in the `layout` does not already exist, it will be created
+     * with a name that starts with `internal-generated-`.
+     *
+     * When set to `reparent`, Views prefixed with `internal-generated-` will
+     * be reparented to the current Window and added to this new Layout.
+     * Use this option when you need to transfer an existing Layout between Windows.
+     *
+     * When set to 'duplicate', Views prefixed with `internal-generated-` will
+     * be duplicated with new generated names. Use this option when you need
+     * to clone a Layout to any Window.
+     *
+     * When set to `default` or omitted, the Layout will attempt to re-use
+     * existing Views only if they are attached to the current Window or
+     * the Provider Window. Set to `default` or omit this option when creating
+     * Layouts as part of implementing the LayoutManager::applyLayoutSnapshot
+     * override. Note that during applyLayoutSnapshot, Views are created and
+     * attached to the Provider while the Window is being created, so it's
+     * important to not 'duplicate' Views in this workflow.
+     */
+    multiInstanceViewBehavior?: MultiInstanceViewBehavior;
 };
 
 /**
@@ -6655,6 +6689,13 @@ declare type InfoForIntentOptions<MetadataType = IntentMetadata_3> = {
     metadata?: MetadataType;
 };
 
+declare type InheritableOptions = {
+    customContext: boolean;
+    customData: boolean;
+    icon: boolean;
+    preloadScripts: boolean;
+};
+
 /**
  * Generated when an application has initialized.
  * @interface
@@ -7573,7 +7614,7 @@ declare type InteropBrokerDisconnectionEvent = {
  * @interface
  */
 declare type InteropBrokerOptions = {
-    contextGroups?: ContextGroupInfo;
+    contextGroups?: ContextGroupInfo[];
     logging?: InteropLoggingOptions;
 };
 
@@ -9567,6 +9608,13 @@ declare type MonitorInfoChangedEvent = BaseEvent_8 & OpenFin.MonitorInfo & {
     type: 'monitor-info-changed';
 };
 
+/**
+ * @experimental
+ *
+ * Used to control view behavior for Layout.create API
+ */
+declare type MultiInstanceViewBehavior = 'reparent' | 'duplicate' | 'default';
+
 /**
  * @interface
  */
@@ -10091,6 +10139,7 @@ declare namespace OpenFin {
         WindowState,
         AutoplayPolicyOptions,
         ConstWindowOptions,
+        InheritableOptions,
         MutableWindowOptions,
         WorkspacePlatformOptions,
         WebRequestHeader,
@@ -10308,6 +10357,7 @@ declare namespace OpenFin {
         LayoutManagerOverride,
         LayoutManager,
         CreateLayoutOptions,
+        MultiInstanceViewBehavior,
         PresetLayoutOptions_2 as PresetLayoutOptions,
         ResultBehavior,
         PopupBaseBehavior,
@@ -11358,10 +11408,6 @@ declare type PlatformOptions = ApplicationCreationOptions & {
      * The provider url.
      */
     providerUrl?: string;
-    /**
-     * The permissions for secured APIs.
-     */
-    permissions?: Partial<Permissions_2>;
 };
 
 /**

package/out/node-adapter.js

@@ -37,7 +37,7 @@ function getDefaultExportFromCjs (x) {
 
 var main$1 = {};
 
-var fin = {};
+var fin$1 = {};
 
 var system$1 = {};
 
@@ -11660,7 +11660,7 @@ var __classPrivateFieldSet$4 = (commonjsGlobal && commonjsGlobal.__classPrivateF
     if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
     return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
 };
-var _LayoutModule_instances, _LayoutModule_layoutInitializationAttempted, _LayoutModule_layoutManager, _LayoutModule_getSafeLayoutManager;
+var _LayoutModule_instances, _LayoutModule_layoutInitializationAttempted, _LayoutModule_layoutManager, _LayoutModule_getLayoutManagerSpy, _LayoutModule_getSafeLayoutManager;
 Object.defineProperty(Factory$2, "__esModule", { value: true });
 Factory$2.LayoutModule = void 0;
 const base_1$5 = base$1;
@@ -11732,10 +11732,31 @@ class LayoutModule extends base_1$5.Base {
                 // in single-layout case, we return the undocumented layoutManager type (deprecate with CORE-1081)
                 const layoutIdentity = { layoutName: layout_constants_1.DEFAULT_LAYOUT_KEY, ...this.fin.me.identity };
                 const layoutManager = await this.wire.environment.resolveLayout(__classPrivateFieldGet$4(this, _LayoutModule_layoutManager, "f"), layoutIdentity);
-                return Object.assign(this.wrapSync(layoutIdentity), { layoutManager });
+                return __classPrivateFieldGet$4(this, _LayoutModule_getLayoutManagerSpy, "f").call(this, layoutIdentity, layoutManager);
             }
             return this.wrapSync(this.fin.me.identity);
         };
+        _LayoutModule_getLayoutManagerSpy.set(this, (layoutIdentity, layoutManager) => {
+            const msg = '[Layout] You are using a deprecated property `layoutManager` - it will throw if you access it starting in v37.';
+            const managerProxy = new Proxy(layoutManager, {
+                get(target, key) {
+                    console.warn(`[Layout-mgr-proxy] accessing ${key.toString()}`);
+                    console.warn(msg);
+                    return target[key];
+                }
+            });
+            const layout = Object.assign(this.wrapSync(layoutIdentity), { layoutManager: managerProxy });
+            const layoutProxy = new Proxy(layout, {
+                get(target, key) {
+                    if (key === 'layoutManager') {
+                        console.warn(`[Layout-proxy] accessing ${key.toString()}`);
+                        console.warn(msg);
+                    }
+                    return target[key];
+                }
+            });
+            return layoutProxy;
+        });
         /**
          * Returns the layout manager for the current window
          * @returns
@@ -11845,7 +11866,7 @@ class LayoutModule extends base_1$5.Base {
     }
 }
 Factory$2.LayoutModule = LayoutModule;
-_LayoutModule_layoutInitializationAttempted = new WeakMap(), _LayoutModule_layoutManager = new WeakMap(), _LayoutModule_instances = new WeakSet(), _LayoutModule_getSafeLayoutManager = function _LayoutModule_getSafeLayoutManager(method) {
+_LayoutModule_layoutInitializationAttempted = new WeakMap(), _LayoutModule_layoutManager = new WeakMap(), _LayoutModule_getLayoutManagerSpy = new WeakMap(), _LayoutModule_instances = new WeakSet(), _LayoutModule_getSafeLayoutManager = function _LayoutModule_getSafeLayoutManager(method) {
     if (!__classPrivateFieldGet$4(this, _LayoutModule_layoutManager, "f")) {
         throw new Error(`You must call init before using the API ${method}`);
     }
@@ -11959,6 +11980,9 @@ class PlatformModule extends base_1$4.Base {
      * @experimental
      */
     async init(options) {
+        if (!fin.__internal_.isPlatform || fin.me.name !== fin.me.uuid) {
+            throw new Error('fin.Platform.init should only be called from a custom platform provider running in the main window of the application.');
+        }
         return this.wire.environment.initPlatform(this.fin, options);
     }
     /**
@@ -15233,8 +15257,8 @@ Factory.SnapshotSourceModule = SnapshotSourceModule;
 	__exportStar(Instance, exports); 
 } (snapshotSource));
 
-Object.defineProperty(fin, "__esModule", { value: true });
-fin.Fin = void 0;
+Object.defineProperty(fin$1, "__esModule", { value: true });
+fin$1.Fin = void 0;
 const events_1$3 = require$$0;
 // Import from the file rather than the directory in case someone consuming types is using module resolution other than "node"
 const index_1 = system$1;
@@ -15280,7 +15304,7 @@ class Fin extends events_1$3.EventEmitter {
         });
     }
 }
-fin.Fin = Fin;
+fin$1.Fin = Fin;
 
 var wire = {};
 
@@ -16625,7 +16649,7 @@ function requireMain () {
 	(function (exports) {
 		Object.defineProperty(exports, "__esModule", { value: true });
 		exports.ChannelProvider = exports.ChannelClient = exports.Frame = exports.View = exports.System = exports.Window = exports.Application = exports.Fin = exports.launch = exports.connect = void 0;
-		const fin_1 = fin;
+		const fin_1 = fin$1;
 		Object.defineProperty(exports, "Fin", { enumerable: true, get: function () { return fin_1.Fin; } });
 		const index_1 = requireApplication();
 		Object.defineProperty(exports, "Application", { enumerable: true, get: function () { return index_1.Application; } });

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@openfin/node-adapter",
-    "version": "35.79.3",
+    "version": "35.79.5",
     "description": "See README.md",
     "main": "out/node-adapter.js",
     "types": "out/node-adapter.d.ts",