@openfin/core 45.100.94 → 45.100.95

package/out/mock-alpha.d.ts

@@ -13737,6 +13737,9 @@ declare type ProtocolMap = ExternalAdapterOnlyCallsMap & AnalyticsProtocolMap &
         namespace: 'System';
     };
     'register-usage': ApiCall<OpenFin_2.RegisterUsageData, void>;
+    'register-usage-batch': ApiCall<{
+        items: OpenFin_2.RegisterUsageData[];
+    }, void>;
     'system-get-printers': GetterCall<OpenFin_2.PrinterInfo[]>;
     'system-update-process-logging-options': ApiCall<{
         options: OpenFin_2.ProcessLoggingOptions;
@@ -15099,13 +15102,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_2.SystemEvent> {
+    #private;
     /**
      * Chromium content tracing APIs.
      */
@@ -16453,30 +16451,41 @@ declare class System extends EmitterBase<OpenFin_2.SystemEvent> {
     queryPermissionForCurrentContext(apiName: string): Promise<OpenFin_2.QueryPermissionResult>;
     enableNativeWindowIntegrationProvider(permissions: any): Promise<OpenFin_2.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_2.RegisterUsageData): Promise<void>;
+    registerUsage({ data, type }: OpenFin_2.RegisterUsageData): void;
     /**
      * Returns an array with all printers of the caller and not all the printers on the desktop.
      *

package/out/mock-beta.d.ts

@@ -13737,6 +13737,9 @@ declare type ProtocolMap = ExternalAdapterOnlyCallsMap & AnalyticsProtocolMap &
         namespace: 'System';
     };
     'register-usage': ApiCall<OpenFin_2.RegisterUsageData, void>;
+    'register-usage-batch': ApiCall<{
+        items: OpenFin_2.RegisterUsageData[];
+    }, void>;
     'system-get-printers': GetterCall<OpenFin_2.PrinterInfo[]>;
     'system-update-process-logging-options': ApiCall<{
         options: OpenFin_2.ProcessLoggingOptions;
@@ -15099,13 +15102,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_2.SystemEvent> {
+    #private;
     /**
      * Chromium content tracing APIs.
      */
@@ -16453,30 +16451,41 @@ declare class System extends EmitterBase<OpenFin_2.SystemEvent> {
     queryPermissionForCurrentContext(apiName: string): Promise<OpenFin_2.QueryPermissionResult>;
     enableNativeWindowIntegrationProvider(permissions: any): Promise<OpenFin_2.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_2.RegisterUsageData): Promise<void>;
+    registerUsage({ data, type }: OpenFin_2.RegisterUsageData): void;
     /**
      * Returns an array with all printers of the caller and not all the printers on the desktop.
      *

package/out/mock-public.d.ts

@@ -13737,6 +13737,9 @@ declare type ProtocolMap = ExternalAdapterOnlyCallsMap & AnalyticsProtocolMap &
         namespace: 'System';
     };
     'register-usage': ApiCall<OpenFin_2.RegisterUsageData, void>;
+    'register-usage-batch': ApiCall<{
+        items: OpenFin_2.RegisterUsageData[];
+    }, void>;
     'system-get-printers': GetterCall<OpenFin_2.PrinterInfo[]>;
     'system-update-process-logging-options': ApiCall<{
         options: OpenFin_2.ProcessLoggingOptions;
@@ -15099,13 +15102,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_2.SystemEvent> {
+    #private;
     /**
      * Chromium content tracing APIs.
      */
@@ -16453,30 +16451,41 @@ declare class System extends EmitterBase<OpenFin_2.SystemEvent> {
     queryPermissionForCurrentContext(apiName: string): Promise<OpenFin_2.QueryPermissionResult>;
     enableNativeWindowIntegrationProvider(permissions: any): Promise<OpenFin_2.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_2.RegisterUsageData): Promise<void>;
+    registerUsage({ data, type }: OpenFin_2.RegisterUsageData): void;
     /**
      * Returns an array with all printers of the caller and not all the printers on the desktop.
      *

package/out/stub.d.ts

@@ -14154,6 +14154,9 @@ declare type ProtocolMap = ExternalAdapterOnlyCallsMap & AnalyticsProtocolMap &
         namespace: 'System';
     };
     'register-usage': ApiCall<OpenFin_2.RegisterUsageData, void>;
+    'register-usage-batch': ApiCall<{
+        items: OpenFin_2.RegisterUsageData[];
+    }, void>;
     'system-get-printers': GetterCall<OpenFin_2.PrinterInfo[]>;
     'system-update-process-logging-options': ApiCall<{
         options: OpenFin_2.ProcessLoggingOptions;
@@ -15519,13 +15522,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_2.SystemEvent> {
+    #private;
     /**
      * Chromium content tracing APIs.
      */
@@ -16876,30 +16874,41 @@ declare class System extends EmitterBase<OpenFin_2.SystemEvent> {
     queryPermissionForCurrentContext(apiName: string): Promise<OpenFin_2.QueryPermissionResult>;
     enableNativeWindowIntegrationProvider(permissions: any): Promise<OpenFin_2.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_2.RegisterUsageData): Promise<void>;
+    registerUsage({ data, type }: OpenFin_2.RegisterUsageData): void;
     /**
      * Returns an array with all printers of the caller and not all the printers on the desktop.
      *

package/out/stub.js

@@ -211,13 +211,13 @@ var OpenFin = /*#__PURE__*/Object.freeze({
     WindowEvents: window$1
 });
 
-var __classPrivateFieldSet$k = (undefined && undefined.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
+var __classPrivateFieldSet$l = (undefined && undefined.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
     if (kind === "m") throw new TypeError("Private method is not writable");
     if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
     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 __classPrivateFieldGet$l = (undefined && undefined.__classPrivateFieldGet) || function (receiver, state, kind, f) {
+var __classPrivateFieldGet$m = (undefined && undefined.__classPrivateFieldGet) || function (receiver, state, kind, f) {
     if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
     if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
     return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
@@ -298,9 +298,9 @@ class EmitterBase extends Base {
         this.emit = (eventType, payload, ...args) => {
             return this.hasEmitter() ? this.getOrCreateEmitter().emit(eventType, payload, ...args) : false;
         };
-        this.hasEmitter = () => this.wire.eventAggregator.has(__classPrivateFieldGet$l(this, _EmitterBase_emitterAccessor, "f"));
+        this.hasEmitter = () => this.wire.eventAggregator.has(__classPrivateFieldGet$m(this, _EmitterBase_emitterAccessor, "f"));
         this.getOrCreateEmitter = () => {
-            return this.wire.eventAggregator.getOrCreate(__classPrivateFieldGet$l(this, _EmitterBase_emitterAccessor, "f"));
+            return this.wire.eventAggregator.getOrCreate(__classPrivateFieldGet$m(this, _EmitterBase_emitterAccessor, "f"));
         };
         this.listeners = (type) => this.hasEmitter() ? this.getOrCreateEmitter().listeners(type) : [];
         this.listenerCount = (type) => this.hasEmitter() ? this.getOrCreateEmitter().listenerCount(type) : 0;
@@ -338,8 +338,8 @@ class EmitterBase extends Base {
             // This will only be reached if unsubscribe from event that does not exist but do not want to error here
             return Promise.resolve();
         };
-        __classPrivateFieldSet$k(this, _EmitterBase_emitterAccessor, [topic, ...additionalAccessors], "f");
-        __classPrivateFieldSet$k(this, _EmitterBase_deregisterOnceListeners, new WeakMap(), "f");
+        __classPrivateFieldSet$l(this, _EmitterBase_emitterAccessor, [topic, ...additionalAccessors], "f");
+        __classPrivateFieldSet$l(this, _EmitterBase_deregisterOnceListeners, new WeakMap(), "f");
     }
     /**
      * Adds a listener to the end of the listeners array for the specified event.
@@ -367,7 +367,7 @@ class EmitterBase extends Base {
      */
     async once(eventType, listener, options) {
         const deregister = () => this.deregisterEventListener(eventType);
-        __classPrivateFieldGet$l(this, _EmitterBase_deregisterOnceListeners, "f").set(listener, deregister);
+        __classPrivateFieldGet$m(this, _EmitterBase_deregisterOnceListeners, "f").set(listener, deregister);
         await this.registerEventListener(eventType, options, (emitter) => {
             emitter.once(eventType, deregister);
             emitter.once(eventType, listener);
@@ -398,7 +398,7 @@ class EmitterBase extends Base {
      */
     async prependOnceListener(eventType, listener, options) {
         const deregister = () => this.deregisterEventListener(eventType);
-        __classPrivateFieldGet$l(this, _EmitterBase_deregisterOnceListeners, "f").set(listener, deregister);
+        __classPrivateFieldGet$m(this, _EmitterBase_deregisterOnceListeners, "f").set(listener, deregister);
         await this.registerEventListener(eventType, options, (emitter) => {
             emitter.prependOnceListener(eventType, listener);
             emitter.once(eventType, deregister);
@@ -417,7 +417,7 @@ class EmitterBase extends Base {
         const emitter = await this.deregisterEventListener(eventType, options);
         if (emitter) {
             emitter.removeListener(eventType, listener);
-            const deregister = __classPrivateFieldGet$l(this, _EmitterBase_deregisterOnceListeners, "f").get(listener);
+            const deregister = __classPrivateFieldGet$m(this, _EmitterBase_deregisterOnceListeners, "f").get(listener);
             if (deregister) {
                 emitter.removeListener(eventType, deregister);
             }
@@ -463,7 +463,7 @@ class EmitterBase extends Base {
     deleteEmitterIfNothingRegistered(emitter) {
         // TODO: maybe emitterMap should clean up itself..
         if (emitter.eventNames().length === 0) {
-            this.wire.eventAggregator.delete(__classPrivateFieldGet$l(this, _EmitterBase_emitterAccessor, "f"));
+            this.wire.eventAggregator.delete(__classPrivateFieldGet$m(this, _EmitterBase_emitterAccessor, "f"));
         }
     }
 }
@@ -5085,18 +5085,36 @@ class SystemContentTracing extends Base {
  *
  * @packageDocumentation
  */
+var __classPrivateFieldGet$l = (undefined && undefined.__classPrivateFieldGet) || function (receiver, state, kind, f) {
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
+    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
+};
+var __classPrivateFieldSet$k = (undefined && undefined.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
+    if (kind === "m") throw new TypeError("Private method is not writable");
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
+    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 _System_instances, _System_registeredUsageKeys, _System_pendingUsageKeys, _System_usageBatch, _System_usageFlushScheduled, _System_flushUsageBatch;
 /**
  * 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}.
  *
  */
+const sortedKeysReplacer = (_, v) => v && typeof v === 'object' && !Array.isArray(v) ? Object.fromEntries(Object.entries(v).sort()) : v;
 class System extends EmitterBase {
     /**
      * @internal
      */
     constructor(wire) {
         super(wire, 'system');
+        _System_instances.add(this);
+        _System_registeredUsageKeys.set(this, new Set());
+        _System_pendingUsageKeys.set(this, new Set());
+        _System_usageBatch.set(this, []);
+        _System_usageFlushScheduled.set(this, false);
         this.ContentTracing = new SystemContentTracing(wire);
     }
     sendExternalProcessRequest(action, options) {
@@ -6833,31 +6851,58 @@ class System extends EmitterBase {
         return payload.data;
     }
     /**
-     * (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: ''
+     *     }
+     * });
      * ```
      */
-    async registerUsage({ data, type }) {
-        await this.wire.sendAction('register-usage', { data, type });
+    registerUsage({ data, type }) {
+        let dedupKey;
+        try {
+            const key = `${type}\0${JSON.stringify(data, sortedKeysReplacer)}`;
+            if (__classPrivateFieldGet$l(this, _System_registeredUsageKeys, "f").has(key) || __classPrivateFieldGet$l(this, _System_pendingUsageKeys, "f").has(key)) {
+                return;
+            }
+            __classPrivateFieldGet$l(this, _System_pendingUsageKeys, "f").add(key);
+            dedupKey = key;
+        }
+        catch {
+            console.debug(`[registerUsage] Failed to serialize 'data' for deduplication (type: "${type}"). Sending unconditionally.`);
+        }
+        __classPrivateFieldGet$l(this, _System_usageBatch, "f").push({ payload: { data, type }, dedupKey });
+        if (!__classPrivateFieldGet$l(this, _System_usageFlushScheduled, "f")) {
+            __classPrivateFieldSet$k(this, _System_usageFlushScheduled, true, "f");
+            queueMicrotask(() => __classPrivateFieldGet$l(this, _System_instances, "m", _System_flushUsageBatch).call(this));
+        }
     }
     /**
      * Returns an array with all printers of the caller and not all the printers on the desktop.
@@ -7163,6 +7208,37 @@ class System extends EmitterBase {
         return payload.data;
     }
 }
+_System_registeredUsageKeys = new WeakMap(), _System_pendingUsageKeys = new WeakMap(), _System_usageBatch = new WeakMap(), _System_usageFlushScheduled = new WeakMap(), _System_instances = new WeakSet(), _System_flushUsageBatch = function _System_flushUsageBatch() {
+    __classPrivateFieldSet$k(this, _System_usageFlushScheduled, false, "f");
+    const batch = __classPrivateFieldGet$l(this, _System_usageBatch, "f");
+    __classPrivateFieldSet$k(this, _System_usageBatch, [], "f");
+    if (batch.length === 0)
+        return;
+    const items = batch.map(({ payload }) => payload);
+    const keys = batch.map(({ dedupKey }) => dedupKey);
+    const commitKeys = () => {
+        for (const key of keys) {
+            if (key !== undefined) {
+                __classPrivateFieldGet$l(this, _System_pendingUsageKeys, "f").delete(key);
+                __classPrivateFieldGet$l(this, _System_registeredUsageKeys, "f").add(key);
+            }
+        }
+    };
+    const rollbackKeys = () => {
+        for (const key of keys) {
+            if (key !== undefined) {
+                __classPrivateFieldGet$l(this, _System_pendingUsageKeys, "f").delete(key);
+            }
+        }
+    };
+    const action = items.length === 1
+        ? this.wire.sendAction('register-usage', items[0])
+        : this.wire.sendAction('register-usage-batch', { items });
+    action.then(commitKeys).catch((e) => {
+        rollbackKeys();
+        console.debug('[registerUsage] Failed to send usage data.', e);
+    });
+};
 
 class RefCounter {
     constructor() {

package/out/stub.mjs

@@ -207,13 +207,13 @@ var OpenFin = /*#__PURE__*/Object.freeze({
     WindowEvents: window$1
 });
 
-var __classPrivateFieldSet$k = (undefined && undefined.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
+var __classPrivateFieldSet$l = (undefined && undefined.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
     if (kind === "m") throw new TypeError("Private method is not writable");
     if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
     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 __classPrivateFieldGet$l = (undefined && undefined.__classPrivateFieldGet) || function (receiver, state, kind, f) {
+var __classPrivateFieldGet$m = (undefined && undefined.__classPrivateFieldGet) || function (receiver, state, kind, f) {
     if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
     if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
     return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
@@ -294,9 +294,9 @@ class EmitterBase extends Base {
         this.emit = (eventType, payload, ...args) => {
             return this.hasEmitter() ? this.getOrCreateEmitter().emit(eventType, payload, ...args) : false;
         };
-        this.hasEmitter = () => this.wire.eventAggregator.has(__classPrivateFieldGet$l(this, _EmitterBase_emitterAccessor, "f"));
+        this.hasEmitter = () => this.wire.eventAggregator.has(__classPrivateFieldGet$m(this, _EmitterBase_emitterAccessor, "f"));
         this.getOrCreateEmitter = () => {
-            return this.wire.eventAggregator.getOrCreate(__classPrivateFieldGet$l(this, _EmitterBase_emitterAccessor, "f"));
+            return this.wire.eventAggregator.getOrCreate(__classPrivateFieldGet$m(this, _EmitterBase_emitterAccessor, "f"));
         };
         this.listeners = (type) => this.hasEmitter() ? this.getOrCreateEmitter().listeners(type) : [];
         this.listenerCount = (type) => this.hasEmitter() ? this.getOrCreateEmitter().listenerCount(type) : 0;
@@ -334,8 +334,8 @@ class EmitterBase extends Base {
             // This will only be reached if unsubscribe from event that does not exist but do not want to error here
             return Promise.resolve();
         };
-        __classPrivateFieldSet$k(this, _EmitterBase_emitterAccessor, [topic, ...additionalAccessors], "f");
-        __classPrivateFieldSet$k(this, _EmitterBase_deregisterOnceListeners, new WeakMap(), "f");
+        __classPrivateFieldSet$l(this, _EmitterBase_emitterAccessor, [topic, ...additionalAccessors], "f");
+        __classPrivateFieldSet$l(this, _EmitterBase_deregisterOnceListeners, new WeakMap(), "f");
     }
     /**
      * Adds a listener to the end of the listeners array for the specified event.
@@ -363,7 +363,7 @@ class EmitterBase extends Base {
      */
     async once(eventType, listener, options) {
         const deregister = () => this.deregisterEventListener(eventType);
-        __classPrivateFieldGet$l(this, _EmitterBase_deregisterOnceListeners, "f").set(listener, deregister);
+        __classPrivateFieldGet$m(this, _EmitterBase_deregisterOnceListeners, "f").set(listener, deregister);
         await this.registerEventListener(eventType, options, (emitter) => {
             emitter.once(eventType, deregister);
             emitter.once(eventType, listener);
@@ -394,7 +394,7 @@ class EmitterBase extends Base {
      */
     async prependOnceListener(eventType, listener, options) {
         const deregister = () => this.deregisterEventListener(eventType);
-        __classPrivateFieldGet$l(this, _EmitterBase_deregisterOnceListeners, "f").set(listener, deregister);
+        __classPrivateFieldGet$m(this, _EmitterBase_deregisterOnceListeners, "f").set(listener, deregister);
         await this.registerEventListener(eventType, options, (emitter) => {
             emitter.prependOnceListener(eventType, listener);
             emitter.once(eventType, deregister);
@@ -413,7 +413,7 @@ class EmitterBase extends Base {
         const emitter = await this.deregisterEventListener(eventType, options);
         if (emitter) {
             emitter.removeListener(eventType, listener);
-            const deregister = __classPrivateFieldGet$l(this, _EmitterBase_deregisterOnceListeners, "f").get(listener);
+            const deregister = __classPrivateFieldGet$m(this, _EmitterBase_deregisterOnceListeners, "f").get(listener);
             if (deregister) {
                 emitter.removeListener(eventType, deregister);
             }
@@ -459,7 +459,7 @@ class EmitterBase extends Base {
     deleteEmitterIfNothingRegistered(emitter) {
         // TODO: maybe emitterMap should clean up itself..
         if (emitter.eventNames().length === 0) {
-            this.wire.eventAggregator.delete(__classPrivateFieldGet$l(this, _EmitterBase_emitterAccessor, "f"));
+            this.wire.eventAggregator.delete(__classPrivateFieldGet$m(this, _EmitterBase_emitterAccessor, "f"));
         }
     }
 }
@@ -5081,18 +5081,36 @@ class SystemContentTracing extends Base {
  *
  * @packageDocumentation
  */
+var __classPrivateFieldGet$l = (undefined && undefined.__classPrivateFieldGet) || function (receiver, state, kind, f) {
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
+    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
+};
+var __classPrivateFieldSet$k = (undefined && undefined.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
+    if (kind === "m") throw new TypeError("Private method is not writable");
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
+    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 _System_instances, _System_registeredUsageKeys, _System_pendingUsageKeys, _System_usageBatch, _System_usageFlushScheduled, _System_flushUsageBatch;
 /**
  * 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}.
  *
  */
+const sortedKeysReplacer = (_, v) => v && typeof v === 'object' && !Array.isArray(v) ? Object.fromEntries(Object.entries(v).sort()) : v;
 class System extends EmitterBase {
     /**
      * @internal
      */
     constructor(wire) {
         super(wire, 'system');
+        _System_instances.add(this);
+        _System_registeredUsageKeys.set(this, new Set());
+        _System_pendingUsageKeys.set(this, new Set());
+        _System_usageBatch.set(this, []);
+        _System_usageFlushScheduled.set(this, false);
         this.ContentTracing = new SystemContentTracing(wire);
     }
     sendExternalProcessRequest(action, options) {
@@ -6829,31 +6847,58 @@ class System extends EmitterBase {
         return payload.data;
     }
     /**
-     * (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: ''
+     *     }
+     * });
      * ```
      */
-    async registerUsage({ data, type }) {
-        await this.wire.sendAction('register-usage', { data, type });
+    registerUsage({ data, type }) {
+        let dedupKey;
+        try {
+            const key = `${type}\0${JSON.stringify(data, sortedKeysReplacer)}`;
+            if (__classPrivateFieldGet$l(this, _System_registeredUsageKeys, "f").has(key) || __classPrivateFieldGet$l(this, _System_pendingUsageKeys, "f").has(key)) {
+                return;
+            }
+            __classPrivateFieldGet$l(this, _System_pendingUsageKeys, "f").add(key);
+            dedupKey = key;
+        }
+        catch {
+            console.debug(`[registerUsage] Failed to serialize 'data' for deduplication (type: "${type}"). Sending unconditionally.`);
+        }
+        __classPrivateFieldGet$l(this, _System_usageBatch, "f").push({ payload: { data, type }, dedupKey });
+        if (!__classPrivateFieldGet$l(this, _System_usageFlushScheduled, "f")) {
+            __classPrivateFieldSet$k(this, _System_usageFlushScheduled, true, "f");
+            queueMicrotask(() => __classPrivateFieldGet$l(this, _System_instances, "m", _System_flushUsageBatch).call(this));
+        }
     }
     /**
      * Returns an array with all printers of the caller and not all the printers on the desktop.
@@ -7159,6 +7204,37 @@ class System extends EmitterBase {
         return payload.data;
     }
 }
+_System_registeredUsageKeys = new WeakMap(), _System_pendingUsageKeys = new WeakMap(), _System_usageBatch = new WeakMap(), _System_usageFlushScheduled = new WeakMap(), _System_instances = new WeakSet(), _System_flushUsageBatch = function _System_flushUsageBatch() {
+    __classPrivateFieldSet$k(this, _System_usageFlushScheduled, false, "f");
+    const batch = __classPrivateFieldGet$l(this, _System_usageBatch, "f");
+    __classPrivateFieldSet$k(this, _System_usageBatch, [], "f");
+    if (batch.length === 0)
+        return;
+    const items = batch.map(({ payload }) => payload);
+    const keys = batch.map(({ dedupKey }) => dedupKey);
+    const commitKeys = () => {
+        for (const key of keys) {
+            if (key !== undefined) {
+                __classPrivateFieldGet$l(this, _System_pendingUsageKeys, "f").delete(key);
+                __classPrivateFieldGet$l(this, _System_registeredUsageKeys, "f").add(key);
+            }
+        }
+    };
+    const rollbackKeys = () => {
+        for (const key of keys) {
+            if (key !== undefined) {
+                __classPrivateFieldGet$l(this, _System_pendingUsageKeys, "f").delete(key);
+            }
+        }
+    };
+    const action = items.length === 1
+        ? this.wire.sendAction('register-usage', items[0])
+        : this.wire.sendAction('register-usage-batch', { items });
+    action.then(commitKeys).catch((e) => {
+        rollbackKeys();
+        console.debug('[registerUsage] Failed to send usage data.', e);
+    });
+};
 
 class RefCounter {
     constructor() {

package/package.json

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