@microsoft/applicationinsights-core-js 3.4.0-nightlybeta3.2602-27 → 3.4.1

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

@@ -1,5 +1,5 @@
 /*
- * Microsoft Application Insights Core Javascript SDK, 3.4.0-nightlybeta3.2602-27
+ * Microsoft Application Insights Core Javascript SDK, 3.4.1
  * Copyright (c) Microsoft and contributors. All rights reserved.
  *
  * Microsoft Application Insights Team
@@ -366,6 +366,25 @@ declare namespace ApplicationInsights {
         protected _updateHook?(updateCtx: IProcessTelemetryUpdateContext, updateState: ITelemetryUpdateState): void | boolean;
     }
 
+    /**
+     * @group Classes
+     * @group Entrypoint
+     */
+    class AppInsightsExtCore<C extends IExtendedConfiguration = IExtendedConfiguration> extends AppInsightsCore<C> {
+        constructor();
+        /**
+         * Initialize the sdk.
+         * @param config - The configuration to initialize the SDK.
+         * @param extensions - An array of extensions that are to be used by the core.
+         */
+        initialize(config: C, extensions: IPlugin[], logger?: IDiagnosticLogger, notificationManager?: INotificationManager): void;
+        track(item: IExtendedTelemetryItem | ITelemetryItem): void;
+        /**
+         * Periodically check logger.queue for
+         */
+        pollInternalLogs(eventName?: string): ITimerHandler;
+    }
+
     const ApplicationInsightsAvailabilityBaseType = "AvailabilityData";
 
     const ApplicationInsightsAvailabilityName: string;
@@ -1200,6 +1219,24 @@ declare namespace ApplicationInsights {
         [key in keyof E]: E[keyof E];
     }) => EnumValue<E>;
 
+    /**
+     * Create an extended common schema telemetry item from the provided span
+     * @param core - The app insights core instance
+     * @param span - The span to create the telemetry item from
+     * @returns A new extended telemetry item or null if the span kind is not supported
+     */
+    function createExtendedTelemetryItemFromSpan(core: IAppInsightsCore, span: IReadableSpan): IExtendedTelemetryItem | null;
+
+    /**
+     * Create a new guid.
+     * @param style - The style of guid to generated, defaults to Digits
+     * Digits (Default) : 32 digits separated by hyphens: 00000000-0000-0000-0000-000000000000
+     * Braces - 32 digits separated by hyphens, enclosed in braces: \{00000000-0000-0000-0000-000000000000\}
+     * Parentheses - 32 digits separated by hyphens, enclosed in parentheses: (00000000-0000-0000-0000-000000000000)
+     * Numeric - 32 digits: 00000000000000000000000000000000
+     */
+    function createGuid(style?: GuidStyle): string;
+
     /**
      * Return a non-recording span based on the provided spanContext using the otelApi instance as the
      * owning instance.
@@ -1861,6 +1898,22 @@ declare namespace ApplicationInsights {
         W3C_TRACE = 18
     }
 
+    /**
+     * Enum for property types.
+     */
+    const enum eEventPropertyType {
+        Unspecified = 0,
+        String = 1,
+        Int32 = 2,
+        UInt32 = 3,
+        Int64 = 4,
+        UInt64 = 5,
+        Double = 6,
+        Bool = 7,
+        Guid = 8,
+        DateTime = 9
+    }
+
     /**
      * The eEventsDiscardedReason enumeration contains a set of values that specify the reason for discarding an event.
      */
@@ -1895,6 +1948,29 @@ declare namespace ApplicationInsights {
         BeaconSendFailure = 6
     }
 
+    const enum _eExtendedInternalMessageId {
+        AuthHandShakeError = 501,
+        AuthRedirectFail = 502,
+        BrowserCannotReadLocalStorage = 503,
+        BrowserCannotWriteLocalStorage = 504,
+        BrowserDoesNotSupportLocalStorage = 505,
+        CannotParseBiBlobValue = 506,
+        CannotParseDataAttribute = 507,
+        CVPluginNotAvailable = 508,
+        DroppedEvent = 509,
+        ErrorParsingAISessionCookie = 510,
+        ErrorProvidedChannels = 511,
+        FailedToGetCookies = 512,
+        FailedToInitializeCorrelationVector = 513,
+        FailedToInitializeSDK = 514,
+        InvalidContentBlob = 515,
+        InvalidCorrelationValue = 516,
+        SessionRenewalDateIsZero = 517,
+        SendPostOnCompleteFailure = 518,
+        PostResponseHandler = 519,
+        SDKNotInitialized = 520
+    }
+
     const enum _eInternalMessageId {
         BrowserDoesNotSupportLocalStorage = 0,
         BrowserCannotReadLocalStorage = 1,
@@ -2180,6 +2256,136 @@ declare namespace ApplicationInsights {
         All = 3
     }
 
+    /**
+     * The TraceLevel contains a set of values that specify the trace level for the trace messages.
+     */
+    const enum eTraceLevel {
+        /**
+         * None.
+         */
+        NONE = 0,
+        /**
+         * Error trace.
+         */
+        ERROR = 1,
+        /**
+         * Warning trace.
+         */
+        WARNING = 2,
+        /**
+         * Information trace.
+         */
+        INFORMATION = 3
+    }
+
+    /**
+     * Controls how the user can configure which parts of the URL should be redacted. Example, certain query parameters, username and password, etc.
+     */
+    const enum eUrlRedactionOptions {
+        /**
+         * The default value, will redact the username and password as well as the default set of query parameters
+         */
+        true = 1,
+        /**
+         * Does not redact username and password or any query parameters, the URL will be left as is. Note: this is not recommended as it may lead
+         * to sensitive data being sent in clear text.
+         */
+        false = 2,
+        /**
+         * This will append any additional queryParams that the user has provided through redactQueryParams config to the default set i.e to
+         * @defaultValue ["sig", "Signature", "AWSAccessKeyId", "X-Goog-Signature"].
+         */
+        appendToDefault = 3,
+        /**
+         * This will replace the default set of query parameters to redact with the query parameters defined in redactQueryParams config, if provided by the user.
+         */
+        replaceDefault = 4,
+        /**
+         * This will redact username and password in the URL but will not redact any query parameters, even those in the default set.
+         */
+        usernamePasswordOnly = 5,
+        /**
+         * This will only redact the query parameter in the default set of query parameters to redact. It will not redact username and password.
+         */
+        queryParamsOnly = 6
+    }
+
+    /**
+     * The eValueKind contains a set of values that specify value kind of the property.
+     * Either PII (Personal Identifiable Information) or customer content.
+     */
+    const enum eValueKind {
+        /**
+         * No kind.
+         */
+        NotSet = 0,
+        /**
+         * An LDAP distinguished name. For example, CN=Jeff Smith,OU=Sales,DC=Fabrikam,DC=COM.
+         */
+        Pii_DistinguishedName = 1,
+        /**
+         * Generic information.
+         */
+        Pii_GenericData = 2,
+        /**
+         * An IPV4 Internet address. For example, 192.0.2.1.
+         */
+        Pii_IPV4Address = 3,
+        /**
+         * An IPV6 Internet address. For example, 2001:0db8:85a3:0000:0000:8a2e:0370:7334.
+         */
+        Pii_IPv6Address = 4,
+        /**
+         * The Subject of an e-mail message.
+         */
+        Pii_MailSubject = 5,
+        /**
+         * A telephone number.
+         */
+        Pii_PhoneNumber = 6,
+        /**
+         * A query string.
+         */
+        Pii_QueryString = 7,
+        /**
+         * An SIP (Session Internet Protocol) address.
+         */
+        Pii_SipAddress = 8,
+        /**
+         * An e-mail address.
+         */
+        Pii_SmtpAddress = 9,
+        /**
+         * An user ID.
+         */
+        Pii_Identity = 10,
+        /**
+         * A URI (Uniform Resource Identifier).
+         */
+        Pii_Uri = 11,
+        /**
+         * The fully-qualified domain name.
+         */
+        Pii_Fqdn = 12,
+        /**
+         * Scrubs the last octet in a IPV4 Internet address.
+         * For example: 10.121.227.147 becomes 10.121.227.*
+         */
+        Pii_IPV4AddressLegacy = 13,
+        /**
+         * Scrubs the last 4 Hextets (last 64-bits) of an IPv6 address
+         */
+        Pii_IPv6ScrubLastHextets = 14,
+        /**
+         * Drops the value altogether, rather than hashing
+         */
+        Pii_DropValue = 15,
+        /**
+         * Generic content.
+         */
+        CustomerContent_GenericContent = 32
+    }
+
     class Event_2 implements IEventData, ISerializable {
         /**
          * @deprecated Use the constant EventEnvelopeType instead.
@@ -2222,6 +2428,36 @@ declare namespace ApplicationInsights {
 
     const EventEnvelopeType: string;
 
+    /**
+     * The EventLatency contains a set of values that specify the latency with which an event is sent.
+     */
+    const EventLatency: EnumValue<typeof EventLatencyValue>;
+
+    type EventLatency = number | EventLatencyValue;
+
+    /**
+     * The EventLatency contains a set of values that specify the latency with which an event is sent.
+     */
+    const enum EventLatencyValue {
+        /**
+         * Normal latency.
+         */
+        Normal = 1,
+        /**
+         * Cost deferred latency. At the moment this latency is treated as Normal latency.
+         */
+        CostDeferred = 2,
+        /**
+         * Real time latency.
+         */
+        RealTime = 3,
+        /**
+         * Bypass normal batching/timing and send as soon as possible, this will still send asynchronously.
+         * Added in v3.1.1
+         */
+        Immediate = 4
+    }
+
     /**
      * Removes an event handler for the specified event
      * @param Object - to remove the event from
@@ -2257,7 +2493,7 @@ declare namespace ApplicationInsights {
     type EventPersistence = number | EventPersistenceValue;
 
     /**
-     * The EventPersistence contains a set of values that specify the event's persistence.
+     * The EventPersistenceValue contains a set of values that specify the event's persistence.
      */
     const enum EventPersistenceValue {
         /**
@@ -2270,6 +2506,13 @@ declare namespace ApplicationInsights {
         Critical = 2
     }
 
+    /**
+     * Enum for property types.
+     */
+    const EventPropertyType: EnumValue<typeof eEventPropertyType>;
+
+    type EventPropertyType = number | eEventPropertyType;
+
     /**
      * The EventsDiscardedReason enumeration contains a set of values that specify the reason for discarding an event.
      */
@@ -2277,6 +2520,34 @@ declare namespace ApplicationInsights {
 
     type EventsDiscardedReason = number | eEventsDiscardedReason;
 
+    /**
+     * Define a specific way to send an event synchronously
+     */
+    const enum EventSendType {
+        /**
+         * Batch and send the event asynchronously, this is the same as either setting the event `sync` flag to false or not setting at all.
+         */
+        Batched = 0,
+        /**
+         * Attempt to send the event synchronously, this is the same as setting the event `sync` flag to true
+         */
+        Synchronous = 1,
+        /**
+         * Attempt to send the event synchronously with a preference for the sendBeacon() API.
+         * As per the specification, the payload of the event (when converted to JSON) must not be larger than 64kb,
+         * the sendHook is also not supported or used when sendBeacon.
+         */
+        SendBeacon = 2,
+        /**
+         * Attempt to send the event synchronously with a preference for the fetch() API with the keepalive flag,
+         * the SDK checks to ensure that the fetch() implementation supports the 'keepalive' flag and if not it
+         * will fallback to either sendBeacon() or a synchronous XHR request.
+         * As per the specification, the payload of the event (when converted to JSON) must not be larger than 64kb.
+         * Note: Not all browsers support the keepalive flag so for those environments the events may still fail
+         */
+        SyncFetch = 3
+    }
+
     /**
      * The TelemetryUpdateReason enumeration contains a set of bit-wise values that specify the reason for update request.
      */
@@ -2361,6 +2632,19 @@ declare namespace ApplicationInsights {
 
     const EXP_ATTR_SYNTHETIC_TYPE = "synthetic.type";
 
+    /**
+     * Pass in the objects to merge as arguments.
+     * @param obj1 - object to merge.  Set this argument to 'true' for a deep extend.
+     * @param obj2 - object to merge.
+     * @param obj3 - object to merge.
+     * @param obj4 - object to merge.
+     * @param obj5 - object to merge.
+     * @returns The extended object.
+     */
+    function extend(obj?: any, obj2?: any, obj3?: any, obj4?: any, obj5?: any): any;
+
+    type _ExtendedInternalMessageId = number | _eExtendedInternalMessageId | _eInternalMessageId;
+
     /**
      * Defines extended attribute values which may contain nested attributes.
      *
@@ -2379,6 +2663,16 @@ declare namespace ApplicationInsights {
         SDKExt: string;
     };
 
+    /**
+     * Identifies the full version for the extended SDK
+     */
+    const ExtFullVersionString: string;
+
+    /**
+     * Identifies the version for the extended SDK
+     */
+    const ExtVersion = "4.4.1";
+
     const enum FeatureOptInMode {
         /**
          * not set, completely depends on cdn cfg
@@ -2413,6 +2707,20 @@ declare namespace ApplicationInsights {
         Hidden = 4
     }
 
+    type FieldValueSanitizerFunc = (details: IFieldSanitizerDetails) => IEventProperty | null;
+
+    const enum FieldValueSanitizerType {
+        NotSet = 0,
+        String = 1,
+        Number = 2,
+        Boolean = 3,
+        Object = 4,
+        Array = 4096,
+        EventProperty = 8192
+    }
+
+    type FieldValueSanitizerTypes = string | number | boolean | object | string[] | number[] | boolean[] | IEventProperty;
+
     /**
      * This defines the handler function that is called via the finally when the promise is resolved or rejected
      */
@@ -2489,6 +2797,12 @@ declare namespace ApplicationInsights {
      */
     function formatTraceParent(value: ITraceParent): string;
 
+    /**
+     * Identifies the full version for the extended SDK (legacy constant)
+     * @deprecated Use {@link ExtFullVersionString} instead
+     */
+    const FullVersionString: string;
+
     /**
      * generate W3C trace id
      */
@@ -2500,11 +2814,23 @@ declare namespace ApplicationInsights {
      */
     function _getAllResponseHeaders(xhr: XMLHttpRequest, isOneDs?: boolean): {};
 
+    function getCommonSchemaMetaData(value: string | boolean | number | string[] | number[] | boolean[] | undefined, kind: number | undefined, type?: number | undefined): number;
+
     /**
      * Returns the global console object
      */
     function getConsole(): Console | null;
 
+    /**
+     * Helper to get and decode the cookie value using decodeURIComponent, this is for historical
+     * backward compatibility where the document.cookie value was decoded before parsing.
+     * @param cookieMgr - The cookie manager to use
+     * @param name - The name of the cookie to get
+     * @param decode - A flag to indicate whether the cookie value should be decoded
+     * @returns The decoded cookie value (if available) otherwise an empty string.
+     */
+    function getCookieValue(cookieMgr: ICookieMgr, name: string, decode?: boolean): string;
+
     /**
      * Returns the crypto object if it is present otherwise null.
      * This helper is used to access the crypto object from the current
@@ -2541,6 +2867,12 @@ declare namespace ApplicationInsights {
 
     function getExtensionByName(extensions: IPlugin[], identifier: string): IPlugin | null;
 
+    /**
+     * Returns a bitwise value for the FieldValueSanitizerType enum representing the decoded type of the passed value
+     * @param value - The value to determine the type
+     */
+    function getFieldValueType(value: any): FieldValueSanitizerType;
+
     /**
      * Get the current global performance manager that will be used with no performance manager is supplied.
      * @returns - The current default manager
@@ -2690,6 +3022,15 @@ declare namespace ApplicationInsights {
      */
     function getSyntheticType(container: IAttributeContainer): OTelAttributeValue;
 
+    /**
+     * Gets the tenant id from the tenant token.
+     * @param apiKey - The token from which the tenant id is to be extracted.
+     * @returns The tenant id.
+     */
+    function getTenantId(apiKey: string | undefined): string;
+
+    let getTime: typeof perfNow;
+
     /**
      * Get the URL from the attribute container
      * @param container - The attribute container to extract the URL from
@@ -2707,6 +3048,13 @@ declare namespace ApplicationInsights {
      */
     const getWindow: () => Window;
 
+    const enum GuidStyle {
+        Numeric = "N",
+        Digits = "D",
+        Braces = "B",
+        Parentheses = "P"
+    }
+
     /**
      * Handle / report an error.
      * When not provided the default is to generally throw an {@link OTelInvalidAttributeError}
@@ -4006,10 +4354,10 @@ declare namespace ApplicationInsights {
          */
         expCfg?: IExceptionConfig;
         /**
-         * [Optional] A flag to enable or disable the use of the field redaction for urls.
+         * [Optional] A flag to enable or disable redaction for query parameters and username/password.
          * @defaultValue true
          */
-        redactUrls?: boolean;
+        redactUrls?: UrlRedactionOptions;
         /**
          * [Optional] Additional query parameters to redact beyond the default set.
          * Use this to specify custom parameters that contain sensitive information.
@@ -5107,6 +5455,29 @@ declare namespace ApplicationInsights {
         measurements: any;
     }
 
+    /**
+     * An interface used to create an event property value along with tagging it as PII, or customer content.
+     * <b>Caution:</b> Customer content and PII are mutually exclusive. You can use only one of them at a time.
+     * If you use both, then the property will be considered invalid, and therefore won't be sent.
+     */
+    interface IEventProperty {
+        /**
+         * The value for the property.
+         */
+        value: string | number | boolean | string[] | number[] | boolean[];
+        /**
+         * [Optional] The value kind associated with property value. The constant enum ValueKind should be used to specify the
+         * different kinds.
+         */
+        kind?: number;
+        /**
+         * [Optional] The data type for the property. Valid values accepted by onecollector are
+         * "string", "bool", "double", "int64", "datetime", "guid".
+         *  The EventPropertyType constant enum should be used to specify the different property type values.
+         */
+        propertyType?: number;
+    }
+
     interface IEventTelemetry extends IPartC {
         /**
          * @description An event name string
@@ -5118,6 +5489,46 @@ declare namespace ApplicationInsights {
         iKey?: string;
     }
 
+    /**
+     * An interface used for telemetry event timings.
+     */
+    interface IEventTiming {
+        /**
+         * Time when 1DS Core calls track
+         */
+        trackStart?: number;
+        /**
+         * Array of times when each plugin configured in 1DS calls processTelemetry method
+         */
+        processTelemetryStart?: {
+            [key: string]: number;
+        };
+        /**
+         * Array of times when a specific channel tried to send the telemetry to configured endpoint
+         */
+        sendEventStart?: {
+            [key: string]: number;
+        };
+        /**
+         * Array of times when a specific channel received a response from endpoint or request timed out
+         */
+        sendEventCompleted?: {
+            [key: string]: number;
+        };
+        /**
+         * Array of times when a specific channel started serialization of the telemetry event
+         */
+        serializationStart?: {
+            [key: string]: number;
+        };
+        /**
+         * Array of times when a specific channel completed serialization of the telemetry event
+         */
+        serializationCompleted?: {
+            [key: string]: number;
+        };
+    }
+
     /**
      * Configuration for extra exceptions information sent with the exception telemetry.
      * @example
@@ -5282,6 +5693,83 @@ declare namespace ApplicationInsights {
         severityLevel?: SeverityLevel | number;
     }
 
+    /**
+     * The IExtendedConfiguration interface holds the configuration details passed to core during initialize.
+     */
+    interface IExtendedConfiguration extends IConfiguration {
+        /**
+         * [Optional] The property storage override that should be used to store
+         * internal SDK properties, otherwise stored as cookies. It is needed where cookies are not available.
+         */
+        propertyStorageOverride?: IPropertyStorageOverride;
+        /**
+         * [Optional] A boolean that indicated whether to disable the use of cookies by the 1DS Web SDK. The cookies added by the SDK are
+         * MicrosoftApplicationsTelemetryDeviceId. If cookies are disabled, then session events are not sent unless propertyStorageOverride
+         * is provided to store the values elsewhere.
+         */
+        disableCookiesUsage?: boolean;
+        /**
+         * [Optional] Name of the Anon cookie.  The value will be set in the qsp header to collector requests.  Collector will use this value to look for specific cookie to use for anid property.
+         */
+        anonCookieName?: string;
+        /**
+         * [Optional] Disables additional internal event timings that are added during processing of events, the timings are not sent as part telemetry items to the server
+         */
+        disableEventTimings?: boolean;
+        /**
+         * [Optional] Enables support for objects with compound keys which indirectly represent an object where the "key" of the object contains a "." as part of it's name.
+         * @example
+         * ```typescript
+         * event: { "somedata.embeddedvalue": 123 }
+         * ```
+         */
+        enableCompoundKey?: boolean;
+        /**
+         * Add "&w=0" parameter to support UA Parsing when web-workers don't have access to Document.
+         * Default is false
+         */
+        enableWParam?: boolean;
+    }
+
+    /**
+     * An interface used to create an event, along with its name, properties, type, timestamp, and priority.
+     */
+    interface IExtendedTelemetryItem extends ITelemetryItem {
+        /**
+         * Properties to be captured about the telemetry item.
+         * Custom properties (alternatively referred to as Part C properties for a Common Schema event) can be
+         * directly added under data.
+         */
+        data?: {
+            [key: string]: any;
+        };
+        /**
+         * Telemetry properties pertaining to domain about which data is being captured. Example, duration, referrerUri for browser page.
+         * These are alternatively referred to as Part B properties for a Common Schema event.
+         */
+        baseData?: {
+            [key: string]: any;
+        };
+        /**
+         * An EventLatency value, that specifies the latency for the event.The EventLatency constant should be
+         * used to specify the different latency values.
+         */
+        latency?: number | EventLatencyValue;
+        /**
+         * [Optional] An EventPersistence value, that specifies the persistence for the event. The EventPersistence constant
+         * should be used to specify the different persistence values.
+         */
+        persistence?: number | EventPersistenceValue;
+        /**
+         * [Optional] A boolean that specifies whether the event should be sent as a sync request.
+         */
+        sync?: boolean | EventSendType;
+        /**
+         * [Optional] A timings object.
+         */
+        timings?: IEventTiming;
+    }
+
     interface IFeatureOptIn {
         [feature: string]: IFeatureOptInDetails;
     }
@@ -5317,6 +5805,57 @@ declare namespace ApplicationInsights {
         blockCdnCfg?: boolean;
     }
 
+    /**
+     * This interface defines the object that is passed to any provided FieldValueSanitizerFunc, it provides not only the value to be sanitized but also
+     * some context about the value like it's location within the envelope (serialized object), the format is defined via the
+     * [Common Schema 4.0](https://aka.ms/CommonSchema) specification.
+     */
+    interface IFieldSanitizerDetails {
+        /**
+         * The path within the event where the value is stored
+         */
+        path: string;
+        /**
+         * The name of the field with the event path that will store the value
+         */
+        name: string;
+        /**
+         * Identifies the type of the property value
+         */
+        type: FieldValueSanitizerType;
+        /**
+         * The value for the property.
+         */
+        prop: IEventProperty;
+        /**
+         * A reference to the value sanitizer that created the details
+         */
+        sanitizer: IValueSanitizer;
+    }
+
+    /**
+     * This interface is used during the serialization of individual fields when converting the events into envelope (serialized object) which is sent to the services,
+     * the format is defined via the [Common Schema 4.0](https://aka.ms/CommonSchema) specification. The path and field names used are based
+     * on how the data is serialized to the service (CS 4.0 location) and not specifically the location on the event object you pass into the track methods (unless they are the same).
+     */
+    interface IFieldValueSanitizerProvider {
+        /**
+         * Does this field value sanitizer handle this path / field combination
+         * @param path - The field path
+         * @param name - The name of the field
+         */
+        handleField(path: string, name: string): boolean;
+        /**
+         * Get the field sanitizer for this type of field based on the field type, value kind and/or event property type
+         * @param path - The field path
+         * @param name - The name of the field
+         * @param theType - The type of field
+         * @param theKind - The value kind of the field
+         * @param propType - The property type of the field
+         */
+        getSanitizer(path: string, name: string, theType: FieldValueSanitizerType, theKind?: number, propType?: number): FieldValueSanitizerFunc | null | undefined;
+    }
+
     interface IInstrumentCallDetails {
         name: string;
         inst: any;
@@ -7524,6 +8063,26 @@ declare namespace ApplicationInsights {
         readonly context: ITelemetryContext;
     }
 
+    /**
+     * The IPropertyStorageOverride interface provides a custom interface for storing internal SDK properties - otherwise they are
+     * stored as cookies.
+     * You need this interface when you intend to run auto collection for common properties, or when you log a session in
+     * a non browser environment.
+     */
+    interface IPropertyStorageOverride {
+        /**
+         * A function for passing key value pairs to be stored.
+         * @param key   - The key for the key value pair.
+         * @param value - The value for the key value pair.
+         */
+        setProperty: (key: string, value: string) => void;
+        /**
+         * A function that gets a value for a given key.
+         * @param key - The key for which the value must be fetched.
+         */
+        getProperty: (key: string) => string;
+    }
+
     /**
      * Provides an OpenTelemetry compatible Interface for the Open Telemetry Sdk-Trace-Base (1.8.0 and 2.0.0) ReadableSpan type.
      *
@@ -7733,6 +8292,8 @@ declare namespace ApplicationInsights {
      */
     const isArray: <T = any>(arg: any) => arg is Array<T>;
 
+    function isArrayValid(value: any[]): boolean;
+
     /**
      * Helper function to identify if a passed argument is or implements the IAttributeContainer interface
      * @param value - The value to check
@@ -7790,6 +8351,11 @@ declare namespace ApplicationInsights {
      */
     const isBoolean: (value: any) => value is boolean;
 
+    /**
+     * Helper to identify whether we are running in a chromium based browser environment
+     */
+    function isChromium(): boolean;
+
     function isCrossOriginError(message: string | Event, url: string, lineNumber: number, columnNumber: number, error: Error | Event): boolean;
 
     /**
@@ -7813,6 +8379,11 @@ declare namespace ApplicationInsights {
 
     function isDistributedTraceContext(obj: any): obj is IDistributedTraceContext;
 
+    /**
+     * Checks if document object is available
+     */
+    const isDocumentObjectAvailable: boolean;
+
     /**
      * internal interface
      * Define functions when xhr/xdr/fetch requests are successfully returned. If they are not defined, oncomplete with be called instead
@@ -8040,6 +8611,13 @@ declare namespace ApplicationInsights {
      */
     const isFunction: (value: any) => value is Function;
 
+    /**
+     * Check to see if the value is \> 0
+     * @param value - The value to check
+     * @returns true if \> 0 otherwise false
+     */
+    function isGreaterThanZero(value: number): boolean;
+
     /**
      * Identifies whether the current environment appears to be IE
      */
@@ -8047,6 +8625,13 @@ declare namespace ApplicationInsights {
 
     function isInternalApplicationInsightsEndpoint(endpointUrl: string): boolean;
 
+    /**
+     * Checks if the value is a valid EventLatency.
+     * @param value - The value that needs to be checked.
+     * @returns True if the value is in AWTEventLatency, false otherwise.
+     */
+    function isLatency(value: EventLatency | undefined): boolean;
+
     function isNotNullOrUndefined<T>(value: T): value is T;
 
     /**
@@ -8329,6 +8914,13 @@ declare namespace ApplicationInsights {
      */
     function isTypeof(value: any, theType: string): boolean;
 
+    /**
+     * Checks if Uint8Array are available in the current environment. Safari and Firefox along with
+     * ReactNative are known to not support Uint8Array properly.
+     * @returns True if available, false otherwise.
+     */
+    function isUint8ArrayAvailable(): boolean;
+
     /**
      * Checks if the provided value is undefined or contains the string value "undefined",
      * if you want to consider the string value as undefined see {@link isStrictUndefined}
@@ -8405,6 +8997,15 @@ declare namespace ApplicationInsights {
      */
     function isValidTraceParent(value: ITraceParent): boolean;
 
+    /**
+     * Checks if value is assigned to the given param.
+     * @param value - The token from which the tenant id is to be extracted.
+     * @returns True/false denoting if value is assigned to the param.
+     */
+    function isValueAssigned(value: any): boolean;
+
+    function isValueKind(value: number | undefined): boolean;
+
     /**
      * Identifies if the provided value looks like a distributed trace state instance
      * @param value - The value to check
@@ -8412,6 +9013,11 @@ declare namespace ApplicationInsights {
      */
     function isW3cTraceState(value: any): value is IW3cTraceState;
 
+    /**
+     * Checks if window object is available
+     */
+    const isWindowObjectAvailable: boolean;
+
     /**
      * Checks if XMLHttpRequest is supported
      * @returns True if supported, otherwise false
@@ -8590,24 +9196,92 @@ declare namespace ApplicationInsights {
 
     /**
      * Interface for telemetry trace context.
-     * @deprecated Use the core getTraceCtx method instead to get / set the current trace context, this is required to
-     * support distributed tracing and allows the core to manage the trace context.
+     * @deprecated Use {@link ITraceHost.getTraceCtx | appInsights.getTraceCtx()} or {@link ITraceHost.getTraceCtx | appInsights.core.getTraceCtx()} instead to get / set the
+     * current trace context. This returns an {@link IDistributedTraceContext} which supports distributed tracing and
+     * allows the core to manage the trace context.
+     *
+     * To replace the entire trace context, use {@link ITraceHost.setTraceCtx | appInsights.core.setTraceCtx()}.
+     *
+     * @see {@link https://microsoft.github.io/ApplicationInsights-JS/webSdk/applicationinsights-core-js/interfaces/IDistributedTraceContext.html | IDistributedTraceContext Typedoc}
+     * @see {@link https://microsoft.github.io/ApplicationInsights-JS/webSdk/applicationinsights-core-js/interfaces/ITraceHost.html#getTraceCtx | getTraceCtx Typedoc}
      */
     interface ITelemetryTrace {
         /**
-         * Trace id
+         * The trace ID for this telemetry context. A 32 lowercase hex character string.
+         * @deprecated Use {@link IDistributedTraceContext.traceId} instead via `appInsights.getTraceCtx().traceId`.
+         *
+         * @example
+         * ```typescript
+         * // Old (deprecated)
+         * let traceId = context.telemetryTrace.traceID;
+         *
+         * // New (recommended) - using the standard SKU (AISKU)
+         * let traceCtx = appInsights.getTraceCtx();
+         * let traceId = traceCtx.traceId;
+         * traceCtx.traceId = "00000000000000000000000000000001";
+         *
+         * // Or when using the core directly
+         * let traceCtx = appInsights.core.getTraceCtx();
+         * ```
          */
         traceID?: string;
         /**
-         * Parent id
+         * The parent span ID. A 16 lowercase hex character string.
+         * @deprecated Use {@link IDistributedTraceContext.spanId} instead via `appInsights.getTraceCtx().spanId`.
+         *
+         * @example
+         * ```typescript
+         * // Old (deprecated)
+         * let parentId = context.telemetryTrace.parentID;
+         *
+         * // New (recommended) - using the standard SKU (AISKU)
+         * let traceCtx = appInsights.getTraceCtx();
+         * let spanId = traceCtx.spanId;
+         * traceCtx.spanId = "0000000000000001";
+         *
+         * // Or when using the core directly
+         * let traceCtx = appInsights.core.getTraceCtx();
+         * ```
          */
         parentID?: string;
         /**
-         * An integer representation of the W3C TraceContext trace-flags. https://www.w3.org/TR/trace-context/#trace-flags
+         * An integer representation of the W3C TraceContext trace-flags.
+         * @deprecated Use {@link IDistributedTraceContext.traceFlags} instead via `appInsights.getTraceCtx().traceFlags`.
+         *
+         * @example
+         * ```typescript
+         * // Old (deprecated)
+         * let flags = context.telemetryTrace.traceFlags;
+         *
+         * // New (recommended) - using the standard SKU (AISKU)
+         * let traceCtx = appInsights.getTraceCtx();
+         * let flags = traceCtx.traceFlags;
+         * traceCtx.traceFlags = 1; // sampled
+         *
+         * // Or when using the core directly
+         * let traceCtx = appInsights.core.getTraceCtx();
+         * ```
+         *
+         * @see {@link https://www.w3.org/TR/trace-context/#trace-flags | W3C TraceContext trace-flags}
          */
         traceFlags?: number;
         /**
-         * Name
+         * The operation/page name for this trace context.
+         * @deprecated Use {@link IDistributedTraceContext.pageName} instead via `appInsights.getTraceCtx().pageName`.
+         *
+         * @example
+         * ```typescript
+         * // Old (deprecated)
+         * let name = context.telemetryTrace.name;
+         *
+         * // New (recommended) - using the standard SKU (AISKU)
+         * let traceCtx = appInsights.getTraceCtx();
+         * let pageName = traceCtx.pageName;
+         * traceCtx.pageName = "my-page";
+         *
+         * // Or when using the core directly
+         * let traceCtx = appInsights.core.getTraceCtx();
+         * ```
          */
         name?: string;
     }
@@ -9192,6 +9866,56 @@ declare namespace ApplicationInsights {
         update(userId?: string): void;
     }
 
+    /**
+     * This interface is used during the serialization of events into envelope (serialized object) which is sent to the services, the format is defined via the
+     * [Common Schema 4.0](https://aka.ms/CommonSchema) specification. The path and field names used are based on how the data is serialized
+     * to the service (CS 4.0 location) and not specifically the location on the event object you pass into the track methods (unless they are the same).
+     */
+    interface IValueSanitizer {
+        /**
+         * Add a value sanitizer as a fallback sanitizer if this sanitizer can't handle the path/name.
+         */
+        addSanitizer: (sanitizer: IValueSanitizer) => void;
+        /**
+         * Adds a field sanitizer to the evaluation list
+         */
+        addFieldSanitizer: (fieldSanitizer: IFieldValueSanitizerProvider) => void;
+        /**
+         * Removes the value sanitizer as a fallback sanitizer if this sanitizer can't handle the path/name if present.
+         */
+        rmSanitizer: (theSanitizer: IValueSanitizer) => void;
+        /**
+         * Removes the field sanitizer to the evaluation list if present
+         */
+        rmFieldSanitizer: (theFieldSanitizer: IFieldValueSanitizerProvider) => void;
+        /**
+         * Does this field value sanitizer handle this path / field combination
+         * @param path - The field path
+         * @param name - The name of the field
+         */
+        handleField: (path: string, name: string) => boolean;
+        /**
+         * Sanitizes the value. It checks the that the property name and value are valid. It also
+         * checks/populates the correct type and pii of the property value.
+         * @param path - The root path of the property
+         * @param name - The property name.
+         * @param value - The property value or an IEventProperty containing value, type ,pii and customer content.
+         * @param stringifyObjects - If supplied tells the sanitizer that it should JSON stringify() objects
+         * @returns IEventProperty containing valid name, value, pii and type or null if invalid.
+         */
+        value: (path: string, name: string, value: FieldValueSanitizerTypes, stringifyObjects?: boolean) => IEventProperty | null;
+        /**
+         * Sanitizes the Property. It checks the that the property name and value are valid. It also
+         * checks/populates the correct type and pii of the property value.
+         * @param path - The root path of the property
+         * @param name - The property name.
+         * @param property - The property value or an IEventProperty containing value, type ,pii and customer content.
+         * @param stringifyObjects - If supplied tells the sanitizer that it should JSON stringify() objects
+         * @returns IEventProperty containing valid name, value, pii and type or null if invalid.
+         */
+        property: (path: string, name: string, property: IEventProperty, stringifyObjects?: boolean) => IEventProperty | null;
+    }
+
     /**
      * Represents a mutable [W3C trace state list](https://www.w3.org/TR/trace-context/#tracestate-header), this is a
      * list of key/value pairs that are used to pass trace state information between different tracing systems. The
@@ -10433,6 +11157,16 @@ declare namespace ApplicationInsights {
      */
     function sanitizeAttributes(otelApi: IOTelApi, attributes: unknown): IOTelAttributes;
 
+    /**
+     * Sanitizes the Property. It checks the that the property name and value are valid. It also
+     * checks/populates the correct type and pii of the property value.
+     * @param name - property name                          - The property name.
+     * @param property - The property value or an IEventProperty containing value,
+     * type ,pii and customer content.
+     * @returns IEventProperty containing valid name, value, pii and type or null if invalid.
+     */
+    function sanitizeProperty(name: string, property: string | number | boolean | string[] | number[] | boolean[] | object | IEventProperty, stringifyObjects?: boolean): IEventProperty | null;
+
     interface scriptsInfo {
         url: string;
         crossOrigin?: string;
@@ -10613,6 +11347,8 @@ declare namespace ApplicationInsights {
      */
     function setObjStringTag<T>(target: T, nameOrFunc: string | (() => string)): T;
 
+    function setProcessTelemetryTimings(event: ITelemetryItem, identifier: string): void;
+
     /**
      * Introduce an intermediate prototype to the target object and that sets the toStringTag on that prototype,
      * this avoids directly modifying the target object and also allows multiple different "types" to be
@@ -10942,6 +11678,15 @@ declare namespace ApplicationInsights {
 
     const TraceEnvelopeType: string;
 
+    const TraceLevel: EnumValue<typeof eTraceLevel>;
+
+    type TraceLevel = number | eTraceLevel;
+
+    /**
+     * An enumeration that identifies the transport type that are requested to be used, if the requested
+     * transport is not available ir supported the SDK may choose the first available transport or it
+     * will log a warning to the diagnostic logger.
+     */
     const enum TransportType {
         /**
          * Use the default available api
@@ -10999,6 +11744,10 @@ declare namespace ApplicationInsights {
 
     function urlParseUrl(url: string): HTMLAnchorElement;
 
+    const UrlRedactionOptions: EnumValue<typeof eUrlRedactionOptions>;
+
+    type UrlRedactionOptions = boolean | eUrlRedactionOptions;
+
     /**
      * Execute the callback `fn` function with the passed span as the active span. The callback receives
      * an ISpanScope object as its first parameter and the `this` context (when no thisArg is provided).
@@ -11061,6 +11810,76 @@ declare namespace ApplicationInsights {
 
     function utlSetStoragePrefix(storagePrefix: string): void;
 
+    /**
+     * The ValueKind contains a set of values that specify value kind of the property.
+     * Either PII (Personal Identifiable Information) or customer content.
+     */
+    const ValueKind: EnumValue<typeof eValueKind>;
+
+    type ValueKind = number | eValueKind;
+
+    class ValueSanitizer implements IValueSanitizer {
+        static getFieldType: typeof getFieldValueType;
+        /**
+         * Clear the current value sanitizer cache.
+         */
+        clearCache: () => void;
+        /**
+         * Add a value sanitizer as a fallback sanitizer if this sanitizer can't handle the path/name.
+         */
+        addSanitizer: (sanitizer: IValueSanitizer) => void;
+        /**
+         * Adds a field sanitizer to the evaluation list
+         */
+        addFieldSanitizer: (fieldSanitizer: IFieldValueSanitizerProvider) => void;
+        /**
+         * Removes the value sanitizer as a fallback sanitizer if this sanitizer can't handle the path/name if present.
+         */
+        rmSanitizer: (theSanitizer: IValueSanitizer) => void;
+        /**
+         * Removes the field sanitizer to the evaluation list if present
+         */
+        rmFieldSanitizer: (theFieldSanitizer: IFieldValueSanitizerProvider) => void;
+        /**
+         * Does this field value sanitizer handle this path / field combination
+         * @param path - The field path
+         * @param name - The name of the field
+         */
+        handleField: (path: string, name: string) => boolean;
+        /**
+         * Sanitizes the value. It checks the that the property name and value are valid. It also
+         * checks/populates the correct type and pii of the property value.
+         * @param path - The root path of the property
+         * @param name - The property name.
+         * @param value - The property value or an IEventProperty containing value, type ,pii and customer content.
+         * @param stringifyObjects - If supplied tells the sanitizer that it should JSON stringify() objects
+         * @returns IEventProperty containing valid name, value, pii and type or null if invalid.
+         */
+        value: (path: string, name: string, value: FieldValueSanitizerTypes, stringifyObjects?: boolean) => IEventProperty | null;
+        /**
+         * Sanitizes the Property. It checks the that the property name and value are valid. It also
+         * checks/populates the correct type and pii of the property value.
+         * @param path - The root path of the property
+         * @param name - The property name.
+         * @param property - The property value or an IEventProperty containing value, type ,pii and customer content.
+         * @param stringifyObjects - If supplied tells the sanitizer that it should JSON stringify() objects
+         * @returns IEventProperty containing valid name, value, pii and type or null if invalid.
+         */
+        property: (path: string, name: string, property: IEventProperty, stringifyObjects?: boolean) => IEventProperty | null;
+        /**
+         * Returns whether this ValueSanitizer is empty
+         * @returns `true` if it contains no chained sanitizers or field sanitizers, otherwise `false`
+         */
+        isEmpty?: () => boolean;
+        constructor(fieldSanitizerProvider?: IFieldValueSanitizerProvider);
+    }
+
+    /**
+     * Identifies the version for the extended SDK (legacy constant)
+     * @deprecated Use {@link ExtVersion} instead
+     */
+    const Version = "4.4.1";
+
     /**
      * This is a helper method which will call warnToConsole on the passed logger with the provided message.
      * @param logger - The Diagnostic Logger instance to use.