@openfin/node-adapter 35.78.27 → 35.79.1

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

@@ -97,9 +97,9 @@ declare type Api = {
         enableDeprecatedSharedName?: boolean;
     };
     /**
-     *  Prevent fin API injection. If true `fin` won't be available in this context.
+     *  Prevent fin API injection. If 'none', `fin` won't be available in this context.
      */
-    preventInjection?: boolean;
+    fin?: InjectionType;
 };
 
 declare type ApiCall<Request, Response> = {
@@ -111,6 +111,13 @@ declare type ApiClient<T extends Record<any, any>> = {
     [key in keyof PickOfType<T, Function>]: (...args: Parameters<T[key]>) => ReturnType<T[key]> extends Promise<any> ? ReturnType<T[key]> : Promise<ReturnType<T[key]>>;
 };
 
+/**
+ * @interface
+ */
+declare type ApiInjection = {
+    fin: InjectionType;
+};
+
 /**
  * Generated when a new Platform's API becomes responsive.
  * @interface
@@ -1178,10 +1185,13 @@ declare type ApplicationOptions = LegacyWinOptionsInAppOptions & {
      */
     apiDiagnostics: boolean;
     /**
-     * Define the file download rules.
-     * See [here](https://developers.openfin.co/of-docs/docs/file-download#manifest-properties-for-file-downloads) for more details.
+     * @deprecated Please use {@link domainSettings} instead
      */
     defaultDomainSettings: DefaultDomainSettings;
+    /**
+     * 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;
     /**
      * @defaultValue false
      *
@@ -3480,9 +3490,13 @@ declare type ConstViewOptions = {
     /**
      * Controls interaction of the view with its parent window's download shelf.
      */
-    downloadShelf?: {
+    downloadShelf: {
         /**
-         * Whether downloads in this view trigger opening the download shelf on its parent BrowserWindow
+         * Whether downloads in this view trigger opening the download shelf on its parent BrowserWindow.
+         *
+         * @remarks If `enabled: true`, downloads from this view will cause the download shelf to display
+         * on the parent window even if that parent window's {@link DownloadShelfOptions} specify
+         * `enabled: false`.
          */
         enabled: boolean;
     };
@@ -3598,6 +3612,12 @@ declare type ConstWindowOptions = {
      * launches in favor of the cached value.
      */
     defaultWidth: number;
+    /**
+     * Controls the styling and behavior of the window download shelf.
+     *
+     * @remarks This will control the styling for the download shelf regardless of whether its display was
+     * triggered by the window itself, or a view targeting the window.
+     */
     downloadShelf: DownloadShelfOptions;
     height: number;
     layout: any;
@@ -4435,21 +4455,15 @@ declare type CustomRequestHeaders = {
 declare type DataChannelReadyState = RTCDataChannel['readyState'];
 
 /**
+ * @deprecated Use {@link OpenFin.DomainSettings} instead.
  * @interface
  */
-declare type DefaultDomainSettings = {
-    rules: DefaultDomainSettingsRule[];
-};
+declare type DefaultDomainSettings = DomainSettings;
 
 /**
- * @interface
+ * @deprecated Use {@link OpenFin.DomainSettingsRule} instead.
  */
-declare type DefaultDomainSettingsRule = {
-    match: string[];
-    options: {
-        downloadSettings: FileDownloadSettings;
-    };
-};
+declare type DefaultDomainSettingsRule = DomainSettingsRule;
 
 declare interface DesktopAgent {
     open(app: TargetApp, context?: Context): Promise<void>;
@@ -4694,6 +4708,25 @@ declare type DisplayMetadata_3 = {
     readonly glyph?: string;
 };
 
+/**
+ * @interface
+ * 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.
+ */
+declare type DomainSettings = {
+    rules: DomainSettingsRule[];
+};
+
+/**
+ * @interface
+ */
+declare type DomainSettingsRule = {
+    match: string[];
+    options: {
+        downloadSettings?: FileDownloadSettings;
+        api?: ApiInjection;
+    };
+};
+
 /**
  * Metadata returned from a preload script download request.
  *
@@ -4738,14 +4771,24 @@ declare type DownloadRule = {
  * @interface
  *
  * Controls the styling and behavior of the window download shelf.
+ *
+ * @remarks This will control the styling for the download shelf regardless of whether its display was
+ * triggered by the window itself, or a view targeting the window.
  */
 declare type DownloadShelfOptions = {
     /**
-     * Whether downloads in this window trigger opening the download shelf.
+     * Whether downloads in this window trigger display of the download shelf.
+     *
+     * @remarks Setting this to false will *not* prevent the download shelf from opening if a child view
+     * with `downloadShelf: { enabled: true }` initiates a download.
      */
     enabled: boolean;
     /**
      * Styling options for the download shelf border.
+     *
+     * @remarks These apply regardless of whether download shelf display was
+     * triggered by this window itself, or a view targeting the window.  Individual views
+     * cannot control the rendering of their parent window's download shelf.
      */
     border?: {
         /**
@@ -4755,7 +4798,7 @@ declare type DownloadShelfOptions = {
          */
         size?: number;
         /**
-         * Color of the border, either a string name or a hex code.  Defaults to chromium theme
+         * Color of the border.  Must be a 6-character hex code prefixed by #.  Defaults to chromium theme
          * if absent.
          */
         color?: string;
@@ -6568,6 +6611,13 @@ declare type InitPlatformOptions = {
     interopOverride?: OverrideCallback<InteropBroker> | ConstructorOverride<InteropBroker>[];
 };
 
+/**
+ * * 'none': The `fin` API will be not available from within this context.
+ * * 'global': The entire `fin` API will be available from within this context.
+ * @defaultValue 'global'
+ */
+declare type InjectionType = 'none' | 'global';
+
 /**
  * Generated when the value of the element changes.
  * @interface
@@ -7412,8 +7462,6 @@ declare type InteropBrokerOptions = {
 };
 
 /**
- * {@link https://developers.openfin.co/of-docs/docs/enable-color-linking}
- *
  * The Interop Client API is broken up into two groups:
  *
  * **Content Facing APIs** - For Application Developers putting Views into a Platform Window, who care about Context. These are APIs that send out and receive the Context data that flows between applications. Think of this as the Water in the Interop Pipes.
@@ -7816,7 +7864,7 @@ declare class InteropClient extends Base {
      * ```
      */
     onDisconnection(listener: OpenFin.InteropClientOnDisconnectionListener): Promise<void>;
-    static ferryFdc3Call(interopClient: OpenFin.InteropClient, action: string, payload?: any): Promise<any>;
+    /* Excluded from this release type: ferryFdc3Call */
 }
 
 /**
@@ -8746,7 +8794,7 @@ declare type LayoutOptions = {
          * @defaultValue false
          *
          * Limits the area to which tabs can be dragged.
-         * If true, stack headers are the only areas where tabs can be dropped.
+         * If true, the layout container is the only area where tabs can be dropped.
          */
         constrainDragToContainer?: boolean;
         /**
@@ -8823,7 +8871,7 @@ declare type LayoutOptions = {
 declare type LayoutPosition = 'top' | 'bottom' | 'left' | 'right';
 
 /**
- * @interface
+ * Layout preset type.
  */
 declare type LayoutPresetType = 'columns' | 'grid' | 'rows' | 'tabs';
 
@@ -9538,7 +9586,7 @@ declare type MutableWindowOptions = {
     showTaskbarIcon: boolean;
     interop: InteropConfig;
     /* Excluded from this release type: _internalWorkspaceData */
-    workspacePlatform: unknown;
+    /* Excluded from this release type: workspacePlatform */
 };
 
 declare type NackHandler = (payloadOrMessage: RuntimeErrorPayload | string) => void;
@@ -9726,6 +9774,7 @@ declare namespace OpenFin {
         ResizeRegion,
         Accelerator,
         Api,
+        InjectionType,
         NavigationRules,
         ContentNavigation,
         ContentRedirect,
@@ -9873,6 +9922,9 @@ declare namespace OpenFin {
         RuntimeInfo,
         DefaultDomainSettings,
         DefaultDomainSettingsRule,
+        DomainSettings,
+        ApiInjection,
+        DomainSettingsRule,
         FileDownloadBehaviorNames,
         FileDownloadSettings,
         DownloadRule,

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

@@ -97,9 +97,9 @@ declare type Api = {
         enableDeprecatedSharedName?: boolean;
     };
     /**
-     *  Prevent fin API injection. If true `fin` won't be available in this context.
+     *  Prevent fin API injection. If 'none', `fin` won't be available in this context.
      */
-    preventInjection?: boolean;
+    fin?: InjectionType;
 };
 
 declare type ApiCall<Request, Response> = {
@@ -111,6 +111,13 @@ declare type ApiClient<T extends Record<any, any>> = {
     [key in keyof PickOfType<T, Function>]: (...args: Parameters<T[key]>) => ReturnType<T[key]> extends Promise<any> ? ReturnType<T[key]> : Promise<ReturnType<T[key]>>;
 };
 
+/**
+ * @interface
+ */
+declare type ApiInjection = {
+    fin: InjectionType;
+};
+
 /**
  * Generated when a new Platform's API becomes responsive.
  * @interface
@@ -1178,10 +1185,13 @@ declare type ApplicationOptions = LegacyWinOptionsInAppOptions & {
      */
     apiDiagnostics: boolean;
     /**
-     * Define the file download rules.
-     * See [here](https://developers.openfin.co/of-docs/docs/file-download#manifest-properties-for-file-downloads) for more details.
+     * @deprecated Please use {@link domainSettings} instead
      */
     defaultDomainSettings: DefaultDomainSettings;
+    /**
+     * 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;
     /**
      * @defaultValue false
      *
@@ -3480,9 +3490,13 @@ declare type ConstViewOptions = {
     /**
      * Controls interaction of the view with its parent window's download shelf.
      */
-    downloadShelf?: {
+    downloadShelf: {
         /**
-         * Whether downloads in this view trigger opening the download shelf on its parent BrowserWindow
+         * Whether downloads in this view trigger opening the download shelf on its parent BrowserWindow.
+         *
+         * @remarks If `enabled: true`, downloads from this view will cause the download shelf to display
+         * on the parent window even if that parent window's {@link DownloadShelfOptions} specify
+         * `enabled: false`.
          */
         enabled: boolean;
     };
@@ -3598,6 +3612,12 @@ declare type ConstWindowOptions = {
      * launches in favor of the cached value.
      */
     defaultWidth: number;
+    /**
+     * Controls the styling and behavior of the window download shelf.
+     *
+     * @remarks This will control the styling for the download shelf regardless of whether its display was
+     * triggered by the window itself, or a view targeting the window.
+     */
     downloadShelf: DownloadShelfOptions;
     height: number;
     layout: any;
@@ -4435,21 +4455,15 @@ declare type CustomRequestHeaders = {
 declare type DataChannelReadyState = RTCDataChannel['readyState'];
 
 /**
+ * @deprecated Use {@link OpenFin.DomainSettings} instead.
  * @interface
  */
-declare type DefaultDomainSettings = {
-    rules: DefaultDomainSettingsRule[];
-};
+declare type DefaultDomainSettings = DomainSettings;
 
 /**
- * @interface
+ * @deprecated Use {@link OpenFin.DomainSettingsRule} instead.
  */
-declare type DefaultDomainSettingsRule = {
-    match: string[];
-    options: {
-        downloadSettings: FileDownloadSettings;
-    };
-};
+declare type DefaultDomainSettingsRule = DomainSettingsRule;
 
 declare interface DesktopAgent {
     open(app: TargetApp, context?: Context): Promise<void>;
@@ -4694,6 +4708,25 @@ declare type DisplayMetadata_3 = {
     readonly glyph?: string;
 };
 
+/**
+ * @interface
+ * 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.
+ */
+declare type DomainSettings = {
+    rules: DomainSettingsRule[];
+};
+
+/**
+ * @interface
+ */
+declare type DomainSettingsRule = {
+    match: string[];
+    options: {
+        downloadSettings?: FileDownloadSettings;
+        api?: ApiInjection;
+    };
+};
+
 /**
  * Metadata returned from a preload script download request.
  *
@@ -4738,14 +4771,24 @@ declare type DownloadRule = {
  * @interface
  *
  * Controls the styling and behavior of the window download shelf.
+ *
+ * @remarks This will control the styling for the download shelf regardless of whether its display was
+ * triggered by the window itself, or a view targeting the window.
  */
 declare type DownloadShelfOptions = {
     /**
-     * Whether downloads in this window trigger opening the download shelf.
+     * Whether downloads in this window trigger display of the download shelf.
+     *
+     * @remarks Setting this to false will *not* prevent the download shelf from opening if a child view
+     * with `downloadShelf: { enabled: true }` initiates a download.
      */
     enabled: boolean;
     /**
      * Styling options for the download shelf border.
+     *
+     * @remarks These apply regardless of whether download shelf display was
+     * triggered by this window itself, or a view targeting the window.  Individual views
+     * cannot control the rendering of their parent window's download shelf.
      */
     border?: {
         /**
@@ -4755,7 +4798,7 @@ declare type DownloadShelfOptions = {
          */
         size?: number;
         /**
-         * Color of the border, either a string name or a hex code.  Defaults to chromium theme
+         * Color of the border.  Must be a 6-character hex code prefixed by #.  Defaults to chromium theme
          * if absent.
          */
         color?: string;
@@ -6568,6 +6611,13 @@ declare type InitPlatformOptions = {
     interopOverride?: OverrideCallback<InteropBroker> | ConstructorOverride<InteropBroker>[];
 };
 
+/**
+ * * 'none': The `fin` API will be not available from within this context.
+ * * 'global': The entire `fin` API will be available from within this context.
+ * @defaultValue 'global'
+ */
+declare type InjectionType = 'none' | 'global';
+
 /**
  * Generated when the value of the element changes.
  * @interface
@@ -7412,8 +7462,6 @@ declare type InteropBrokerOptions = {
 };
 
 /**
- * {@link https://developers.openfin.co/of-docs/docs/enable-color-linking}
- *
  * The Interop Client API is broken up into two groups:
  *
  * **Content Facing APIs** - For Application Developers putting Views into a Platform Window, who care about Context. These are APIs that send out and receive the Context data that flows between applications. Think of this as the Water in the Interop Pipes.
@@ -7816,7 +7864,7 @@ declare class InteropClient extends Base {
      * ```
      */
     onDisconnection(listener: OpenFin.InteropClientOnDisconnectionListener): Promise<void>;
-    static ferryFdc3Call(interopClient: OpenFin.InteropClient, action: string, payload?: any): Promise<any>;
+    /* Excluded from this release type: ferryFdc3Call */
 }
 
 /**
@@ -8746,7 +8794,7 @@ declare type LayoutOptions = {
          * @defaultValue false
          *
          * Limits the area to which tabs can be dragged.
-         * If true, stack headers are the only areas where tabs can be dropped.
+         * If true, the layout container is the only area where tabs can be dropped.
          */
         constrainDragToContainer?: boolean;
         /**
@@ -8823,7 +8871,7 @@ declare type LayoutOptions = {
 declare type LayoutPosition = 'top' | 'bottom' | 'left' | 'right';
 
 /**
- * @interface
+ * Layout preset type.
  */
 declare type LayoutPresetType = 'columns' | 'grid' | 'rows' | 'tabs';
 
@@ -9538,7 +9586,7 @@ declare type MutableWindowOptions = {
     showTaskbarIcon: boolean;
     interop: InteropConfig;
     /* Excluded from this release type: _internalWorkspaceData */
-    workspacePlatform: unknown;
+    /* Excluded from this release type: workspacePlatform */
 };
 
 declare type NackHandler = (payloadOrMessage: RuntimeErrorPayload | string) => void;
@@ -9726,6 +9774,7 @@ declare namespace OpenFin {
         ResizeRegion,
         Accelerator,
         Api,
+        InjectionType,
         NavigationRules,
         ContentNavigation,
         ContentRedirect,
@@ -9873,6 +9922,9 @@ declare namespace OpenFin {
         RuntimeInfo,
         DefaultDomainSettings,
         DefaultDomainSettingsRule,
+        DomainSettings,
+        ApiInjection,
+        DomainSettingsRule,
         FileDownloadBehaviorNames,
         FileDownloadSettings,
         DownloadRule,

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

@@ -97,9 +97,9 @@ declare type Api = {
         enableDeprecatedSharedName?: boolean;
     };
     /**
-     *  Prevent fin API injection. If true `fin` won't be available in this context.
+     *  Prevent fin API injection. If 'none', `fin` won't be available in this context.
      */
-    preventInjection?: boolean;
+    fin?: InjectionType;
 };
 
 declare type ApiCall<Request, Response> = {
@@ -111,6 +111,13 @@ declare type ApiClient<T extends Record<any, any>> = {
     [key in keyof PickOfType<T, Function>]: (...args: Parameters<T[key]>) => ReturnType<T[key]> extends Promise<any> ? ReturnType<T[key]> : Promise<ReturnType<T[key]>>;
 };
 
+/**
+ * @interface
+ */
+declare type ApiInjection = {
+    fin: InjectionType;
+};
+
 /**
  * Generated when a new Platform's API becomes responsive.
  * @interface
@@ -1178,10 +1185,13 @@ declare type ApplicationOptions = LegacyWinOptionsInAppOptions & {
      */
     apiDiagnostics: boolean;
     /**
-     * Define the file download rules.
-     * See [here](https://developers.openfin.co/of-docs/docs/file-download#manifest-properties-for-file-downloads) for more details.
+     * @deprecated Please use {@link domainSettings} instead
      */
     defaultDomainSettings: DefaultDomainSettings;
+    /**
+     * 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;
     /**
      * @defaultValue false
      *
@@ -3480,9 +3490,13 @@ declare type ConstViewOptions = {
     /**
      * Controls interaction of the view with its parent window's download shelf.
      */
-    downloadShelf?: {
+    downloadShelf: {
         /**
-         * Whether downloads in this view trigger opening the download shelf on its parent BrowserWindow
+         * Whether downloads in this view trigger opening the download shelf on its parent BrowserWindow.
+         *
+         * @remarks If `enabled: true`, downloads from this view will cause the download shelf to display
+         * on the parent window even if that parent window's {@link DownloadShelfOptions} specify
+         * `enabled: false`.
          */
         enabled: boolean;
     };
@@ -3598,6 +3612,12 @@ declare type ConstWindowOptions = {
      * launches in favor of the cached value.
      */
     defaultWidth: number;
+    /**
+     * Controls the styling and behavior of the window download shelf.
+     *
+     * @remarks This will control the styling for the download shelf regardless of whether its display was
+     * triggered by the window itself, or a view targeting the window.
+     */
     downloadShelf: DownloadShelfOptions;
     height: number;
     layout: any;
@@ -4435,21 +4455,15 @@ declare type CustomRequestHeaders = {
 declare type DataChannelReadyState = RTCDataChannel['readyState'];
 
 /**
+ * @deprecated Use {@link OpenFin.DomainSettings} instead.
  * @interface
  */
-declare type DefaultDomainSettings = {
-    rules: DefaultDomainSettingsRule[];
-};
+declare type DefaultDomainSettings = DomainSettings;
 
 /**
- * @interface
+ * @deprecated Use {@link OpenFin.DomainSettingsRule} instead.
  */
-declare type DefaultDomainSettingsRule = {
-    match: string[];
-    options: {
-        downloadSettings: FileDownloadSettings;
-    };
-};
+declare type DefaultDomainSettingsRule = DomainSettingsRule;
 
 declare interface DesktopAgent {
     open(app: TargetApp, context?: Context): Promise<void>;
@@ -4694,6 +4708,25 @@ declare type DisplayMetadata_3 = {
     readonly glyph?: string;
 };
 
+/**
+ * @interface
+ * 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.
+ */
+declare type DomainSettings = {
+    rules: DomainSettingsRule[];
+};
+
+/**
+ * @interface
+ */
+declare type DomainSettingsRule = {
+    match: string[];
+    options: {
+        downloadSettings?: FileDownloadSettings;
+        api?: ApiInjection;
+    };
+};
+
 /**
  * Metadata returned from a preload script download request.
  *
@@ -4738,14 +4771,24 @@ declare type DownloadRule = {
  * @interface
  *
  * Controls the styling and behavior of the window download shelf.
+ *
+ * @remarks This will control the styling for the download shelf regardless of whether its display was
+ * triggered by the window itself, or a view targeting the window.
  */
 declare type DownloadShelfOptions = {
     /**
-     * Whether downloads in this window trigger opening the download shelf.
+     * Whether downloads in this window trigger display of the download shelf.
+     *
+     * @remarks Setting this to false will *not* prevent the download shelf from opening if a child view
+     * with `downloadShelf: { enabled: true }` initiates a download.
      */
     enabled: boolean;
     /**
      * Styling options for the download shelf border.
+     *
+     * @remarks These apply regardless of whether download shelf display was
+     * triggered by this window itself, or a view targeting the window.  Individual views
+     * cannot control the rendering of their parent window's download shelf.
      */
     border?: {
         /**
@@ -4755,7 +4798,7 @@ declare type DownloadShelfOptions = {
          */
         size?: number;
         /**
-         * Color of the border, either a string name or a hex code.  Defaults to chromium theme
+         * Color of the border.  Must be a 6-character hex code prefixed by #.  Defaults to chromium theme
          * if absent.
          */
         color?: string;
@@ -6568,6 +6611,13 @@ declare type InitPlatformOptions = {
     interopOverride?: OverrideCallback<InteropBroker> | ConstructorOverride<InteropBroker>[];
 };
 
+/**
+ * * 'none': The `fin` API will be not available from within this context.
+ * * 'global': The entire `fin` API will be available from within this context.
+ * @defaultValue 'global'
+ */
+declare type InjectionType = 'none' | 'global';
+
 /**
  * Generated when the value of the element changes.
  * @interface
@@ -7412,8 +7462,6 @@ declare type InteropBrokerOptions = {
 };
 
 /**
- * {@link https://developers.openfin.co/of-docs/docs/enable-color-linking}
- *
  * The Interop Client API is broken up into two groups:
  *
  * **Content Facing APIs** - For Application Developers putting Views into a Platform Window, who care about Context. These are APIs that send out and receive the Context data that flows between applications. Think of this as the Water in the Interop Pipes.
@@ -7816,7 +7864,7 @@ declare class InteropClient extends Base {
      * ```
      */
     onDisconnection(listener: OpenFin.InteropClientOnDisconnectionListener): Promise<void>;
-    static ferryFdc3Call(interopClient: OpenFin.InteropClient, action: string, payload?: any): Promise<any>;
+    /* Excluded from this release type: ferryFdc3Call */
 }
 
 /**
@@ -8746,7 +8794,7 @@ declare type LayoutOptions = {
          * @defaultValue false
          *
          * Limits the area to which tabs can be dragged.
-         * If true, stack headers are the only areas where tabs can be dropped.
+         * If true, the layout container is the only area where tabs can be dropped.
          */
         constrainDragToContainer?: boolean;
         /**
@@ -8823,7 +8871,7 @@ declare type LayoutOptions = {
 declare type LayoutPosition = 'top' | 'bottom' | 'left' | 'right';
 
 /**
- * @interface
+ * Layout preset type.
  */
 declare type LayoutPresetType = 'columns' | 'grid' | 'rows' | 'tabs';
 
@@ -9538,7 +9586,7 @@ declare type MutableWindowOptions = {
     showTaskbarIcon: boolean;
     interop: InteropConfig;
     /* Excluded from this release type: _internalWorkspaceData */
-    workspacePlatform: unknown;
+    /* Excluded from this release type: workspacePlatform */
 };
 
 declare type NackHandler = (payloadOrMessage: RuntimeErrorPayload | string) => void;
@@ -9726,6 +9774,7 @@ declare namespace OpenFin {
         ResizeRegion,
         Accelerator,
         Api,
+        InjectionType,
         NavigationRules,
         ContentNavigation,
         ContentRedirect,
@@ -9873,6 +9922,9 @@ declare namespace OpenFin {
         RuntimeInfo,
         DefaultDomainSettings,
         DefaultDomainSettingsRule,
+        DomainSettings,
+        ApiInjection,
+        DomainSettingsRule,
         FileDownloadBehaviorNames,
         FileDownloadSettings,
         DownloadRule,

package/out/node-adapter.d.ts

@@ -97,9 +97,9 @@ declare type Api = {
         enableDeprecatedSharedName?: boolean;
     };
     /**
-     *  Prevent fin API injection. If true `fin` won't be available in this context.
+     *  Prevent fin API injection. If 'none', `fin` won't be available in this context.
      */
-    preventInjection?: boolean;
+    fin?: InjectionType;
 };
 
 declare type ApiCall<Request, Response> = {
@@ -111,6 +111,13 @@ declare type ApiClient<T extends Record<any, any>> = {
     [key in keyof PickOfType<T, Function>]: (...args: Parameters<T[key]>) => ReturnType<T[key]> extends Promise<any> ? ReturnType<T[key]> : Promise<ReturnType<T[key]>>;
 };
 
+/**
+ * @interface
+ */
+declare type ApiInjection = {
+    fin: InjectionType;
+};
+
 /**
  * Generated when a new Platform's API becomes responsive.
  * @interface
@@ -1184,10 +1191,13 @@ declare type ApplicationOptions = LegacyWinOptionsInAppOptions & {
      */
     apiDiagnostics: boolean;
     /**
-     * Define the file download rules.
-     * See [here](https://developers.openfin.co/of-docs/docs/file-download#manifest-properties-for-file-downloads) for more details.
+     * @deprecated Please use {@link domainSettings} instead
      */
     defaultDomainSettings: DefaultDomainSettings;
+    /**
+     * 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;
     /**
      * @defaultValue false
      *
@@ -3523,9 +3533,13 @@ declare type ConstViewOptions = {
     /**
      * Controls interaction of the view with its parent window's download shelf.
      */
-    downloadShelf?: {
+    downloadShelf: {
         /**
-         * Whether downloads in this view trigger opening the download shelf on its parent BrowserWindow
+         * Whether downloads in this view trigger opening the download shelf on its parent BrowserWindow.
+         *
+         * @remarks If `enabled: true`, downloads from this view will cause the download shelf to display
+         * on the parent window even if that parent window's {@link DownloadShelfOptions} specify
+         * `enabled: false`.
          */
         enabled: boolean;
     };
@@ -3641,6 +3655,12 @@ declare type ConstWindowOptions = {
      * launches in favor of the cached value.
      */
     defaultWidth: number;
+    /**
+     * Controls the styling and behavior of the window download shelf.
+     *
+     * @remarks This will control the styling for the download shelf regardless of whether its display was
+     * triggered by the window itself, or a view targeting the window.
+     */
     downloadShelf: DownloadShelfOptions;
     height: number;
     layout: any;
@@ -4478,21 +4498,15 @@ declare type CustomRequestHeaders = {
 declare type DataChannelReadyState = RTCDataChannel['readyState'];
 
 /**
+ * @deprecated Use {@link OpenFin.DomainSettings} instead.
  * @interface
  */
-declare type DefaultDomainSettings = {
-    rules: DefaultDomainSettingsRule[];
-};
+declare type DefaultDomainSettings = DomainSettings;
 
 /**
- * @interface
+ * @deprecated Use {@link OpenFin.DomainSettingsRule} instead.
  */
-declare type DefaultDomainSettingsRule = {
-    match: string[];
-    options: {
-        downloadSettings: FileDownloadSettings;
-    };
-};
+declare type DefaultDomainSettingsRule = DomainSettingsRule;
 
 declare interface DesktopAgent {
     open(app: TargetApp, context?: Context): Promise<void>;
@@ -4737,6 +4751,25 @@ declare type DisplayMetadata_3 = {
     readonly glyph?: string;
 };
 
+/**
+ * @interface
+ * 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.
+ */
+declare type DomainSettings = {
+    rules: DomainSettingsRule[];
+};
+
+/**
+ * @interface
+ */
+declare type DomainSettingsRule = {
+    match: string[];
+    options: {
+        downloadSettings?: FileDownloadSettings;
+        api?: ApiInjection;
+    };
+};
+
 /**
  * Metadata returned from a preload script download request.
  *
@@ -4781,14 +4814,24 @@ declare type DownloadRule = {
  * @interface
  *
  * Controls the styling and behavior of the window download shelf.
+ *
+ * @remarks This will control the styling for the download shelf regardless of whether its display was
+ * triggered by the window itself, or a view targeting the window.
  */
 declare type DownloadShelfOptions = {
     /**
-     * Whether downloads in this window trigger opening the download shelf.
+     * Whether downloads in this window trigger display of the download shelf.
+     *
+     * @remarks Setting this to false will *not* prevent the download shelf from opening if a child view
+     * with `downloadShelf: { enabled: true }` initiates a download.
      */
     enabled: boolean;
     /**
      * Styling options for the download shelf border.
+     *
+     * @remarks These apply regardless of whether download shelf display was
+     * triggered by this window itself, or a view targeting the window.  Individual views
+     * cannot control the rendering of their parent window's download shelf.
      */
     border?: {
         /**
@@ -4798,7 +4841,7 @@ declare type DownloadShelfOptions = {
          */
         size?: number;
         /**
-         * Color of the border, either a string name or a hex code.  Defaults to chromium theme
+         * Color of the border.  Must be a 6-character hex code prefixed by #.  Defaults to chromium theme
          * if absent.
          */
         color?: string;
@@ -6668,6 +6711,13 @@ declare type InitPlatformOptions = {
     interopOverride?: OverrideCallback<InteropBroker> | ConstructorOverride<InteropBroker>[];
 };
 
+/**
+ * * 'none': The `fin` API will be not available from within this context.
+ * * 'global': The entire `fin` API will be available from within this context.
+ * @defaultValue 'global'
+ */
+declare type InjectionType = 'none' | 'global';
+
 /**
  * Generated when the value of the element changes.
  * @interface
@@ -7527,8 +7577,6 @@ declare type InteropBrokerOptions = {
 };
 
 /**
- * {@link https://developers.openfin.co/of-docs/docs/enable-color-linking}
- *
  * The Interop Client API is broken up into two groups:
  *
  * **Content Facing APIs** - For Application Developers putting Views into a Platform Window, who care about Context. These are APIs that send out and receive the Context data that flows between applications. Think of this as the Water in the Interop Pipes.
@@ -7934,6 +7982,11 @@ declare class InteropClient extends Base {
      * ```
      */
     onDisconnection(listener: OpenFin.InteropClientOnDisconnectionListener): Promise<void>;
+    /**
+     * @internal
+     *
+     * Used to ferry fdc3-only calls from the fdc3 shim to the Interop Broker
+     */
     static ferryFdc3Call(interopClient: OpenFin.InteropClient, action: string, payload?: any): Promise<any>;
 }
 
@@ -9040,7 +9093,7 @@ declare type LayoutOptions = {
          * @defaultValue false
          *
          * Limits the area to which tabs can be dragged.
-         * If true, stack headers are the only areas where tabs can be dropped.
+         * If true, the layout container is the only area where tabs can be dropped.
          */
         constrainDragToContainer?: boolean;
         /**
@@ -9117,7 +9170,7 @@ declare type LayoutOptions = {
 declare type LayoutPosition = 'top' | 'bottom' | 'left' | 'right';
 
 /**
- * @interface
+ * Layout preset type.
  */
 declare type LayoutPresetType = 'columns' | 'grid' | 'rows' | 'tabs';
 
@@ -9840,7 +9893,11 @@ declare type MutableWindowOptions = {
      * Used by Workspace to store custom data. Overwriting or modifying this field may impact the functionality of Workspace
      */
     _internalWorkspaceData: any;
-    workspacePlatform: unknown;
+    /**
+     * @internal
+     * Used by workspace to stork platform specific options. Overwriting or modifying this field may impact the functionality of Workspace
+     */
+    workspacePlatform: WorkspacePlatformOptions;
 };
 
 declare type NackHandler = (payloadOrMessage: RuntimeErrorPayload | string) => void;
@@ -10038,6 +10095,7 @@ declare namespace OpenFin {
         ResizeRegion,
         Accelerator,
         Api,
+        InjectionType,
         NavigationRules,
         ContentNavigation,
         ContentRedirect,
@@ -10185,6 +10243,9 @@ declare namespace OpenFin {
         RuntimeInfo,
         DefaultDomainSettings,
         DefaultDomainSettingsRule,
+        DomainSettings,
+        ApiInjection,
+        DomainSettingsRule,
         FileDownloadBehaviorNames,
         FileDownloadSettings,
         DownloadRule,

package/out/node-adapter.js

@@ -8054,7 +8054,8 @@ function errorToPOJO(error) {
         stack: error.stack,
         name: error.name,
         message: error.message,
-        toString: error.toString
+        // support the case where stack is empty or missing
+        toString: () => error.stack || error.toString()
     };
 }
 errors.errorToPOJO = errorToPOJO;
@@ -11659,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_getBackCompatLayoutManager, _LayoutModule_throwIfLayoutManagerNotInitialized;
+var _LayoutModule_instances, _LayoutModule_layoutInitializationAttempted, _LayoutModule_layoutManager, _LayoutModule_waitForBackCompatLayoutManager, _LayoutModule_getSafeLayoutManager;
 Object.defineProperty(Factory$2, "__esModule", { value: true });
 Factory$2.LayoutModule = void 0;
 const base_1$5 = base$1;
@@ -11712,7 +11713,7 @@ class LayoutModule extends base_1$5.Base {
          * ```
          */
         this.init = async (options = {}) => {
-            this.wire.sendAction('layout-init').catch((e) => {
+            this.wire.sendAction('layout-init').catch(() => {
                 // don't expose
             });
             if (!this.fin.me.isWindow) {
@@ -11723,23 +11724,29 @@ class LayoutModule extends base_1$5.Base {
             }
             __classPrivateFieldSet$4(this, _LayoutModule_layoutInitializationAttempted, true, "f");
             __classPrivateFieldSet$4(this, _LayoutModule_layoutManager, await this.wire.environment.initLayoutManager(this.fin, this.wire, options), "f");
+            // in single-layout case, we return the undocumented layoutManager type (deprecate with CORE-1081)
+            let backCompatLayoutPromise;
+            if (!options.layoutManagerOverride) {
+                backCompatLayoutPromise = __classPrivateFieldGet$4(this, _LayoutModule_waitForBackCompatLayoutManager, "f").call(this, this.fin);
+            }
             // apply the initial snapshot which in turn will call fin.Platform.Layout.create()
             const platformClient = await this.fin.Platform.getCurrentSync().getClient();
             const snapshot = await platformClient.dispatch('get-initial-layout-snapshot');
             await __classPrivateFieldGet$4(this, _LayoutModule_layoutManager, "f").applyLayoutSnapshot(snapshot);
-            if (!options.layoutManagerOverride) {
-                return __classPrivateFieldGet$4(this, _LayoutModule_getBackCompatLayoutManager, "f").call(this, this.fin);
+            if (backCompatLayoutPromise) {
+                return backCompatLayoutPromise;
             }
             // warn user if they do not call create() in the next 30 seconds
             setTimeout(() => {
-                if (__classPrivateFieldGet$4(this, _LayoutModule_layoutManager, "f").size() === 0) {
+                if (__classPrivateFieldGet$4(this, _LayoutModule_layoutManager, "f")?.size() === 0) {
                     console.warn(`[Layout.init] Layout.init was called 30s ago, but no layouts have been created yet. Make sure you ` +
                         `override LayoutManager.applyLayoutSnapshot, and then call fin.Platform.Layout.create()`);
                 }
             }, 30000);
             return this.wrapSync(this.fin.me.identity);
         };
-        _LayoutModule_getBackCompatLayoutManager.set(this, async (fin) => {
+        // deprecate with CORE-1081
+        _LayoutModule_waitForBackCompatLayoutManager.set(this, async (fin) => {
             let layoutManager;
             let resolve;
             const layoutResolved = new Promise((r) => {
@@ -11747,6 +11754,7 @@ class LayoutModule extends base_1$5.Base {
             });
             // wait for a layout to be created
             await fin.me.once('layout-ready', async ({ layoutIdentity }) => {
+                // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
                 layoutManager = await this.wire.environment.resolveLayout(__classPrivateFieldGet$4(this, _LayoutModule_layoutManager, "f"), layoutIdentity);
                 // Backward compat - undocumented / not typed openfin-layout as layoutManager
                 // TODO: eventually deprecate this
@@ -11759,17 +11767,13 @@ class LayoutModule extends base_1$5.Base {
          * @returns
          */
         this.getCurrentLayoutManagerSync = () => {
-            __classPrivateFieldGet$4(this, _LayoutModule_instances, "m", _LayoutModule_throwIfLayoutManagerNotInitialized).call(this, `fin.Platform.Layout.getCurrentLayoutManagerSync()`);
-            // @ts-expect-error User may have implemented their own snapshot type when overriding LayoutManager
-            return __classPrivateFieldGet$4(this, _LayoutModule_layoutManager, "f");
+            return __classPrivateFieldGet$4(this, _LayoutModule_instances, "m", _LayoutModule_getSafeLayoutManager).call(this, `fin.Platform.Layout.getCurrentLayoutManagerSync()`);
         };
         this.create = async (options) => {
-            __classPrivateFieldGet$4(this, _LayoutModule_instances, "m", _LayoutModule_throwIfLayoutManagerNotInitialized).call(this, `fin.Platform.Layout.create()`);
-            return this.wire.environment.createLayout(__classPrivateFieldGet$4(this, _LayoutModule_layoutManager, "f"), options);
+            return this.wire.environment.createLayout(__classPrivateFieldGet$4(this, _LayoutModule_instances, "m", _LayoutModule_getSafeLayoutManager).call(this, `fin.Platform.Layout.create()`), options);
         };
         this.destroy = async (layoutIdentity) => {
-            __classPrivateFieldGet$4(this, _LayoutModule_instances, "m", _LayoutModule_throwIfLayoutManagerNotInitialized).call(this, `fin.Platform.Layout.destroy()`);
-            return this.wire.environment.destroyLayout(__classPrivateFieldGet$4(this, _LayoutModule_layoutManager, "f"), layoutIdentity);
+            return this.wire.environment.destroyLayout(__classPrivateFieldGet$4(this, _LayoutModule_instances, "m", _LayoutModule_getSafeLayoutManager).call(this, `fin.Platform.Layout.destroy()`), layoutIdentity);
         };
     }
     /**
@@ -11792,7 +11796,7 @@ class LayoutModule extends base_1$5.Base {
      * ```
      */
     async wrap(identity) {
-        this.wire.sendAction('layout-wrap').catch((e) => {
+        this.wire.sendAction('layout-wrap').catch(() => {
             // don't expose
         });
         return new Instance_1$2.Layout(identity, this.wire);
@@ -11817,7 +11821,7 @@ class LayoutModule extends base_1$5.Base {
      * ```
      */
     wrapSync(identity) {
-        this.wire.sendAction('layout-wrap-sync').catch((e) => {
+        this.wire.sendAction('layout-wrap-sync').catch(() => {
             // don't expose
         });
         return new Instance_1$2.Layout(identity, this.wire);
@@ -11833,7 +11837,7 @@ class LayoutModule extends base_1$5.Base {
      * ```
      */
     async getCurrent() {
-        this.wire.sendAction('layout-get-current').catch((e) => {
+        this.wire.sendAction('layout-get-current').catch(() => {
             // don't expose
         });
         if (!this.fin.me.isWindow) {
@@ -11856,7 +11860,7 @@ class LayoutModule extends base_1$5.Base {
      * ```
      */
     getCurrentSync() {
-        this.wire.sendAction('layout-get-current-sync').catch((e) => {
+        this.wire.sendAction('layout-get-current-sync').catch(() => {
             // don't expose
         });
         if (!this.fin.me.isWindow) {
@@ -11867,10 +11871,11 @@ class LayoutModule extends base_1$5.Base {
     }
 }
 Factory$2.LayoutModule = LayoutModule;
-_LayoutModule_layoutInitializationAttempted = new WeakMap(), _LayoutModule_layoutManager = new WeakMap(), _LayoutModule_getBackCompatLayoutManager = new WeakMap(), _LayoutModule_instances = new WeakSet(), _LayoutModule_throwIfLayoutManagerNotInitialized = function _LayoutModule_throwIfLayoutManagerNotInitialized(method) {
+_LayoutModule_layoutInitializationAttempted = new WeakMap(), _LayoutModule_layoutManager = new WeakMap(), _LayoutModule_waitForBackCompatLayoutManager = 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}`);
     }
+    return __classPrivateFieldGet$4(this, _LayoutModule_layoutManager, "f");
 };
 
 (function (exports) {
@@ -14208,8 +14213,6 @@ const base_1$2 = base$1;
 const SessionContextGroupClient_1 = SessionContextGroupClient$1;
 const utils_1$2 = utils$1;
 /**
- * {@link https://developers.openfin.co/of-docs/docs/enable-color-linking}
- *
  * The Interop Client API is broken up into two groups:
  *
  * **Content Facing APIs** - For Application Developers putting Views into a Platform Window, who care about Context. These are APIs that send out and receive the Context data that flows between applications. Think of this as the Water in the Interop Pipes.
@@ -14775,7 +14778,11 @@ class InteropClient extends base_1$2.Base {
             listener({ type: 'interop-broker', topic: 'disconnected', brokerName: uuid });
         });
     }
-    // used to ferry fdc3-only calls from the fdc3 shim to the Interop Broker
+    /**
+     * @internal
+     *
+     * Used to ferry fdc3-only calls from the fdc3 shim to the Interop Broker
+     */
     static async ferryFdc3Call(interopClient, action, payload) {
         const client = await __classPrivateFieldGet$2(interopClient, _InteropClient_clientPromise, "f");
         return client.dispatch(action, payload || null);
@@ -14792,29 +14799,33 @@ function requireOverrideCheck () {
 	if (hasRequiredOverrideCheck) return overrideCheck;
 	hasRequiredOverrideCheck = 1;
 	Object.defineProperty(overrideCheck, "__esModule", { value: true });
-	overrideCheck.overrideCheck = overrideCheck.getDefaultViewFdc3VersionFromAppInfo = void 0;
+	overrideCheck.overrideCheck = overrideCheck.checkFDC32Overrides = overrideCheck.getDefaultViewFdc3VersionFromAppInfo = void 0;
 	const InteropBroker_1 = requireInteropBroker();
 	function getDefaultViewFdc3VersionFromAppInfo({ manifest, initialOptions }) {
 	    const setVersion = manifest.platform?.defaultViewOptions?.fdc3InteropApi ?? initialOptions.defaultViewOptions?.fdc3InteropApi;
 	    return ['1.2', '2.0'].includes(setVersion ?? '') ? setVersion : undefined;
 	}
 	overrideCheck.getDefaultViewFdc3VersionFromAppInfo = getDefaultViewFdc3VersionFromAppInfo;
-	// TODO: Unit test this
+	function checkFDC32Overrides(overriddenBroker) {
+	    // These are the APIs that must be overridden for FDC3 2.0 compliance
+	    const mustOverrideAPIs = [
+	        'fdc3HandleFindInstances',
+	        'handleInfoForIntent',
+	        'handleInfoForIntentsByContext',
+	        'fdc3HandleGetAppMetadata',
+	        'fdc3HandleGetInfo',
+	        'fdc3HandleOpen',
+	        'handleFiredIntent',
+	        'handleFiredIntentForContext'
+	    ];
+	    return mustOverrideAPIs.filter((api) => {
+	        return overriddenBroker[api] === InteropBroker_1.InteropBroker.prototype[api];
+	    });
+	}
+	overrideCheck.checkFDC32Overrides = checkFDC32Overrides;
 	function overrideCheck$1(overriddenBroker, fdc3InteropApi) {
 	    if (fdc3InteropApi && fdc3InteropApi === '2.0') {
-	        const mustOverrideAPIs = [
-	            'fdc3HandleFindInstances',
-	            'handleInfoForIntent',
-	            'handleInfoForIntentsByContext',
-	            'fdc3HandleGetAppMetadata',
-	            'fdc3HandleGetInfo',
-	            'fdc3HandleOpen',
-	            'handleFiredIntent',
-	            'handleFiredIntentForContext'
-	        ];
-	        const notOverridden = mustOverrideAPIs.filter((api) => {
-	            return overriddenBroker[api] === InteropBroker_1.InteropBroker.prototype[api];
-	        });
+	        const notOverridden = checkFDC32Overrides(overriddenBroker);
 	        if (notOverridden.length > 0) {
 	            console.warn(`WARNING: FDC3 2.0 has been set as a default option for Views in this Platform, but the required InteropBroker APIs for FDC3 2.0 compliance have not all been overridden.\nThe following APIs need to be overridden:\n${notOverridden.join('\n')}`);
 	        }

package/package.json

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