@openfin/core 38.81.29 → 38.81.31

package/out/mock-alpha.d.ts

@@ -825,7 +825,7 @@ declare class Application extends EmitterBase<OpenFin_2.ApplicationEvent> {
      */
     showTrayIconPopupMenu<Data>(options: OpenFin_2.ShowTrayIconPopupMenuOptions<Data>): Promise<OpenFin_2.MenuResult<Data>>;
     /**
-     * CLoses the tray icon menu.
+     * Closes the tray icon menu.
      *
      * @throws if the application has no tray icon set
      * @example
@@ -934,7 +934,7 @@ declare type ApplicationIdentity_2 = {
  * @interface
  */
 declare type ApplicationInfo = {
-    initialOptions: ApplicationCreationOptions | PlatformOptions;
+    initialOptions: WithUserAppConfigArgs & (ApplicationCreationOptions | PlatformOptions);
     launchMode: string;
     manifest: Manifest & {
         [key: string]: any;
@@ -3432,6 +3432,13 @@ declare type ConstViewOptions = {
      * Initial bounds given relative to the window.
      */
     bounds: Bounds;
+    /**
+     * API permissions for code running in the view.
+     *
+     * @remarks Superseded by {@link DomainSettings.default.api.permissions} - if present, this setting will be **ignored**.
+     * It is recommended for users to migrate to a domain-based security model, since it is more natural to assign trust
+     * to the source of the page content than to the context rendering it.
+     */
     permissions: Partial<Permissions_2>;
     /**
      * String tag that attempts to group like-tagged renderers together. Will only be used if pages are on the same origin.
@@ -3632,6 +3639,13 @@ declare type ConstWindowOptions = {
      * The name of the window.
      */
     name: string;
+    /**
+     * API permissions for code running in the window.
+     *
+     * @remarks Superseded by {@link DomainSettings.default.api.permissions} - if present, this setting will be **ignored**.
+     * It is recommended for users to migrate to a domain-based security model, since it is more natural to assign trust
+     * to the source of the page content than to the context rendering it.
+     */
     permissions: Partial<Permissions_2>;
     /**
      * Scripts that run before page load.  When omitted, inherits from the parent application.
@@ -4712,6 +4726,10 @@ declare type DomainSettings = {
     rules: DomainSettingsRule[];
     /**
      * Default values for settings in {@link DomainSettingsRule}.
+     *
+     * @remarks If {@link PerDomainSettings.content} or {@link PerDomainSettings.api.fin} are given a default value
+     * here, they will supersede any equivalent functionality in {@link WindowOptions} or {@link ViewOptions}.  For
+     * more information, see the documentation for the individual properties.
      */
     default?: PerDomainSettings;
 };
@@ -9899,6 +9917,7 @@ declare namespace OpenFin_2 {
         AppVersionError,
         AppVersionRuntimeInfo,
         LaunchEmitter,
+        UserAppConfigArgs,
         RvmLaunchOptions,
         ShortCutConfig,
         TerminateExternalRequestType,
@@ -10208,7 +10227,7 @@ declare type PerDomainSettings = {
      * Whether DOM content can be loaded (by navigation or redirect).
      *
      * @remarks If this is included in {@link DomainSettings.default}, then {@link ContentNavigation} and
-     * {@link ContentRedirect} will be **ignored**.
+     * {@link ContentRedirect} in {@link WindowOptions} and {@link ViewOptions} will be **ignored**.
      */
     content?: ContentPermission;
 };
@@ -12725,7 +12744,7 @@ declare type RunRequestedEvent = OpenFin_2.ApplicationEvents.RunRequestedEvent;
 declare type RunRequestedEvent_2 = BaseEvents.IdentityEvent & {
     topic: 'application';
     type: 'run-requested';
-    userAppConfigArgs: Record<string, any>;
+    userAppConfigArgs: OpenFin_2.UserAppConfigArgs;
     manifest: OpenFin_2.Manifest;
 };
 
@@ -12840,7 +12859,7 @@ declare type RvmLaunchOptions = {
      * True if no UI when launching
      */
     noUi?: boolean;
-    userAppConfigArgs?: object;
+    userAppConfigArgs?: UserAppConfigArgs;
     /**
      * Timeout in seconds until RVM launch request expires.
      */
@@ -15369,6 +15388,11 @@ declare type UrlChangedEvent = BaseUrlEvent & ({
     httpStatusText: string;
 });
 
+/**
+ * @interface
+ */
+declare type UserAppConfigArgs = Record<string, string | string[]>;
+
 /**
  * A general user bounds change event without event type.
  * @interface
@@ -18775,6 +18799,32 @@ declare type WithPositioningOptions<T extends {} = {}> = T & {
     positioningOptions?: OpenFin_2.PositioningOptions;
 };
 
+declare type WithUserAppConfigArgs = {
+    /**
+     * Represents the key-value pairs for the parameters passed into any fin:// or fins:// link
+     * that launches this application.
+     *
+     * @remarks
+     * In the link, user defined parameters are separated by the `$$` delimeter, for example:
+     * `fins://path.to/app/manifest.json?$$use-last-configuration=true`
+     *
+     * Results in the following object:
+     * ```json
+     * {
+     *    "use-last-configuration": true"
+     * }
+     * ```
+     *
+     * These args can be accessed via the {@link ApplicationInfo.initialOptions} object:
+     * ```typescript
+     * const appInfo = await fin.Application.getCurrentSync().getInfo();
+     * const { userAppConfigArgs } = appInfo.initialOptions;
+     * console.log(userAppConfigArgs['use-last-configuration']); // 'true'
+     * ```
+     */
+    userAppConfigArgs?: UserAppConfigArgs;
+};
+
 /* Excluded from this release type: WorkspacePlatformOptions */
 
 /**

package/out/mock-beta.d.ts

@@ -825,7 +825,7 @@ declare class Application extends EmitterBase<OpenFin_2.ApplicationEvent> {
      */
     showTrayIconPopupMenu<Data>(options: OpenFin_2.ShowTrayIconPopupMenuOptions<Data>): Promise<OpenFin_2.MenuResult<Data>>;
     /**
-     * CLoses the tray icon menu.
+     * Closes the tray icon menu.
      *
      * @throws if the application has no tray icon set
      * @example
@@ -934,7 +934,7 @@ declare type ApplicationIdentity_2 = {
  * @interface
  */
 declare type ApplicationInfo = {
-    initialOptions: ApplicationCreationOptions | PlatformOptions;
+    initialOptions: WithUserAppConfigArgs & (ApplicationCreationOptions | PlatformOptions);
     launchMode: string;
     manifest: Manifest & {
         [key: string]: any;
@@ -3432,6 +3432,13 @@ declare type ConstViewOptions = {
      * Initial bounds given relative to the window.
      */
     bounds: Bounds;
+    /**
+     * API permissions for code running in the view.
+     *
+     * @remarks Superseded by {@link DomainSettings.default.api.permissions} - if present, this setting will be **ignored**.
+     * It is recommended for users to migrate to a domain-based security model, since it is more natural to assign trust
+     * to the source of the page content than to the context rendering it.
+     */
     permissions: Partial<Permissions_2>;
     /**
      * String tag that attempts to group like-tagged renderers together. Will only be used if pages are on the same origin.
@@ -3632,6 +3639,13 @@ declare type ConstWindowOptions = {
      * The name of the window.
      */
     name: string;
+    /**
+     * API permissions for code running in the window.
+     *
+     * @remarks Superseded by {@link DomainSettings.default.api.permissions} - if present, this setting will be **ignored**.
+     * It is recommended for users to migrate to a domain-based security model, since it is more natural to assign trust
+     * to the source of the page content than to the context rendering it.
+     */
     permissions: Partial<Permissions_2>;
     /**
      * Scripts that run before page load.  When omitted, inherits from the parent application.
@@ -4712,6 +4726,10 @@ declare type DomainSettings = {
     rules: DomainSettingsRule[];
     /**
      * Default values for settings in {@link DomainSettingsRule}.
+     *
+     * @remarks If {@link PerDomainSettings.content} or {@link PerDomainSettings.api.fin} are given a default value
+     * here, they will supersede any equivalent functionality in {@link WindowOptions} or {@link ViewOptions}.  For
+     * more information, see the documentation for the individual properties.
      */
     default?: PerDomainSettings;
 };
@@ -9899,6 +9917,7 @@ declare namespace OpenFin_2 {
         AppVersionError,
         AppVersionRuntimeInfo,
         LaunchEmitter,
+        UserAppConfigArgs,
         RvmLaunchOptions,
         ShortCutConfig,
         TerminateExternalRequestType,
@@ -10208,7 +10227,7 @@ declare type PerDomainSettings = {
      * Whether DOM content can be loaded (by navigation or redirect).
      *
      * @remarks If this is included in {@link DomainSettings.default}, then {@link ContentNavigation} and
-     * {@link ContentRedirect} will be **ignored**.
+     * {@link ContentRedirect} in {@link WindowOptions} and {@link ViewOptions} will be **ignored**.
      */
     content?: ContentPermission;
 };
@@ -12725,7 +12744,7 @@ declare type RunRequestedEvent = OpenFin_2.ApplicationEvents.RunRequestedEvent;
 declare type RunRequestedEvent_2 = BaseEvents.IdentityEvent & {
     topic: 'application';
     type: 'run-requested';
-    userAppConfigArgs: Record<string, any>;
+    userAppConfigArgs: OpenFin_2.UserAppConfigArgs;
     manifest: OpenFin_2.Manifest;
 };
 
@@ -12840,7 +12859,7 @@ declare type RvmLaunchOptions = {
      * True if no UI when launching
      */
     noUi?: boolean;
-    userAppConfigArgs?: object;
+    userAppConfigArgs?: UserAppConfigArgs;
     /**
      * Timeout in seconds until RVM launch request expires.
      */
@@ -15369,6 +15388,11 @@ declare type UrlChangedEvent = BaseUrlEvent & ({
     httpStatusText: string;
 });
 
+/**
+ * @interface
+ */
+declare type UserAppConfigArgs = Record<string, string | string[]>;
+
 /**
  * A general user bounds change event without event type.
  * @interface
@@ -18775,6 +18799,32 @@ declare type WithPositioningOptions<T extends {} = {}> = T & {
     positioningOptions?: OpenFin_2.PositioningOptions;
 };
 
+declare type WithUserAppConfigArgs = {
+    /**
+     * Represents the key-value pairs for the parameters passed into any fin:// or fins:// link
+     * that launches this application.
+     *
+     * @remarks
+     * In the link, user defined parameters are separated by the `$$` delimeter, for example:
+     * `fins://path.to/app/manifest.json?$$use-last-configuration=true`
+     *
+     * Results in the following object:
+     * ```json
+     * {
+     *    "use-last-configuration": true"
+     * }
+     * ```
+     *
+     * These args can be accessed via the {@link ApplicationInfo.initialOptions} object:
+     * ```typescript
+     * const appInfo = await fin.Application.getCurrentSync().getInfo();
+     * const { userAppConfigArgs } = appInfo.initialOptions;
+     * console.log(userAppConfigArgs['use-last-configuration']); // 'true'
+     * ```
+     */
+    userAppConfigArgs?: UserAppConfigArgs;
+};
+
 /* Excluded from this release type: WorkspacePlatformOptions */
 
 /**

package/out/mock-public.d.ts

@@ -825,7 +825,7 @@ declare class Application extends EmitterBase<OpenFin_2.ApplicationEvent> {
      */
     showTrayIconPopupMenu<Data>(options: OpenFin_2.ShowTrayIconPopupMenuOptions<Data>): Promise<OpenFin_2.MenuResult<Data>>;
     /**
-     * CLoses the tray icon menu.
+     * Closes the tray icon menu.
      *
      * @throws if the application has no tray icon set
      * @example
@@ -934,7 +934,7 @@ declare type ApplicationIdentity_2 = {
  * @interface
  */
 declare type ApplicationInfo = {
-    initialOptions: ApplicationCreationOptions | PlatformOptions;
+    initialOptions: WithUserAppConfigArgs & (ApplicationCreationOptions | PlatformOptions);
     launchMode: string;
     manifest: Manifest & {
         [key: string]: any;
@@ -3432,6 +3432,13 @@ declare type ConstViewOptions = {
      * Initial bounds given relative to the window.
      */
     bounds: Bounds;
+    /**
+     * API permissions for code running in the view.
+     *
+     * @remarks Superseded by {@link DomainSettings.default.api.permissions} - if present, this setting will be **ignored**.
+     * It is recommended for users to migrate to a domain-based security model, since it is more natural to assign trust
+     * to the source of the page content than to the context rendering it.
+     */
     permissions: Partial<Permissions_2>;
     /**
      * String tag that attempts to group like-tagged renderers together. Will only be used if pages are on the same origin.
@@ -3632,6 +3639,13 @@ declare type ConstWindowOptions = {
      * The name of the window.
      */
     name: string;
+    /**
+     * API permissions for code running in the window.
+     *
+     * @remarks Superseded by {@link DomainSettings.default.api.permissions} - if present, this setting will be **ignored**.
+     * It is recommended for users to migrate to a domain-based security model, since it is more natural to assign trust
+     * to the source of the page content than to the context rendering it.
+     */
     permissions: Partial<Permissions_2>;
     /**
      * Scripts that run before page load.  When omitted, inherits from the parent application.
@@ -4712,6 +4726,10 @@ declare type DomainSettings = {
     rules: DomainSettingsRule[];
     /**
      * Default values for settings in {@link DomainSettingsRule}.
+     *
+     * @remarks If {@link PerDomainSettings.content} or {@link PerDomainSettings.api.fin} are given a default value
+     * here, they will supersede any equivalent functionality in {@link WindowOptions} or {@link ViewOptions}.  For
+     * more information, see the documentation for the individual properties.
      */
     default?: PerDomainSettings;
 };
@@ -9899,6 +9917,7 @@ declare namespace OpenFin_2 {
         AppVersionError,
         AppVersionRuntimeInfo,
         LaunchEmitter,
+        UserAppConfigArgs,
         RvmLaunchOptions,
         ShortCutConfig,
         TerminateExternalRequestType,
@@ -10208,7 +10227,7 @@ declare type PerDomainSettings = {
      * Whether DOM content can be loaded (by navigation or redirect).
      *
      * @remarks If this is included in {@link DomainSettings.default}, then {@link ContentNavigation} and
-     * {@link ContentRedirect} will be **ignored**.
+     * {@link ContentRedirect} in {@link WindowOptions} and {@link ViewOptions} will be **ignored**.
      */
     content?: ContentPermission;
 };
@@ -12725,7 +12744,7 @@ declare type RunRequestedEvent = OpenFin_2.ApplicationEvents.RunRequestedEvent;
 declare type RunRequestedEvent_2 = BaseEvents.IdentityEvent & {
     topic: 'application';
     type: 'run-requested';
-    userAppConfigArgs: Record<string, any>;
+    userAppConfigArgs: OpenFin_2.UserAppConfigArgs;
     manifest: OpenFin_2.Manifest;
 };
 
@@ -12840,7 +12859,7 @@ declare type RvmLaunchOptions = {
      * True if no UI when launching
      */
     noUi?: boolean;
-    userAppConfigArgs?: object;
+    userAppConfigArgs?: UserAppConfigArgs;
     /**
      * Timeout in seconds until RVM launch request expires.
      */
@@ -15369,6 +15388,11 @@ declare type UrlChangedEvent = BaseUrlEvent & ({
     httpStatusText: string;
 });
 
+/**
+ * @interface
+ */
+declare type UserAppConfigArgs = Record<string, string | string[]>;
+
 /**
  * A general user bounds change event without event type.
  * @interface
@@ -18775,6 +18799,32 @@ declare type WithPositioningOptions<T extends {} = {}> = T & {
     positioningOptions?: OpenFin_2.PositioningOptions;
 };
 
+declare type WithUserAppConfigArgs = {
+    /**
+     * Represents the key-value pairs for the parameters passed into any fin:// or fins:// link
+     * that launches this application.
+     *
+     * @remarks
+     * In the link, user defined parameters are separated by the `$$` delimeter, for example:
+     * `fins://path.to/app/manifest.json?$$use-last-configuration=true`
+     *
+     * Results in the following object:
+     * ```json
+     * {
+     *    "use-last-configuration": true"
+     * }
+     * ```
+     *
+     * These args can be accessed via the {@link ApplicationInfo.initialOptions} object:
+     * ```typescript
+     * const appInfo = await fin.Application.getCurrentSync().getInfo();
+     * const { userAppConfigArgs } = appInfo.initialOptions;
+     * console.log(userAppConfigArgs['use-last-configuration']); // 'true'
+     * ```
+     */
+    userAppConfigArgs?: UserAppConfigArgs;
+};
+
 /* Excluded from this release type: WorkspacePlatformOptions */
 
 /**

package/out/mock.d.ts

@@ -831,7 +831,7 @@ declare class Application extends EmitterBase<OpenFin_2.ApplicationEvent> {
      */
     showTrayIconPopupMenu<Data>(options: OpenFin_2.ShowTrayIconPopupMenuOptions<Data>): Promise<OpenFin_2.MenuResult<Data>>;
     /**
-     * CLoses the tray icon menu.
+     * Closes the tray icon menu.
      *
      * @throws if the application has no tray icon set
      * @example
@@ -940,7 +940,7 @@ declare type ApplicationIdentity_2 = {
  * @interface
  */
 declare type ApplicationInfo = {
-    initialOptions: ApplicationCreationOptions | PlatformOptions;
+    initialOptions: WithUserAppConfigArgs & (ApplicationCreationOptions | PlatformOptions);
     launchMode: string;
     manifest: Manifest & {
         [key: string]: any;
@@ -3491,6 +3491,13 @@ declare type ConstViewOptions = {
      * Initial bounds given relative to the window.
      */
     bounds: Bounds;
+    /**
+     * API permissions for code running in the view.
+     *
+     * @remarks Superseded by {@link DomainSettings.default.api.permissions} - if present, this setting will be **ignored**.
+     * It is recommended for users to migrate to a domain-based security model, since it is more natural to assign trust
+     * to the source of the page content than to the context rendering it.
+     */
     permissions: Partial<Permissions_2>;
     /**
      * String tag that attempts to group like-tagged renderers together. Will only be used if pages are on the same origin.
@@ -3691,6 +3698,13 @@ declare type ConstWindowOptions = {
      * The name of the window.
      */
     name: string;
+    /**
+     * API permissions for code running in the window.
+     *
+     * @remarks Superseded by {@link DomainSettings.default.api.permissions} - if present, this setting will be **ignored**.
+     * It is recommended for users to migrate to a domain-based security model, since it is more natural to assign trust
+     * to the source of the page content than to the context rendering it.
+     */
     permissions: Partial<Permissions_2>;
     /**
      * Scripts that run before page load.  When omitted, inherits from the parent application.
@@ -4771,6 +4785,10 @@ declare type DomainSettings = {
     rules: DomainSettingsRule[];
     /**
      * Default values for settings in {@link DomainSettingsRule}.
+     *
+     * @remarks If {@link PerDomainSettings.content} or {@link PerDomainSettings.api.fin} are given a default value
+     * here, they will supersede any equivalent functionality in {@link WindowOptions} or {@link ViewOptions}.  For
+     * more information, see the documentation for the individual properties.
      */
     default?: PerDomainSettings;
 };
@@ -10214,6 +10232,7 @@ declare namespace OpenFin_2 {
         AppVersionError,
         AppVersionRuntimeInfo,
         LaunchEmitter,
+        UserAppConfigArgs,
         RvmLaunchOptions,
         ShortCutConfig,
         TerminateExternalRequestType,
@@ -10523,7 +10542,7 @@ declare type PerDomainSettings = {
      * Whether DOM content can be loaded (by navigation or redirect).
      *
      * @remarks If this is included in {@link DomainSettings.default}, then {@link ContentNavigation} and
-     * {@link ContentRedirect} will be **ignored**.
+     * {@link ContentRedirect} in {@link WindowOptions} and {@link ViewOptions} will be **ignored**.
      */
     content?: ContentPermission;
 };
@@ -13118,7 +13137,7 @@ declare type RunRequestedEvent = OpenFin_2.ApplicationEvents.RunRequestedEvent;
 declare type RunRequestedEvent_2 = BaseEvents.IdentityEvent & {
     topic: 'application';
     type: 'run-requested';
-    userAppConfigArgs: Record<string, any>;
+    userAppConfigArgs: OpenFin_2.UserAppConfigArgs;
     manifest: OpenFin_2.Manifest;
 };
 
@@ -13233,7 +13252,7 @@ declare type RvmLaunchOptions = {
      * True if no UI when launching
      */
     noUi?: boolean;
-    userAppConfigArgs?: object;
+    userAppConfigArgs?: UserAppConfigArgs;
     /**
      * Timeout in seconds until RVM launch request expires.
      */
@@ -15775,6 +15794,11 @@ declare type UrlChangedEvent = BaseUrlEvent & ({
     httpStatusText: string;
 });
 
+/**
+ * @interface
+ */
+declare type UserAppConfigArgs = Record<string, string | string[]>;
+
 /**
  * A general user bounds change event without event type.
  * @interface
@@ -19227,6 +19251,32 @@ declare type WithPositioningOptions<T extends {} = {}> = T & {
     positioningOptions?: OpenFin_2.PositioningOptions;
 };
 
+declare type WithUserAppConfigArgs = {
+    /**
+     * Represents the key-value pairs for the parameters passed into any fin:// or fins:// link
+     * that launches this application.
+     *
+     * @remarks
+     * In the link, user defined parameters are separated by the `$$` delimeter, for example:
+     * `fins://path.to/app/manifest.json?$$use-last-configuration=true`
+     *
+     * Results in the following object:
+     * ```json
+     * {
+     *    "use-last-configuration": true"
+     * }
+     * ```
+     *
+     * These args can be accessed via the {@link ApplicationInfo.initialOptions} object:
+     * ```typescript
+     * const appInfo = await fin.Application.getCurrentSync().getInfo();
+     * const { userAppConfigArgs } = appInfo.initialOptions;
+     * console.log(userAppConfigArgs['use-last-configuration']); // 'true'
+     * ```
+     */
+    userAppConfigArgs?: UserAppConfigArgs;
+};
+
 /**
  * @internal
  * @interface

package/out/mock.js

@@ -4026,7 +4026,7 @@ function requireInstance$1 () {
 	        return payload.data;
 	    }
 	    /**
-	     * CLoses the tray icon menu.
+	     * Closes the tray icon menu.
 	     *
 	     * @throws if the application has no tray icon set
 	     * @example

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@openfin/core",
-    "version": "38.81.29",
+    "version": "38.81.31",
     "description": "The core renderer entry point of OpenFin",
     "license": "SEE LICENSE IN LICENSE.md",
     "main": "out/mock.js",