@microsoft/applicationinsights-debugplugin-js 3.4.0-nightlybeta3.2602-06 → 3.4.0-nightlybeta3.2602-11

package/dist-es5/DebugPlugin.js

@@ -1,5 +1,5 @@
 /*
- * Application Insights JavaScript SDK - Debug Plugin, 3.4.0-nightlybeta3.2602-06
+ * Application Insights JavaScript SDK - Debug Plugin, 3.4.0-nightlybeta3.2602-11
  * Copyright (c) Microsoft and contributors. All rights reserved.
  */
 

package/dist-es5/__DynamicConstants.js

@@ -1,5 +1,5 @@
 /*
- * Application Insights JavaScript SDK - Debug Plugin, 3.4.0-nightlybeta3.2602-06
+ * Application Insights JavaScript SDK - Debug Plugin, 3.4.0-nightlybeta3.2602-11
  * Copyright (c) Microsoft and contributors. All rights reserved.
  */
 

package/dist-es5/applicationinsights-debugplugin-js.js

@@ -1,5 +1,5 @@
 /*
- * Application Insights JavaScript SDK - Debug Plugin, 3.4.0-nightlybeta3.2602-06
+ * Application Insights JavaScript SDK - Debug Plugin, 3.4.0-nightlybeta3.2602-11
  * Copyright (c) Microsoft and contributors. All rights reserved.
  */
 

package/dist-es5/components/Dashboard.js

@@ -1,5 +1,5 @@
 /*
- * Application Insights JavaScript SDK - Debug Plugin, 3.4.0-nightlybeta3.2602-06
+ * Application Insights JavaScript SDK - Debug Plugin, 3.4.0-nightlybeta3.2602-11
  * Copyright (c) Microsoft and contributors. All rights reserved.
  */
 import dynamicProto from "@microsoft/dynamicproto-js";

package/dist-es5/components/LogEntry.js

@@ -1,5 +1,5 @@
 /*
- * Application Insights JavaScript SDK - Debug Plugin, 3.4.0-nightlybeta3.2602-06
+ * Application Insights JavaScript SDK - Debug Plugin, 3.4.0-nightlybeta3.2602-11
  * Copyright (c) Microsoft and contributors. All rights reserved.
  */
 import { isArray, isBoolean, isError, isNumber, isObject, isString, objToString } from "@microsoft/applicationinsights-core-js";

package/dist-es5/components/debugBins.js

@@ -1,5 +1,5 @@
 /*
- * Application Insights JavaScript SDK - Debug Plugin, 3.4.0-nightlybeta3.2602-06
+ * Application Insights JavaScript SDK - Debug Plugin, 3.4.0-nightlybeta3.2602-11
  * Copyright (c) Microsoft and contributors. All rights reserved.
  */
 

package/dist-es5/components/filterList.js

@@ -1,5 +1,5 @@
 /*
- * Application Insights JavaScript SDK - Debug Plugin, 3.4.0-nightlybeta3.2602-06
+ * Application Insights JavaScript SDK - Debug Plugin, 3.4.0-nightlybeta3.2602-11
  * Copyright (c) Microsoft and contributors. All rights reserved.
  */
 

package/dist-es5/components/helpers.js

@@ -1,5 +1,5 @@
 /*
- * Application Insights JavaScript SDK - Debug Plugin, 3.4.0-nightlybeta3.2602-06
+ * Application Insights JavaScript SDK - Debug Plugin, 3.4.0-nightlybeta3.2602-11
  * Copyright (c) Microsoft and contributors. All rights reserved.
  */
 

package/dist-es5/components/styleNodeSrc.js

@@ -1,5 +1,5 @@
 /*
- * Application Insights JavaScript SDK - Debug Plugin, 3.4.0-nightlybeta3.2602-06
+ * Application Insights JavaScript SDK - Debug Plugin, 3.4.0-nightlybeta3.2602-11
  * Copyright (c) Microsoft and contributors. All rights reserved.
  */
 

package/dist-es5/interfaces/IDebugPluginConfig.js

@@ -1,5 +1,5 @@
 /*
- * Application Insights JavaScript SDK - Debug Plugin, 3.4.0-nightlybeta3.2602-06
+ * Application Insights JavaScript SDK - Debug Plugin, 3.4.0-nightlybeta3.2602-11
  * Copyright (c) Microsoft and contributors. All rights reserved.
  */
 

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@microsoft/applicationinsights-debugplugin-js",
-    "version": "3.4.0-nightlybeta3.2602-06",
+    "version": "3.4.0-nightlybeta3.2602-11",
     "description": "Microsoft Application Insights JavaScript SDK - Debug Plugin extension",
     "homepage": "https://github.com/microsoft/ApplicationInsights-JS#readme",
     "author": "Microsoft Application Insights Team",
@@ -33,10 +33,10 @@
         "@microsoft/api-extractor": "^7.40.0",
         "typescript": "^4.9.3",
         "tslib": "^2.0.0",
-        "grunt": "^1.5.3",
-        "grunt-cli": "^1.4.3",
-        "@nevware21/grunt-ts-plugin": "^0.4.3",
-        "@nevware21/grunt-eslint-ts": "^0.2.2",
+        "grunt": "^1.6.1",
+        "grunt-cli": "^1.5.0",
+        "@nevware21/grunt-ts-plugin": "^0.5.1",
+        "@nevware21/grunt-eslint-ts": "^0.5.1",
         "globby": "^11.0.0",
         "magic-string": "^0.25.7",
         "@rollup/plugin-commonjs": "^24.0.0",
@@ -52,7 +52,7 @@
     },
     "dependencies": {
         "@microsoft/dynamicproto-js": "^2.0.3",
-        "@microsoft/applicationinsights-core-js": "3.4.0-nightlybeta3.2602-06",
+        "@microsoft/applicationinsights-core-js": "3.4.0-nightlybeta3.2602-11",
         "@microsoft/applicationinsights-shims": "3.0.1",
         "@nevware21/ts-utils": ">= 0.12.6 < 2.x"
     },

package/types/applicationinsights-debugplugin-js.d.ts

@@ -1,5 +1,5 @@
 /*
- * Microsoft.ApplicationInsights, 3.4.0-nightlybeta3.2602-06
+ * Microsoft.ApplicationInsights, 3.4.0-nightlybeta3.2602-11
  * Copyright (c) Microsoft and contributors. All rights reserved.
  *
  * Microsoft Application Insights Team

package/types/applicationinsights-debugplugin-js.namespaced.d.ts

@@ -1,5 +1,5 @@
 /*
- * Microsoft.ApplicationInsights, 3.4.0-nightlybeta3.2602-06
+ * Microsoft.ApplicationInsights, 3.4.0-nightlybeta3.2602-11
  * Copyright (c) Microsoft and contributors. All rights reserved.
  *
  * Microsoft Application Insights Team
@@ -275,7 +275,8 @@ declare namespace ApplicationInsights {
         AttributeError = 115,
         SpanError = 116,
         TraceError = 117,
-        NotImplementedError = 118
+        NotImplementedError = 118,
+        VersionMismatch = 119
     }
 
     const enum eLoggingSeverity {
@@ -1282,7 +1283,7 @@ declare namespace ApplicationInsights {
         /**
          * The internal logging queue
          */
-        queue: _InternalLogMessage[];
+        queue: IInternalLogMessage[];
         /**
          * This method will throw exceptions in debug mode or attempt to log the error as a console warning.
          * @param severity - The severity of the log message
@@ -1315,7 +1316,7 @@ declare namespace ApplicationInsights {
          * @param severity - The severity of the log message
          * @param message - The message to log.
          */
-        logInternalMessage?(severity: LoggingSeverity, message: _InternalLogMessage): void;
+        logInternalMessage?(severity: LoggingSeverity, message: IInternalLogMessage): void;
         /**
          * Optional Callback hook to allow the diagnostic logger to update it's configuration
          * @param updateState - The new configuration state to apply to the diagnostic logger
@@ -1336,7 +1337,7 @@ declare namespace ApplicationInsights {
         readonly dbgMode?: boolean;
     }
 
-    interface IDistributedTraceContext {
+    interface IDistributedTraceContext extends IDistributedTraceInit {
         /**
          * Returns the current name of the page
          */
@@ -1472,6 +1473,180 @@ declare namespace ApplicationInsights {
         readonly parentCtx?: IDistributedTraceContext | null;
     }
 
+    /**
+     * An object that can be used to populate a new {@link IDistributedTraceContext} instance,
+     * the included {@link IW3cTraceState} or {@link IOTelTraceState} is used as the parent of the
+     * created instances traceState
+     */
+    interface IDistributedTraceInit {
+        /**
+         * The unique identifier for the trace that this span belongs to.
+         *
+         * The trace ID is a globally unique identifier that connects all spans within a single
+         * distributed trace. It consists of 16 randomly generated bytes encoded as 32 lowercase
+         * hexadecimal characters, providing 128 bits of entropy to ensure worldwide uniqueness
+         * with practically sufficient probability.
+         *
+         * @remarks
+         * - Must be exactly 32 lowercase hexadecimal characters
+         * - Represents 128 bits (16 bytes) of random data
+         * - Shared by all spans within the same trace
+         * - Used for trace correlation across distributed systems
+         * - Should never be all zeros (invalid trace ID)
+         *
+         * @example
+         * ```typescript
+         * // Example trace ID format
+         * const traceId = "4bf92f3577b34da6a3ce929d0e0e4736";
+         *
+         * // All spans in the same trace share this ID
+         * console.log(parentSpan.spanContext().traceId === childSpan.spanContext().traceId); // true
+         * ```
+         */
+        traceId: string;
+        /**
+         * The unique identifier for this specific span within the trace.
+         *
+         * The span ID uniquely identifies this span within the trace and is used to establish
+         * parent-child relationships between spans. It consists of 8 randomly generated bytes
+         * encoded as 16 lowercase hexadecimal characters, providing 64 bits of entropy to
+         * ensure global uniqueness with practically sufficient probability.
+         *
+         * @remarks
+         * - Must be exactly 16 lowercase hexadecimal characters
+         * - Represents 64 bits (8 bytes) of random data
+         * - Unique within the trace (different spans have different span IDs)
+         * - Used as parent ID when creating child spans
+         * - Should never be all zeros (invalid span ID)
+         *
+         * @example
+         * ```typescript
+         * // Example span ID format
+         * const spanId = "00f067aa0ba902b7";
+         *
+         * // Each span has a unique ID within the trace
+         * const parentId = parentSpan.spanContext().spanId; // "00f067aa0ba902b7"
+         * const childId = childSpan.spanContext().spanId;   // "b9c7c989f97918e1"
+         *
+         * // Child span uses parent's span ID as its parent ID
+         * console.log(childSpan.parentSpanId === parentId); // true
+         * ```
+         */
+        spanId: string;
+        /**
+         * Indicates whether this span context was propagated from a remote parent span.
+         *
+         * This flag distinguishes between spans created locally within the same process
+         * and spans that represent operations in remote services. Remote spans are typically
+         * created when trace context is received via HTTP headers, message queues, or other
+         * inter-process communication mechanisms.
+         *
+         * @defaultValue false - spans are considered local unless explicitly marked as remote
+         *
+         * @remarks
+         * - True only when span context was received from another process/service
+         * - Helps distinguish local vs. distributed trace segments
+         * - Used by tracing systems for visualization and analysis
+         * - Local child spans of remote parents are NOT considered remote themselves
+         *
+         * @example
+         * ```typescript
+         * // HTTP service receiving trace context
+         * const incomingSpanContext = extractSpanContextFromHeaders(request.headers);
+         * console.log(incomingSpanContext.isRemote); // true
+         *
+         * // Child span created locally
+         * const localChild = tracer.startSpan('local-operation', {
+         *   parent: incomingSpanContext
+         * });
+         * console.log(localChild.spanContext().isRemote); // false
+         * ```
+         */
+        isRemote?: boolean;
+        /**
+         * Trace flags that control trace behavior and indicate sampling decisions.
+         *
+         * The trace flags are represented as a single byte (8-bit bitmap) that carries
+         * trace-level information. The least significant bit (0x01) indicates whether
+         * the trace is sampled. When this bit is set, it documents that the caller
+         * may have recorded trace data. Additional bits are reserved for future use
+         * and should be ignored when not understood.
+         *
+         * @remarks
+         * - Represented as a number (0-255) corresponding to 8 bits
+         * - Bit 0 (0x01): Sampled flag - indicates trace may contain recorded data
+         * - Bits 1-7: Reserved for future use, should be preserved during propagation
+         * - Used by sampling algorithms to make consistent decisions across services
+         * - See {@link eW3CTraceFlags} for standard flag values
+         *
+         * @example
+         * ```typescript
+         * // Check if trace is sampled
+         * const isSampled = (spanContext.traceFlags & 0x01) === 1;
+         *
+         * // Common flag values
+         * const UNSAMPLED = 0x00; // 00000000 - not sampled
+         * const SAMPLED = 0x01;   // 00000001 - sampled
+         *
+         * // Preserving unknown flags during propagation
+         * const preservedFlags = spanContext.traceFlags | 0x01; // Set sampled bit while preserving others
+         *
+         * // W3C traceparent header format includes these flags
+         * const traceparent = `00-${traceId}-${spanId}-${traceFlags.toString(16).padStart(2, '0')}`;
+         * ```
+         */
+        traceFlags?: number;
+        /**
+         * Vendor-specific trace state information for cross-system trace correlation.
+         *
+         * The trace state carries tracing-system-specific context in a standardized format
+         * defined by the W3C Trace Context specification. It allows multiple tracing systems
+         * to participate in the same trace by providing a mechanism for each system to add
+         * its own metadata without interfering with others.
+         *
+         * The trace state is formatted as a comma-separated list of key-value pairs, where
+         * each pair represents one tracing system's contribution. Keys should be unique
+         * within the trace state and follow specific naming conventions.
+         *
+         * @remarks
+         * - Maximum of 32 list members allowed
+         * - Each member format: `key=value` separated by commas
+         * - Keys should be namespaced to avoid conflicts (e.g., `vendor@system=value`)
+         * - Total size should not exceed 512 characters for practical header limits
+         * - Spaces around list members are ignored
+         * - Preserves vendor-specific information during trace propagation
+         *
+         * @see {@link https://www.w3.org/TR/trace-context/#tracestate-field | W3C Trace Context Specification}
+         *
+         * @example
+         * ```typescript
+         * // Single tracing system
+         * const singleVendor = {
+         *   get: (key: string) => key === 'rojo' ? '00f067aa0ba902b7' : undefined,
+         *   set: (key: string, value: string) => { ... },
+         *   unset: (key: string) => { ... },
+         *   serialize: () => 'rojo=00f067aa0ba902b7'
+         * };
+         *
+         * // Multiple tracing systems
+         * const multiVendor = {
+         *   serialize: () => 'rojo=00f067aa0ba902b7,congo=t61rcWkgMzE,vendor@system=custom-value'
+         * };
+         *
+         * // Accessing trace state
+         * const rojoValue = spanContext.traceState?.get('rojo');
+         * const serialized = spanContext.traceState?.serialize();
+         *
+         * // HTTP header format (When the traceState is an IOTelTraceState)
+         * headers['tracestate'] = spanContext.traceState?.serialize() || '';
+         *
+         * // HTTP header format (When the traceState is an IW3cTraceState)
+         * headers['tracestate'] = spanContext.traceState?.hdrs()[0] || '';
+         * ```
+         */
+        traceState?: IW3cTraceState | IOTelTraceState;
+    }
+
     /**
      * Configuration for extra exceptions information sent with the exception telemetry.
      * @example
@@ -1557,6 +1732,11 @@ declare namespace ApplicationInsights {
         blockCdnCfg?: boolean;
     }
 
+    interface IInternalLogMessage {
+        message: string;
+        messageId: _InternalMessageId;
+    }
+
     /**
      * Internal Interface
      */
@@ -1756,13 +1936,6 @@ declare namespace ApplicationInsights {
         offlineBatchDrop?(cnt: number, reason?: number): void;
     }
 
-    class _InternalLogMessage {
-        static dataType: string;
-        message: string;
-        messageId: _InternalMessageId;
-        constructor(msgId: _InternalMessageId, msg: string, isUserAct?: boolean, properties?: Object);
-    }
-
     type _InternalMessageId = number | _eInternalMessageId;
 
     /**
@@ -2532,7 +2705,26 @@ declare namespace ApplicationInsights {
     }
 
     /**
-     * Options for creating a span.
+     * A SpanContext represents the portion of a {@link IOTelSpan} which must be
+     * serialized and propagated along side of a {@link IOTelBaggage}.
+     */
+    interface IOTelSpanContext extends IDistributedTraceInit {
+        /**
+         * Trace flags to propagate.
+         *
+         * It is represented as 1 byte (bitmap). Bit to represent whether trace is
+         * sampled or not. When set, the least significant bit documents that the
+         * caller may have recorded trace data. A caller who does not record trace
+         * data out-of-band leaves this flag unset.
+         *
+         * see {@link eW3CTraceFlags} for valid flag values.
+         */
+        traceFlags: number;
+    }
+
+    /**
+     * Provides an OpenTelemetry like Interface for the Open Telemetry Api (1.9.0) SpanOptions
+     * type. Where SpanOptions are options that can be used to configure a span.
      */
     interface IOTelSpanOptions {
         /**
@@ -2608,7 +2800,6 @@ declare namespace ApplicationInsights {
          *
          * @param name - The name of the span, should be descriptive of the operation being traced
          * @param options - Optional configuration for span creation (parent context, attributes, etc.)
-         * @param context - Optional context to use for extracting the parent span; if not provided, uses current context
          *
          * @returns The newly created span, or null if span creation failed
          *
@@ -2744,6 +2935,63 @@ declare namespace ApplicationInsights {
         shutdown?: () => IPromise<void> | void;
     }
 
+    /**
+     * Provides an OpenTelemetry compatible Interface for the Open Telemetry Api (1.9.0) TraceState type.
+     *
+     * The TraceState is a list of key/value pairs that are used to propagate
+     * vendor-specific trace information across different distributed tracing systems.
+     * The TraceState is used to store the state of a trace across different
+     * distributed tracing systems, and it is used to ensure that the trace information
+     * is consistent across different systems.
+     *
+     * Instances of TraceState are immutable, and the methods on this interface
+     * return a new instance of TraceState with the updated values.
+     */
+    interface IOTelTraceState {
+        /**
+         * Create a new TraceState which inherits from this TraceState and has the
+         * given key set.
+         * The new entry will always be added in the front of the list of states.
+         *
+         * @param key - key of the TraceState entry.
+         * @param value - value of the TraceState entry.
+         */
+        set(key: string, value: string): IOTelTraceState;
+        /**
+         * Return a new TraceState which inherits from this TraceState but does not
+         * contain the given key.
+         *
+         * @param key - the key for the TraceState entry to be removed.
+         */
+        unset(key: string): IOTelTraceState;
+        /**
+         * Returns the value to which the specified key is mapped, or `undefined` if
+         * this map contains no mapping for the key.
+         *
+         * @param key - with which the specified value is to be associated.
+         * @returns the value to which the specified key is mapped, or `undefined` if
+         *     this map contains no mapping for the key.
+         */
+        get(key: string): string | undefined;
+        /**
+         * Serializes the TraceState to a `list` as defined below. The `list` is a series of `list-members`
+         * separated by commas `,`, and a list-member is a key/value pair separated by an equals sign `=`.
+         * Spaces and horizontal tabs surrounding `list-members` are ignored. There can be a maximum of 32
+         * `list-members` in a `list`.
+         *
+         * If the resulting serialization is limited to no longer than 512 bytes, if the combination of
+         * keys and values exceeds this limit, the serialization will be truncated to the last key/value pair
+         * that fits within the limit. The serialization will be returned as a string.
+         *
+         * This is different from the {@link IW3cTraceState} serialization which returns an array of strings where each
+         * string is limited to 512 bytes and the array is limited to 32 strings. Thus the OpenTelemetry serialization
+         * will only return the first single string that fits within the limie.
+         *
+         * @returns the serialized string.
+         */
+        serialize(): string;
+    }
+
     /** IPayloadData describes interface of payload sent via POST channel */
     interface IPayloadData {
         urlString: string;
@@ -3490,12 +3738,12 @@ declare namespace ApplicationInsights {
          * @param spanContext - The {@link IDistributedTraceContext} to be wrapped
          * @returns a new non-recording {@link IReadableSpan} with the provided context
          */
-        wrapSpanContext(spanContext: IDistributedTraceContext): IReadableSpan;
+        wrapSpanContext(spanContext: IDistributedTraceContext | IDistributedTraceInit | IOTelSpanContext): IReadableSpan;
         /**
          * Returns true if this {@link IDistributedTraceContext} is valid.
          * @return true if this {@link IDistributedTraceContext} is valid.
          */
-        isSpanContextValid(spanContext: IDistributedTraceContext): boolean;
+        isSpanContextValid(spanContext: IDistributedTraceContext | IDistributedTraceInit | IOTelSpanContext): boolean;
         /**
          * Gets the span from the current context, if one exists.
          */