@microsoft/applicationinsights-core-js 3.0.0-beta.2208-04 → 3.0.0-beta.2208-18

package/types/JavaScriptSDK/HelperFuncs.d.ts

@@ -1,18 +1,7 @@
-/**
-  * Helper used to get the prototype of the target object as getPrototypeOf is not available in an ES3 environment.
-  * @ignore
-  */
-export declare function _getObjProto(target: any): any;
+export declare let _getObjProto: any;
 export declare function objToString(obj: any): any;
-export declare function isTypeof(value: any, theType: string): boolean;
-export declare function isUndefined(value: any): value is undefined;
 export declare function isNotUndefined<T>(value: T): value is T;
-export declare function isNullOrUndefined(value: any): value is null | undefined;
 export declare function isNotNullOrUndefined<T>(value: T): value is T;
-export declare function hasOwnProperty(obj: any, prop: string): boolean;
-export declare function isObject<T>(value: T): value is T;
-export declare function isFunction(value: any): value is Function;
-export declare function isPromiseLike<T>(value: any): value is PromiseLike<T>;
 /**
  * Validates that the string name conforms to the JS IdentifierName specification and if not
  * normalizes the name so that it would. This method does not identify or change any keywords
@@ -21,85 +10,12 @@ export declare function isPromiseLike<T>(value: any): value is PromiseLike<T>;
  * @param name The name to validate
  */
 export declare function normalizeJsName(name: string): string;
-/**
- * This is a helper function for the equivalent of arForEach(objKeys(target), callbackFn), this is a
- * performance optimization to avoid the creation of a new array for large objects
- * @param target The target object to find and process the keys
- * @param callbackfn The function to call with the details
- */
-export declare function objForEachKey<T = any>(target: T, callbackfn: (name: string, value: T[keyof T]) => void): void;
-/**
- * The strEndsWith() method determines whether a string ends with the characters of a specified string, returning true or false as appropriate.
- * @param value - The value to check whether it ends with the search value.
- * @param search - The characters to be searched for at the end of the value.
- * @returns true if the given search value is found at the end of the string, otherwise false.
- */
-export declare function strEndsWith(value: string, search: string): boolean;
-/**
- * The _strEndsWith() method determines whether a string ends with the characters of a specified string, returning true or false as appropriate.
- * @param value - The value to check whether it ends with the search value.
- * @param search - The characters to be searched for at the end of the value.
- * @returns true if the given search value is found at the end of the string, otherwise false.
- */
-export declare function _strEndsWithPoly(value: string, search: string): boolean;
-/**
- * The strStartsWith() method determines whether a string starts with the characters of the specified string, returning true or false as appropriate.
- * @param value - The value to check whether it ends with the search value.
- * @param checkValue - The characters to be searched for at the start of the value.
- * @returns true if the given search value is found at the start of the string, otherwise false.
- */
-export declare function strStartsWith(value: string, checkValue: string): boolean;
-/**
- * The strStartsWith() method determines whether a string starts with the characters of the specified string, returning true or false as appropriate.
- * @param value - The value to check whether it ends with the search value.
- * @param checkValue - The characters to be searched for at the start of the value.
- * @returns true if the given search value is found at the start of the string, otherwise false.
- */
-export declare function _strStartsWithPoly(value: string, checkValue: string): boolean;
 /**
  * A simple wrapper (for minification support) to check if the value contains the search string.
  * @param value - The string value to check for the existence of the search value
  * @param search - The value search within the value
  */
 export declare function strContains(value: string, search: string): boolean;
-/**
- * Check if an object is of type Date
- */
-export declare function isDate(obj: any): obj is Date;
-/**
- * Check if an object is of type Array with optional generic T, the generic type is not validated
- * and exists to help with TypeScript validation only.
- */
-export declare let isArray: <T = any>(obj: any) => obj is Array<T>;
-/**
- * Check if an object is of type Error
- */
-export declare function isError(obj: any): obj is Error;
-/**
- * Checks if the type of value is a string.
- * @param {any} value - Value to be checked.
- * @return {boolean} True if the value is a string, false otherwise.
- */
-export declare function isString(value: any): value is string;
-/**
- * Checks if the type of value is a number.
- * @param {any} value - Value to be checked.
- * @return {boolean} True if the value is a number, false otherwise.
- */
-export declare function isNumber(value: any): value is number;
-/**
- * Checks if the type of value is a boolean.
- * @param {any} value - Value to be checked.
- * @return {boolean} True if the value is a boolean, false otherwise.
- */
-export declare function isBoolean(value: any): value is boolean;
-/**
- * Checks if the type of value is a Symbol.
- * This only returns a boolean as returning value is Symbol will cause issues for older TypeScript consumers
- * @param {any} value - Value to be checked.
- * @return {boolean} True if the value is a Symbol, false otherwise.
- */
-export declare function isSymbol(value: any): boolean;
 /**
  * Checks if the type of the value is a normal plain object (not a null or data)
  * @param value
@@ -108,72 +24,8 @@ export declare function isPlainObject(value: any): boolean;
 /**
  * Convert a date to I.S.O. format in IE8
  */
-export declare function toISOString(date: Date): string;
-/**
- * Convert a date to I.S.O. format in IE8
- */
-export declare function _toISOStringPoly(date: Date): string;
-/**
- * Performs the specified action for each element in an array. This helper exists to avoid adding a polyfil for older browsers
- * that do not define Array.prototype.xxxx (eg. ES3 only, IE8) just in case any page checks for presence/absence of the prototype
- * implementation. Note: For consistency this will not use the Array.prototype.xxxx implementation if it exists as this would
- * cause a testing requirement to test with and without the implementations
- * @param callbackfn  A function that accepts up to three arguments. forEach calls the callbackfn function one time for each element in the array. It can return -1 to break out of the loop
- * @param thisArg  [Optional] An object to which the this keyword can refer in the callbackfn function. If thisArg is omitted, undefined is used as the this value.
- */
-export declare function arrForEach<T = any>(arr: T[], callbackfn: (value: T, index?: number, array?: T[]) => undefined | void | number, thisArg?: any): void;
-/**
- * Returns the index of the first occurrence of a value in an array. This helper exists to avoid adding a polyfil for older browsers
- * that do not define Array.prototype.xxxx (eg. ES3 only, IE8) just in case any page checks for presence/absence of the prototype
- * implementation. Note: For consistency this will not use the Array.prototype.xxxx implementation if it exists as this would
- * cause a testing requirement to test with and without the implementations
- * @param searchElement The value to locate in the array.
- * @param fromIndex The array index at which to begin the search. If fromIndex is omitted, the search starts at index 0.
- */
-export declare function arrIndexOf<T>(arr: T[], searchElement: T, fromIndex?: number): number;
-/**
- * Calls a defined callback function on each element of an array, and returns an array that contains the results. This helper exists
- * to avoid adding a polyfil for older browsers that do not define Array.prototype.xxxx (eg. ES3 only, IE8) just in case any page
- * checks for presence/absence of the prototype implementation. Note: For consistency this will not use the Array.prototype.xxxx
- * implementation if it exists as this would cause a testing requirement to test with and without the implementations
- * @param callbackfn A function that accepts up to three arguments. The map method calls the callbackfn function one time for each element in the array.
- * @param thisArg An object to which the this keyword can refer in the callbackfn function. If thisArg is omitted, undefined is used as the this value.
- */
-export declare function arrMap<T, R>(arr: T[], callbackfn: (value: T, index?: number, array?: T[]) => R, thisArg?: any): R[];
-/**
- * Calls the specified callback function for all the elements in an array. The return value of the callback function is the accumulated result, and is
- * provided as an argument in the next call to the callback function. This helper exists to avoid adding a polyfil for older browsers that do not define
- * Array.prototype.xxxx (eg. ES3 only, IE8) just in case any page checks for presence/absence of the prototype implementation. Note: For consistency
- * this will not use the Array.prototype.xxxx implementation if it exists as this would cause a testing requirement to test with and without the implementations
- * @param callbackfn A function that accepts up to four arguments. The reduce method calls the callbackfn function one time for each element in the array.
- * @param initialValue If initialValue is specified, it is used as the initial value to start the accumulation. The first call to the callbackfn function provides this value as an argument instead of an array value.
- */
-export declare function arrReduce<T, R>(arr: T[], callbackfn: (previousValue: T | R, currentValue?: T, currentIndex?: number, array?: T[]) => R, initialValue?: R): R;
-/**
- * helper method to trim strings (IE8 does not implement String.prototype.trim)
- */
-export declare function strTrim(str: any): string;
-/**
- * Returns the names of the enumerable string properties and methods of an object. This helper exists to avoid adding a polyfil for older browsers
- * that do not define Object.keys eg. ES3 only, IE8 just in case any page checks for presence/absence of the prototype implementation.
- * Note: For consistency this will not use the Object.keys implementation if it exists as this would cause a testing requirement to test with and without the implementations
- * @param obj Object that contains the properties and methods. This can be an object that you created or an existing Document Object Model (DOM) object.
- */
-export declare function objKeys(obj: {}): string[];
-/**
- * Try to define get/set object property accessors for the target object/prototype, this will provide compatibility with
- * existing API definition when run within an ES5+ container that supports accessors but still enable the code to be loaded
- * and executed in an ES3 container, providing basic IE8 compatibility.
- * @param target The object on which to define the property.
- * @param prop The name of the property to be defined or modified.
- * @param getProp The getter function to wire against the getter.
- * @param setProp The setter function to wire against the setter.
- * @returns True if it was able to create the accessors otherwise false
- */
-export declare function objDefineAccessors<T>(target: any, prop: string, getProp?: () => T, setProp?: (v: T) => void): boolean;
-export declare function deepFreeze<T>(obj: T): T;
-export declare const objFreeze: <T>(value: T) => T;
-export declare const objSeal: <T>(value: T) => T;
+export declare function toISOString(date: Date): any;
+export declare const deepFreeze: <T>(obj: T) => T;
 /**
  * Return the current time via the Date now() function (if available) and falls back to (new Date()).getTime() if now() is unavailable (IE8 or less)
  * https://caniuse.com/#search=Date.now
@@ -207,9 +59,6 @@ export declare function getSetValue<T, K extends keyof T>(target: T, field: K, d
  * @param defaultValue - The default value to return if the config field is not present, null or undefined.
  */
 export declare function getCfgValue<V>(theValue: V, defaultValue?: V): V;
-export declare function isNotTruthy(value: any): boolean;
-export declare function isTruthy(value: any): boolean;
-export declare function throwError(message: string): never;
 /**
  * Effectively assigns all enumerable properties (not just own properties) and functions (including inherited prototype) from
  * the source object to the target, it attempts to use proxy getters / setters (if possible) and proxy functions to avoid potential

package/types/JavaScriptSDK.Enums/EnumHelperFuncs.d.ts

@@ -1,25 +1,13 @@
-export declare type EnumValue<E = any> = {
-    readonly [key in keyof E]: E[key];
-};
-export declare type EnumMap<E = any, I = E> = {
-    readonly [key in keyof E extends string ? keyof E : never]: key extends string ? key : keyof E;
-} & I;
+import { EnumCls } from "@nevware21/ts-utils";
+export declare type EnumValue<E = any> = EnumCls<E>;
 /**
  * Create an enum style object which has both the key => value and value => key mappings
  * @param values - The values to populate on the new object
  * @returns
  */
-export declare function createEnumStyle<E>(values: {
+export declare const createEnumStyle: <E>(values: {
     [key in keyof E]: E[keyof E];
-}): EnumValue<E>;
-/**
- * Create a 2 index map that maps an enum's key as both the key and value, X["key"] => "key" and X[0] => "keyof 0".
- * @param values - The values to populate on the new object
- * @returns
- */
-export declare function createEnumMap<E, I = keyof E>(values: {
-    [key in keyof E]: E[keyof E];
-}): EnumMap<E, I>;
+}) => EnumValue<E>;
 /**
  * Create a 2 index map that maps an enum's key and value to the defined map value, X["key"] => mapValue and X[0] => mapValue.
  * Generic values
@@ -29,6 +17,6 @@ export declare function createEnumMap<E, I = keyof E>(values: {
  * @param values - The values to populate on the new object
  * @returns
  */
-export declare function createValueMap<E, V = E>(values: {
+export declare const createValueMap: <E, V = E>(values: {
     [key in keyof E]: [E[keyof E], V[keyof V]];
-}): V;
+}) => V;

package/types/JavaScriptSDK.Interfaces/ITelemetryPlugin.d.ts

@@ -71,4 +71,10 @@ export interface IPlugin {
      * Plugin version (available in data.properties.version in common schema)
      */
     readonly version?: string;
+    /**
+     * The App Insights core to use for backward compatibility.
+     * Therefore the interface will be able to access the core without needing to cast to "any".
+     * [optional] any 3rd party plugins which are already implementing this interface don't fail to compile.
+     */
+    core?: IAppInsightsCore;
 }

package/types/__DynamicConstants.d.ts

@@ -30,21 +30,19 @@ export declare const _DYN_DIAG_LOG = "diagLog";
 export declare const _DYN_SET_NEXT_PLUGIN = "setNextPlugin";
 export declare const _DYN_CREATE_NEW = "createNew";
 export declare const _DYN_COOKIE_CFG = "cookieCfg";
-export declare const _DYN_INDEX_OF = "indexOf";
 export declare const _DYN_SUBSTRING = "substring";
 export declare const _DYN_USER_AGENT = "userAgent";
 export declare const _DYN_SPLIT = "split";
-export declare const _DYN_SET_ENABLED = "setEnabled";
-export declare const _DYN_REPLACE = "replace";
 export declare const _DYN_SUBSTR = "substr";
 export declare const _DYN_NODE_TYPE = "nodeType";
 export declare const _DYN_APPLY = "apply";
+export declare const _DYN_REPLACE = "replace";
 export declare const _DYN_ENABLE_DEBUG_EXCEPTI4 = "enableDebugExceptions";
 export declare const _DYN_LOG_INTERNAL_MESSAGE = "logInternalMessage";
 export declare const _DYN_TO_LOWER_CASE = "toLowerCase";
-export declare const _DYN_CALL = "call";
 export declare const _DYN_TYPE = "type";
 export declare const _DYN_HANDLER = "handler";
+export declare const _DYN_CALL = "call";
 export declare const _DYN_LISTENERS = "listeners";
 export declare const _DYN_IS_CHILD_EVT = "isChildEvt";
 export declare const _DYN_GET_CTX = "getCtx";

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

@@ -17,11 +17,12 @@ export { AppInsightsCore } from "./JavaScriptSDK/AppInsightsCore";
 export { BaseCore } from "./JavaScriptSDK/BaseCore";
 export { BaseTelemetryPlugin } from "./JavaScriptSDK/BaseTelemetryPlugin";
 export { randomValue, random32, mwcRandomSeed, mwcRandom32, newId } from "./JavaScriptSDK/RandomHelper";
-export { CoreUtils, ICoreUtils, EventHelper, IEventHelper, Undefined, newGuid, perfNow, generateW3CId, disableCookies, canUseCookies, getCookie, setCookie, deleteCookie, _legacyCookieMgr } from "./JavaScriptSDK/CoreUtils";
-export { isTypeof, isUndefined, isNullOrUndefined, hasOwnProperty, isObject, isFunction, normalizeJsName, objForEachKey, strEndsWith, strStartsWith, isDate, isArray, isError, isString, isNumber, isBoolean, toISOString, arrForEach, arrIndexOf, arrMap, arrReduce, strTrim, objKeys, objDefineAccessors, dateNow, getExceptionName, throwError, strContains, isSymbol, setValue, getSetValue, isNotTruthy, isTruthy, proxyAssign, proxyFunctions, proxyFunctionAs, createClassFromInterface, optimizeObject, isNotUndefined, isNotNullOrUndefined, objFreeze, objSeal, objExtend, objToString, deepFreeze } from "./JavaScriptSDK/HelperFuncs";
-export { EnumValue, createEnumStyle, EnumMap, createEnumMap, createValueMap } from "./JavaScriptSDK.Enums/EnumHelperFuncs";
+export { Undefined, newGuid, perfNow, generateW3CId } from "./JavaScriptSDK/CoreUtils";
+export { normalizeJsName, toISOString, dateNow, getExceptionName, strContains, setValue, getSetValue, proxyAssign, proxyFunctions, proxyFunctionAs, createClassFromInterface, optimizeObject, isNotUndefined, isNotNullOrUndefined, objExtend } from "./JavaScriptSDK/HelperFuncs";
+export { isArray, isTypeof, isUndefined, isNullOrUndefined, objHasOwnProperty as hasOwnProperty, isObject, isFunction, objForEachKey, strEndsWith, strStartsWith, isDate, isError, isString, isNumber, isBoolean, arrForEach, arrIndexOf, arrReduce, arrMap, strTrim, objKeys, objDefineAccessors, throwError, isSymbol, isNotTruthy, isTruthy, objFreeze, objSeal, objToString, objDeepFreeze as deepFreeze, getInst as getGlobalInst, hasWindow, getWindow, hasDocument, getDocument, hasNavigator, getNavigator, hasHistory, getHistory, dumpObj } from "@nevware21/ts-utils";
+export { EnumValue, createEnumStyle, createValueMap } from "./JavaScriptSDK.Enums/EnumHelperFuncs";
 export { attachEvent, detachEvent, addEventHandler, addEventListeners, addPageUnloadEventListener, addPageHideEventListener, addPageShowEventListener, removeEventHandler, removeEventListeners, removePageUnloadEventListener, removePageHideEventListener, removePageShowEventListener, eventOn, eventOff, mergeEvtNamespace, _IRegisteredEvents, __getRegisteredEvents } from "./JavaScriptSDK/EventHelpers";
-export { getGlobalInst, hasWindow, getWindow, hasDocument, getDocument, getCrypto, getMsCrypto, hasNavigator, getNavigator, hasHistory, getHistory, getLocation, getPerformance, hasJSON, getJSON, isReactNative, getConsole, dumpObj, isIE, getIEVersion, isSafari, setEnableEnvMocks, isBeaconsSupported, isFetchSupported, useXDomainRequest, isXhrSupported, findMetaTag, findNamedServerTiming } from "./JavaScriptSDK/EnvUtils";
+export { getCrypto, getMsCrypto, getLocation, getPerformance, hasJSON, getJSON, isReactNative, getConsole, isIE, getIEVersion, isSafari, setEnableEnvMocks, isBeaconsSupported, isFetchSupported, useXDomainRequest, isXhrSupported, findMetaTag, findNamedServerTiming } from "./JavaScriptSDK/EnvUtils";
 export { getGlobal, objCreateFn as objCreate, strShimPrototype as strPrototype, strShimFunction as strFunction, strShimUndefined as strUndefined, strShimObject as strObject } from "@microsoft/applicationinsights-shims";
 export { NotificationManager } from "./JavaScriptSDK/NotificationManager";
 export { INotificationManager } from "./JavaScriptSDK.Interfaces/INotificationManager";

package/types/tsdoc-metadata.json

@@ -5,7 +5,7 @@
   "toolPackages": [
     {
       "packageName": "@microsoft/api-extractor",
-      "packageVersion": "7.28.7"
+      "packageVersion": "7.29.2"
     }
   ]
 }