@openfin/node-adapter 46.100.4 → 46.100.6

package/out/node-adapter.js

@@ -35,13 +35,13 @@ var net__namespace = /*#__PURE__*/_interopNamespaceDefault(net);
 var os__namespace = /*#__PURE__*/_interopNamespaceDefault(os);
 var path__namespace = /*#__PURE__*/_interopNamespaceDefault(path);
 
-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);
@@ -122,9 +122,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;
@@ -162,8 +162,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.
@@ -191,7 +191,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);
@@ -222,7 +222,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);
@@ -241,7 +241,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);
             }
@@ -287,7 +287,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"));
         }
     }
 }
@@ -4917,18 +4917,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) {
@@ -6665,31 +6683,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.
@@ -6995,6 +7040,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() {
@@ -17338,7 +17414,7 @@ class NodeEnvironment extends BaseEnvironment {
         };
     }
     getAdapterVersionSync() {
-        return "46.100.4";
+        return "46.100.6";
     }
     observeBounds(element, onChange) {
         throw new Error('Method not implemented.');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openfin/node-adapter",
-  "version": "46.100.4",
+  "version": "46.100.6",
   "description": "See README.md",
   "main": "out/node-adapter.js",
   "types": "out/node-adapter.d.ts",
@@ -20,7 +20,7 @@
     "es-toolkit": "^1.39.3",
     "ws": "^7.5.10",
     "tslib": "2.8.1",
-    "@openfin/core": "46.100.4"
+    "@openfin/core": "46.100.6"
   },
   "scripts": {
     "prebuild": "rimraf ./out",