@interopio/otel 0.1.15 → 0.1.17

package/dist/index.d.ts

@@ -39,6 +39,13 @@ export type InstanceCrashHandler = IOInsights.InstanceCrashHandler;
 export type InstanceCrashHandlerArgs = IOInsights.InstanceCrashHandlerArgs;
 export type InstanceErrorHandler = IOInsights.InstanceErrorHandler;
 export type InstanceErrorHandlerArgs = IOInsights.InstanceErrorHandlerArgs;
+export type InstanceHangHandler = IOInsights.InstanceHangHandler;
+export type InstanceHangHandlerArgs = IOInsights.InstanceHangHandlerArgs;
+export type InstanceLoadFailedHandler = IOInsights.InstanceLoadFailedHandler;
+export type InstanceLoadFailedHandlerArgs = IOInsights.InstanceLoadFailedHandlerArgs;
+export type InstanceReloadHandler = IOInsights.InstanceReloadHandler;
+export type InstanceReloadHandlerArgs = IOInsights.InstanceReloadHandlerArgs;
+export type ApplicationStack = IOInsights.ApplicationStack;
 export type InstanceFocusedHandler = IOInsights.InstanceFocusedHandler;
 export type InstanceFocusedHandlerArgs = IOInsights.InstanceFocusedHandlerArgs;
 export type InstanceReadyHandler = IOInsights.InstanceReadyHandler;

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AASC,CAAC;AAKF,qCAAoC;AAA3B,kGAAA,OAAO,OAAA;AAChB,wDAAuD;AAA9C,8GAAA,aAAa,OAAA;AACtB,yCAAwC;AAA/B,sGAAA,SAAS,OAAA;AA0BlB,uCAA4C;AAAnC,kGAAA,UAAU,OAAA;AACnB,+EAA8E;AAArE,oIAAA,wBAAwB,OAAA;AAgEjC,0DAAoD;AAC3C,iBADF,gBAAM,CACE;AAAE,yFADC,iBAAQ,OACD;AACZ,QAAA,WAAW,GAAG,iCAAiC,CAAC;AAC7D,iFAAyD;AAChD,2BADF,0BAAgB,CACE;AACzB,0EAAyE;AAAhE,gIAAA,sBAAsB,OAAA;AAY/B,oCAAmC;AAA1B,4FAAA,IAAI,OAAA;AAUb,iDAA4E;AAInE,uGAJA,qCAAsB,OAIA;AAAE,mGAJA,iCAAkB,OAIA;AAHnD,2CAAwC;AAI/B,uFAJA,eAAM,OAIA;AAHf,2DAAuD;AAGtC,8FAHR,8BAAa,OAGQ;AAF9B,iDAAgI;AAE1E,4FAF7C,uBAAW,OAE6C;AAAjC,qGAFV,gCAAoB,OAEU;AAAe,gHAFvB,2CAA+B,OAEuB;AAAE,2FAFvB,sBAAU,OAEuB;AAAE,4FAFvB,uBAAW,OAEuB;AAE3H,IAAI,OAAO,OAAO,KAAK,WAAW,EAAE,CAAC;IACnC,OAAO,CAAC,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,CAAC,CAAC,QAAa,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CACxE,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,CAAC;SACrB,IAAI,CAAC,CAAC,KAAU,EAAE,EAAE,CAAC,CAAC;QACnB,MAAM,EAAE,WAAW;QACnB,KAAK;KACR,CAAC,CAAC;SACF,KAAK,CAAC,CAAC,MAAW,EAAE,EAAE,CAAC,CAAC;QACrB,MAAM,EAAE,UAAU;QAClB,MAAM;KACT,CAAC,CAAC,CACN,CACF,CAAC,CAAC;AACL,CAAC;AACD,IAAK,cAcJ;AAdD,WAAK,cAAc;IACjB;;OAEG;IACH,qDAAS,CAAA;IACT;;;OAGG;IACH,+CAAM,CAAA;IACN;;OAEG;IACH,qDAAS,CAAA;AACX,CAAC,EAdI,cAAc,8BAAd,cAAc,QAclB"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AASC,CAAC;AAKF,qCAAoC;AAA3B,kGAAA,OAAO,OAAA;AAChB,wDAAuD;AAA9C,8GAAA,aAAa,OAAA;AACtB,yCAAwC;AAA/B,sGAAA,SAAS,OAAA;AA0BlB,uCAA4C;AAAnC,kGAAA,UAAU,OAAA;AACnB,+EAA8E;AAArE,oIAAA,wBAAwB,OAAA;AAuEjC,0DAAoD;AAC3C,iBADF,gBAAM,CACE;AAAE,yFADC,iBAAQ,OACD;AACZ,QAAA,WAAW,GAAG,iCAAiC,CAAC;AAC7D,iFAAyD;AAChD,2BADF,0BAAgB,CACE;AACzB,0EAAyE;AAAhE,gIAAA,sBAAsB,OAAA;AAY/B,oCAAmC;AAA1B,4FAAA,IAAI,OAAA;AAUb,iDAA4E;AAInE,uGAJA,qCAAsB,OAIA;AAAE,mGAJA,iCAAkB,OAIA;AAHnD,2CAAwC;AAI/B,uFAJA,eAAM,OAIA;AAHf,2DAAuD;AAGtC,8FAHR,8BAAa,OAGQ;AAF9B,iDAAgI;AAE1E,4FAF7C,uBAAW,OAE6C;AAAjC,qGAFV,gCAAoB,OAEU;AAAe,gHAFvB,2CAA+B,OAEuB;AAAE,2FAFvB,sBAAU,OAEuB;AAAE,4FAFvB,uBAAW,OAEuB;AAE3H,IAAI,OAAO,OAAO,KAAK,WAAW,EAAE,CAAC;IACnC,OAAO,CAAC,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,CAAC,CAAC,QAAa,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CACxE,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,CAAC;SACrB,IAAI,CAAC,CAAC,KAAU,EAAE,EAAE,CAAC,CAAC;QACnB,MAAM,EAAE,WAAW;QACnB,KAAK;KACR,CAAC,CAAC;SACF,KAAK,CAAC,CAAC,MAAW,EAAE,EAAE,CAAC,CAAC;QACrB,MAAM,EAAE,UAAU;QAClB,MAAM;KACT,CAAC,CAAC,CACN,CACF,CAAC,CAAC;AACL,CAAC;AACD,IAAK,cAcJ;AAdD,WAAK,cAAc;IACjB;;OAEG;IACH,qDAAS,CAAA;IACT;;;OAGG;IACH,+CAAM,CAAA;IACN;;OAEG;IACH,qDAAS,CAAA;AACX,CAAC,EAdI,cAAc,8BAAd,cAAc,QAclB"}

package/dist/metrics/metricsDependencyBuilder.d.ts

@@ -7,6 +7,9 @@ export declare class MetricsDependencyBuilder {
     private instanceFocusedHandler;
     private instanceErrorHandler;
     private instanceCrashHandler;
+    private instanceHangHandler;
+    private instanceLoadFailedHandler;
+    private instanceReloadHandler;
     private layoutRestoredHandler;
     private platformStartedHandler;
     private platformErrorHandler;
@@ -31,6 +34,9 @@ export declare class MetricsDependencyBuilder {
     withInstanceFocusedHandler(instanceFocusedHandler: IOInsights.InstanceFocusedHandler): this;
     withInstanceErrorHandler(instanceErrorHandler: IOInsights.InstanceErrorHandler): this;
     withInstanceCrashHandler(instanceCrashHandler: IOInsights.InstanceCrashHandler): this;
+    withInstanceHangHandler(instanceHangHandler: IOInsights.InstanceHangHandler): this;
+    withInstanceLoadFailedHandler(instanceLoadFailedHandler: IOInsights.InstanceLoadFailedHandler): this;
+    withInstanceReloadHandler(instanceReloadHandler: IOInsights.InstanceReloadHandler): this;
     withLayoutRestoredHandler(layoutRestoredHandler: IOInsights.LayoutRestoredHandler): this;
     withWorkspaceLoadedHandler(workspaceLoadedHandler: IOInsights.WorkspaceGenericActionHandler<IOInsights.WorkspaceLoadedHandlerArgs>): this;
     withWorkspaceSavedHandler(workspaceSavedHandler: IOInsights.WorkspaceGenericActionHandler<IOInsights.WorkspaceSavedHandlerArgs>): this;

package/dist/metrics/metricsDependencyBuilder.js

@@ -11,6 +11,9 @@ class MetricsDependencyBuilder {
         this.instanceReadyHandler = () => () => { };
         this.instanceErrorHandler = () => () => { };
         this.instanceCrashHandler = () => () => { };
+        this.instanceHangHandler = () => () => { };
+        this.instanceLoadFailedHandler = () => () => { };
+        this.instanceReloadHandler = () => () => { };
         this.layoutRestoredHandler = () => () => { };
         this.platformStartedHandler = () => () => { };
         this.platformErrorHandler = () => () => { };
@@ -37,6 +40,9 @@ class MetricsDependencyBuilder {
             instanceFocusedHandler: this.instanceFocusedHandler,
             instanceErrorHandler: this.instanceErrorHandler,
             instanceCrashHandler: this.instanceCrashHandler,
+            instanceHangHandler: this.instanceHangHandler,
+            instanceLoadFailedHandler: this.instanceLoadFailedHandler,
+            instanceReloadHandler: this.instanceReloadHandler,
             layoutRestoredHandler: this.layoutRestoredHandler,
             platformStartedHandler: this.platformStartedHandler,
             platformErrorHandler: this.platformErrorHandler,
@@ -80,6 +86,18 @@ class MetricsDependencyBuilder {
         this.instanceCrashHandler = instanceCrashHandler;
         return this;
     }
+    withInstanceHangHandler(instanceHangHandler) {
+        this.instanceHangHandler = instanceHangHandler;
+        return this;
+    }
+    withInstanceLoadFailedHandler(instanceLoadFailedHandler) {
+        this.instanceLoadFailedHandler = instanceLoadFailedHandler;
+        return this;
+    }
+    withInstanceReloadHandler(instanceReloadHandler) {
+        this.instanceReloadHandler = instanceReloadHandler;
+        return this;
+    }
     withLayoutRestoredHandler(layoutRestoredHandler) {
         this.layoutRestoredHandler = layoutRestoredHandler;
         return this;

package/dist/metrics/metricsDependencyBuilder.js.map

@@ -1 +1 @@
-{"version":3,"file":"metricsDependencyBuilder.js","sourceRoot":"","sources":["../../src/metrics/metricsDependencyBuilder.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"metricsDependencyBuilder.js","sourceRoot":"","sources":["../../src/metrics/metricsDependencyBuilder.ts"],"names":[],"mappings":"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"}

package/dist/metrics/nullMetricsManager.d.ts

@@ -1,8 +1,11 @@
+import { Attributes, ObservableResult } from "@opentelemetry/api";
 import { IOInsights } from "../../insights";
 import { NullManager } from "../nullManager";
 export declare class NullMetricsManager extends NullManager<IOInsights.MetricsSettings> implements IOInsights.MetricsManager {
     constructor(settings: IOInsights.MetricsSettings | undefined, otelSettings: IOInsights.Settings | undefined, logger: IOInsights.Logger);
+    getObservable<TData extends Attributes>(name: string, observeCallback: (result: ObservableResult<TData>) => Promise<void>, subscribeCallback?: () => Promise<void>, unsubscribeCallback?: () => Promise<void>): IOInsights.Metric | undefined;
+    getObservableFromSettings<TData extends Attributes>(settings: IOInsights.MetricSettings, observeCallback: (result: ObservableResult<TData>) => Promise<void>, subscribeCallback?: () => Promise<void>, unsubscribeCallback?: () => Promise<void>): IOInsights.Metric | undefined;
     waitForFinalExport(timeoutMs?: number | undefined): Promise<void>;
     getFromSettings(settings: IOInsights.MetricSettings): IOInsights.Metric | undefined;
-    get(type: IOInsights.MetricType): IOInsights.Metric | undefined;
+    get(name: string): IOInsights.Metric | undefined;
 }

package/dist/metrics/nullMetricsManager.js

@@ -11,14 +11,20 @@ class NullMetricsManager extends nullManager_1.NullManager {
         }
         super();
     }
+    getObservable(name, observeCallback, subscribeCallback, unsubscribeCallback) {
+        return new null_1.NullMetric({ name, type: "null", enabled: false, description: name });
+    }
+    getObservableFromSettings(settings, observeCallback, subscribeCallback, unsubscribeCallback) {
+        return new null_1.NullMetric(settings);
+    }
     waitForFinalExport(timeoutMs) {
         return Promise.resolve();
     }
     getFromSettings(settings) {
         return new null_1.NullMetric(settings);
     }
-    get(type) {
-        return new null_1.NullMetric({ name: type, type, enabled: false, description: type });
+    get(name) {
+        return new null_1.NullMetric({ name, type: "null", enabled: false, description: name });
     }
 }
 exports.NullMetricsManager = NullMetricsManager;

package/dist/metrics/nullMetricsManager.js.map

@@ -1 +1 @@
-{"version":3,"file":"nullMetricsManager.js","sourceRoot":"","sources":["../../src/metrics/nullMetricsManager.ts"],"names":[],"mappings":";;;AACA,gDAA6C;AAC7C,4DAAwD;AACxD,iCAAoC;AACpC,MAAa,kBAAmB,SAAQ,yBAAuC;IAC3E,YAAY,QAAgD,EAAE,YAA6C,EAAE,MAAyB;QAClI,IAAI,CAAA,YAAY,aAAZ,YAAY,uBAAZ,YAAY,CAAE,oBAAoB,MAAK,KAAK,EAAE,CAAC;YAC/C,MAAM,aAAN,MAAM,uBAAN,MAAM,CAAE,IAAI,CAAC,4CAA4C,IAAA,8BAAa,EAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;QACxF,CAAC;QACD,KAAK,EAAE,CAAC;IACZ,CAAC;IAED,kBAAkB,CAAC,SAA8B;QAC7C,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;IAC7B,CAAC;IACD,eAAe,CAAC,QAAmC;QAC/C,OAAO,IAAI,iBAAU,CAAC,QAAQ,CAAC,CAAC;IACpC,CAAC;IACM,GAAG,CAAC,IAA2B;QAClC,OAAO,IAAI,iBAAU,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC;IACnF,CAAC;CACJ;AAjBD,gDAiBC"}
+{"version":3,"file":"nullMetricsManager.js","sourceRoot":"","sources":["../../src/metrics/nullMetricsManager.ts"],"names":[],"mappings":";;;AAEA,gDAA6C;AAC7C,4DAAwD;AACxD,iCAAoC;AACpC,MAAa,kBAAmB,SAAQ,yBAAuC;IAC3E,YAAY,QAAgD,EAAE,YAA6C,EAAE,MAAyB;QAClI,IAAI,CAAA,YAAY,aAAZ,YAAY,uBAAZ,YAAY,CAAE,oBAAoB,MAAK,KAAK,EAAE,CAAC;YAC/C,MAAM,aAAN,MAAM,uBAAN,MAAM,CAAE,IAAI,CAAC,4CAA4C,IAAA,8BAAa,EAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;QACxF,CAAC;QACD,KAAK,EAAE,CAAC;IACZ,CAAC;IAEM,aAAa,CAChB,IAAY,EACZ,eAAmE,EACnE,iBAAuC,EACvC,mBAAyC;QACzC,OAAO,IAAI,iBAAU,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC;IACrF,CAAC;IAEM,yBAAyB,CAC5B,QAAmC,EACnC,eAAmE,EACnE,iBAAuC,EACvC,mBAAyC;QACzC,OAAO,IAAI,iBAAU,CAAC,QAAQ,CAAC,CAAC;IACpC,CAAC;IAED,kBAAkB,CAAC,SAA8B;QAC7C,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;IAC7B,CAAC;IACD,eAAe,CAAC,QAAmC;QAC/C,OAAO,IAAI,iBAAU,CAAC,QAAQ,CAAC,CAAC;IACpC,CAAC;IACM,GAAG,CAAC,IAAY;QACnB,OAAO,IAAI,iBAAU,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC;IACrF,CAAC;CACJ;AAjCD,gDAiCC"}

package/insights.d.ts

@@ -539,7 +539,10 @@ export namespace IOInsights {
     | "app_duration"
     | "app_duration_soft"
     | "app_error"
+    | "app_hang"
+    | "app_load_failed"
     | "app_memory"
+    | "app_reload"
     | "app_started"
     | "app_startup"
     | "app_stopped"
@@ -647,6 +650,9 @@ export namespace IOInsights {
     instanceFocusedHandler: InstanceFocusedHandler;
     instanceErrorHandler: InstanceErrorHandler;
     instanceCrashHandler: InstanceCrashHandler;
+    instanceHangHandler: InstanceHangHandler;
+    instanceLoadFailedHandler: InstanceLoadFailedHandler;
+    instanceReloadHandler: InstanceReloadHandler;
     layoutRestoredHandler: LayoutRestoredHandler;
     // vnikolov 2025-09-04 keeping these non-generic names to avoid breaking changes
     // in platforms
@@ -670,11 +676,19 @@ export namespace IOInsights {
    * @ignore
    */
   export type Unsubscribe = () => void;
+  /**
+   * Which runtime stack an application belongs to: "web" for renderer-backed
+   * applications (windows, workspaces, web groups), "exe" for external
+   * processes, "node" for node processes. Published as a metric attribute on
+   * the app_* metrics.
+   */
+  export type ApplicationStack = "web" | "exe" | "node" | "unknown";
   /**
    * @ignore
    */
   export interface InstanceActionHandlerArgs {
     application: string;
+    stack?: ApplicationStack;
   }
   /**
    * @ignore
@@ -685,6 +699,7 @@ export namespace IOInsights {
 
   export interface InstanceErrorHandlerArgs {
     application: string;
+    stack?: ApplicationStack;
   }
   /**
    * @ignore
@@ -708,6 +723,7 @@ export namespace IOInsights {
   export interface InstanceCrashHandlerArgs {
     application: string;
     reason: string;
+    stack?: ApplicationStack;
   }
   /**
    * @ignore
@@ -715,12 +731,72 @@ export namespace IOInsights {
   export type InstanceCrashHandler = (
     callback: (args: InstanceCrashHandlerArgs) => void
   ) => Unsubscribe;
+  /**
+   * @ignore
+   */
+  export interface InstanceHangHandlerArgs {
+    application: string;
+    /**
+     * How long the instance was unresponsive, in milliseconds: until it became
+     * responsive again, or until it was closed/killed while still hung.
+     */
+    durationMs: number;
+    /**
+     * Whether the instance became responsive again. false when it was
+     * closed/killed while still hung.
+     */
+    recovered?: boolean;
+    stack?: ApplicationStack;
+  }
+  /**
+   * @ignore
+   */
+  export type InstanceHangHandler = (
+    callback: (args: InstanceHangHandlerArgs) => void
+  ) => Unsubscribe;
+  /**
+   * @ignore
+   */
+  export interface InstanceLoadFailedHandlerArgs {
+    application: string;
+    /** Milliseconds from load start until the failure was determined. */
+    durationMs: number;
+    /** Why the load failed (e.g. "timeout", "crashed", "load-error"). */
+    reason?: string;
+    stack?: ApplicationStack;
+  }
+  /**
+   * @ignore
+   */
+  export type InstanceLoadFailedHandler = (
+    callback: (args: InstanceLoadFailedHandlerArgs) => void
+  ) => Unsubscribe;
+  /**
+   * @ignore
+   */
+  export interface InstanceReloadHandlerArgs {
+    application: string;
+    /**
+     * What initiated the reload, when known (e.g. "user" for F5/menu refresh,
+     * "app" for a page-initiated reload, "platform"). Keep the set of values
+     * small - it becomes a metric attribute.
+     */
+    initiator?: string;
+    stack?: ApplicationStack;
+  }
+  /**
+   * @ignore
+   */
+  export type InstanceReloadHandler = (
+    callback: (args: InstanceReloadHandlerArgs) => void
+  ) => Unsubscribe;
   /**
    * @ignore
    */
   export interface InstanceFocusedHandlerArgs {
     application: string;
     focused: boolean;
+    stack?: ApplicationStack;
   }
   /**
    * @ignore
@@ -847,6 +923,7 @@ export namespace IOInsights {
     startTime: Date;
     endTime: Date;
     api: string;
+    stack?: ApplicationStack;
   }
   /**
    * @ignore
@@ -886,6 +963,7 @@ export namespace IOInsights {
     app: string;
     instance: string;
     cpu: number;
+    stack?: ApplicationStack;
   }
   /**
    * @ignore
@@ -894,6 +972,7 @@ export namespace IOInsights {
     app: string;
     instance: string;
     memory: number;
+    stack?: ApplicationStack;
   }
   /**
    * @ignore
@@ -928,8 +1007,23 @@ export namespace IOInsights {
     /**
      * Called by the application to signify that its startup has completed
      * and no further spans should be nested under the startup trace.
+     *
+     * @param reason Optional description of the startup finalization status, gets added to the span
      */
-    startupTraceFinished?: () => void;
+    startupTraceFinished?: (reason?: string) => void;
+
+    /**
+     * Instruments Electron's main-process `net` module (net.request and net.fetch)
+     * with the request spans (source "interopio.api.instrumentation.electronNet" /
+     * ".fetch") and the same request metrics as the renderer fetch/XHR
+     * instrumentation. The net module is injected by the caller - io.Connect
+     * Desktop's bootstrap, guarded by instrumentRequests.platform - because the
+     * io.Insights packages have no electron dependency. Honors the
+     * instrumentRequests configuration (ignore/match patterns, ignoreTelemetryURLs,
+     * errorStatusCodes, spanNames, metric flags); no-op when instrumentRequests is
+     * disabled.
+     */
+    instrumentElectronNet?: (netModule: unknown) => void;
 
     /**
      * Optional callback function to programmatically create marker spans in the User Journey trace.
@@ -1240,36 +1334,85 @@ export namespace IOInsights {
     resultMetric?: string;
 
     /**
-     * If `true`, io.Insights will instrument and trace XMLHttpRequest and fetch()
-     * requests automatically.
-     * 
-     * @default true
+     * If `true` (or a configuration object with `enabled: true`), io.Insights
+     * will instrument and trace XMLHttpRequest and fetch() requests
+     * automatically. When enabled, the pre-init recorder (when installed)
+     * also captures requests from page start - opt out of that with the
+     * configuration object's `preInit: false`.
+     *
+     * @default false
      */
     instrumentRequests?: boolean | RequestTraceConfig;
 
+    /**
+     * If `true` (or a configuration object), WebSocket connections are instrumented:
+     * each connection is published as a span ("interopio.api.instrumentation.webSocket")
+     * covering its whole lifetime - construction until close - with the connect
+     * duration, negotiated protocol, close code/reason/wasClean, and message/byte
+     * totals in both directions. Abnormal closures (code 1006) and connection
+     * failures mark the span as ERROR. Optional message/byte counters and a
+     * connect-duration histogram can be enabled via the configuration object.
+     * Telemetry endpoints are never instrumented; the io.Connect gateway connection
+     * is tracked by default (its lifecycle is platform-health telemetry - exclude it
+     * with ignoreGateway), and ignorePattern can exclude other infrastructure sockets.
+     *
+     * When the pre-init module (early.js) is loaded, sockets are tracked from page
+     * start: connections that closed before initialization become retroactive spans,
+     * and connections still open are adopted with spans starting at their true
+     * construction time and counters carried across - a socket opened at bootstrap
+     * is fully observed. Without the pre-init module, sockets constructed before
+     * initialization are not observed at all.
+     *
+     * @default false
+     */
+    instrumentWebSockets?: boolean | WebSocketInstrumentationConfig;
+
+    /**
+     * If `true` (or a configuration object), session-level Web Vitals are tracked:
+     * CLS (cumulative layout shift, session-window algorithm), INP (interaction to
+     * next paint, the web-vitals estimation over Event Timing entries) and the final
+     * LCP. A "interopio.api.instrumentation.webVitals" span with the current values
+     * is published each time the page becomes hidden (when the values changed), and
+     * optional histogram metrics record one terminal sample per page at pagehide.
+     * Complements the startup trace's perf.vitals, which cover only the startup
+     * window - CLS accumulates and INP is defined over the whole session.
+     *
+     * @default false
+     */
+    instrumentWebVitals?: boolean | WebVitalsInstrumentationConfig;
+
     // https://github.com/open-telemetry/opentelemetry-browser/blob/main/packages/instrumentation/README.md#fetch
     /**
-     * If `true`, uncaught errors and unhandled promise rejections are published as
-     * error spans ("interopio.api.instrumentation.error" / ".unhandledRejection"),
+     * If `true` (or a configuration object with `enabled`), uncaught errors and
+     * unhandled promise rejections are published as error spans
+     * ("interopio.api.instrumentation.error" / ".unhandledRejection"),
      * including errors buffered before initialization by the pre-init recorder.
      * Capped per session to guard against error storms. When enabled, the app
-     * startup trace defers its own error capture to this instrumentation.
+     * startup trace defers its own error capture to this instrumentation, and
+     * the pre-init recorder (when installed) captures errors from page start -
+     * opt out of that with the configuration object's `preInit: false`.
      *
-     * @default true
+     * @default false
      */
-    instrumentErrors?: boolean;
+    instrumentErrors?: boolean | ErrorInstrumentationConfig;
 
     /**
-     * If `true`, resource loads (scripts, stylesheets, images, fonts, ...) are
-     * published as spans ("interopio.api.instrumentation.resource") with their real
-     * timings from the resource timing buffer, including resources loaded before
-     * initialization. fetch/XHR resources are excluded (the request instrumentation
-     * covers them in more detail), as are telemetry uploads. When enabled, the app
-     * startup trace defers its slowest-resource child spans to this instrumentation.
+     * If `true` (or a configuration object), resource loads (scripts, stylesheets,
+     * images, fonts, ...) are published as spans
+     * ("interopio.api.instrumentation.resource") with their real timings from the
+     * resource timing buffer, including resources loaded before initialization, a
+     * cacheState attribute ("hit", "revalidated", "network", or "unknown" -
+     * cross-origin resources without a Timing-Allow-Origin header withhold cache
+     * provenance), and the nonzero connection-phase timings (dns/connect/tls/ttfb).
+     * By default fetch/XHR resources are excluded (the request instrumentation
+     * covers them in more detail; see skipRequests), as are telemetry uploads.
+     * Optional histogram/counter metrics can be enabled via the configuration
+     * object. When enabled, the app startup trace defers its slowest-resource
+     * child spans to this instrumentation.
      *
-     * @default true
+     * @default false
      */
-    instrumentResources?: boolean;
+    instrumentResources?: boolean | ResourceInstrumentationConfig;
 
     /**
      * If `true`, in-page (SPA) navigations - history pushState/replaceState,
@@ -1277,10 +1420,24 @@ export namespace IOInsights {
      * ("interopio.api.instrumentation.navigation") with the sanitized from/to URLs.
      * Same-URL state updates are not reported.
      *
-     * @default true
+     * @default false
      */
     instrumentNavigation?: boolean;
 
+    /**
+     * If `true` (or a configuration object), event loop responsiveness is instrumented:
+     * slow input events (Event Timing API) and main-thread-blocking long frames
+     * (Long Animation Frames API, falling back to Long Tasks) are published as spans
+     * ("interopio.api.instrumentation.inputDelay" / ".eventLoopBlocking"), with the
+     * input-delay spans carrying the same element-describing attributes as the
+     * clickstream spans. Optional histogram metrics can be enabled via the
+     * configuration object. Entries recorded before initialization are replayed
+     * from the performance buffers.
+     *
+     * @default false
+     */
+    instrumentEventLoop?: boolean | EventLoopInstrumentationConfig;
+
     /**
      * If `true`, io.Insights will instrument and trace the application startup process
      * automatically.
@@ -1290,7 +1447,7 @@ export namespace IOInsights {
     instrumentAppStartup?: boolean;
 
     /**
-     * If `true`, io.Insights will instrument and trace the application loading process
+     * If `true`, io.Insights will instrument and trace the application initialization process
      * automatically.
      *
      * @default true
@@ -1300,7 +1457,7 @@ export namespace IOInsights {
 
     /**
      * If `true`, io.Insights will instrument and trace the steps of the document load
-     * and initialization process automatically
+     * process automatically
      *
      * @default true
      * @deprecated use instrumentAppStartup
@@ -1420,12 +1577,24 @@ export namespace IOInsights {
      */
     userJourney?: boolean | "nested" | "sibling" | UserJourneyTraceConfig;
     /**
-     * How long after application startup will any traced operations
-     * automatically be nested under the application startup trace.
+     * If non-zero, how long after application startup will any traced operations
+     * automatically be nested under the application startup trace. The timeout is counted from the moment
+     * the io.Connect API begins initializing.
      * 
-     * @default 3000 
+     * @default 0
      */
     startupParentSpanTimeoutMs?: number;
+    /**
+     * When will the application startup span be considered completed,
+     * so that further spans are added under it.
+     * * explicit - when Traces.instance.startupTraceFinished() is called by the application code
+     * * timeout - same as "explicit" OR when startupParentSpanTimeoutMs have elapsed and the DOMContentLoaded event has fired
+     * * loader - same as "explicit" OR when the loading animation of the window has completed
+     * * any - when any of the above conditions are met
+     * 
+     * @default "any"
+     */
+    startupParentSpanEnd?: "explicit" | "timeout" | "loader" | "any";
 
     /**
      * If `true`, the application will create a span with the name `interopio.api.application.close` when
@@ -1813,6 +1982,12 @@ export namespace IOInsights {
      * cross-origin ones - use it in filters whose `context.url` matches origins
      * known to accept the headers (e.g. via Access-Control-Allow-Headers).
      *
+     * Applies to the fetch/XHR instrumentation and to the platform's Electron
+     * net.request instrumentation. Note the main process has no origin, so
+     * `"same-origin"` never matches there - opt platform backends in with
+     * `"all-origins"` filters scoped by `context.url` (there is no CORS preflight
+     * risk for main-process requests).
+     *
      * @default false
      */
     injectOTELHeaders?: false | "same-origin" | "all-origins";
@@ -1918,12 +2093,79 @@ export namespace IOInsights {
     nestEventHandlersEagerly?: boolean;
   }
 
+  export interface ErrorInstrumentationConfig {
+    /**
+     * Whether uncaught errors and unhandled promise rejections are published
+     * as error spans.
+     */
+    enabled: boolean;
+
+    /**
+     * Unless `false`, the pre-init recorder (installEarlyInstrumentation from
+     * @interopio/insights-traces - installed by a window preload script or an
+     * inline snippet before the SDK loads) also captures uncaught errors and
+     * unhandled promise rejections from page start while this instrumentation
+     * is enabled. The recorder reads this configuration from
+     * glue42gd.insights; the buffered records are drained into this
+     * instrumentation's retroactive error spans (with their real timestamps)
+     * at initialization.
+     *
+     * @default true
+     */
+    preInit?: boolean;
+  }
+
   export interface RequestTraceConfig {
     /**
      * Whether fetch and XHR requests will be instrumented with traces automatically.
      */
     enabled: boolean;
 
+    /**
+     * If `true`, the io.Connect Desktop platform also instruments its OWN
+     * main-process HTTP traffic - Electron's net module (net.request and
+     * net.fetch) - at bootstrap, publishing through the platform's io.Insights
+     * instance with the same span and metric shapes as the renderer fetch/XHR
+     * instrumentation (spans under "interopio.api.instrumentation.electronNet").
+     * Read by the platform's bootstrap, which guards its call to
+     * TracesManager.instrumentElectronNet with it; has no effect outside the
+     * platform process.
+     *
+     * @default false
+     */
+    platform?: boolean;
+
+    /**
+     * Unless `false`, the pre-init recorder (installEarlyInstrumentation from
+     * @interopio/insights-traces - installed by a window preload script or an
+     * inline snippet before the SDK loads) also patches fetch and
+     * XMLHttpRequest, so requests issued before the SDK initializes are
+     * recorded and drained into retroactive spans and metric samples at
+     * initialization, while this instrumentation is enabled. The recorder
+     * reads this configuration from glue42gd.insights and derives its
+     * measurement settings from it - request body sizing from
+     * requestBytesMetric, responseBytesMeasurement, download-completion
+     * observation from the total/download duration metrics - so pre-init and
+     * live records measure identically.
+     *
+     * @default true
+     */
+    preInit?: boolean;
+
+    /**
+     * If `false`, no request spans are published - metrics-only mode. The whole
+     * instrumentation flow otherwise runs unchanged: measurement, the duration/size
+     * metrics, error classification, and the pre-init drain (which then produces
+     * metric samples but no retroactive spans). Applies to fetch, XHR, and the
+     * platform's Electron net instrumentation alike. Note that trace header
+     * injection requires a span context, so injectOTELHeaders has no effect in
+     * metrics-only mode. This is a hard switch - span filters cannot re-enable
+     * the spans.
+     *
+     * @default true
+     */
+    trace?: boolean;
+
     /**
      * Whether request instrumentation spans can be root spans of new traces. This allows you
      * to trace requests without any instrumentation in your own code, but may create a large
@@ -2042,6 +2284,31 @@ export namespace IOInsights {
      */
     requestBodyDownloadDurationMetricBuckets?: number[];
 
+    /**
+     * If `true` or a string, effective download throughput (response body bytes over
+     * the download window, in bytes per second) is published as a histogram metric.
+     * If a string value is specified, this will be the name of the metric. Otherwise,
+     * the default "io.insights.http.client.response.download.throughput" is used.
+     *
+     * Derived from the same observation as requestBodyDownloadDurationMetric (same
+     * population and cost caveats), so it contributes samples only for successful
+     * requests with an observable body completion - and only bodies of at least 32KB:
+     * smaller transfers complete within the initial congestion window and would
+     * measure round-trip time, not bandwidth. Per-stream effective throughput:
+     * concurrent transfers share the link.
+     *
+     * @default false
+     */
+    requestBodyDownloadThroughputMetric?: boolean | string;
+
+    /**
+     * Explicit histogram bucket boundaries for requestBodyDownloadThroughputMetric, in
+     * bytes per second, ascending.
+     *
+     * @default [65536, 262144, 1048576, 4194304, 16777216, 67108864, 268435456]
+     */
+    requestBodyDownloadThroughputMetricBuckets?: number[];
+
     /**
      * If `true` or a string, the request size in bytes will be published as a histogram metric.
      * If a string value is specified, this will be the name of the metric. Otherwise, the
@@ -2100,6 +2367,464 @@ export namespace IOInsights {
     responseBytesMeasurement?: "content-length" | "raw" | "both";
   }
 
+  /**
+   * Configuration for the event loop responsiveness instrumentation.
+   *
+   * Both measurements are event-driven (no polling): samples record only when the
+   * browser delivers a performance entry, so an idle or smooth application produces
+   * none. Metric export follows the meter's publish interval as usual.
+   */
+  export interface EventLoopInstrumentationConfig {
+    /**
+     * Whether the event loop instrumentation is enabled.
+     */
+    enabled: boolean;
+
+    /**
+     * If `false`, no spans are published - metrics-only mode: the input-delay
+     * and blocking histograms keep reporting. The master switch over
+     * inputDelaySpans/eventLoopBlockingSpans, which refine it per kind.
+     *
+     * @default true
+     */
+    trace?: boolean;
+
+    /**
+     * If `true`, slow input events are published as spans
+     * ("interopio.api.instrumentation.inputDelay") spanning the event's timestamp until
+     * its next paint, with the input delay / processing / presentation phases and the
+     * same element-describing attributes as the clickstream spans (elementIdOrPath,
+     * elementSelectorString, ...).
+     *
+     * @default true
+     */
+    inputDelaySpans?: boolean;
+
+    /**
+     * If `true` or a string, the input event queueing delay (event timestamp until its
+     * handlers started running - the event loop latency a user experienced) is published
+     * as a histogram metric. If a string value is specified, this will be the name of the
+     * metric. Otherwise, the default "io.insights.event_loop.input.delay" is used (no
+     * semantic convention exists for this metric).
+     *
+     * Only events whose total duration reaches inputDelayDurationThresholdMs are surfaced
+     * by the browser, so the distribution describes slow-ish interactions, not all input.
+     *
+     * @default false
+     */
+    inputDelayMetric?: boolean | string;
+
+    /**
+     * Explicit histogram bucket boundaries for inputDelayMetric, in seconds, ascending.
+     * The default brackets the INP "good" (0.2s) and "poor" (0.5s) thresholds.
+     *
+     * @default [0.001, 0.0025, 0.005, 0.01, 0.025, 0.05, 0.1, 0.25, 0.5, 1]
+     */
+    inputDelayMetricBuckets?: number[];
+
+    /**
+     * The Event Timing API durationThreshold, in milliseconds: only input events whose
+     * total duration (event timestamp until next paint) reaches this value are observed.
+     * The browser floor is 16ms.
+     *
+     * @default 16
+     */
+    inputDelayDurationThresholdMs?: number;
+
+    /**
+     * If `true`, only interaction-eligible events (Event Timing entries with a non-zero
+     * interactionId - discrete interactions like clicks and key presses, the population
+     * INP is computed over) are observed. Disabling it also surfaces continuous events
+     * (pointermoves etc.) that meet the duration threshold.
+     *
+     * @default true
+     */
+    inputDelayInteractionsOnly?: boolean;
+
+    /**
+     * If `true`, main-thread-blocking long frames are published as spans
+     * ("interopio.api.instrumentation.eventLoopBlocking") spanning the frame, with the
+     * blocking duration and (where the Long Animation Frames API is available) the
+     * attribution of the longest script in the frame.
+     *
+     * @default true
+     */
+    eventLoopBlockingSpans?: boolean;
+
+    /**
+     * If `true` or a string, the main-thread blocking time per long frame (the time
+     * beyond the 50ms threshold, per the Long Animation Frames API's blockingDuration;
+     * where only Long Tasks are available, task duration minus 50ms) is published as a
+     * histogram metric. If a string value is specified, this will be the name of the
+     * metric. Otherwise, the default "io.insights.event_loop.blocking.duration" is used
+     * (no semantic convention exists for this metric). Zero-blocking frames contribute
+     * no sample. The "measurement" attribute says which API produced each sample.
+     *
+     * @default false
+     */
+    eventLoopBlockingMetric?: boolean | string;
+
+    /**
+     * Explicit histogram bucket boundaries for eventLoopBlockingMetric, in seconds,
+     * ascending.
+     *
+     * @default [0.01, 0.025, 0.05, 0.1, 0.25, 0.5, 1, 2.5, 5]
+     */
+    eventLoopBlockingMetricBuckets?: number[];
+  }
+
+  /**
+   * Configuration for the resource load instrumentation.
+   *
+   * The phase metrics record nonzero samples only: with connection reuse most
+   * requests have no DNS/TCP/TLS phase at all, and recording those zeros would
+   * drown the distributions. Each histogram therefore answers "when this phase
+   * happened, what did it cost". Cross-origin resources without a
+   * Timing-Allow-Origin header withhold the detailed timings and sizes and
+   * contribute no phase/throughput samples.
+   */
+  export interface ResourceInstrumentationConfig {
+    /**
+     * Whether the resource instrumentation is enabled.
+     */
+    enabled: boolean;
+
+    /**
+     * If `true`, resource timing entries produced by fetch/XMLHttpRequest are
+     * skipped entirely (the request instrumentation covers those requests in more
+     * detail). Set to `false` to also publish resource spans and metric samples
+     * for them - e.g. to include API backends in the connection-phase and
+     * throughput metrics. Beacon entries and telemetry uploads are always skipped.
+     *
+     * @default true
+     */
+    skipRequests?: boolean;
+
+    /**
+     * If `false`, no resource spans are published - metrics-only mode: the
+     * phase/TTFB/throughput histograms and the cache-state counter keep reporting.
+     *
+     * @default true
+     */
+    trace?: boolean;
+
+    /**
+     * If `true` or a string, DNS lookup durations are published as a histogram
+     * metric ("io.insights.resource.dns.duration" unless a string names it).
+     * Nonzero lookups only. Tagged with server.address/server.port and the ALPN protocol.
+     *
+     * @default false
+     */
+    dnsDurationMetric?: boolean | string;
+
+    /**
+     * Explicit histogram bucket boundaries for dnsDurationMetric, in seconds, ascending.
+     *
+     * @default [0.001, 0.0025, 0.005, 0.01, 0.025, 0.05, 0.1, 0.25, 0.5, 1, 2.5]
+     */
+    dnsDurationMetricBuckets?: number[];
+
+    /**
+     * If `true` or a string, connection establishment durations (connectStart until
+     * connectEnd - includes the TLS handshake when one happened) are published as a
+     * histogram metric ("io.insights.resource.connect.duration" unless a string
+     * names it). Nonzero connects only.
+     *
+     * @default false
+     */
+    connectDurationMetric?: boolean | string;
+
+    /**
+     * Explicit histogram bucket boundaries for connectDurationMetric, in seconds, ascending.
+     *
+     * @default [0.001, 0.0025, 0.005, 0.01, 0.025, 0.05, 0.1, 0.25, 0.5, 1, 2.5]
+     */
+    connectDurationMetricBuckets?: number[];
+
+    /**
+     * If `true` or a string, TLS handshake durations (secureConnectionStart until
+     * connectEnd - a subset of the connect duration) are published as a histogram
+     * metric ("io.insights.resource.tls.duration" unless a string names it).
+     * Secure connections only.
+     *
+     * @default false
+     */
+    tlsDurationMetric?: boolean | string;
+
+    /**
+     * Explicit histogram bucket boundaries for tlsDurationMetric, in seconds, ascending.
+     *
+     * @default [0.001, 0.0025, 0.005, 0.01, 0.025, 0.05, 0.1, 0.25, 0.5, 1, 2.5]
+     */
+    tlsDurationMetricBuckets?: number[];
+
+    /**
+     * If `true` or a string, resource time-to-first-byte (requestStart until
+     * responseStart) is published as a histogram metric
+     * ("io.insights.resource.ttfb.duration" unless a string names it). Measures the
+     * asset-serving infrastructure, distinct from the request instrumentation's TTFB
+     * metric which covers fetch/XHR API traffic. Samples only resources that
+     * actually hit the network ("network" and "revalidated" cache states) - cache
+     * hits would contribute disk latency, not server latency.
+     *
+     * @default false
+     */
+    firstByteDurationMetric?: boolean | string;
+
+    /**
+     * Explicit histogram bucket boundaries for firstByteDurationMetric, in seconds, ascending.
+     *
+     * @default [0.005, 0.01, 0.025, 0.05, 0.075, 0.1, 0.25, 0.5, 0.75, 1, 2.5, 5, 7.5, 10]
+     */
+    firstByteDurationMetricBuckets?: number[];
+
+    /**
+     * If `true` or a string, effective download throughput (encodedBodySize over the
+     * responseStart-responseEnd window, in bytes per second) is published as a
+     * histogram metric ("io.insights.resource.download.throughput" unless a string
+     * names it). "network" cache state only, and only bodies of at least
+     * downloadThroughputMinBytes - smaller transfers complete within the initial
+     * congestion window and would measure round-trip time, not bandwidth. Note this
+     * is per-stream effective throughput: concurrent downloads share the link, so it
+     * reflects what a transfer experienced, not link capacity. For a byte-weighted
+     * aggregate, sum sizes and durations at query time instead of averaging rates.
+     *
+     * @default false
+     */
+    downloadThroughputMetric?: boolean | string;
+
+    /**
+     * Explicit histogram bucket boundaries for downloadThroughputMetric, in bytes
+     * per second, ascending.
+     *
+     * @default [65536, 262144, 1048576, 4194304, 16777216, 67108864, 268435456]
+     */
+    downloadThroughputMetricBuckets?: number[];
+
+    /**
+     * Minimum encodedBodySize, in bytes, for a resource to contribute a
+     * downloadThroughputMetric sample.
+     *
+     * @default 32768
+     */
+    downloadThroughputMinBytes?: number;
+
+    /**
+     * If `true` or a string, a counter of observed resource loads by cache state is
+     * published ("io.insights.resource.cache.state" unless a string names it),
+     * tagged with cacheState ("hit" / "revalidated" / "network" / "unknown") and
+     * server.address/server.port - the cache hit ratio falls out at query time.
+     *
+     * @default false
+     */
+    cacheStateMetric?: boolean | string;
+  }
+
+  /**
+   * Configuration for the WebSocket instrumentation.
+   */
+  export interface WebSocketInstrumentationConfig {
+    /**
+     * Whether the WebSocket instrumentation is enabled.
+     */
+    enabled: boolean;
+
+    /**
+     * If `true`, the io.Connect Desktop platform also tracks its OWN main-process
+     * WebSocket connections - most importantly its gateway connection, which is
+     * created before the platform's io.Insights initializes: the platform's
+     * bootstrap installs the pre-init recorder (with WebSocket tracking enabled)
+     * early enough that the connection is observed from construction, and the
+     * platform's io.Insights instance adopts it at initialization. Read by the
+     * platform's bootstrap; has no effect outside the platform process.
+     *
+     * @default false
+     */
+    platform?: boolean;
+
+    /**
+     * Unless `false`, the pre-init recorder (installEarlyInstrumentation from
+     * @interopio/insights-traces - installed by a window preload script or an
+     * inline snippet before the SDK loads) tracks WebSocket connections from
+     * page start while this instrumentation is enabled: connections closed
+     * before initialization become retroactive spans, still-open ones are
+     * adopted with spans starting at their true construction time. Opting out
+     * restricts the instrumentation to sockets constructed after
+     * initialization - a socket opened pre-init (the io.Connect gateway
+     * connection, bootstrap-time data feeds) is then unobservable for its
+     * whole lifetime, since WebSockets can only be intercepted at
+     * construction.
+     *
+     * @default true
+     */
+    preInit?: boolean;
+
+    /**
+     * If `true` (the default), each WebSocket connection is published as a span
+     * ("interopio.api.instrumentation.webSocket") covering construction until close,
+     * with connectMs, the negotiated protocol, close code/reason/wasClean, message
+     * and byte totals in both directions, and the connection duration. Abnormal
+     * closures (1006) and connection failures mark the span as ERROR.
+     *
+     * If `false`, no connection spans are published - metrics-only mode: the
+     * message/byte counters and the connect-duration histogram keep reporting.
+     *
+     * @default true
+     */
+    trace?: boolean;
+
+    /**
+     * If `true`, the io.Connect gateway connection is excluded from instrumentation.
+     * By default the gateway socket IS tracked: its connection lifecycle (connects,
+     * drops, close codes, reconnect attempts) is core platform-health telemetry. The
+     * gateway is recognized via the platform-provided connection URL
+     * (window.glue42gd.gwURL, compared by origin and path); where that is unavailable
+     * the flag has no effect - use ignorePattern to exclude infrastructure sockets
+     * explicitly.
+     *
+     * Cost note: with the message/byte metrics enabled, the gateway socket
+     * contributes a sample per gateway message - volume that describes io.Connect
+     * itself rather than the application. Enable those metrics deliberately, or set
+     * this flag to exclude the gateway.
+     *
+     * Sockets explicitly handed to the pre-init recorder via its trackWebSocket hook
+     * (e.g. the core-js gateway transport handing over its own connection) bypass
+     * this flag even when set - explicit handover is a deliberate opt-in.
+     * ignorePattern still applies to them and remains the veto.
+     *
+     * @default false
+     */
+    ignoreGateway?: boolean;
+
+    /**
+     * Optional regex pattern for WebSocket URLs that should be excluded from
+     * instrumentation - e.g. infrastructure sockets beyond the gateway connection
+     * (which can be excluded using ignoreGateway).
+     */
+    ignorePattern?: string;
+
+    /**
+     * Optional regex pattern; if specified, only matching WebSocket URLs are
+     * instrumented.
+     */
+    matchPattern?: string;
+
+    /**
+     * If `true` or a string, a counter of WebSocket messages is published
+     * ("io.insights.websocket.messages" unless a string names it), tagged with
+     * direction ("send" / "receive") and server.address/server.port.
+     *
+     * @default false
+     */
+    messagesMetric?: boolean | string;
+
+    /**
+     * If `true` or a string, a counter summing WebSocket payload bytes is published
+     * ("io.insights.websocket.bytes" unless a string names it), tagged with
+     * direction ("send" / "receive") and server.address/server.port.
+     *
+     * @default false
+     */
+    bytesMetric?: boolean | string;
+
+    /**
+     * If `true` or a string, the connection establishment time (construction until
+     * the open event) is published as a histogram metric
+     * ("io.insights.websocket.connect.duration" unless a string names it).
+     * Successful connections only.
+     *
+     * @default false
+     */
+    connectDurationMetric?: boolean | string;
+
+    /**
+     * Explicit histogram bucket boundaries for connectDurationMetric, in seconds, ascending.
+     *
+     * @default [0.01, 0.025, 0.05, 0.1, 0.25, 0.5, 1, 2.5, 5, 10]
+     */
+    connectDurationMetricBuckets?: number[];
+  }
+
+  /**
+   * Configuration for the session-level Web Vitals instrumentation.
+   *
+   * Values are reported when the page becomes hidden: a span with the current
+   * values on each hidden transition where they changed, and (for the metrics)
+   * one terminal sample per page at pagehide - so each session contributes a
+   * single sample per histogram.
+   */
+  export interface WebVitalsInstrumentationConfig {
+    /**
+     * Whether the Web Vitals instrumentation is enabled.
+     */
+    enabled: boolean;
+
+    /**
+     * If `true` (the default), a "interopio.api.instrumentation.webVitals" span
+     * carrying the current CLS/INP/LCP values and the interaction count is published
+     * on each transition to hidden where the values changed since the last report.
+     *
+     * If `false`, no webVitals spans are published - metrics-only mode: the
+     * terminal CLS/INP/LCP samples at pagehide keep reporting.
+     *
+     * @default true
+     */
+    trace?: boolean;
+
+    /**
+     * If `true` or a string, the session's cumulative layout shift is published as a
+     * histogram metric ("io.insights.web_vitals.cls" unless a string names it).
+     * Unitless score, session-window algorithm (shifts without recent input,
+     * windowed at 5s max / 1s gap, the worst window wins).
+     *
+     * @default false
+     */
+    clsMetric?: boolean | string;
+
+    /**
+     * Explicit histogram bucket boundaries for clsMetric (unitless score), ascending.
+     * The default brackets the CLS "good" (0.1) and "poor" (0.25) thresholds.
+     *
+     * @default [0.01, 0.025, 0.05, 0.1, 0.25, 0.5, 1, 2.5]
+     */
+    clsMetricBuckets?: number[];
+
+    /**
+     * If `true` or a string, the session's INP (interaction to next paint) is
+     * published as a histogram metric ("io.insights.web_vitals.inp" unless a string
+     * names it) - the worst interaction latency, moving to a high percentile as the
+     * interaction count grows, per the web-vitals estimation.
+     *
+     * @default false
+     */
+    inpMetric?: boolean | string;
+
+    /**
+     * Explicit histogram bucket boundaries for inpMetric, in seconds, ascending.
+     * The default brackets the INP "good" (0.2s) and "poor" (0.5s) thresholds.
+     *
+     * @default [0.04, 0.1, 0.2, 0.3, 0.5, 0.75, 1, 2.5, 5]
+     */
+    inpMetricBuckets?: number[];
+
+    /**
+     * If `true` or a string, the final largest contentful paint is published as a
+     * histogram metric ("io.insights.web_vitals.lcp" unless a string names it), in
+     * seconds from navigation start.
+     *
+     * @default false
+     */
+    lcpMetric?: boolean | string;
+
+    /**
+     * Explicit histogram bucket boundaries for lcpMetric, in seconds, ascending.
+     * The default brackets the LCP "good" (2.5s) and "poor" (4s) thresholds.
+     *
+     * @default [0.5, 1, 1.5, 2, 2.5, 4, 5, 7.5, 10, 15]
+     */
+    lcpMetricBuckets?: number[];
+  }
+
   /**
    * Configuration for User Journey trace behavior.
    * Controls how significant User Journey milestones are tracked throughout the platform session.
@@ -2256,11 +2981,11 @@ export namespace IOInsights {
      */
     levelCountMetric?: string;
 
-    /**
-     * How long after application startup will any log entries
-     * automatically be associated with the application startup trace.
-     */
-    startupTraceAssociationTimeoutMs?: number;
+    // /**
+    //  * How long after application startup will any log entries
+    //  * automatically be associated with the application startup trace.
+    //  */
+    // startupTraceAssociationTimeoutMs?: number;
 
     /**
      * If true, use a predefined list of filters for well-known

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@interopio/otel",
-  "version": "0.1.15",
+  "version": "0.1.17",
   "description": "io.Insights observability library",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",