@openfin/core 38.81.24 → 38.81.30

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;
@@ -4521,6 +4521,17 @@ declare type DeviceInfo = {
     productId: string | number;
 };
 
+/**
+ * Permission string keys for device APIs
+ *
+ * @remarks We currently only support USB and HID devices.  Permissions for individual devices
+ * must be granted in {@link Permissions.devices}.
+ *
+ * `usb`: Access to one or more USB devices
+ * `hid : Access to one or more HID devices
+ */
+declare type DevicePermissionName = 'usb' | 'hid';
+
 /**
  * Generated when a page's theme color changes. This is usually due to encountering a meta tag.
  * @interface
@@ -9823,6 +9834,8 @@ declare namespace OpenFin_2 {
         ApplicationPermissions,
         LaunchExternalProcessRule,
         SystemPermissions,
+        DevicePermissionName,
+        WebPermissionName,
         WebPermission,
         VerboseWebPermission,
         OpenExternalPermission,
@@ -9886,6 +9899,7 @@ declare namespace OpenFin_2 {
         AppVersionError,
         AppVersionRuntimeInfo,
         LaunchEmitter,
+        UserAppConfigArgs,
         RvmLaunchOptions,
         ShortCutConfig,
         TerminateExternalRequestType,
@@ -12712,7 +12726,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;
 };
 
@@ -12827,7 +12841,7 @@ declare type RvmLaunchOptions = {
      * True if no UI when launching
      */
     noUi?: boolean;
-    userAppConfigArgs?: object;
+    userAppConfigArgs?: UserAppConfigArgs;
     /**
      * Timeout in seconds until RVM launch request expires.
      */
@@ -14629,8 +14643,13 @@ declare class System extends EmitterBase<OpenFin_2.SystemEvent> {
     launchManifest(manifestUrl: string, opts?: OpenFin_2.RvmLaunchOptions): Promise<OpenFin_2.Manifest>;
     /**
      * Query permission of a secured api in current context.
+     *
      * @param apiName - The full name of a secured API.
      *
+     * @remarks If a function has a structured permission value, the value of `granted` will reflect the `enabled` key
+     * of the call's permissions literal.  In this case, *permission may still be denied to a call* pending arguments or other
+     * runtime state.  This is indicated with `state: unavailable`.
+     *
      * @example
      * ```js
      * fin.System.queryPermissionForCurrentContext('System.launchExternalProcess').then(result => console.log(result)).catch(err => console.log(err));
@@ -15351,6 +15370,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
@@ -17205,18 +17229,38 @@ declare namespace WebContentsEvents {
  *
  * @remarks We only support those web APIs listed by electron.
  *
- * `audio`: Request access to audio devices.<br>
- * `video`: Request access to video devices.<br>
- * `geolocation`: Request access to user's current location.<br>
+ * `audio`: Access to audio devices.<br>
+ * `video`: Access to video devices.<br>
+ * `geolocation`: Access to user's current location.<br>
  * `notifications`: Request notification creation and the ability to display them in the user's system tray.<br>
- * `midiSysex`: Request the use of system exclusive messages in the webmidi API.<br>
- * `pointerLock`: Request to directly interpret mouse movements as an input method.<br>
- * `fullscreen`: Request for the app to enter fullscreen mode.<br>
- * `openExternal`: Request to open links in external applications.<br>
- * `clipboard-read`: Request access to read from the clipboard.<br>
- * `clipboard-sanitized-write`: Request access to write to the clipboard.
+ * `midiSysex`: Use of system exclusive messages in the webmidi API.<br>
+ * `pointerLock`: Access to mouse movements as an input method.<br>
+ * `fullscreen`: Access to fullscreen mode.<br>
+ * `openExternal`: Access to open links in external applications.<br>
+ * `clipboard-read`: Access to read from the clipboard.<br>
+ * `clipboard-sanitized-write`: Access to write to the clipboard.
+ * `usb`: Access to one or more USB devices
+ * `hid : Access to one or more HID devices
  */
-declare type WebPermission = 'audio' | 'video' | 'geolocation' | 'notifications' | 'midiSysex' | 'pointerLock' | 'fullscreen' | 'openExternal' | 'clipboard-read' | 'clipboard-sanitized-write' | 'hid' | 'usb' | OpenExternalPermission;
+declare type WebPermission = WebPermissionName | DevicePermissionName | OpenExternalPermission;
+
+/**
+ * Permission string keys for webAPIs
+ *
+ * @remarks We only support those web APIs listed by electron.
+ *
+ * `audio`: Access to audio devices.<br>
+ * `video`: Access to video devices.<br>
+ * `geolocation`: Access to user's current location.<br>
+ * `notifications`: Request notification creation and the ability to display them in the user's system tray.<br>
+ * `midiSysex`: Use of system exclusive messages in the webmidi API.<br>
+ * `pointerLock`: Access to mouse movements as an input method.<br>
+ * `fullscreen`: Access to fullscreen mode.<br>
+ * `openExternal`: Access to open links in external applications.<br>
+ * `clipboard-read`: Access to read from the clipboard.<br>
+ * `clipboard-sanitized-write`: Access to write to the clipboard.
+ */
+declare type WebPermissionName = 'audio' | 'video' | 'geolocation' | 'notifications' | 'midiSysex' | 'pointerLock' | 'fullscreen' | 'openExternal' | 'clipboard-read' | 'clipboard-sanitized-write';
 
 /**
  * Object representing headers and their values, where the
@@ -18737,6 +18781,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;
@@ -4521,6 +4521,17 @@ declare type DeviceInfo = {
     productId: string | number;
 };
 
+/**
+ * Permission string keys for device APIs
+ *
+ * @remarks We currently only support USB and HID devices.  Permissions for individual devices
+ * must be granted in {@link Permissions.devices}.
+ *
+ * `usb`: Access to one or more USB devices
+ * `hid : Access to one or more HID devices
+ */
+declare type DevicePermissionName = 'usb' | 'hid';
+
 /**
  * Generated when a page's theme color changes. This is usually due to encountering a meta tag.
  * @interface
@@ -9823,6 +9834,8 @@ declare namespace OpenFin_2 {
         ApplicationPermissions,
         LaunchExternalProcessRule,
         SystemPermissions,
+        DevicePermissionName,
+        WebPermissionName,
         WebPermission,
         VerboseWebPermission,
         OpenExternalPermission,
@@ -9886,6 +9899,7 @@ declare namespace OpenFin_2 {
         AppVersionError,
         AppVersionRuntimeInfo,
         LaunchEmitter,
+        UserAppConfigArgs,
         RvmLaunchOptions,
         ShortCutConfig,
         TerminateExternalRequestType,
@@ -12712,7 +12726,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;
 };
 
@@ -12827,7 +12841,7 @@ declare type RvmLaunchOptions = {
      * True if no UI when launching
      */
     noUi?: boolean;
-    userAppConfigArgs?: object;
+    userAppConfigArgs?: UserAppConfigArgs;
     /**
      * Timeout in seconds until RVM launch request expires.
      */
@@ -14629,8 +14643,13 @@ declare class System extends EmitterBase<OpenFin_2.SystemEvent> {
     launchManifest(manifestUrl: string, opts?: OpenFin_2.RvmLaunchOptions): Promise<OpenFin_2.Manifest>;
     /**
      * Query permission of a secured api in current context.
+     *
      * @param apiName - The full name of a secured API.
      *
+     * @remarks If a function has a structured permission value, the value of `granted` will reflect the `enabled` key
+     * of the call's permissions literal.  In this case, *permission may still be denied to a call* pending arguments or other
+     * runtime state.  This is indicated with `state: unavailable`.
+     *
      * @example
      * ```js
      * fin.System.queryPermissionForCurrentContext('System.launchExternalProcess').then(result => console.log(result)).catch(err => console.log(err));
@@ -15351,6 +15370,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
@@ -17205,18 +17229,38 @@ declare namespace WebContentsEvents {
  *
  * @remarks We only support those web APIs listed by electron.
  *
- * `audio`: Request access to audio devices.<br>
- * `video`: Request access to video devices.<br>
- * `geolocation`: Request access to user's current location.<br>
+ * `audio`: Access to audio devices.<br>
+ * `video`: Access to video devices.<br>
+ * `geolocation`: Access to user's current location.<br>
  * `notifications`: Request notification creation and the ability to display them in the user's system tray.<br>
- * `midiSysex`: Request the use of system exclusive messages in the webmidi API.<br>
- * `pointerLock`: Request to directly interpret mouse movements as an input method.<br>
- * `fullscreen`: Request for the app to enter fullscreen mode.<br>
- * `openExternal`: Request to open links in external applications.<br>
- * `clipboard-read`: Request access to read from the clipboard.<br>
- * `clipboard-sanitized-write`: Request access to write to the clipboard.
+ * `midiSysex`: Use of system exclusive messages in the webmidi API.<br>
+ * `pointerLock`: Access to mouse movements as an input method.<br>
+ * `fullscreen`: Access to fullscreen mode.<br>
+ * `openExternal`: Access to open links in external applications.<br>
+ * `clipboard-read`: Access to read from the clipboard.<br>
+ * `clipboard-sanitized-write`: Access to write to the clipboard.
+ * `usb`: Access to one or more USB devices
+ * `hid : Access to one or more HID devices
  */
-declare type WebPermission = 'audio' | 'video' | 'geolocation' | 'notifications' | 'midiSysex' | 'pointerLock' | 'fullscreen' | 'openExternal' | 'clipboard-read' | 'clipboard-sanitized-write' | 'hid' | 'usb' | OpenExternalPermission;
+declare type WebPermission = WebPermissionName | DevicePermissionName | OpenExternalPermission;
+
+/**
+ * Permission string keys for webAPIs
+ *
+ * @remarks We only support those web APIs listed by electron.
+ *
+ * `audio`: Access to audio devices.<br>
+ * `video`: Access to video devices.<br>
+ * `geolocation`: Access to user's current location.<br>
+ * `notifications`: Request notification creation and the ability to display them in the user's system tray.<br>
+ * `midiSysex`: Use of system exclusive messages in the webmidi API.<br>
+ * `pointerLock`: Access to mouse movements as an input method.<br>
+ * `fullscreen`: Access to fullscreen mode.<br>
+ * `openExternal`: Access to open links in external applications.<br>
+ * `clipboard-read`: Access to read from the clipboard.<br>
+ * `clipboard-sanitized-write`: Access to write to the clipboard.
+ */
+declare type WebPermissionName = 'audio' | 'video' | 'geolocation' | 'notifications' | 'midiSysex' | 'pointerLock' | 'fullscreen' | 'openExternal' | 'clipboard-read' | 'clipboard-sanitized-write';
 
 /**
  * Object representing headers and their values, where the
@@ -18737,6 +18781,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;
@@ -4521,6 +4521,17 @@ declare type DeviceInfo = {
     productId: string | number;
 };
 
+/**
+ * Permission string keys for device APIs
+ *
+ * @remarks We currently only support USB and HID devices.  Permissions for individual devices
+ * must be granted in {@link Permissions.devices}.
+ *
+ * `usb`: Access to one or more USB devices
+ * `hid : Access to one or more HID devices
+ */
+declare type DevicePermissionName = 'usb' | 'hid';
+
 /**
  * Generated when a page's theme color changes. This is usually due to encountering a meta tag.
  * @interface
@@ -9823,6 +9834,8 @@ declare namespace OpenFin_2 {
         ApplicationPermissions,
         LaunchExternalProcessRule,
         SystemPermissions,
+        DevicePermissionName,
+        WebPermissionName,
         WebPermission,
         VerboseWebPermission,
         OpenExternalPermission,
@@ -9886,6 +9899,7 @@ declare namespace OpenFin_2 {
         AppVersionError,
         AppVersionRuntimeInfo,
         LaunchEmitter,
+        UserAppConfigArgs,
         RvmLaunchOptions,
         ShortCutConfig,
         TerminateExternalRequestType,
@@ -12712,7 +12726,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;
 };
 
@@ -12827,7 +12841,7 @@ declare type RvmLaunchOptions = {
      * True if no UI when launching
      */
     noUi?: boolean;
-    userAppConfigArgs?: object;
+    userAppConfigArgs?: UserAppConfigArgs;
     /**
      * Timeout in seconds until RVM launch request expires.
      */
@@ -14629,8 +14643,13 @@ declare class System extends EmitterBase<OpenFin_2.SystemEvent> {
     launchManifest(manifestUrl: string, opts?: OpenFin_2.RvmLaunchOptions): Promise<OpenFin_2.Manifest>;
     /**
      * Query permission of a secured api in current context.
+     *
      * @param apiName - The full name of a secured API.
      *
+     * @remarks If a function has a structured permission value, the value of `granted` will reflect the `enabled` key
+     * of the call's permissions literal.  In this case, *permission may still be denied to a call* pending arguments or other
+     * runtime state.  This is indicated with `state: unavailable`.
+     *
      * @example
      * ```js
      * fin.System.queryPermissionForCurrentContext('System.launchExternalProcess').then(result => console.log(result)).catch(err => console.log(err));
@@ -15351,6 +15370,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
@@ -17205,18 +17229,38 @@ declare namespace WebContentsEvents {
  *
  * @remarks We only support those web APIs listed by electron.
  *
- * `audio`: Request access to audio devices.<br>
- * `video`: Request access to video devices.<br>
- * `geolocation`: Request access to user's current location.<br>
+ * `audio`: Access to audio devices.<br>
+ * `video`: Access to video devices.<br>
+ * `geolocation`: Access to user's current location.<br>
  * `notifications`: Request notification creation and the ability to display them in the user's system tray.<br>
- * `midiSysex`: Request the use of system exclusive messages in the webmidi API.<br>
- * `pointerLock`: Request to directly interpret mouse movements as an input method.<br>
- * `fullscreen`: Request for the app to enter fullscreen mode.<br>
- * `openExternal`: Request to open links in external applications.<br>
- * `clipboard-read`: Request access to read from the clipboard.<br>
- * `clipboard-sanitized-write`: Request access to write to the clipboard.
+ * `midiSysex`: Use of system exclusive messages in the webmidi API.<br>
+ * `pointerLock`: Access to mouse movements as an input method.<br>
+ * `fullscreen`: Access to fullscreen mode.<br>
+ * `openExternal`: Access to open links in external applications.<br>
+ * `clipboard-read`: Access to read from the clipboard.<br>
+ * `clipboard-sanitized-write`: Access to write to the clipboard.
+ * `usb`: Access to one or more USB devices
+ * `hid : Access to one or more HID devices
  */
-declare type WebPermission = 'audio' | 'video' | 'geolocation' | 'notifications' | 'midiSysex' | 'pointerLock' | 'fullscreen' | 'openExternal' | 'clipboard-read' | 'clipboard-sanitized-write' | 'hid' | 'usb' | OpenExternalPermission;
+declare type WebPermission = WebPermissionName | DevicePermissionName | OpenExternalPermission;
+
+/**
+ * Permission string keys for webAPIs
+ *
+ * @remarks We only support those web APIs listed by electron.
+ *
+ * `audio`: Access to audio devices.<br>
+ * `video`: Access to video devices.<br>
+ * `geolocation`: Access to user's current location.<br>
+ * `notifications`: Request notification creation and the ability to display them in the user's system tray.<br>
+ * `midiSysex`: Use of system exclusive messages in the webmidi API.<br>
+ * `pointerLock`: Access to mouse movements as an input method.<br>
+ * `fullscreen`: Access to fullscreen mode.<br>
+ * `openExternal`: Access to open links in external applications.<br>
+ * `clipboard-read`: Access to read from the clipboard.<br>
+ * `clipboard-sanitized-write`: Access to write to the clipboard.
+ */
+declare type WebPermissionName = 'audio' | 'video' | 'geolocation' | 'notifications' | 'midiSysex' | 'pointerLock' | 'fullscreen' | 'openExternal' | 'clipboard-read' | 'clipboard-sanitized-write';
 
 /**
  * Object representing headers and their values, where the
@@ -18737,6 +18781,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;
@@ -4580,6 +4580,17 @@ declare type DeviceInfo = {
     productId: string | number;
 };
 
+/**
+ * Permission string keys for device APIs
+ *
+ * @remarks We currently only support USB and HID devices.  Permissions for individual devices
+ * must be granted in {@link Permissions.devices}.
+ *
+ * `usb`: Access to one or more USB devices
+ * `hid : Access to one or more HID devices
+ */
+declare type DevicePermissionName = 'usb' | 'hid';
+
 /**
  * Generated when a page's theme color changes. This is usually due to encountering a meta tag.
  * @interface
@@ -10138,6 +10149,8 @@ declare namespace OpenFin_2 {
         ApplicationPermissions,
         LaunchExternalProcessRule,
         SystemPermissions,
+        DevicePermissionName,
+        WebPermissionName,
         WebPermission,
         VerboseWebPermission,
         OpenExternalPermission,
@@ -10201,6 +10214,7 @@ declare namespace OpenFin_2 {
         AppVersionError,
         AppVersionRuntimeInfo,
         LaunchEmitter,
+        UserAppConfigArgs,
         RvmLaunchOptions,
         ShortCutConfig,
         TerminateExternalRequestType,
@@ -13105,7 +13119,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;
 };
 
@@ -13220,7 +13234,7 @@ declare type RvmLaunchOptions = {
      * True if no UI when launching
      */
     noUi?: boolean;
-    userAppConfigArgs?: object;
+    userAppConfigArgs?: UserAppConfigArgs;
     /**
      * Timeout in seconds until RVM launch request expires.
      */
@@ -15028,8 +15042,13 @@ declare class System extends EmitterBase<OpenFin_2.SystemEvent> {
     launchManifest(manifestUrl: string, opts?: OpenFin_2.RvmLaunchOptions): Promise<OpenFin_2.Manifest>;
     /**
      * Query permission of a secured api in current context.
+     *
      * @param apiName - The full name of a secured API.
      *
+     * @remarks If a function has a structured permission value, the value of `granted` will reflect the `enabled` key
+     * of the call's permissions literal.  In this case, *permission may still be denied to a call* pending arguments or other
+     * runtime state.  This is indicated with `state: unavailable`.
+     *
      * @example
      * ```js
      * fin.System.queryPermissionForCurrentContext('System.launchExternalProcess').then(result => console.log(result)).catch(err => console.log(err));
@@ -15757,6 +15776,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
@@ -17648,18 +17672,38 @@ declare namespace WebContentsEvents {
  *
  * @remarks We only support those web APIs listed by electron.
  *
- * `audio`: Request access to audio devices.<br>
- * `video`: Request access to video devices.<br>
- * `geolocation`: Request access to user's current location.<br>
+ * `audio`: Access to audio devices.<br>
+ * `video`: Access to video devices.<br>
+ * `geolocation`: Access to user's current location.<br>
  * `notifications`: Request notification creation and the ability to display them in the user's system tray.<br>
- * `midiSysex`: Request the use of system exclusive messages in the webmidi API.<br>
- * `pointerLock`: Request to directly interpret mouse movements as an input method.<br>
- * `fullscreen`: Request for the app to enter fullscreen mode.<br>
- * `openExternal`: Request to open links in external applications.<br>
- * `clipboard-read`: Request access to read from the clipboard.<br>
- * `clipboard-sanitized-write`: Request access to write to the clipboard.
+ * `midiSysex`: Use of system exclusive messages in the webmidi API.<br>
+ * `pointerLock`: Access to mouse movements as an input method.<br>
+ * `fullscreen`: Access to fullscreen mode.<br>
+ * `openExternal`: Access to open links in external applications.<br>
+ * `clipboard-read`: Access to read from the clipboard.<br>
+ * `clipboard-sanitized-write`: Access to write to the clipboard.
+ * `usb`: Access to one or more USB devices
+ * `hid : Access to one or more HID devices
  */
-declare type WebPermission = 'audio' | 'video' | 'geolocation' | 'notifications' | 'midiSysex' | 'pointerLock' | 'fullscreen' | 'openExternal' | 'clipboard-read' | 'clipboard-sanitized-write' | 'hid' | 'usb' | OpenExternalPermission;
+declare type WebPermission = WebPermissionName | DevicePermissionName | OpenExternalPermission;
+
+/**
+ * Permission string keys for webAPIs
+ *
+ * @remarks We only support those web APIs listed by electron.
+ *
+ * `audio`: Access to audio devices.<br>
+ * `video`: Access to video devices.<br>
+ * `geolocation`: Access to user's current location.<br>
+ * `notifications`: Request notification creation and the ability to display them in the user's system tray.<br>
+ * `midiSysex`: Use of system exclusive messages in the webmidi API.<br>
+ * `pointerLock`: Access to mouse movements as an input method.<br>
+ * `fullscreen`: Access to fullscreen mode.<br>
+ * `openExternal`: Access to open links in external applications.<br>
+ * `clipboard-read`: Access to read from the clipboard.<br>
+ * `clipboard-sanitized-write`: Access to write to the clipboard.
+ */
+declare type WebPermissionName = 'audio' | 'video' | 'geolocation' | 'notifications' | 'midiSysex' | 'pointerLock' | 'fullscreen' | 'openExternal' | 'clipboard-read' | 'clipboard-sanitized-write';
 
 /**
  * Object representing headers and their values, where the
@@ -19189,6 +19233,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
@@ -7500,8 +7500,13 @@ class System extends base_1$i.EmitterBase {
     }
     /**
      * Query permission of a secured api in current context.
+     *
      * @param apiName - The full name of a secured API.
      *
+     * @remarks If a function has a structured permission value, the value of `granted` will reflect the `enabled` key
+     * of the call's permissions literal.  In this case, *permission may still be denied to a call* pending arguments or other
+     * runtime state.  This is indicated with `state: unavailable`.
+     *
      * @example
      * ```js
      * fin.System.queryPermissionForCurrentContext('System.launchExternalProcess').then(result => console.log(result)).catch(err => console.log(err));

package/package.json

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