@interopio/otel 0.0.145 → 0.0.148

package/dist/builder.d.ts

@@ -12,7 +12,8 @@ export declare class Builder {
     withTraces(): IOInsights.TracesManagerBuilder;
     build(): Container;
     private buildCore;
-    static propagateAttributesDown<T extends "additionalAttributes" | "additionalResourceAttributes">(k: T, otelSettings: {
+    static propagateAttributeDown<T extends IOInsights.MetricsSettings | IOInsights.LogsSettings | IOInsights.TracesSettings>(k: keyof IOInsights.Settings & keyof T, otelSettings: Partial<IOInsights.Settings>, settings?: T): void;
+    static propagateAttributesDown<T extends "additionalAttributes" | "additionalResourceAttributes" | "headers">(k: T, otelSettings: {
         [k in T]?: {
             [x: string]: unknown;
         } | (() => {

package/dist/builder.js

@@ -13,6 +13,7 @@ const nullManager_1 = require("./logs/nullManager");
 const manager_1 = require("./logs/manager");
 const safe_stringify_1 = require("./utils/safe-stringify");
 const constants_1 = require("./constants");
+const logWrapper_1 = require("./logger/logWrapper");
 class Builder {
     constructor() {
         this.logger = new null_1.NullLogger();
@@ -20,7 +21,16 @@ class Builder {
     // these methods must be invoked...
     withLogger(logger) {
         var _a;
-        this.logger = logger !== null && logger !== void 0 ? logger : this.logger;
+        if (logger) {
+            logger = new logWrapper_1.LogWrapper(logger, (_, msg) => {
+                var _a;
+                if (((_a = this.settings) === null || _a === void 0 ? void 0 : _a.suppressDoubleInitializationWarnings) &&
+                    ~(msg + "").indexOf("@opentelemetry/api: Attempted duplicate registration of API")) {
+                    return true;
+                }
+                return false;
+            });
+        }
         if (this.logger.level) {
             const level = (_a = this.logger.level) === null || _a === void 0 ? void 0 : _a.valueOf();
             api_1.diag.setLogger(this.logger, level);
@@ -76,6 +86,12 @@ class Builder {
             Builder.maybeAddResourceAttributesToAttributes(this.settings.logs);
             Builder.maybeAddResourceAttributesToAttributes(this.settings.metrics);
             Builder.maybeAddResourceAttributesToAttributes(this.settings.traces);
+            Builder.propagateAttributeDown("useSSOAuth", this.settings, this.settings.logs);
+            Builder.propagateAttributeDown("useSSOAuth", this.settings, this.settings.metrics);
+            Builder.propagateAttributeDown("useSSOAuth", this.settings, this.settings.traces);
+            Builder.propagateAttributesDown("headers", this.settings, this.settings.logs);
+            Builder.propagateAttributesDown("headers", this.settings, this.settings.metrics);
+            Builder.propagateAttributesDown("headers", this.settings, this.settings.traces);
             Builder.propagateAttributesDown("additionalAttributes", this.settings, this.settings.logs);
             Builder.propagateAttributesDown("additionalResourceAttributes", this.settings, this.settings.logs);
             Builder.propagateAttributesDown("additionalAttributes", this.settings, this.settings.metrics);
@@ -98,6 +114,13 @@ class Builder {
             return new container_1.Container(nonPartialSettings, new nullTracesManager_1.NullTracesManager(this.settings.traces, nonPartialSettings, this.logger), new nullMetricsManager_1.NullMetricsManager(this.settings.metrics, nonPartialSettings, this.logger), new nullManager_1.NullLogsManager(this.settings.logs, nonPartialSettings, this.logger), this.logger);
         }
     }
+    static propagateAttributeDown(k, otelSettings, settings) {
+        var _a;
+        if (!settings) {
+            return;
+        }
+        settings[k] = (_a = settings[k]) !== null && _a !== void 0 ? _a : otelSettings[k];
+    }
     static propagateAttributesDown(k, otelSettings, settings) {
         var _a, _b;
         if (!settings) {

package/dist/builder.js.map

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

package/dist/logger/logWrapper.d.ts

@@ -0,0 +1,12 @@
+import { IOInsights } from "../../insights";
+export declare class LogWrapper implements IOInsights.Logger {
+    private logger;
+    private dropLog;
+    constructor(logger: IOInsights.Logger, dropLog: (level: IOInsights.LoggerLogLevel, ...args: unknown[]) => boolean);
+    get level(): IOInsights.LoggerLogLevel;
+    error(message: string, ...args: unknown[]): void;
+    warn(message: string, ...args: unknown[]): void;
+    info(message: string, ...args: unknown[]): void;
+    debug(message: string, ...args: unknown[]): void;
+    verbose(message: string, ...args: unknown[]): void;
+}

package/dist/logger/logWrapper.js

@@ -0,0 +1,54 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LogWrapper = void 0;
+// wraps an OTEL library logger into an OTEL library logger
+// allows filtering messages etc
+class LogWrapper {
+    constructor(logger, dropLog) {
+        this.logger = logger;
+        this.dropLog = dropLog;
+    }
+    get level() {
+        var _a;
+        return (_a = this.logger.level) !== null && _a !== void 0 ? _a : 0 /* IOInsights.LoggerLogLevel.NONE */;
+    }
+    error(message, ...args) {
+        var _a;
+        if ((_a = this.dropLog) === null || _a === void 0 ? void 0 : _a.call(this, 50 /* IOInsights.LoggerLogLevel.WARN */, args)) {
+            return;
+        }
+        // we log errors as warn because some of our clients stopped the platform if an log error is observed (they consider it as broken state)
+        // we can do that since otel impl is not considered critical
+        this.logger.warn(message, ...args);
+    }
+    warn(message, ...args) {
+        var _a;
+        if ((_a = this.dropLog) === null || _a === void 0 ? void 0 : _a.call(this, 50 /* IOInsights.LoggerLogLevel.WARN */, args)) {
+            return;
+        }
+        this.logger.warn(message, ...args);
+    }
+    info(message, ...args) {
+        var _a;
+        if ((_a = this.dropLog) === null || _a === void 0 ? void 0 : _a.call(this, 60 /* IOInsights.LoggerLogLevel.INFO */, args)) {
+            return;
+        }
+        this.logger.info(message, ...args);
+    }
+    debug(message, ...args) {
+        var _a;
+        if ((_a = this.dropLog) === null || _a === void 0 ? void 0 : _a.call(this, 70 /* IOInsights.LoggerLogLevel.DEBUG */, args)) {
+            return;
+        }
+        this.logger.debug(message, ...args);
+    }
+    verbose(message, ...args) {
+        var _a;
+        if ((_a = this.dropLog) === null || _a === void 0 ? void 0 : _a.call(this, 80 /* IOInsights.LoggerLogLevel.VERBOSE */, args)) {
+            return;
+        }
+        this.logger.verbose(message, ...args);
+    }
+}
+exports.LogWrapper = LogWrapper;
+//# sourceMappingURL=logWrapper.js.map

package/dist/logger/logWrapper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logWrapper.js","sourceRoot":"","sources":["../../src/logger/logWrapper.ts"],"names":[],"mappings":";;;AAEA,2DAA2D;AAC3D,gCAAgC;AAChC,MAAa,UAAU;IAEnB,YACY,MAAyB,EACzB,OAA0E;QAD1E,WAAM,GAAN,MAAM,CAAmB;QACzB,YAAO,GAAP,OAAO,CAAmE;IACtF,CAAC;IAED,IAAW,KAAK;;QACZ,OAAO,MAAA,IAAI,CAAC,MAAM,CAAC,KAAK,yEAAkC,CAAC;IAC/D,CAAC;IAEM,KAAK,CAAC,OAAe,EAAE,GAAG,IAAe;;QAC5C,IAAI,MAAA,IAAI,CAAC,OAAO,8FAAmC,IAAI,CAAC,EAAE;YACtD,OAAO;SACV;QACD,wIAAwI;QACxI,4DAA4D;QAC5D,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,CAAC;IACvC,CAAC;IAEM,IAAI,CAAC,OAAe,EAAE,GAAG,IAAe;;QAC3C,IAAI,MAAA,IAAI,CAAC,OAAO,8FAAmC,IAAI,CAAC,EAAE;YACtD,OAAO;SACV;QACD,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,CAAC;IACvC,CAAC;IAEM,IAAI,CAAC,OAAe,EAAE,GAAG,IAAe;;QAC3C,IAAI,MAAA,IAAI,CAAC,OAAO,8FAAmC,IAAI,CAAC,EAAE;YACtD,OAAO;SACV;QACD,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,CAAC;IACvC,CAAC;IAEM,KAAK,CAAC,OAAe,EAAE,GAAG,IAAe;;QAC5C,IAAI,MAAA,IAAI,CAAC,OAAO,+FAAoC,IAAI,CAAC,EAAE;YACvD,OAAO;SACV;QACD,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,CAAC;IACxC,CAAC;IAEM,OAAO,CAAC,OAAe,EAAE,GAAG,IAAe;;QAC9C,IAAI,MAAA,IAAI,CAAC,OAAO,iGAAsC,IAAI,CAAC,EAAE;YACzD,OAAO;SACV;QACD,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,CAAC;IAC1C,CAAC;CACJ;AA/CD,gCA+CC"}

package/insights.d.ts

@@ -1,5 +1,6 @@
 /* eslint-disable @typescript-eslint/no-explicit-any */
 /* eslint-disable max-lines */
+import { Layout } from "log4js";
 import {
   Attributes,
   Context,
@@ -15,7 +16,7 @@ import {
   TracerProvider,
 } from "@opentelemetry/api";
 import { UserInteractionInstrumentationConfig as UserInteractionInstrumentationConfigBase } from "@opentelemetry/instrumentation-user-interaction";
-import {  LogRecord } from "@opentelemetry/api-logs";
+import { LogRecord } from "@opentelemetry/api-logs";
 import {
   CompressionAlgorithm,
   OTLPExporterConfigBase,
@@ -70,173 +71,87 @@ export namespace IOInsights {
     getFromSettings(settings: MetricSettings): Metric | undefined;
   }
   export interface MetricsManagerBuilder {
-      build(): MetricsManager;
-      withLogger(logger: Logger): this;
-      withSettings(settings: Settings): this;
-      withMeterProvider(func: MetricsMeterProviderCreateFunc): this;
-      withDependencyContainer(container: MetricsDependencyContainer): this;
+    build(): MetricsManager;
+    withLogger(logger: Logger): this;
+    withSettings(settings: Settings): this;
+    withMeterProvider(func: MetricsMeterProviderCreateFunc): this;
+    withDependencyContainer(container: MetricsDependencyContainer): this;
   }
 
-  export type MetricsMeterProviderCreateFunc = () => { meterProvider: MetricsMeterProvider, metricReader: MetricReader };
-  
+  export type MetricsMeterProviderCreateFunc = () => {
+    meterProvider: MetricsMeterProvider;
+    metricReader: MetricReader;
+  };
+
   export interface MetricsMeterProvider extends MeterProvider {
-      forceFlush(): Promise<void>;
+    forceFlush(): Promise<void>;
   }
 
+  /**
+   * @ignore
+   */
   export interface MetricsFactory {
-      create<TData extends Attributes>(
-          settings: MetricSettings,
-          generalSettings: MetricsSettings,
-          observeCallback?: (result: ObservableResult<TData>) => Promise<void>,
-          subscribeCallback?: () => Promise<void>,
-          unsubscribeCallback?: () => Promise<void>): Metric;
+    create<TData extends Attributes>(
+      settings: MetricSettings,
+      generalSettings: MetricsSettings,
+      observeCallback?: (result: ObservableResult<TData>) => Promise<void>,
+      subscribeCallback?: () => Promise<void>,
+      unsubscribeCallback?: () => Promise<void>
+    ): Metric;
   }
-  
-  export type CreateMetricFunc = (settings: MetricSettings, generalSettings: MetricsSettings) => Metric;
-  // /**
-  //  * Traces API.
-  //  */
-  export interface TracesManager extends Manager<TracesSettings> {
-    currentTracingState: TracingState | null;
+  /**
+   * @ignore
+   */
+  export type CreateMetricFunc = (
+    settings: MetricSettings,
+    generalSettings: MetricsSettings
+  ) => Metric;
 
+  export interface MetricsSettings {
+    useSSOAuth?: boolean;
     /**
-     * Called by the application to signify that its startup has completed
-     * and no further spans should be nested under the startup trace.
+     * Optional override for the dependency container providing platform-specific metric handlers.
      */
-    startupTraceFinished?: () => void;
-
-    setStartupTraceFinished(startupTraceFinished: () => void): void;
-
-    userJourneyMarker?: MarkerSpanCallback;
-    setUserJourneyMarker(userJourneyMarker: MarkerSpanCallback): void;
-
-    clickstreamMarker?: MarkerSpanCallback;
-    setClickstreamMarker(clickstreamMarker: MarkerSpanCallback): void;
-
-    setFilterConfig(filters: SpanFilter[]): void;
-    withSpan<T>(source: string, callback: WithSpanCallback<T>): T;
-
-    withSpan<T>(
-      source: string,
-      filteringContext: FilteringContext,
-      callback: WithSpanCallback<T>
-    ): T;
-
-    withSpan<T>(
-      source: string,
-      filteringContext: FilteringContext,
-      propagationInfo: PropagationInfo | PropagationInfoCarrier | null,
-      callback: WithSpanCallback<T>
-    ): T;
-
-    withSpan<T>(
-      source: string,
-      filteringContext: FilteringContext,
-      propagationInfo: PropagationInfo | PropagationInfoCarrier | null,
-      options: WithSpanOptions | null,
-      callback: WithSpanCallback<T>
-    ): T;
-  }
-
-  export interface LogsManager extends Manager<LogsSettings> {
-    emit(logRecord: LogRecord): Promise<void> | null;
-  }
-
-  export interface Manager<TSettings> {
-    settings: TSettings;
-    started: boolean;
-
-    start(): Promise<void>;
-    stop(): Promise<void>;
-    waitForFinalExport(timeoutMs?: number): Promise<void>;
-  }
-
-  export interface Settings {
+    dependencyContainerOverride?: MetricsDependencyContainer;
     /**
-     * Whether library is enabled.
+     * Whether metrics functionality is enabled.
      * If disabled, API is still usable, but methods are no-ops.
+     * 
+     * @default false
      */
     enabled: boolean;
     /**
-     * Interval in milliseconds to wait for any remaining telemetry data to be exported during shutdown of the platform. This is the maximum awaiting interval and the platform may shutdown before it expires if all telemetry data has already been published.
-     */
-    finalExportTimeoutMs?: number;
-    /**
-     * Interval in milliseconds to wait for any remaining telemetry data to be published by any apps before proceeding with the platform shutdown.
-     */
-    finalExportGracePeriodMs?: number;
-
-    errorlessMode?: boolean;
-    /**
-     * If the library should log the settings used to initialize it.
-     *
-     * @default true
-     */
-    logSettingsOnStartup?: boolean;
-    /**
-     * If failure to initialize library will throw upstream error.
+     * Whether to enable automatic collection of platform-level metrics (CPU, memory, etc.).
      */
-    failOnInitError?: boolean;
-    /**
-     * If provided, this value will be added to the metrics and span attributes
-     * and to the span filtering context (see 'filters' in TracesSettings).
-     */
-    platformVersion?: string;
+    platformMetricsEnabled?: boolean;
     /**
-     * If provided, this value will be added to the metrics and traces service.name attribute,
-     * unless an OTEL service object (e.g. TraceProvider) has been provided to the library with
-     * a different setting.
+     * Array of individual metric configurations to collect.
      */
-    serviceName?: string;
+    metrics?: MetricSettings[];
     /**
-     * If provided, this value will be added to the metrics and traces service.instance.id attribute,
-     * unless an OTEL service object (e.g. TraceProvider) has been provided to the library with
-     * a different setting.
+     * The destination URL for exporting metrics via OTLP.
      */
-    serviceId?: string;
-    /**
-     * If provided, this value will be added to the metrics and traces service.version attribute,
-     * unless an OTEL service object (e.g. TraceProvider) has been provided to the library with
-     * a different setting.
-     * attribute.
-     */
-    serviceVersion?: string;
+    url?: string;
     /**
-     * If provided, this value will be added to the metrics and traces user.id attribute,
-     * unless an OTEL service object (e.g. TraceProvider) has been provided to the library with
-     * a different setting.
+     * Interval in milliseconds between metric export batches.
      */
-    userId?: string;
-
+    publishInterval?: number;
     /**
-     * Additional headers to send in HTTP requests, e.g. when using HTTP exporters.
+     * Compression algorithm to use when exporting metrics.
      */
-    headers?: { [x: string]: string } | (() => { [x: string]: string });
+    compression?: CompressionAlgorithm;
     /**
-     * Additional attributes to add to observability entities (metrics, spans, log entries) by default.
+     * Hostname to include in exported metrics.???????
      */
-    additionalAttributes?: { [x: string]: unknown } | (() => { [x: string]: unknown });
+    hostname?: string;
     /**
-     * Additional attributes to add to the observability resource definition.
+     * Whether to use HTTP keep-alive connections for metric exports.
      */
-    additionalResourceAttributes?: { [x: string]: unknown } | (() => { [x: string]: unknown });
-
-    traces?: TracesSettings;
-    metrics?: MetricsSettings;
-    logs?: LogsSettings;
-  }
-
-  export interface MetricsSettings {
-    dependencyContainerOverride?: MetricsDependencyContainer;
-    enabled: boolean;
-    platformMetricsEnabled?: boolean;
-    metrics?: MetricSettings[];
-    url?: string;
-    publishInterval?: number;
-    compression?: CompressionAlgorithm;
-    hostname?: string;
     keepAlive?: boolean;
     // httpAgentOptions?: http.AgentOptions | https.AgentOptions;
+    /**
+     * Maximum number of concurrent metric export requests.
+     */
     concurrencyLimit?: number;
     /** Maximum time the OTLP exporter will wait for each batch export.
      * The default value is 10000ms. */
@@ -245,22 +160,33 @@ export namespace IOInsights {
      * Additional headers to send in HTTP requests, e.g. when using HTTP exporters.
      */
     headers?: { [x: string]: string } | (() => { [x: string]: string });
+    /**
+     * Whether to add resource attributes to metric data point attributes.
+     */
     addResourceAttributesToAttributes?: boolean;
     /**
-     * Additional attributes to add to observability entities (metrics, spans, log entries) by default.
+     * Additional metrics properties to publish as part of each metric, specified as key/value pairs. You can use environment variables as values. Environment variables must start and end with a percent sign (e.g., `%MyEnvVar%`), and can contain a fallback value (e.g., `%MyEnvVar?literalDefaultValue%`).
      */
     additionalAttributes?: { [x: string]: unknown } | (() => { [x: string]: unknown });
     /**
-     * Additional attributes to add to the observability resource definition.
+     * Additional attributes to publish as part of the OTEL resource definition, specified as key/value pairs. You can use environment variables as values. Environment variables must start and end with a percent sign (e.g., `%MyEnvVar%`), and can contain a fallback value (e.g., `%MyEnvVar?literalDefaultValue%`).
      */
     additionalResourceAttributes?: { [x: string]: unknown } | (() => { [x: string]: unknown });
-
+    /**
+     * Partial MetricsSettings for meter configuration.
+     */
     meter?: Partial<MetricsSettings>;
-
+    /**
+     * Custom metric exporter implementation for pushing metrics.
+     */
     metricExporter?: PushMetricExporter;
-
+    /**
+     * Array of filter rules to determine which metrics should be collected and exported.
+     */
     filters?: MetricFilter[];
-
+    /**
+     * Whether to apply predefined default filters for platform metrics.
+     */
     useDefaultFilters?: boolean;
   }
   export interface MetricSettings {
@@ -283,16 +209,26 @@ export namespace IOInsights {
     start(): Promise<void>;
     stop(): Promise<void>;
   }
+
+  /**
+   * @ignore
+   */
   export interface MetricData extends Attributes {
     platformVersion?: string;
     user?: string;
-}
+  }
+  /**
+   * @ignore
+   */
   export interface ApplicationMetricData extends MetricData {
     application: string;
   }
 
+  /**
+   * @ignore
+   */
   export interface LayoutMetricData extends MetricData {
-      layout: string;
+    layout: string;
   }
 
   export type MetricType =
@@ -340,20 +276,25 @@ export namespace IOInsights {
     /*rest:      */
     | "null";
 
-  export interface MetricDefaultFilter
-  {
-      type?: MetricType;
-      enabled: boolean;
-      overrideDefaultFilters?: boolean;
-      attributes?: {
-          complexLoad?: boolean;
-          includesFrameCreation?: boolean;
-      }
+  export interface MetricDefaultFilter {
+    type?: MetricType;
+    enabled: boolean;
+    overrideDefaultFilters?: boolean;
+    attributes?: {
+      /**
+       * Indicates whether the workspace loading involved a complex operation where existing apps are added to a new workspace.
+       * This attribute can be used to filter out metrics.
+       */
+      complexLoad?: boolean;
+      /**
+       * Indicates whether the metric includes the time to create and load the Workspace Frame App when the workspace is opened in a new frame.
+       */
+      includesFrameCreation?: boolean;
+    };
   }
-  export interface MetricFilter extends MetricDefaultFilter
-  {
-      name: string;
-      type: MetricType;
+  export interface MetricFilter extends MetricDefaultFilter {
+    name: string;
+    type: MetricType;
   }
   export interface MetricsDependencyContainer {
     performanceProvider: PerformanceProvider;
@@ -441,7 +382,14 @@ export namespace IOInsights {
   export interface WorkspaceTimedActionHandlerArgs extends WorkspaceActionHandlerArgs {
     startTime: Date;
     endTime: Date;
+    /**
+     * Indicates whether the workspace loading involved a complex operation where existing apps are added to a new workspace.
+     * This attribute can be used to filter out metrics.
+     */
     complexLoad: boolean;
+    /**
+     * Indicates whether the metric includes the time to create and load the Workspace Frame App when the workspace is opened in a new frame.
+     */
     includesFrameCreation: boolean;
     [x: string]: any;
   }
@@ -449,16 +397,30 @@ export namespace IOInsights {
   export interface WorkspaceRestoredHandlerArgs extends WorkspaceActionHandlerArgs {
     startTime: Date;
     endTime: Date;
+    /**
+     * Indicates whether the workspace loading involved a complex operation where existing apps are added to a new workspace.
+     * This attribute can be used to filter out metrics.
+     */
     complexLoad?: boolean;
+    /**
+     * Indicates whether the metric includes the time to create and load the Workspace Frame App when the workspace is opened in a new frame.
+     */
     includesFrameCreation?: boolean;
     [x: string]: any;
   }
 
   export interface WorkspaceAppsStartedHandlerArgs extends WorkspaceTimedActionHandlerArgs {
+    /**
+     * Indicates whether the workspace loading involved a complex operation where existing apps are added to a new workspace.
+     * This attribute can be used to filter out metrics.
+     */
     complexLoad: boolean;
   }
 
   export interface WorkspaceStartupHandlerArgs extends WorkspaceAppsStartedHandlerArgs {
+    /**
+     * Indicates whether the metric includes the time to create and load the Workspace Frame App when the workspace is opened in a new frame.
+     */
     includesFrameCreation: boolean;
   }
 
@@ -475,9 +437,9 @@ export namespace IOInsights {
   ) => Unsubscribe;
 
   export type WorkspaceActionHandler = WorkspaceGenericActionHandler<WorkspaceActionHandlerArgs>;
-  export type WorkspaceLoadedHandler =
-    WorkspaceGenericActionHandler<WorkspaceLoadedHandlerArgs>;
-  export type WorkspaceRestoredHandler = WorkspaceGenericActionHandler<WorkspaceRestoredHandlerArgs>;
+  export type WorkspaceLoadedHandler = WorkspaceGenericActionHandler<WorkspaceLoadedHandlerArgs>;
+  export type WorkspaceRestoredHandler =
+    WorkspaceGenericActionHandler<WorkspaceRestoredHandlerArgs>;
   export type WorkspaceSavedHandler = WorkspaceGenericActionHandler<WorkspaceSavedHandlerArgs>;
 
   export interface InstanceReadyHandlerArgs {
@@ -533,6 +495,77 @@ export namespace IOInsights {
     systemFree: number;
   }
 
+  /**
+   * Traces API.
+   */
+  export interface TracesManager extends Manager<TracesSettings> {
+    currentTracingState: TracingState | null;
+
+    /**
+     * Called by the application to signify that its startup has completed
+     * and no further spans should be nested under the startup trace.
+     */
+    startupTraceFinished?: () => void;
+
+    setStartupTraceFinished(startupTraceFinished: () => void): void;
+
+    /**
+     * Optional callback function to programmatically create marker spans in the User Journey trace.
+     * Allows applications to mark significant points in a user's journey through the application
+     * (e.g., navigation events, key user actions, milestone completions).
+     *
+     * The callback receives:
+     * - source: A descriptive name for the marker (e.g., "user-navigated-to-dashboard")
+     * - data: Optional span data organized by verbosity level for detailed context
+     *
+     * Returns either PropagationInfo to link the marker span to other traces, or void.
+     *
+     * Works in conjunction with the userJourney setting to track the user's entire session flow.
+     */
+    userJourneyMarker?: MarkerSpanCallback;
+    setUserJourneyMarker(userJourneyMarker: MarkerSpanCallback): void;
+
+    /**
+     * Optional callback function to programmatically create marker spans in the Clickstream trace.
+     * Allows applications to mark specific user interaction events beyond automatic click tracking
+     * (e.g., custom UI interactions, gesture events, programmatic actions).
+     *
+     * The callback receives:
+     * - source: A descriptive name for the marker (e.g., "user-swiped-left", "custom-button-action")
+     * - data: Optional span data organized by verbosity level for detailed context
+     *
+     * Returns either PropagationInfo to link the marker span to other traces, or void.
+     *
+     * Works in conjunction with the clickstream setting to track detailed user interaction patterns.
+     */
+    clickstreamMarker?: MarkerSpanCallback;
+    setClickstreamMarker(clickstreamMarker: MarkerSpanCallback): void;
+
+    setFilterConfig(filters: SpanFilter[]): void;
+    withSpan<T>(source: string, callback: WithSpanCallback<T>): T;
+
+    withSpan<T>(
+      source: string,
+      filteringContext: FilteringContext,
+      callback: WithSpanCallback<T>
+    ): T;
+
+    withSpan<T>(
+      source: string,
+      filteringContext: FilteringContext,
+      propagationInfo: PropagationInfo | PropagationInfoCarrier | null,
+      callback: WithSpanCallback<T>
+    ): T;
+
+    withSpan<T>(
+      source: string,
+      filteringContext: FilteringContext,
+      propagationInfo: PropagationInfo | PropagationInfoCarrier | null,
+      options: WithSpanOptions | null,
+      callback: WithSpanCallback<T>
+    ): T;
+  }
+
   interface TracingState {
     end(): void;
     /**
@@ -574,6 +607,7 @@ export namespace IOInsights {
   }
 
   export interface TracesSettings {
+    useSSOAuth?: boolean;
     /**
      * Name of span hit counter metric, set to null to disable.
      *
@@ -597,7 +631,7 @@ export namespace IOInsights {
      * Whether tracing functionality is enabled.
      * If disabled, API is still usable, but methods are no-ops.
      *
-     * Defaults to 'false'.
+     * @default false
      */
     enabled: boolean;
 
@@ -657,13 +691,17 @@ export namespace IOInsights {
     url?: string;
     /**
      * Whether the clickstream trace will be enabled.
-     *
+     * false - clickstream trace is disabled.
+     * nested - clickstream trace is enabled and each subsequent span is a child span of the previous one.
+     * sibling - clickstream trace is enabled and each subsequent span is a child of the same initial span.
      * @default false
      */
     clickstream?: boolean | "nested" | "sibling" | ClickstreamTraceConfig;
     /**
      * Whether the user journey trace will be enabled.
-     *
+     * false - User Journey trace is disabled.
+     * nested - User Journey trace is enabled and each subsequent span is a child span of the previous one.
+     * sibling - User Journey trace is enabled and each subsequent span is a child of the same initial span.
      * @default true
      */
     userJourney?: boolean | "nested" | "sibling" | UserJourneyTraceConfig;
@@ -679,9 +717,33 @@ export namespace IOInsights {
     startupTraceFinished?: () => void;
 
     closeTrace?: boolean;
-
+    /**
+     * Optional callback function to programmatically create marker spans in the Clickstream trace.
+     * Allows applications to mark specific user interaction events beyond automatic click tracking
+     * (e.g., custom UI interactions, gesture events, programmatic actions).
+     *
+     * The callback receives:
+     * - source: A descriptive name for the marker (e.g., "user-swiped-left", "custom-button-action")
+     * - data: Optional span data organized by verbosity level for detailed context
+     *
+     * Returns either PropagationInfo to link the marker span to other traces, or void.
+     *
+     * Works in conjunction with the clickstream setting to track detailed user interaction patterns.
+     */
     clickstreamMarker?: MarkerSpanCallback;
-
+    /**
+     * Optional callback function to programmatically create marker spans in the User Journey trace.
+     * Allows applications to mark significant points in a user's journey through the application
+     * (e.g., navigation events, key user actions, milestone completions).
+     *
+     * The callback receives:
+     * - source: A descriptive name for the marker (e.g., "user-navigated-to-dashboard")
+     * - data: Optional span data organized by verbosity level for detailed context
+     *
+     * Returns either PropagationInfo to link the marker span to other traces, or void.
+     *
+     * Works in conjunction with the userJourney setting to track the user's entire session flow.
+     */
     userJourneyMarker?: MarkerSpanCallback;
 
     /**
@@ -693,13 +755,24 @@ export namespace IOInsights {
      * 'otlpExporterConfig' as additional * config.
      */
     otlpExporterConfig?: OTLPExporterNodeConfigBase;
-
+    /**
+     * OTEL TracerConfig - provides an interface for configuring a Basic Tracer.
+     */
     tracerProviderConfig?: TracerConfig;
-
+    /**
+     * Configuration for the batch span processor buffer settings.
+     */
     batchSpanProcessorConfig?: BufferConfig;
 
+    /**
+     * Configuration for automatic instrumentation of common browser operations.
+     * Enables automatic tracing of document load, user interactions, fetch requests, and XHR calls.
+     */
     autoInstrumentations?: AutoInstrumentationOptions;
 
+    /**
+     * Maximum length for parent operation names in span hierarchies.
+     */
     parentNameLimit?: number;
     /**
      * If an OTEL TraceProvider isn't provided to the library,
@@ -716,11 +789,11 @@ export namespace IOInsights {
     headers?: { [x: string]: string } | (() => { [x: string]: string });
     addResourceAttributesToAttributes?: boolean;
     /**
-     * Additional attributes to add to observability entities (metrics, spans, log entries) by default.
+     * Additional span attributes to publish as part of each span, specified as key/value pairs. You can use environment variables as values. Environment variables must start and end with a percent sign (e.g., `%MyEnvVar%`), and can contain a fallback value (e.g., `%MyEnvVar?literalDefaultValue%`).
      */
     additionalAttributes?: { [x: string]: unknown } | (() => { [x: string]: unknown });
     /**
-     * Additional attributes to add to the observability resource definition.
+     * Additional attributes to publish as part of the OTEL resource definition, specified as key/value pairs. You can use environment variables as values. Environment variables must start and end with a percent sign (e.g., `%MyEnvVar%`), and can contain a fallback value (e.g., `%MyEnvVar?literalDefaultValue%`).
      */
     additionalResourceAttributes?: { [x: string]: unknown } | (() => { [x: string]: unknown });
 
@@ -749,10 +822,13 @@ export namespace IOInsights {
   export type WithSpanCallback<T> = (tracingState: TracingState) => T;
 
   export interface WithSpanDecoratorOptions extends WithSpanOptions {
-    argMapping?: { [x: string]: string } | Array<string | null | undefined> | ((...args: any[]) => any);
+    argMapping?:
+      | { [x: string]: string }
+      | Array<string | null | undefined>
+      | ((...args: any[]) => any);
     thisMapping?: { [x: string]: string } | ((that: any) => any);
   }
-  
+
   export interface PropagationInfo {
     traceparent?: string;
     tracestate?: string;
@@ -934,6 +1010,10 @@ export namespace IOInsights {
       [key: string]: string | number | boolean;
     };
   }
+  /**
+   * Configuration for automatic instrumentation of common browser operations.
+   * Enables automatic tracing of document load, user interactions, fetch requests, and XHR calls.
+   */ 
   export interface AutoInstrumentationOptions {
     documentLoad?: boolean | DocumentLoadInstrumentationConfig;
     userInteraction?: boolean | UserInteractionInstrumentationConfig;
@@ -975,26 +1055,153 @@ export namespace IOInsights {
     sample: number | boolean;
   }
 
+  /**
+   * Configuration for automatic instrumentation of user interactions.
+   * Extends the base OpenTelemetry user interaction instrumentation with additional throttling options.
+   */
   export interface UserInteractionInstrumentationConfig
     extends UserInteractionInstrumentationConfigBase {
+    /**
+     * Minimum interval in milliseconds between capturing consecutive user interaction events.
+     * Used to throttle high-frequency interactions and reduce span volume.
+     */
     throttleIntervalMs?: number;
   }
 
+  /**
+   * Configuration for clickstream trace behavior.
+   * Controls how user interaction events are tracked and organized in traces.
+   */
+  export interface ClickstreamTraceConfig {
+    enabled: boolean;
+    structure?: "sibling" | "nested";
+    descriptiveName?: boolean;
+    events?: string[];
+  }
+
+  /**
+   * Configuration for user journey trace behavior.
+   * Controls how significant user journey milestones are tracked throughout the application session.
+   */
+  export interface UserJourneyTraceConfig {
+    enabled: boolean;
+    structure?: "sibling" | "nested";
+    descriptiveName?: boolean;
+    chainLength?: number;
+  }
+
+  /**
+   * Callback function type for creating marker spans in user journey or clickstream traces.
+   * 
+   * @param source - Descriptive name for the marker span (e.g., "checkout-completed", "navigation-event")
+   * @param data - Optional span data organized by verbosity level, allowing different detail levels for different environments
+   * @returns Either PropagationInfo to link the marker span to other traces, or void
+   */
+  export type MarkerSpanCallback = (
+    source: string,
+    data?: { [level in SpanVerbosity]: any }
+  ) => Promise<PropagationInfo> | void;
+
+  /**
+   * Array type for span/log attributes that can contain primitive values or null/undefined.
+   * Used when attribute values need to be represented as arrays in OpenTelemetry context.
+   */
+  export type AttributeArray = Array<null | undefined | string | number | boolean>;
+
+  /**
+   * Interface for structured attribute data attached to spans, metrics, or log entries.
+   * Supports nested objects and arrays to represent complex attribute hierarchies.
+   */
+  export interface AttributeData {
+    [key: string]: string | number | boolean | undefined | AttributeArray | unknown[] | object;
+  }
+
+  /**
+   * Logs API.
+   */
+  export interface LogsManager extends Manager<LogsSettings> {
+    emit(logRecord: LogRecord): Promise<void> | null;
+  }
   export interface LogsSettings {
+    /** 
+     * Whether logging functionality is enabled.
+     * If disabled, API is still usable, but methods are no-ops.
+     *
+     * @default false
+    */
     enabled: boolean;
+    useSSOAuth?: boolean;
+    /**
+     * OTLP logs exporter endpoint URL.
+     */
     url?: string;
-
+    /**
+     * Whether to keep the connection alive when sending logs.
+     *
+     * @default true
+     */
     keepAlive?: boolean;
+    /**
+     * Settings for the OTLP exporter used to send logs.
+     */
     exporterSettings?: OTLPExporterConfigBase;
+    /**
+     * Settings for batching log records before export.
+     */
     batchSettings?: BufferConfig;
+    /**
+     * Configuration for the logger provider.
+     */
     providerSettings?: LoggerProviderConfig;
-
+    /**
+     * Logger provider instance.
+     */
     loggerProvider?: LoggerProvider;
+    /**
+     * Log record processors.
+     */
     logProcessors?: LogRecordProcessor[];
+    /**
+     * Log record exporters.
+     */
     logExporters?: LogRecordExporter[];
+    /** 
+     * Name of log level counter metric, set to null to disable.
+     *
+     * Defaults to 'insights_log_level_count'.
+     */
+    levelCountMetric?: string;
 
+    /**
+     * 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
+     * platform logs.
+     *
+     * @default true
+     */
+    useDefaultFilters?: boolean;
+    /**
+     * Maximum length for log attribute object nesting.
+     */
     maxAttributeDepth?: number;
+    /**
+     * Array of filter entries used to determine whether
+     * a particular log entry will be emitted, and
+     * which attributes will be included.
+     *
+     * If no matching filter entry is found,
+     * the settings from 'defaults' are used.
+     */
     filters?: LogFilter[];
+    /**
+     * Default settings if appropriate entries aren't found
+     * in 'filters' collection.
+     */
     defaults?: LogOptions;
 
     /**
@@ -1003,11 +1210,11 @@ export namespace IOInsights {
     headers?: { [x: string]: string } | (() => { [x: string]: string });
     addResourceAttributesToAttributes?: boolean;
     /**
-     * Additional attributes to add to observability entities (metrics, spans, log entries) by default.
+     * Additional logs attributes to publish as part of each log entry, specified as key/value pairs. You can use environment variables as values. Environment variables must start and end with a percent sign (e.g., `%MyEnvVar%`), and can contain a fallback value (e.g., `%MyEnvVar?literalDefaultValue%`).
      */
     additionalAttributes?: { [x: string]: unknown } | (() => { [x: string]: unknown });
     /**
-     * Additional attributes to add to the observability resource definition.
+     * Additional attributes to publish as part of the OTEL resource definition, specified as key/value pairs. You can use environment variables as values. Environment variables must start and end with a percent sign (e.g., `%MyEnvVar%`), and can contain a fallback value (e.g., `%MyEnvVar?literalDefaultValue%`).
      */
     additionalResourceAttributes?: { [x: string]: unknown } | (() => { [x: string]: unknown });
   }
@@ -1030,7 +1237,7 @@ export namespace IOInsights {
     INFO = 60,
     DEBUG = 70,
     VERBOSE = 80,
-    ALL = 9999
+    ALL = 9999,
   }
 
   export interface Logger {
@@ -1042,30 +1249,101 @@ export namespace IOInsights {
     verbose(message: string, ...args: unknown[]): void;
   }
 
-  export interface ClickstreamTraceConfig {
-    enabled: boolean;
-    structure?: "sibling" | "nested";
-    descriptiveName?: boolean;
-    events?: string[];
+  export interface Log4JSToOTELAppenderConfig
+  {
+    layout?: Layout;
+    maxRecordsBeforeOTELActive?: number;
+    maxTimeBeforeOTELActiveMs?: number;
+    logErrorsInConsole?: boolean;
+    rawLayout?: boolean;
   }
 
-  export interface UserJourneyTraceConfig {
-    enabled: boolean;
-    structure?: "sibling" | "nested";
-    descriptiveName?: boolean;
-    chainLength?: number;
+  export interface Manager<TSettings> {
+    settings: TSettings;
+    started: boolean;
+
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    waitForFinalExport(timeoutMs?: number): Promise<void>;
   }
 
-  export type MarkerSpanCallback = (
-    source: string,
-    data?: { [level in SpanVerbosity]: any }
-  ) => Promise<PropagationInfo> | void;
+  export interface Settings {
+    /**
+     * Whether library is enabled.
+     * If disabled, API is still usable, but methods are no-ops.
+     */
+    enabled: boolean;
+    useSSOAuth?: boolean;
+    /**
+     * Suppress double initialization warnings
+     */
+    suppressDoubleInitializationWarnings?: boolean;
+    /**
+     * Interval in milliseconds to wait for any remaining telemetry data to be exported during shutdown of the platform. This is the maximum awaiting interval and the platform may shutdown before it expires if all telemetry data has already been published.
+     */
+    finalExportTimeoutMs?: number;
+    /**
+     * Interval in milliseconds to wait for any remaining telemetry data to be published by any apps before proceeding with the platform shutdown.
+     */
+    finalExportGracePeriodMs?: number;
 
-  export type AttributeArray = Array<null | undefined | string | number | boolean>;
+    errorlessMode?: boolean;
+    /**
+     * If the library should log the settings used to initialize it.
+     *
+     * @default true
+     */
+    logSettingsOnStartup?: boolean;
+    /**
+     * If failure to initialize library will throw upstream error.
+     */
+    failOnInitError?: boolean;
+    /**
+     * If provided, this value will be added to the metrics and span attributes
+     * and to the span filtering context (see 'filters' in TracesSettings).
+     */
+    platformVersion?: string;
+    /**
+     * If provided, this value will be added to the metrics and traces service.name attribute,
+     * unless an OTEL service object (e.g. TraceProvider) has been provided to the library with
+     * a different setting.
+     */
+    serviceName?: string;
+    /**
+     * If provided, this value will be added to the metrics and traces service.instance.id attribute,
+     * unless an OTEL service object (e.g. TraceProvider) has been provided to the library with
+     * a different setting.
+     */
+    serviceId?: string;
+    /**
+     * If provided, this value will be added to the metrics and traces service.version attribute,
+     * unless an OTEL service object (e.g. TraceProvider) has been provided to the library with
+     * a different setting.
+     * attribute.
+     */
+    serviceVersion?: string;
+    /**
+     * If provided, this value will be added to the metrics and traces user.id attribute,
+     * unless an OTEL service object (e.g. TraceProvider) has been provided to the library with
+     * a different setting.
+     */
+    userId?: string;
 
-  export interface AttributeData {
-    [key: string]: string | number | boolean | undefined | AttributeArray | unknown[] | object;
+    /**
+     * Additional headers to send in HTTP requests, e.g. when using HTTP exporters.
+     */
+    headers?: { [x: string]: string } | (() => { [x: string]: string });
+    /**
+     * Additional properties to publish as part of each OpenTelemetry signal, specified as key/value pairs. You can use environment variables as values. Environment variables must start and end with a percent sign (e.g., `%MyEnvVar%`), and can contain a fallback value (e.g., `%MyEnvVar?DefaultValue%`).
+     */
+    additionalAttributes?: { [x: string]: unknown } | (() => { [x: string]: unknown });
+    /**
+     * Additional properties to publish as part of the OpenTelemetry resource definition for all OpenTelemetry signals, specified as key/value pairs. You can use environment variables as values. Environment variables must start and end with a percent sign (e.g., `%MyEnvVar%`), and can contain a fallback value (e.g., `%MyEnvVar?DefaultValue%`).
+     */
+    additionalResourceAttributes?: { [x: string]: unknown } | (() => { [x: string]: unknown });
+
+    traces?: TracesSettings;
+    metrics?: MetricsSettings;
+    logs?: LogsSettings;
   }
-  
 }
-

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@interopio/otel",
-  "version": "0.0.145",
+  "version": "0.0.148",
   "description": "otel library",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",