@openfin/fdc3-api 45.100.59 → 45.100.60

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

@@ -16786,6 +16786,13 @@ declare class System extends EmitterBase<OpenFin.SystemEvent> {
 declare class SystemContentTracing extends Base {
     /**
      * Gets the currently known tracing category groups.
+     *
+     * @example
+     * ```ts
+     * const categories = await fin.System.ContentTracing.getCategories();
+     * const sorted = [...new Set(categories)].sort((a, b) => a.localeCompare(b));
+     * console.log(`Loaded ${sorted.length} tracing categories`);
+     * ```
      */
     getCategories(): Promise<string[]>;
     /**
@@ -16793,6 +16800,29 @@ declare class SystemContentTracing extends Base {
      *
      * 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.
+     *
+     * @example
+     * ```ts
+     * await fin.System.ContentTracing.startRecording({
+     *     recording_mode: 'record-as-much-as-possible',
+     *     included_categories: [
+     *         '*',
+     *         'disabled-by-default-blink.invalidation',
+     *         'disabled-by-default-cc.debug',
+     *         'disabled-by-default-viz.surface_id_flow'
+     *     ]
+     * });
+     *
+     * console.log('Content tracing started. Call stopRecording() when ready to collect the trace.');
+     * ```
+     *
+     * @example
+     * ```ts
+     * await fin.System.ContentTracing.startRecording({
+     *     categoryFilter: 'electron,blink,cc',
+     *     traceOptions: 'record-until-full,enable-sampling'
+     * });
+     * ```
      */
     startRecording(options: OpenFin.TraceConfig | OpenFin.TraceCategoriesAndOptions): Promise<void>;
     /**
@@ -16800,12 +16830,29 @@ declare class SystemContentTracing extends Base {
      *
      * 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.
+     *
+     * @example
+     * ```ts
+     * const tracePath = await fin.System.ContentTracing.stopRecording();
+     * console.log('Trace written to:', tracePath);
+     * // Load the file in chrome://tracing or https://ui.perfetto.dev/
+     * ```
      */
     stopRecording(): Promise<string>;
     /**
      * Returns the current maximum trace buffer usage across processes.
      *
      * This method is not supported on macOS and rejects on that platform.
+     *
+     * @example
+     * ```ts
+     * try {
+     *     const usage = await fin.System.ContentTracing.getTraceBufferUsage();
+     *     console.log(`Buffer usage: ${usage.percentage}% (${usage.value})`);
+     * } catch (error) {
+     *     console.warn('Trace buffer usage is not available on this platform.', error);
+     * }
+     * ```
      */
     getTraceBufferUsage(): Promise<OpenFin.TraceBufferUsage>;
 }

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

@@ -16786,6 +16786,13 @@ declare class System extends EmitterBase<OpenFin.SystemEvent> {
 declare class SystemContentTracing extends Base {
     /**
      * Gets the currently known tracing category groups.
+     *
+     * @example
+     * ```ts
+     * const categories = await fin.System.ContentTracing.getCategories();
+     * const sorted = [...new Set(categories)].sort((a, b) => a.localeCompare(b));
+     * console.log(`Loaded ${sorted.length} tracing categories`);
+     * ```
      */
     getCategories(): Promise<string[]>;
     /**
@@ -16793,6 +16800,29 @@ declare class SystemContentTracing extends Base {
      *
      * 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.
+     *
+     * @example
+     * ```ts
+     * await fin.System.ContentTracing.startRecording({
+     *     recording_mode: 'record-as-much-as-possible',
+     *     included_categories: [
+     *         '*',
+     *         'disabled-by-default-blink.invalidation',
+     *         'disabled-by-default-cc.debug',
+     *         'disabled-by-default-viz.surface_id_flow'
+     *     ]
+     * });
+     *
+     * console.log('Content tracing started. Call stopRecording() when ready to collect the trace.');
+     * ```
+     *
+     * @example
+     * ```ts
+     * await fin.System.ContentTracing.startRecording({
+     *     categoryFilter: 'electron,blink,cc',
+     *     traceOptions: 'record-until-full,enable-sampling'
+     * });
+     * ```
      */
     startRecording(options: OpenFin.TraceConfig | OpenFin.TraceCategoriesAndOptions): Promise<void>;
     /**
@@ -16800,12 +16830,29 @@ declare class SystemContentTracing extends Base {
      *
      * 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.
+     *
+     * @example
+     * ```ts
+     * const tracePath = await fin.System.ContentTracing.stopRecording();
+     * console.log('Trace written to:', tracePath);
+     * // Load the file in chrome://tracing or https://ui.perfetto.dev/
+     * ```
      */
     stopRecording(): Promise<string>;
     /**
      * Returns the current maximum trace buffer usage across processes.
      *
      * This method is not supported on macOS and rejects on that platform.
+     *
+     * @example
+     * ```ts
+     * try {
+     *     const usage = await fin.System.ContentTracing.getTraceBufferUsage();
+     *     console.log(`Buffer usage: ${usage.percentage}% (${usage.value})`);
+     * } catch (error) {
+     *     console.warn('Trace buffer usage is not available on this platform.', error);
+     * }
+     * ```
      */
     getTraceBufferUsage(): Promise<OpenFin.TraceBufferUsage>;
 }

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

@@ -16786,6 +16786,13 @@ declare class System extends EmitterBase<OpenFin.SystemEvent> {
 declare class SystemContentTracing extends Base {
     /**
      * Gets the currently known tracing category groups.
+     *
+     * @example
+     * ```ts
+     * const categories = await fin.System.ContentTracing.getCategories();
+     * const sorted = [...new Set(categories)].sort((a, b) => a.localeCompare(b));
+     * console.log(`Loaded ${sorted.length} tracing categories`);
+     * ```
      */
     getCategories(): Promise<string[]>;
     /**
@@ -16793,6 +16800,29 @@ declare class SystemContentTracing extends Base {
      *
      * 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.
+     *
+     * @example
+     * ```ts
+     * await fin.System.ContentTracing.startRecording({
+     *     recording_mode: 'record-as-much-as-possible',
+     *     included_categories: [
+     *         '*',
+     *         'disabled-by-default-blink.invalidation',
+     *         'disabled-by-default-cc.debug',
+     *         'disabled-by-default-viz.surface_id_flow'
+     *     ]
+     * });
+     *
+     * console.log('Content tracing started. Call stopRecording() when ready to collect the trace.');
+     * ```
+     *
+     * @example
+     * ```ts
+     * await fin.System.ContentTracing.startRecording({
+     *     categoryFilter: 'electron,blink,cc',
+     *     traceOptions: 'record-until-full,enable-sampling'
+     * });
+     * ```
      */
     startRecording(options: OpenFin.TraceConfig | OpenFin.TraceCategoriesAndOptions): Promise<void>;
     /**
@@ -16800,12 +16830,29 @@ declare class SystemContentTracing extends Base {
      *
      * 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.
+     *
+     * @example
+     * ```ts
+     * const tracePath = await fin.System.ContentTracing.stopRecording();
+     * console.log('Trace written to:', tracePath);
+     * // Load the file in chrome://tracing or https://ui.perfetto.dev/
+     * ```
      */
     stopRecording(): Promise<string>;
     /**
      * Returns the current maximum trace buffer usage across processes.
      *
      * This method is not supported on macOS and rejects on that platform.
+     *
+     * @example
+     * ```ts
+     * try {
+     *     const usage = await fin.System.ContentTracing.getTraceBufferUsage();
+     *     console.log(`Buffer usage: ${usage.percentage}% (${usage.value})`);
+     * } catch (error) {
+     *     console.warn('Trace buffer usage is not available on this platform.', error);
+     * }
+     * ```
      */
     getTraceBufferUsage(): Promise<OpenFin.TraceBufferUsage>;
 }

package/out/fdc3-api.d.ts

@@ -17209,6 +17209,13 @@ declare class System extends EmitterBase<OpenFin.SystemEvent> {
 declare class SystemContentTracing extends Base {
     /**
      * Gets the currently known tracing category groups.
+     *
+     * @example
+     * ```ts
+     * const categories = await fin.System.ContentTracing.getCategories();
+     * const sorted = [...new Set(categories)].sort((a, b) => a.localeCompare(b));
+     * console.log(`Loaded ${sorted.length} tracing categories`);
+     * ```
      */
     getCategories(): Promise<string[]>;
     /**
@@ -17216,6 +17223,29 @@ declare class SystemContentTracing extends Base {
      *
      * 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.
+     *
+     * @example
+     * ```ts
+     * await fin.System.ContentTracing.startRecording({
+     *     recording_mode: 'record-as-much-as-possible',
+     *     included_categories: [
+     *         '*',
+     *         'disabled-by-default-blink.invalidation',
+     *         'disabled-by-default-cc.debug',
+     *         'disabled-by-default-viz.surface_id_flow'
+     *     ]
+     * });
+     *
+     * console.log('Content tracing started. Call stopRecording() when ready to collect the trace.');
+     * ```
+     *
+     * @example
+     * ```ts
+     * await fin.System.ContentTracing.startRecording({
+     *     categoryFilter: 'electron,blink,cc',
+     *     traceOptions: 'record-until-full,enable-sampling'
+     * });
+     * ```
      */
     startRecording(options: OpenFin.TraceConfig | OpenFin.TraceCategoriesAndOptions): Promise<void>;
     /**
@@ -17223,12 +17253,29 @@ declare class SystemContentTracing extends Base {
      *
      * 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.
+     *
+     * @example
+     * ```ts
+     * const tracePath = await fin.System.ContentTracing.stopRecording();
+     * console.log('Trace written to:', tracePath);
+     * // Load the file in chrome://tracing or https://ui.perfetto.dev/
+     * ```
      */
     stopRecording(): Promise<string>;
     /**
      * Returns the current maximum trace buffer usage across processes.
      *
      * This method is not supported on macOS and rejects on that platform.
+     *
+     * @example
+     * ```ts
+     * try {
+     *     const usage = await fin.System.ContentTracing.getTraceBufferUsage();
+     *     console.log(`Buffer usage: ${usage.percentage}% (${usage.value})`);
+     * } catch (error) {
+     *     console.warn('Trace buffer usage is not available on this platform.', error);
+     * }
+     * ```
      */
     getTraceBufferUsage(): Promise<OpenFin.TraceBufferUsage>;
 }

package/out/fdc3-api.js

@@ -1,6 +1,6 @@
 'use strict';
 
-var isEqual = require('lodash/isEqual');
+var esToolkit = require('es-toolkit');
 
 const generateId = () => `${Math.random()}${Date.now()}`;
 const wrapInTryCatch = (f, prefix) => (...args) => {
@@ -163,7 +163,7 @@ const createV1Channel = (sessionContextGroup) => {
                 const wrappedHandler = (context, contextMetadata) => {
                     if (first) {
                         first = false;
-                        if (isEqual(currentContext, context)) {
+                        if (esToolkit.isEqual(currentContext, context)) {
                             return;
                         }
                     }
@@ -1453,7 +1453,7 @@ class FDC3ModuleBase {
                     const wrappedHandler = (context, contextMetadata) => {
                         if (first) {
                             first = false;
-                            if (isEqual(currentContext, context)) {
+                            if (esToolkit.isEqual(currentContext, context)) {
                                 return;
                             }
                         }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openfin/fdc3-api",
-  "version": "45.100.59",
+  "version": "45.100.60",
   "description": "OpenFin fdc3 module utilities and types.",
   "license": "SEE LICENSE IN LICENSE.md",
   "private": false,
@@ -14,7 +14,7 @@
   ],
   "author": "OpenFin",
   "dependencies": {
-    "lodash": "^4.17.21",
+    "es-toolkit": "^1.39.3",
     "tslib": "2.8.1"
   },
   "scripts": {