@openfin/fdc3-api 46.100.5 → 46.100.6

package/out/fdc3-api-alpha.d.ts

@@ -14077,6 +14077,9 @@ declare type ProtocolMap = ExternalAdapterOnlyCallsMap & AnalyticsProtocolMap &
         namespace: 'System';
     };
     'register-usage': ApiCall<OpenFin.RegisterUsageData, void>;
+    'register-usage-batch': ApiCall<{
+        items: OpenFin.RegisterUsageData[];
+    }, void>;
     'system-get-printers': GetterCall<OpenFin.PrinterInfo[]>;
     'system-update-process-logging-options': ApiCall<{
         options: OpenFin.ProcessLoggingOptions;
@@ -15439,13 +15442,8 @@ declare type SubscriptionOptions = {
     timestamp?: number;
 };
 
-/**
- * An object representing the core of OpenFin Runtime. Allows the developer
- * to perform system-level actions, such as accessing logs, viewing processes,
- * clearing the cache and exiting the runtime as well as listen to {@link OpenFin.SystemEvents system events}.
- *
- */
 declare class System extends EmitterBase<OpenFin.SystemEvent> {
+    #private;
     /**
      * Chromium content tracing APIs.
      */
@@ -16793,30 +16791,41 @@ declare class System extends EmitterBase<OpenFin.SystemEvent> {
     queryPermissionForCurrentContext(apiName: string): Promise<OpenFin.QueryPermissionResult>;
     enableNativeWindowIntegrationProvider(permissions: any): Promise<OpenFin.NativeWindowIntegrationProviderAuthorization>;
     /**
-     * (Internal) Register the usage of a component with a platform
-     * @param options - Object with data and type
+     * (Internal) Register the usage of a component with a platform.
+     *
+     * @param options - Object with `data` and `type`.
+     *
+     * @remarks
+     * **This method never throws.** All errors — including IPC failures, RVM timeouts, and
+     * serialization errors — are caught internally and logged at `debug` level. Usage tracking
+     * must never break the calling feature.
+     *
+     * Calls are automatically deduplicated client-side for the lifetime of the current window
+     * (i.e. until the window is closed or the page is reloaded). The first call with a given
+     * `type` + `data` combination is forwarded to the Runtime as normal. Any subsequent call
+     * with the same `type` and `data` values within the same window lifetime is silently
+     * suppressed without making an IPC round-trip.
+     *
+     * If `data` cannot be serialized to JSON (for example, a circular reference), deduplication
+     * is skipped for that call and the IPC call is still forwarded unconditionally.
      *
      * @example
      * ```js
-     * async function registerUsage() {
-     *     const app = await fin.System.getCurrent();
-     *     return await fin.System.registerUsage({
-     *         type: 'workspace-licensing',
-     *         // example values for the following data object
-     *         data: {
-     *             apiVersion: '1.0',
-     *             componentName: 'home',
-     *             componentVersion: '1.0',
-     *             allowed: true,
-     *             rejectionCode: ''
-     *         }
-     *     });
-     * }
-     *
-     * registerUsage().then(() => console.log('Successfully registered component application')).catch(err => console.log(err));
+     * // Safe to fire-and-forget — will never throw or reject.
+     * // Duplicate calls within the same window lifetime are suppressed automatically.
+     * fin.System.registerUsage({
+     *     type: 'workspace-licensing',
+     *     data: {
+     *         apiVersion: '1.0',
+     *         componentName: 'home',
+     *         componentVersion: '1.0',
+     *         allowed: true,
+     *         rejectionCode: ''
+     *     }
+     * });
      * ```
      */
-    registerUsage({ data, type }: OpenFin.RegisterUsageData): Promise<void>;
+    registerUsage({ data, type }: OpenFin.RegisterUsageData): void;
     /**
      * Returns an array with all printers of the caller and not all the printers on the desktop.
      *

package/out/fdc3-api-beta.d.ts

@@ -14077,6 +14077,9 @@ declare type ProtocolMap = ExternalAdapterOnlyCallsMap & AnalyticsProtocolMap &
         namespace: 'System';
     };
     'register-usage': ApiCall<OpenFin.RegisterUsageData, void>;
+    'register-usage-batch': ApiCall<{
+        items: OpenFin.RegisterUsageData[];
+    }, void>;
     'system-get-printers': GetterCall<OpenFin.PrinterInfo[]>;
     'system-update-process-logging-options': ApiCall<{
         options: OpenFin.ProcessLoggingOptions;
@@ -15439,13 +15442,8 @@ declare type SubscriptionOptions = {
     timestamp?: number;
 };
 
-/**
- * An object representing the core of OpenFin Runtime. Allows the developer
- * to perform system-level actions, such as accessing logs, viewing processes,
- * clearing the cache and exiting the runtime as well as listen to {@link OpenFin.SystemEvents system events}.
- *
- */
 declare class System extends EmitterBase<OpenFin.SystemEvent> {
+    #private;
     /**
      * Chromium content tracing APIs.
      */
@@ -16793,30 +16791,41 @@ declare class System extends EmitterBase<OpenFin.SystemEvent> {
     queryPermissionForCurrentContext(apiName: string): Promise<OpenFin.QueryPermissionResult>;
     enableNativeWindowIntegrationProvider(permissions: any): Promise<OpenFin.NativeWindowIntegrationProviderAuthorization>;
     /**
-     * (Internal) Register the usage of a component with a platform
-     * @param options - Object with data and type
+     * (Internal) Register the usage of a component with a platform.
+     *
+     * @param options - Object with `data` and `type`.
+     *
+     * @remarks
+     * **This method never throws.** All errors — including IPC failures, RVM timeouts, and
+     * serialization errors — are caught internally and logged at `debug` level. Usage tracking
+     * must never break the calling feature.
+     *
+     * Calls are automatically deduplicated client-side for the lifetime of the current window
+     * (i.e. until the window is closed or the page is reloaded). The first call with a given
+     * `type` + `data` combination is forwarded to the Runtime as normal. Any subsequent call
+     * with the same `type` and `data` values within the same window lifetime is silently
+     * suppressed without making an IPC round-trip.
+     *
+     * If `data` cannot be serialized to JSON (for example, a circular reference), deduplication
+     * is skipped for that call and the IPC call is still forwarded unconditionally.
      *
      * @example
      * ```js
-     * async function registerUsage() {
-     *     const app = await fin.System.getCurrent();
-     *     return await fin.System.registerUsage({
-     *         type: 'workspace-licensing',
-     *         // example values for the following data object
-     *         data: {
-     *             apiVersion: '1.0',
-     *             componentName: 'home',
-     *             componentVersion: '1.0',
-     *             allowed: true,
-     *             rejectionCode: ''
-     *         }
-     *     });
-     * }
-     *
-     * registerUsage().then(() => console.log('Successfully registered component application')).catch(err => console.log(err));
+     * // Safe to fire-and-forget — will never throw or reject.
+     * // Duplicate calls within the same window lifetime are suppressed automatically.
+     * fin.System.registerUsage({
+     *     type: 'workspace-licensing',
+     *     data: {
+     *         apiVersion: '1.0',
+     *         componentName: 'home',
+     *         componentVersion: '1.0',
+     *         allowed: true,
+     *         rejectionCode: ''
+     *     }
+     * });
      * ```
      */
-    registerUsage({ data, type }: OpenFin.RegisterUsageData): Promise<void>;
+    registerUsage({ data, type }: OpenFin.RegisterUsageData): void;
     /**
      * Returns an array with all printers of the caller and not all the printers on the desktop.
      *

package/out/fdc3-api-public.d.ts

@@ -14077,6 +14077,9 @@ declare type ProtocolMap = ExternalAdapterOnlyCallsMap & AnalyticsProtocolMap &
         namespace: 'System';
     };
     'register-usage': ApiCall<OpenFin.RegisterUsageData, void>;
+    'register-usage-batch': ApiCall<{
+        items: OpenFin.RegisterUsageData[];
+    }, void>;
     'system-get-printers': GetterCall<OpenFin.PrinterInfo[]>;
     'system-update-process-logging-options': ApiCall<{
         options: OpenFin.ProcessLoggingOptions;
@@ -15439,13 +15442,8 @@ declare type SubscriptionOptions = {
     timestamp?: number;
 };
 
-/**
- * An object representing the core of OpenFin Runtime. Allows the developer
- * to perform system-level actions, such as accessing logs, viewing processes,
- * clearing the cache and exiting the runtime as well as listen to {@link OpenFin.SystemEvents system events}.
- *
- */
 declare class System extends EmitterBase<OpenFin.SystemEvent> {
+    #private;
     /**
      * Chromium content tracing APIs.
      */
@@ -16793,30 +16791,41 @@ declare class System extends EmitterBase<OpenFin.SystemEvent> {
     queryPermissionForCurrentContext(apiName: string): Promise<OpenFin.QueryPermissionResult>;
     enableNativeWindowIntegrationProvider(permissions: any): Promise<OpenFin.NativeWindowIntegrationProviderAuthorization>;
     /**
-     * (Internal) Register the usage of a component with a platform
-     * @param options - Object with data and type
+     * (Internal) Register the usage of a component with a platform.
+     *
+     * @param options - Object with `data` and `type`.
+     *
+     * @remarks
+     * **This method never throws.** All errors — including IPC failures, RVM timeouts, and
+     * serialization errors — are caught internally and logged at `debug` level. Usage tracking
+     * must never break the calling feature.
+     *
+     * Calls are automatically deduplicated client-side for the lifetime of the current window
+     * (i.e. until the window is closed or the page is reloaded). The first call with a given
+     * `type` + `data` combination is forwarded to the Runtime as normal. Any subsequent call
+     * with the same `type` and `data` values within the same window lifetime is silently
+     * suppressed without making an IPC round-trip.
+     *
+     * If `data` cannot be serialized to JSON (for example, a circular reference), deduplication
+     * is skipped for that call and the IPC call is still forwarded unconditionally.
      *
      * @example
      * ```js
-     * async function registerUsage() {
-     *     const app = await fin.System.getCurrent();
-     *     return await fin.System.registerUsage({
-     *         type: 'workspace-licensing',
-     *         // example values for the following data object
-     *         data: {
-     *             apiVersion: '1.0',
-     *             componentName: 'home',
-     *             componentVersion: '1.0',
-     *             allowed: true,
-     *             rejectionCode: ''
-     *         }
-     *     });
-     * }
-     *
-     * registerUsage().then(() => console.log('Successfully registered component application')).catch(err => console.log(err));
+     * // Safe to fire-and-forget — will never throw or reject.
+     * // Duplicate calls within the same window lifetime are suppressed automatically.
+     * fin.System.registerUsage({
+     *     type: 'workspace-licensing',
+     *     data: {
+     *         apiVersion: '1.0',
+     *         componentName: 'home',
+     *         componentVersion: '1.0',
+     *         allowed: true,
+     *         rejectionCode: ''
+     *     }
+     * });
      * ```
      */
-    registerUsage({ data, type }: OpenFin.RegisterUsageData): Promise<void>;
+    registerUsage({ data, type }: OpenFin.RegisterUsageData): void;
     /**
      * Returns an array with all printers of the caller and not all the printers on the desktop.
      *

package/out/fdc3-api.d.ts

@@ -14494,6 +14494,9 @@ declare type ProtocolMap = ExternalAdapterOnlyCallsMap & AnalyticsProtocolMap &
         namespace: 'System';
     };
     'register-usage': ApiCall<OpenFin.RegisterUsageData, void>;
+    'register-usage-batch': ApiCall<{
+        items: OpenFin.RegisterUsageData[];
+    }, void>;
     'system-get-printers': GetterCall<OpenFin.PrinterInfo[]>;
     'system-update-process-logging-options': ApiCall<{
         options: OpenFin.ProcessLoggingOptions;
@@ -15859,13 +15862,8 @@ declare type SubscriptionOptions = {
     timestamp?: number;
 };
 
-/**
- * An object representing the core of OpenFin Runtime. Allows the developer
- * to perform system-level actions, such as accessing logs, viewing processes,
- * clearing the cache and exiting the runtime as well as listen to {@link OpenFin.SystemEvents system events}.
- *
- */
 declare class System extends EmitterBase<OpenFin.SystemEvent> {
+    #private;
     /**
      * Chromium content tracing APIs.
      */
@@ -17216,30 +17214,41 @@ declare class System extends EmitterBase<OpenFin.SystemEvent> {
     queryPermissionForCurrentContext(apiName: string): Promise<OpenFin.QueryPermissionResult>;
     enableNativeWindowIntegrationProvider(permissions: any): Promise<OpenFin.NativeWindowIntegrationProviderAuthorization>;
     /**
-     * (Internal) Register the usage of a component with a platform
-     * @param options - Object with data and type
+     * (Internal) Register the usage of a component with a platform.
+     *
+     * @param options - Object with `data` and `type`.
+     *
+     * @remarks
+     * **This method never throws.** All errors — including IPC failures, RVM timeouts, and
+     * serialization errors — are caught internally and logged at `debug` level. Usage tracking
+     * must never break the calling feature.
+     *
+     * Calls are automatically deduplicated client-side for the lifetime of the current window
+     * (i.e. until the window is closed or the page is reloaded). The first call with a given
+     * `type` + `data` combination is forwarded to the Runtime as normal. Any subsequent call
+     * with the same `type` and `data` values within the same window lifetime is silently
+     * suppressed without making an IPC round-trip.
+     *
+     * If `data` cannot be serialized to JSON (for example, a circular reference), deduplication
+     * is skipped for that call and the IPC call is still forwarded unconditionally.
      *
      * @example
      * ```js
-     * async function registerUsage() {
-     *     const app = await fin.System.getCurrent();
-     *     return await fin.System.registerUsage({
-     *         type: 'workspace-licensing',
-     *         // example values for the following data object
-     *         data: {
-     *             apiVersion: '1.0',
-     *             componentName: 'home',
-     *             componentVersion: '1.0',
-     *             allowed: true,
-     *             rejectionCode: ''
-     *         }
-     *     });
-     * }
-     *
-     * registerUsage().then(() => console.log('Successfully registered component application')).catch(err => console.log(err));
+     * // Safe to fire-and-forget — will never throw or reject.
+     * // Duplicate calls within the same window lifetime are suppressed automatically.
+     * fin.System.registerUsage({
+     *     type: 'workspace-licensing',
+     *     data: {
+     *         apiVersion: '1.0',
+     *         componentName: 'home',
+     *         componentVersion: '1.0',
+     *         allowed: true,
+     *         rejectionCode: ''
+     *     }
+     * });
      * ```
      */
-    registerUsage({ data, type }: OpenFin.RegisterUsageData): Promise<void>;
+    registerUsage({ data, type }: OpenFin.RegisterUsageData): void;
     /**
      * Returns an array with all printers of the caller and not all the printers on the desktop.
      *

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openfin/fdc3-api",
-  "version": "46.100.5",
+  "version": "46.100.6",
   "description": "OpenFin fdc3 module utilities and types.",
   "license": "SEE LICENSE IN LICENSE.md",
   "private": false,