@openfin/node-adapter 45.100.51 → 45.100.56

package/out/node-adapter-alpha.d.ts

@@ -18,6 +18,7 @@ declare type BaseConfig = {
     devToolsPort?: number;
     installerUI?: boolean;
     runtime?: RuntimeConfig;
+    apiDiagnostics?: boolean;
     appAssets?: [
         {
         src: string;

package/out/node-adapter-beta.d.ts

@@ -18,6 +18,7 @@ declare type BaseConfig = {
     devToolsPort?: number;
     installerUI?: boolean;
     runtime?: RuntimeConfig;
+    apiDiagnostics?: boolean;
     appAssets?: [
         {
         src: string;

package/out/node-adapter-public.d.ts

@@ -18,6 +18,7 @@ declare type BaseConfig = {
     devToolsPort?: number;
     installerUI?: boolean;
     runtime?: RuntimeConfig;
+    apiDiagnostics?: boolean;
     appAssets?: [
         {
         src: string;

package/out/node-adapter.d.ts

@@ -18,6 +18,7 @@ declare type BaseConfig = {
     devToolsPort?: number;
     installerUI?: boolean;
     runtime?: RuntimeConfig;
+    apiDiagnostics?: boolean;
     appAssets?: [
         {
         src: string;

package/out/node-adapter.js

@@ -543,9 +543,7 @@ class ViewModule extends Base {
      * @experimental
      */
     async wrap(identity) {
-        this.wire.sendAction('view-wrap').catch((e) => {
-            // we do not want to expose this error, just continue if this analytics-only call fails
-        });
+        this.wire.recordAnalytic('view-wrap');
         const errorMsg = validateIdentity(identity);
         if (errorMsg) {
             throw new Error(errorMsg);
@@ -567,9 +565,7 @@ class ViewModule extends Base {
      * @experimental
      */
     wrapSync(identity) {
-        this.wire.sendAction('view-wrap-sync').catch((e) => {
-            // we do not want to expose this error, just continue if this analytics-only call fails
-        });
+        this.wire.recordAnalytic('view-wrap-sync');
         const errorMsg = validateIdentity(identity);
         if (errorMsg) {
             throw new Error(errorMsg);
@@ -589,9 +585,7 @@ class ViewModule extends Base {
      * @experimental
      */
     getCurrent() {
-        this.wire.sendAction('view-get-current').catch((e) => {
-            // we do not want to expose this error, just continue if this analytics-only call fails
-        });
+        this.wire.recordAnalytic('view-get-current');
         if (!this.wire.me.isView) {
             throw new Error('You are not in a View context');
         }
@@ -610,9 +604,7 @@ class ViewModule extends Base {
      * @experimental
      */
     getCurrentSync() {
-        this.wire.sendAction('view-get-current-sync').catch((e) => {
-            // we do not want to expose this error, just continue if this analytics-only call fails
-        });
+        this.wire.recordAnalytic('view-get-current-sync');
         if (!this.wire.me.isView) {
             throw new Error('You are not in a View context');
         }
@@ -1664,9 +1656,7 @@ class WebContents extends EmitterBase {
      * {@link OpenFin.WebContentsEvents event namespace}.
      */
     async showPopupWindow(options) {
-        this.wire.sendAction(`${this.entityType}-show-popup-window`, this.identity).catch(() => {
-            // we do not want to expose this error, just continue if this analytics-only call fails
-        });
+        this.wire.recordAnalytic(`${this.entityType}-show-popup-window`);
         if (options?.onPopupReady) {
             const readyListener = async ({ popupName }) => {
                 try {
@@ -2080,9 +2070,7 @@ class View extends WebContents {
          * @experimental
          */
         this.getParentLayout = async () => {
-            this.wire.sendAction('view-get-parent-layout').catch(() => {
-                // don't expose
-            });
+            this.wire.recordAnalytic('view-get-parent-layout');
             return this.fin.Platform.Layout.getLayoutByViewIdentity(this.identity);
         };
         /**
@@ -2195,9 +2183,7 @@ class View extends WebContents {
          * ```
          */
         this.getCurrentStack = async () => {
-            this.wire.sendAction('view-get-current-stack').catch(() => {
-                // don't expose
-            });
+            this.wire.recordAnalytic('view-get-current-stack');
             try {
                 const layout = await this.getParentLayout();
                 return layout.getStackByViewIdentity(this.identity);
@@ -2392,9 +2378,7 @@ class Application extends EmitterBase {
      */
     close(force = false) {
         console.warn('Deprecation Warning: Application.close is deprecated Please use Application.quit');
-        this.wire.sendAction('application-close', this.identity).catch((e) => {
-            // we do not want to expose this error, just continue if this analytics-only call fails
-        });
+        this.wire.recordAnalytic('application-close');
         return this._close(force);
     }
     /**
@@ -2535,9 +2519,7 @@ class Application extends EmitterBase {
      * ```
      */
     getWindow() {
-        this.wire.sendAction('application-get-window', this.identity).catch((e) => {
-            // we do not want to expose this error, just continue if this analytics-only call fails
-        });
+        this.wire.recordAnalytic('application-get-window');
         return Promise.resolve(this.window);
     }
     /**
@@ -2615,9 +2597,7 @@ class Application extends EmitterBase {
      */
     run() {
         console.warn('Deprecation Warning: Application.run is deprecated Please use fin.Application.start');
-        this.wire.sendAction('application-run', this.identity).catch((e) => {
-            // we do not want to expose this error, just continue if this analytics-only call fails
-        });
+        this.wire.recordAnalytic('application-run');
         return this._run();
     }
     _run(opts = {}) {
@@ -3129,9 +3109,7 @@ class ApplicationModule extends Base {
      *
      */
     async wrap(identity) {
-        this.wire.sendAction('wrap-application').catch((e) => {
-            // we do not want to expose this error, just continue if this analytics-only call fails
-        });
+        this.wire.recordAnalytic('wrap-application');
         const errorMsg = validateIdentity(identity);
         if (errorMsg) {
             throw new Error(errorMsg);
@@ -3154,9 +3132,7 @@ class ApplicationModule extends Base {
      *
      */
     wrapSync(identity) {
-        this.wire.sendAction('wrap-application-sync').catch((e) => {
-            // we do not want to expose this error, just continue if this analytics-only call fails
-        });
+        this.wire.recordAnalytic('wrap-application-sync');
         const errorMsg = validateIdentity(identity);
         if (errorMsg) {
             throw new Error(errorMsg);
@@ -3197,9 +3173,7 @@ class ApplicationModule extends Base {
      */
     create(appOptions) {
         console.warn('Deprecation Warning: fin.Application.create is deprecated. Please use fin.Application.start');
-        this.wire.sendAction('application-create').catch((e) => {
-            // we do not want to expose this error, just continue if this analytics-only call fails
-        });
+        this.wire.recordAnalytic('application-create');
         return this._create(appOptions);
     }
     /**
@@ -3221,9 +3195,7 @@ class ApplicationModule extends Base {
      *
      */
     async start(appOptions) {
-        this.wire.sendAction('start-application').catch((e) => {
-            // we do not want to expose this error, just continue if this analytics-only call fails
-        });
+        this.wire.recordAnalytic('start-application');
         const app = await this._create(appOptions);
         await this.wire.sendAction('run-application', { uuid: appOptions.uuid });
         return app;
@@ -3286,9 +3258,7 @@ class ApplicationModule extends Base {
      * ```
      */
     getCurrent() {
-        this.wire.sendAction('get-current-application').catch((e) => {
-            // we do not want to expose this error, just continue if this analytics-only call fails
-        });
+        this.wire.recordAnalytic('get-current-application');
         return this.wrap({ uuid: this.wire.me.uuid });
     }
     /**
@@ -3311,9 +3281,7 @@ class ApplicationModule extends Base {
      * ```
      */
     getCurrentSync() {
-        this.wire.sendAction('get-current-application-sync').catch((e) => {
-            // we do not want to expose this error, just continue if this analytics-only call fails
-        });
+        this.wire.recordAnalytic('get-current-application-sync');
         return this.wrapSync({ uuid: this.wire.me.uuid });
     }
     /**
@@ -3331,9 +3299,7 @@ class ApplicationModule extends Base {
      * ```
      */
     async startFromManifest(manifestUrl, opts) {
-        this.wire.sendAction('application-start-from-manifest').catch((e) => {
-            // we do not want to expose this error, just continue if this analytics-only call fails
-        });
+        this.wire.recordAnalytic('application-start-from-manifest');
         const app = await this._createFromManifest(manifestUrl);
         // @ts-expect-error using private method without warning.
         await app._run(opts); // eslint-disable-line no-underscore-dangle
@@ -3355,9 +3321,7 @@ class ApplicationModule extends Base {
      */
     createFromManifest(manifestUrl) {
         console.warn('Deprecation Warning: fin.Application.createFromManifest is deprecated. Please use fin.Application.startFromManifest');
-        this.wire.sendAction('application-create-from-manifest').catch((e) => {
-            // we do not want to expose this error, just continue if this analytics-only call fails
-        });
+        this.wire.recordAnalytic('application-create-from-manifest');
         return this._createFromManifest(manifestUrl);
     }
     _createFromManifest(manifestUrl) {
@@ -3420,9 +3384,7 @@ class _Window extends WebContents {
         super(wire, identity, 'window');
     }
     async createWindow(options) {
-        this.wire.sendAction('window-create-window').catch((e) => {
-            // we do not want to expose this error, just continue if this analytics-only call fails
-        });
+        this.wire.recordAnalytic('window-create-window');
         const CONSTRUCTOR_CB_TOPIC = 'fire-constructor-callback';
         const responseSubscription = await promisifySubscription(this, CONSTRUCTOR_CB_TOPIC);
         // set defaults:
@@ -3896,9 +3858,7 @@ class _Window extends WebContents {
      * @experimental
      */
     async getLayout(layoutIdentity) {
-        this.wire.sendAction('window-get-layout').catch((e) => {
-            // don't expose
-        });
+        this.wire.recordAnalytic('window-get-layout');
         const opts = await this.getOptions();
         if (!opts.layout && !opts.layoutSnapshot) {
             throw new Error('Window does not have a Layout');
@@ -3947,9 +3907,7 @@ class _Window extends WebContents {
      * ```
      */
     getParentApplication() {
-        this.wire.sendAction('window-get-parent-application').catch((e) => {
-            // we do not want to expose this error, just continue if this analytics-only call fails
-        });
+        this.wire.recordAnalytic('window-get-parent-application');
         return Promise.resolve(new Application(this.wire, this.identity));
     }
     /**
@@ -3972,9 +3930,7 @@ class _Window extends WebContents {
      * ```
      */
     getParentWindow() {
-        this.wire.sendAction('window-get-parent-window').catch((e) => {
-            // we do not want to expose this error, just continue if this analytics-only call fails
-        });
+        this.wire.recordAnalytic('window-get-parent-window');
         return Promise.resolve(new Application(this.wire, this.identity)).then((app) => app.getWindow());
     }
     /**
@@ -4078,9 +4034,7 @@ class _Window extends WebContents {
      * ```
      */
     getWebWindow() {
-        this.wire.sendAction('window-get-web-window').catch((e) => {
-            // we do not want to expose this error, just continue if this analytics-only call fails
-        });
+        this.wire.recordAnalytic('window-get-web-window');
         return this.wire.environment.getWebWindow(this.identity);
     }
     /**
@@ -4094,9 +4048,7 @@ class _Window extends WebContents {
      * ```
      */
     isMainWindow() {
-        this.wire.sendAction('window-is-main-window').catch((e) => {
-            // we do not want to expose this error, just continue if this analytics-only call fails
-        });
+        this.wire.recordAnalytic('window-is-main-window');
         return this.me.uuid === this.me.name;
     }
     /**
@@ -4618,9 +4570,7 @@ class _Window extends WebContents {
      * ```
      */
     async dispatchPopupResult(data) {
-        this.wire.sendAction('window-dispatch-popup-result').catch((e) => {
-            // we do not want to expose this error, just continue if this analytics-only call fails
-        });
+        this.wire.recordAnalytic('window-dispatch-popup-result');
         await this.wire.sendAction('dispatch-popup-result', { data, ...this.identity });
     }
     /**
@@ -4769,9 +4719,7 @@ class _WindowModule extends Base {
      * ```
      */
     async wrap(identity) {
-        this.wire.sendAction('window-wrap').catch((e) => {
-            // we do not want to expose this error, just continue if this analytics-only call fails
-        });
+        this.wire.recordAnalytic('window-wrap');
         const errorMsg = validateIdentity(identity);
         if (errorMsg) {
             throw new Error(errorMsg);
@@ -4801,9 +4749,7 @@ class _WindowModule extends Base {
      * ```
      */
     wrapSync(identity) {
-        this.wire.sendAction('window-wrap-sync').catch((e) => {
-            // we do not want to expose this error, just continue if this analytics-only call fails
-        });
+        this.wire.recordAnalytic('window-wrap-sync');
         const errorMsg = validateIdentity(identity);
         if (errorMsg) {
             throw new Error(errorMsg);
@@ -4832,9 +4778,7 @@ class _WindowModule extends Base {
      * ```
      */
     create(options) {
-        this.wire.sendAction('create-window').catch((e) => {
-            // we do not want to expose this error, just continue if this analytics-only call fails
-        });
+        this.wire.recordAnalytic('create-window');
         const win = new _Window(this.wire, { uuid: this.me.uuid, name: options.name });
         return win.createWindow(options);
     }
@@ -4850,9 +4794,7 @@ class _WindowModule extends Base {
      * ```
      */
     getCurrent() {
-        this.wire.sendAction('get-current-window').catch((e) => {
-            // we do not want to expose this error, just continue if this analytics-only call fails
-        });
+        this.wire.recordAnalytic('get-current-window');
         if (!this.wire.me.isWindow) {
             throw new Error('You are not in a Window context');
         }
@@ -4871,9 +4813,7 @@ class _WindowModule extends Base {
      * ```
      */
     getCurrentSync() {
-        this.wire.sendAction('get-current-window-sync').catch((e) => {
-            // we do not want to expose this error, just continue if this analytics-only call fails
-        });
+        this.wire.recordAnalytic('get-current-window-sync');
         if (!this.wire.me.isWindow) {
             throw new Error('You are not in a Window context');
         }
@@ -4882,6 +4822,47 @@ class _WindowModule extends Base {
     }
 }
 
+/**
+ * Chromium content tracing APIs exposed under `fin.System.ContentTracing`.
+ */
+class SystemContentTracing extends Base {
+    /**
+     * Gets the currently known tracing category groups.
+     */
+    async getCategories() {
+        const { payload } = await this.wire.sendAction('content-tracing-get-categories');
+        return payload.data;
+    }
+    /**
+     * Starts content tracing across runtime processes.
+     *
+     * Only one content tracing session may be active across the runtime at a time.
+     * This method rejects if another identity already owns the active session.
+     */
+    async startRecording(options) {
+        await this.wire.sendAction('content-tracing-start-recording', { options });
+    }
+    /**
+     * Stops the active content tracing session and writes the trace to the runtime-managed cache folder.
+     *
+     * The calling identity must match the identity that started the active tracing session.
+     * This method rejects if tracing is not active or is owned by another identity.
+     */
+    async stopRecording() {
+        const { payload } = await this.wire.sendAction('content-tracing-stop-recording');
+        return payload.data;
+    }
+    /**
+     * Returns the current maximum trace buffer usage across processes.
+     *
+     * This method is not supported on macOS and rejects on that platform.
+     */
+    async getTraceBufferUsage() {
+        const { payload } = await this.wire.sendAction('content-tracing-get-trace-buffer-usage');
+        return payload.data;
+    }
+}
+
 /**
  * Entry point for the OpenFin `System` API (`fin.System`).
  *
@@ -4901,6 +4882,7 @@ class System extends EmitterBase {
      */
     constructor(wire) {
         super(wire, 'system');
+        this.ContentTracing = new SystemContentTracing(wire);
     }
     sendExternalProcessRequest(action, options) {
         return new Promise((resolve, reject) => {
@@ -6426,9 +6408,7 @@ class System extends EmitterBase {
      * @experimental
      */
     async registerShutdownHandler(handler) {
-        this.wire.sendAction('system-register-shutdown-handler').catch((e) => {
-            // don't expose, analytics-only call
-        });
+        this.wire.recordAnalytic('system-register-shutdown-handler');
         const SystemShutdownEventName = 'system-shutdown';
         const SystemShutdownHandledEventName = 'system-shutdown-handled';
         const { uuid, name } = this.wire.me;
@@ -9122,6 +9102,16 @@ class InterApplicationBus extends Base {
      */
     constructor(wire) {
         super(wire);
+        /**
+         * Event types for the InterApplicationBus.
+         *
+         * @remarks The `subscriber-added` and `subscriber-removed` events are disabled by default.
+         * To re-enable them, launch the runtime with the `--emit-legacy-iab-events` flag.
+         * These events will be removed in a future version. Use {@link Channel} for connection
+         * lifecycle management instead.
+         *
+         * @deprecated Use {@link Channel} `onConnection` / `onDisconnection` instead.
+         */
         this.events = {
             subscriberAdded: 'subscriber-added',
             subscriberRemoved: 'subscriber-removed'
@@ -9544,9 +9534,7 @@ class ExternalApplicationModule extends Base {
      * ```
      */
     wrap(uuid) {
-        this.wire.sendAction('external-application-wrap').catch((e) => {
-            // we do not want to expose this error, just continue if this analytics-only call fails
-        });
+        this.wire.recordAnalytic('external-application-wrap');
         return Promise.resolve(new ExternalApplication(this.wire, { uuid }));
     }
     /**
@@ -9563,9 +9551,7 @@ class ExternalApplicationModule extends Base {
      * ```
      */
     wrapSync(uuid) {
-        this.wire.sendAction('external-application-wrap-sync').catch((e) => {
-            // we do not want to expose this error, just continue if this analytics-only call fails
-        });
+        this.wire.recordAnalytic('external-application-wrap-sync');
         return new ExternalApplication(this.wire, { uuid });
     }
 }
@@ -9653,9 +9639,7 @@ class _FrameModule extends Base {
      * ```
      */
     async wrap(identity) {
-        this.wire.sendAction('frame-wrap').catch((e) => {
-            // we do not want to expose this error, just continue if this analytics-only call fails
-        });
+        this.wire.recordAnalytic('frame-wrap');
         const errorMsg = validateIdentity(identity);
         if (errorMsg) {
             throw new Error(errorMsg);
@@ -9677,9 +9661,7 @@ class _FrameModule extends Base {
      * ```
      */
     wrapSync(identity) {
-        this.wire.sendAction('frame-wrap-sync').catch((e) => {
-            // we do not want to expose this error, just continue if this analytics-only call fails
-        });
+        this.wire.recordAnalytic('frame-wrap-sync');
         const errorMsg = validateIdentity(identity);
         if (errorMsg) {
             throw new Error(errorMsg);
@@ -9697,9 +9679,7 @@ class _FrameModule extends Base {
      * ```
      */
     getCurrent() {
-        this.wire.sendAction('frame-get-current').catch((e) => {
-            // we do not want to expose this error, just continue if this analytics-only call fails
-        });
+        this.wire.recordAnalytic('frame-get-current');
         return Promise.resolve(new _Frame(this.wire, this.wire.environment.getCurrentEntityIdentity()));
     }
     /**
@@ -9713,9 +9693,7 @@ class _FrameModule extends Base {
      * ```
      */
     getCurrentSync() {
-        this.wire.sendAction('frame-get-current-sync').catch((e) => {
-            // we do not want to expose this error, just continue if this analytics-only call fails
-        });
+        this.wire.recordAnalytic('frame-get-current-sync');
         return new _Frame(this.wire, this.wire.environment.getCurrentEntityIdentity());
     }
 }
@@ -11671,9 +11649,7 @@ class LayoutModule extends Base {
          * ```
          */
         this.init = async (options = {}) => {
-            this.wire.sendAction('layout-init').catch((e) => {
-                // don't expose
-            });
+            this.wire.recordAnalytic('layout-init');
             if (!this.wire.environment.layoutAllowedInContext(this.fin)) {
                 throw new Error('Layout.init can only be called from a Window context.');
             }
@@ -11751,9 +11727,7 @@ class LayoutModule extends Base {
      * ```
      */
     async wrap(identity) {
-        this.wire.sendAction('layout-wrap').catch((e) => {
-            // don't expose
-        });
+        this.wire.recordAnalytic('layout-wrap');
         return new Layout(identity, this.wire);
     }
     /**
@@ -11776,9 +11750,7 @@ class LayoutModule extends Base {
      * ```
      */
     wrapSync(identity) {
-        this.wire.sendAction('layout-wrap-sync').catch((e) => {
-            // don't expose
-        });
+        this.wire.recordAnalytic('layout-wrap-sync');
         return new Layout(identity, this.wire);
     }
     /**
@@ -11792,9 +11764,7 @@ class LayoutModule extends Base {
      * ```
      */
     async getCurrent() {
-        this.wire.sendAction('layout-get-current').catch((e) => {
-            // don't expose
-        });
+        this.wire.recordAnalytic('layout-get-current');
         if (this.wire.environment.type === 'openfin' && !this.fin.me.isWindow) {
             throw new Error('You are not in a Window context.  Only Windows can have a Layout.');
         }
@@ -11815,9 +11785,7 @@ class LayoutModule extends Base {
      * ```
      */
     getCurrentSync() {
-        this.wire.sendAction('layout-get-current-sync').catch((e) => {
-            // don't expose
-        });
+        this.wire.recordAnalytic('layout-get-current-sync');
         if (this.wire.environment.type === 'openfin' && !this.fin.me.isWindow) {
             throw new Error('You are not in a Window context.  Only Windows can have a Layout.');
         }
@@ -11835,9 +11803,7 @@ class LayoutModule extends Base {
      * ```
      */
     async getLayoutByViewIdentity(viewIdentity) {
-        this.wire.sendAction('layout-get-by-view-identity').catch(() => {
-            // don't expose
-        });
+        this.wire.recordAnalytic('layout-get-by-view-identity');
         const winIdentity = await this.wire.environment.getViewWindowIdentity(this.fin, viewIdentity);
         let layoutWindowIdentity = winIdentity;
         // TODO: CORE-1857 - when we tearout active layout or drag a view out of a window, the above identity includes the whole window info.
@@ -11961,9 +11927,7 @@ class PlatformModule extends Base {
      * ```
      */
     async wrap(identity) {
-        this.wire.sendAction('platform-wrap').catch((e) => {
-            // don't expose
-        });
+        this.wire.recordAnalytic('platform-wrap');
         return new Platform(this.wire, { uuid: identity.uuid });
     }
     /**
@@ -11978,9 +11942,7 @@ class PlatformModule extends Base {
      * ```
      */
     wrapSync(identity) {
-        this.wire.sendAction('platform-wrap-sync').catch((e) => {
-            // don't expose
-        });
+        this.wire.recordAnalytic('platform-wrap-sync');
         return new Platform(this.wire, { uuid: identity.uuid });
     }
     /**
@@ -11994,9 +11956,7 @@ class PlatformModule extends Base {
      * ```
      */
     async getCurrent() {
-        this.wire.sendAction('platform-get-current').catch((e) => {
-            // don't expose
-        });
+        this.wire.recordAnalytic('platform-get-current');
         return this.wrap({ uuid: this.wire.me.uuid });
     }
     /**
@@ -12010,9 +11970,7 @@ class PlatformModule extends Base {
      * ```
      */
     getCurrentSync() {
-        this.wire.sendAction('platform-get-current-sync').catch((e) => {
-            // don't expose
-        });
+        this.wire.recordAnalytic('platform-get-current-sync');
         return this.wrapSync({ uuid: this.wire.me.uuid });
     }
     /**
@@ -12040,9 +11998,7 @@ class PlatformModule extends Base {
      * ```
      */
     start(platformOptions) {
-        this.wire.sendAction('platform-start').catch((e) => {
-            // don't expose
-        });
+        this.wire.recordAnalytic('platform-start');
         // eslint-disable-next-line no-async-promise-executor
         return new Promise(async (resolve, reject) => {
             try {
@@ -12084,9 +12040,7 @@ class PlatformModule extends Base {
      * ```
      */
     startFromManifest(manifestUrl, opts) {
-        this.wire.sendAction('platform-start-from-manifest').catch((e) => {
-            // don't expose
-        });
+        this.wire.recordAnalytic('platform-start-from-manifest');
         // eslint-disable-next-line no-async-promise-executor
         return new Promise(async (resolve, reject) => {
             try {
@@ -15216,9 +15170,7 @@ class FDC3ModuleBase {
      * @static
      */
     async broadcast(context) {
-        this.wire.sendAction('fdc3-broadcast').catch((e) => {
-            // we do not want to expose this error, just continue if this analytics-only call fails
-        });
+        this.wire.recordAnalytic('fdc3-broadcast');
         return this.client.setContext(context);
     }
     /**
@@ -15229,9 +15181,7 @@ class FDC3ModuleBase {
      * @tutorial fdc3.open
      */
     async _open(app, context) {
-        this.wire.sendAction('fdc3-open').catch((e) => {
-            // we do not want to expose this error, just continue if this analytics-only call fails
-        });
+        this.wire.recordAnalytic('fdc3-open');
         try {
             return await InteropClient.ferryFdc3Call(this.client, 'fdc3Open', { app, context });
         }
@@ -15255,9 +15205,7 @@ class FDC3ModuleBase {
      * @tutorial fdc3.getOrCreateChannel
      */
     async getOrCreateChannel(channelId, fdc3Factory) {
-        this.wire.sendAction('fdc3-get-or-create-channel').catch((e) => {
-            // we do not want to expose this error, just continue if this analytics-only call fails
-        });
+        this.wire.recordAnalytic('fdc3-get-or-create-channel');
         const hasChannelIdBeenUsed = await InteropClient.ferryFdc3Call(this.client, 'isIdUsedByPrivateChannel', {
             channelId
         });
@@ -15285,9 +15233,7 @@ class FDC3ModuleBase {
      * @static
      */
     async getSystemChannels() {
-        this.wire.sendAction('fdc3-get-system-channels').catch((e) => {
-            // we do not want to expose this error, just continue if this analytics-only call fails
-        });
+        this.wire.recordAnalytic('fdc3-get-system-channels');
         return this._getChannels();
     }
     /**
@@ -15302,9 +15248,7 @@ class FDC3ModuleBase {
      * @static
      */
     async joinChannel(channelId) {
-        this.wire.sendAction('fdc3-join-channel').catch((e) => {
-            // we do not want to expose this error, just continue if this analytics-only call fails
-        });
+        this.wire.recordAnalytic('fdc3-join-channel');
         try {
             return await this.client.joinContextGroup(channelId);
         }
@@ -15327,9 +15271,7 @@ class FDC3ModuleBase {
      * @tutorial fdc3.getCurrentChannel
      */
     async getCurrentChannel() {
-        this.wire.sendAction('fdc3-get-current-channel').catch((e) => {
-            // we do not want to expose this error, just continue if this analytics-only call fails
-        });
+        this.wire.recordAnalytic('fdc3-get-current-channel');
         const currentContextGroupInfo = await this.getCurrentContextGroupInfo();
         if (!currentContextGroupInfo) {
             return null;
@@ -15344,9 +15286,7 @@ class FDC3ModuleBase {
      * @static
      */
     async leaveCurrentChannel() {
-        this.wire.sendAction('fdc3-leave-current-channel').catch((e) => {
-            // we do not want to expose this error, just continue if this analytics-only call fails
-        });
+        this.wire.recordAnalytic('fdc3-leave-current-channel');
         return this.client.removeFromContextGroup();
     }
     // utils
@@ -15466,9 +15406,7 @@ class Fdc3Module extends FDC3ModuleBase {
      */
     // @ts-expect-error TODO [CORE-1524]
     addContextListener(contextType, handler) {
-        this.wire.sendAction('fdc3-add-context-listener').catch((e) => {
-            // we do not want to expose this error, just continue if this analytics-only call fails
-        });
+        this.wire.recordAnalytic('fdc3-add-context-listener');
         let listener;
         if (typeof contextType === 'function') {
             console.warn('addContextListener(handler) has been deprecated. Please use addContextListener(null, handler)');
@@ -15491,9 +15429,7 @@ class Fdc3Module extends FDC3ModuleBase {
      * @static
      */
     addIntentListener(intent, handler) {
-        this.wire.sendAction('fdc3-add-intent-listener').catch((e) => {
-            // we do not want to expose this error, just continue if this analytics-only call fails
-        });
+        this.wire.recordAnalytic('fdc3-add-intent-listener');
         const contextHandler = (raisedIntent) => {
             const { context, metadata: intentMetadata } = raisedIntent;
             const { metadata } = context;
@@ -15521,9 +15457,7 @@ class Fdc3Module extends FDC3ModuleBase {
      * @static
      */
     async raiseIntent(intent, context, app) {
-        this.wire.sendAction('fdc3-raise-intent').catch((e) => {
-            // we do not want to expose this error, just continue if this analytics-only call fails
-        });
+        this.wire.recordAnalytic('fdc3-raise-intent');
         const intentObj = app
             ? { name: intent, context, metadata: { target: app } }
             : { name: intent, context };
@@ -15543,9 +15477,7 @@ class Fdc3Module extends FDC3ModuleBase {
      * @tutorial fdc3.findIntent
      */
     async findIntent(intent, context) {
-        this.wire.sendAction('fdc3-find-intent').catch((e) => {
-            // we do not want to expose this error, just continue if this analytics-only call fails
-        });
+        this.wire.recordAnalytic('fdc3-find-intent');
         try {
             return await this.client.getInfoForIntent({ name: intent, context });
         }
@@ -15561,9 +15493,7 @@ class Fdc3Module extends FDC3ModuleBase {
      * @tutorial fdc3.findIntentsByContext
      */
     async findIntentsByContext(context) {
-        this.wire.sendAction('fdc3-find-intents-by-context').catch((e) => {
-            // we do not want to expose this error, just continue if this analytics-only call fails
-        });
+        this.wire.recordAnalytic('fdc3-find-intents-by-context');
         try {
             return await this.client.getInfoForIntentsByContext(context);
         }
@@ -15580,9 +15510,7 @@ class Fdc3Module extends FDC3ModuleBase {
      * @tutorial fdc3.raiseIntentForContext
      */
     async raiseIntentForContext(context, app) {
-        this.wire.sendAction('fdc3-raise-intent-for-context').catch((e) => {
-            // we do not want to expose this error, just continue if this analytics-only call fails
-        });
+        this.wire.recordAnalytic('fdc3-raise-intent-for-context');
         try {
             return await this.client.fireIntentForContext({ ...context, metadata: { target: app } });
         }
@@ -15606,9 +15534,7 @@ class Fdc3Module extends FDC3ModuleBase {
      * @tutorial fdc3.getInfo
      */
     getInfo() {
-        this.wire.sendAction('fdc3-get-info').catch((e) => {
-            // we do not want to expose this error, just continue if this analytics-only call fails
-        });
+        this.wire.recordAnalytic('fdc3-get-info');
         const version = this.wire.environment.getAdapterVersionSync();
         return {
             providerVersion: version,
@@ -15675,9 +15601,7 @@ class Fdc3Module2 extends FDC3ModuleBase {
      * @tutorial fdc3v2.findInstances
      */
     async findInstances(app) {
-        this.wire.sendAction('fdc3-find-instances').catch((e) => {
-            // we do not want to expose this error, just continue if this analytics-only call fails
-        });
+        this.wire.recordAnalytic('fdc3-find-instances');
         try {
             return await InteropClient.ferryFdc3Call(this.client, 'fdc3FindInstances', app);
         }
@@ -15693,9 +15617,7 @@ class Fdc3Module2 extends FDC3ModuleBase {
      * @tutorial fdc3v2.getAppMetadata
      */
     async getAppMetadata(app) {
-        this.wire.sendAction('fdc3-get-app-metadata').catch((e) => {
-            // we do not want to expose this error, just continue if this analytics-only call fails
-        });
+        this.wire.recordAnalytic('fdc3-get-app-metadata');
         try {
             return await InteropClient.ferryFdc3Call(this.client, 'fdc3GetAppMetadata', app);
         }
@@ -15713,9 +15635,7 @@ class Fdc3Module2 extends FDC3ModuleBase {
      */
     // @ts-expect-error TODO [CORE-1524]
     async addContextListener(contextType, handler) {
-        this.wire.sendAction('fdc3-add-context-listener').catch((e) => {
-            // we do not want to expose this error, just continue if this analytics-only call fails
-        });
+        this.wire.recordAnalytic('fdc3-add-context-listener');
         // The FDC3 ContextHandler only expects the context and optional ContextMetadata, so we wrap the handler
         // here so it only gets passed these parameters
         const getWrappedHandler = (handlerToWrap) => {
@@ -15744,9 +15664,7 @@ class Fdc3Module2 extends FDC3ModuleBase {
      * @tutorial fdc3.findIntent
      */
     async findIntent(intent, context, resultType) {
-        this.wire.sendAction('fdc3-find-intent').catch((e) => {
-            // we do not want to expose this error, just continue if this analytics-only call fails
-        });
+        this.wire.recordAnalytic('fdc3-find-intent');
         try {
             return await this.client.getInfoForIntent({ name: intent, context, metadata: { resultType } });
         }
@@ -15763,9 +15681,7 @@ class Fdc3Module2 extends FDC3ModuleBase {
      * @tutorial fdc3v2.findIntentsByContext
      */
     async findIntentsByContext(context, resultType) {
-        this.wire.sendAction('fdc3-find-intents-by-context').catch((e) => {
-            // we do not want to expose this error, just continue if this analytics-only call fails
-        });
+        this.wire.recordAnalytic('fdc3-find-intents-by-context');
         const payload = resultType ? { context, metadata: { resultType } } : context;
         try {
             return await InteropClient.ferryFdc3Call(this.client, 'fdc3v2FindIntentsByContext', payload);
@@ -15784,9 +15700,7 @@ class Fdc3Module2 extends FDC3ModuleBase {
      * @tutorial fdc3v2.raiseIntent
      */
     async raiseIntent(intent, context, app) {
-        this.wire.sendAction('fdc3-raise-intent').catch((e) => {
-            // we do not want to expose this error, just continue if this analytics-only call fails
-        });
+        this.wire.recordAnalytic('fdc3-raise-intent');
         try {
             if (typeof app === 'string') {
                 console.warn('Passing a string as the app parameter is deprecated, please use an AppIdentifier ({ appId: string; instanceId?: string }).');
@@ -15807,9 +15721,7 @@ class Fdc3Module2 extends FDC3ModuleBase {
      */
     async raiseIntentForContext(context, app) {
         // TODO: We have to do the same thing we do for raiseIntent here as well.
-        this.wire.sendAction('fdc3-raise-intent-for-context').catch((e) => {
-            // we do not want to expose this error, just continue if this analytics-only call fails
-        });
+        this.wire.recordAnalytic('fdc3-raise-intent-for-context');
         try {
             if (typeof app === 'string') {
                 console.warn('Passing a string as the app parameter is deprecated, please use an AppIdentifier ({ appId: string; instanceId?: string }).');
@@ -15829,9 +15741,7 @@ class Fdc3Module2 extends FDC3ModuleBase {
      * @tutorial fdc3.addIntentListener
      */
     async addIntentListener(intent, handler) {
-        this.wire.sendAction('fdc3-add-intent-listener').catch((e) => {
-            // we do not want to expose this error, just continue if this analytics-only call fails
-        });
+        this.wire.recordAnalytic('fdc3-add-intent-listener');
         if (typeof intent !== 'string') {
             throw new Error('First argument must be an Intent name');
         }
@@ -15989,9 +15899,7 @@ class InteropModule extends Base {
      * ```
      */
     async init(name, override = defaultOverride) {
-        this.wire.sendAction('interop-init').catch(() => {
-            // don't expose, analytics-only call
-        });
+        this.wire.recordAnalytic('interop-init');
         // Allows for manifest-level configuration, without having to override. (e.g. specifying custom context groups)
         const options = await this.wire.environment.getInteropInfo(this.wire.getFin());
         const objectThatThrows = createUnusableObject(BrokerParamAccessError);
@@ -16040,9 +15948,7 @@ class InteropModule extends Base {
      * ```
      */
     connectSync(name, interopConfig) {
-        this.wire.sendAction('interop-connect-sync').catch(() => {
-            // don't expose, analytics-only call
-        });
+        this.wire.recordAnalytic('interop-connect-sync');
         return new InteropClient(this.wire, this.wire.environment.whenReady().then(() => {
             return this.fin.InterApplicationBus.Channel.connect(`interop-broker-${name}`, {
                 payload: interopConfig
@@ -16165,9 +16071,7 @@ class SnapshotSource extends Base {
      * ```
      */
     async ready() {
-        this.wire.sendAction('snapshot-source-ready').catch((e) => {
-            // don't expose, analytics-only call
-        });
+        this.wire.recordAnalytic('snapshot-source-ready');
         // eslint-disable-next-line no-async-promise-executor
         try {
             // If getClient was already called before this, do we have a timing issue where the channel might have been created but we missed the event but this still fails?
@@ -16183,9 +16087,7 @@ class SnapshotSource extends Base {
      *
      */
     async getSnapshot() {
-        this.wire.sendAction('snapshot-source-get-snapshot').catch((e) => {
-            // don't expose, analytics-only call
-        });
+        this.wire.recordAnalytic('snapshot-source-get-snapshot');
         const client = await __classPrivateFieldGet$2(this, _SnapshotSource_getClient, "f").call(this);
         const response = (await client.dispatch('get-snapshot'));
         return (await response).snapshot;
@@ -16195,9 +16097,7 @@ class SnapshotSource extends Base {
      *
      */
     async applySnapshot(snapshot) {
-        this.wire.sendAction('snapshot-source-apply-snapshot').catch((e) => {
-            // don't expose, analytics-only call
-        });
+        this.wire.recordAnalytic('snapshot-source-apply-snapshot');
         const client = await __classPrivateFieldGet$2(this, _SnapshotSource_getClient, "f").call(this);
         return client.dispatch('apply-snapshot', { snapshot });
     }
@@ -16232,9 +16132,7 @@ class SnapshotSourceModule extends Base {
      *
      */
     async init(provider) {
-        this.wire.sendAction('snapshot-source-init').catch((e) => {
-            // don't expose, analytics-only call
-        });
+        this.wire.recordAnalytic('snapshot-source-init');
         if (typeof provider !== 'object' ||
             typeof provider.getSnapshot !== 'function' ||
             typeof provider.applySnapshot !== 'function') {
@@ -16258,9 +16156,7 @@ class SnapshotSourceModule extends Base {
      * ```
      */
     wrapSync(identity) {
-        this.wire.sendAction('snapshot-source-wrap-sync').catch((e) => {
-            // don't expose, analytics-only call
-        });
+        this.wire.recordAnalytic('snapshot-source-wrap-sync');
         return new SnapshotSource(this.wire, identity);
     }
     /**
@@ -16274,9 +16170,7 @@ class SnapshotSourceModule extends Base {
      * ```
      */
     async wrap(identity) {
-        this.wire.sendAction('snapshot-source-wrap').catch((e) => {
-            // don't expose, analytics-only call
-        });
+        this.wire.recordAnalytic('snapshot-source-wrap');
         return this.wrapSync(identity);
     }
 }
@@ -17211,7 +17105,7 @@ class NodeEnvironment extends BaseEnvironment {
         };
     }
     getAdapterVersionSync() {
-        return "45.100.51";
+        return "45.100.56";
     }
     observeBounds(element, onChange) {
         throw new Error('Method not implemented.');
@@ -17328,15 +17222,19 @@ var __classPrivateFieldGet = (undefined && undefined.__classPrivateFieldGet) ||
     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 _Transport_wire, _Transport_fin;
+var _Transport_instances, _Transport_wire, _Transport_analyticsEnabled, _Transport_analyticsBuffer, _Transport_analyticsFlushTimeout, _Transport_fin, _Transport_flushAnalytics;
 class Transport extends events.EventEmitter {
     constructor(factory, environment, config) {
         super();
+        _Transport_instances.add(this);
         this.wireListeners = new Map();
         this.topicRefMap = new Map();
         this.eventAggregator = new EventAggregator();
         this.messageHandlers = [this.eventAggregator.dispatchEvent];
         _Transport_wire.set(this, void 0);
+        _Transport_analyticsEnabled.set(this, true);
+        _Transport_analyticsBuffer.set(this, new Map());
+        _Transport_analyticsFlushTimeout.set(this, void 0);
         // Typing as unknown to avoid circular dependency, should not be used directly.
         _Transport_fin.set(this, void 0);
         this.connectSync = () => {
@@ -17350,6 +17248,7 @@ class Transport extends events.EventEmitter {
         };
         __classPrivateFieldSet(this, _Transport_wire, factory(this.onmessage.bind(this)), "f");
         this.environment = environment;
+        __classPrivateFieldSet(this, _Transport_analyticsEnabled, config.apiDiagnostics !== false, "f");
         this.sendRaw = __classPrivateFieldGet(this, _Transport_wire, "f").send.bind(__classPrivateFieldGet(this, _Transport_wire, "f"));
         this.registerMessageHandler(this.handleMessage.bind(this));
         __classPrivateFieldGet(this, _Transport_wire, "f").on('disconnected', () => {
@@ -17357,6 +17256,9 @@ class Transport extends events.EventEmitter {
                 handleNack({ reason: 'Remote connection has closed' });
             }
             this.wireListeners.clear();
+            clearTimeout(__classPrivateFieldGet(this, _Transport_analyticsFlushTimeout, "f"));
+            __classPrivateFieldSet(this, _Transport_analyticsFlushTimeout, undefined, "f");
+            __classPrivateFieldGet(this, _Transport_analyticsBuffer, "f").clear();
             this.emit('disconnected');
         });
         const { uuid, name } = config;
@@ -17375,6 +17277,18 @@ class Transport extends events.EventEmitter {
         }
         __classPrivateFieldSet(this, _Transport_fin, _fin, "f");
     }
+    recordAnalytic(action) {
+        if (!__classPrivateFieldGet(this, _Transport_analyticsEnabled, "f"))
+            return;
+        __classPrivateFieldGet(this, _Transport_analyticsBuffer, "f").set(action, (__classPrivateFieldGet(this, _Transport_analyticsBuffer, "f").get(action) ?? 0) + 1);
+        if (__classPrivateFieldGet(this, _Transport_analyticsFlushTimeout, "f") === undefined) {
+            const timeout = setTimeout(() => __classPrivateFieldGet(this, _Transport_instances, "m", _Transport_flushAnalytics).call(this), 30000);
+            if (typeof timeout === 'object' && timeout !== null) {
+                timeout.unref?.();
+            }
+            __classPrivateFieldSet(this, _Transport_analyticsFlushTimeout, timeout, "f");
+        }
+    }
     shutdown() {
         const wire = __classPrivateFieldGet(this, _Transport_wire, "f");
         return wire.shutdown();
@@ -17537,7 +17451,16 @@ class Transport extends events.EventEmitter {
         return true;
     }
 }
-_Transport_wire = new WeakMap(), _Transport_fin = new WeakMap();
+_Transport_wire = new WeakMap(), _Transport_analyticsEnabled = new WeakMap(), _Transport_analyticsBuffer = new WeakMap(), _Transport_analyticsFlushTimeout = new WeakMap(), _Transport_fin = new WeakMap(), _Transport_instances = new WeakSet(), _Transport_flushAnalytics = function _Transport_flushAnalytics() {
+    __classPrivateFieldSet(this, _Transport_analyticsFlushTimeout, undefined, "f");
+    if (__classPrivateFieldGet(this, _Transport_analyticsBuffer, "f").size === 0)
+        return;
+    const counts = Object.fromEntries(__classPrivateFieldGet(this, _Transport_analyticsBuffer, "f"));
+    __classPrivateFieldGet(this, _Transport_analyticsBuffer, "f").clear();
+    this.sendAction('send-analytics-batch', { counts }).catch(() => {
+        // analytics flush failure is non-fatal, counts are already cleared
+    });
+};
 
 function isOpen(receiver) {
     return receiver.readyState === 'open' || receiver.readyState === 1;
@@ -17646,7 +17569,8 @@ async function connect(config) {
     const normalized = await validateConfig(config);
     const wire = new Transport((onmessage) => new WebSocketTransport(onmessage), environment, {
         ...normalized,
-        name: normalized.name ?? normalized.uuid
+        name: normalized.name ?? normalized.uuid,
+        apiDiagnostics: config.apiDiagnostics
     });
     await wire.connect(normalized);
     // Casting instead of expect-error to avoid skipLibCheck errors.

package/package.json

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