@safaricom-mxl/web-sdk 0.0.0

package/dist/managers/MXLLimitManager/MXLLimitManager.js

@@ -0,0 +1,116 @@
+import { EMB_TYPES, KEY_EMB_TYPE } from "../../constants/attributes.js";
+import { diag } from "@opentelemetry/api";
+
+//#region src/managers/MXLLimitManager/MXLLimitManager.ts
+const LogSeverityToLimitType = {
+	info: "info_log",
+	warning: "warning_log",
+	error: "error_log"
+};
+var MXLLimitManager = class {
+	_diag;
+	_diagnosticCounts = {};
+	_currentCount = {
+		exception: 0,
+		error_log: 0,
+		warning_log: 0,
+		info_log: 0,
+		breadcrumb: 0,
+		session_property: 0,
+		span: 0,
+		network_request: 0
+	};
+	_maxAllowed;
+	_maxLength;
+	_maxAttributes;
+	constructor({ diag: diagParam, maxAllowed, maxLength, maxAttributes }) {
+		this._diag = diagParam ?? diag.createComponentLogger({ namespace: "MXLLimitManager" });
+		this._maxAllowed = maxAllowed;
+		this._maxLength = maxLength;
+		this._maxAttributes = maxAttributes;
+	}
+	_dropIfMaxReached(type) {
+		if (this._currentCount[type] >= this._maxAllowed[type]) {
+			this._diag.warn(`disallowing ${type} because the maximum number of ${this._maxAllowed[type].toString()} has already been reached for this session`);
+			this._incrDiagnosticCount(type, "drop");
+			return true;
+		}
+		this._currentCount[type] = (this._currentCount[type] || 0) + 1;
+		return false;
+	}
+	truncateString(type, body) {
+		if (body.length > this._maxLength[type]) {
+			this._diag.warn(`truncating ${type} because it is longer than ${this._maxLength[type].toString()} characters: "${body}"`);
+			this._incrDiagnosticCount(type, "truncate_string");
+			return body.substring(0, this._maxLength[type]);
+		}
+		return body;
+	}
+	_truncateAttributes(type, attributes, keyType, valueType) {
+		const keys = Object.keys(attributes);
+		if (keys.length > this._maxAttributes[type]) {
+			this._diag.warn(`truncating ${type} attributes because there are more than ${this._maxAttributes[type].toString()} set`);
+			this._incrDiagnosticCount(type, "truncate_attributes");
+		}
+		const truncatedAttributes = {};
+		for (let i = 0; i < Math.min(keys.length, this._maxAttributes[type]); i++) {
+			const truncatedKey = this.truncateString(keyType, keys[i]);
+			truncatedAttributes[truncatedKey] = this.truncateString(valueType, attributes[keys[i]]?.toString() || "");
+		}
+		return truncatedAttributes;
+	}
+	limitBreadcrumb(name) {
+		if (this._dropIfMaxReached("breadcrumb")) return "dropped";
+		return { name: this.truncateString("breadcrumb", name) };
+	}
+	limitException(message, attributes) {
+		if (this._dropIfMaxReached("exception")) return "dropped";
+		return {
+			message: this.truncateString("exception", message),
+			attributes: this._truncateAttributes("exception", attributes, "exception_attribute_key", "exception_attribute_value")
+		};
+	}
+	limitLog(message, severity, attributes) {
+		const logType = LogSeverityToLimitType[severity];
+		if (this._dropIfMaxReached(logType)) return "dropped";
+		return {
+			message: this.truncateString(logType, message),
+			attributes: this._truncateAttributes(logType, attributes, "log_attribute_key", "log_attribute_value")
+		};
+	}
+	limitSessionProperty(key, value) {
+		if (this._dropIfMaxReached("session_property")) return "dropped";
+		return {
+			key: this.truncateString("session_property_key", key),
+			value: this.truncateString("session_property_value", value)
+		};
+	}
+	dropReadableSpan(span) {
+		const type = span.attributes[KEY_EMB_TYPE] === EMB_TYPES.Network ? "network_request" : "span";
+		return this._dropIfMaxReached(type);
+	}
+	reset() {
+		this._diagnosticCounts = {};
+		this._currentCount = {
+			exception: 0,
+			error_log: 0,
+			warning_log: 0,
+			info_log: 0,
+			breadcrumb: 0,
+			session_property: 0,
+			span: 0,
+			network_request: 0
+		};
+	}
+	_incrDiagnosticCount(type, operation) {
+		const key = `mxl.app.applied_limit.${type}.${operation}.count`;
+		this._diagnosticCounts[key] = (this._diagnosticCounts[key] || 0) + 1;
+	}
+	getDiagnosticCounts() {
+		return this._diagnosticCounts;
+	}
+};
+
+//#endregion
+export { MXLLimitManager };
+//# sourceMappingURL=MXLLimitManager.js.map

package/dist/managers/MXLLimitManager/MXLLimitManager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MXLLimitManager.js","names":[],"sources":["../../../src/managers/MXLLimitManager/MXLLimitManager.ts"],"sourcesContent":["import type { AttributeValue, DiagLogger } from '@opentelemetry/api';\nimport { diag } from '@opentelemetry/api';\nimport type { ReadableSpan } from '@opentelemetry/sdk-trace-web';\nimport type { LogSeverity } from '../../api-logs/index.ts';\nimport { EMB_TYPES, KEY_EMB_TYPE } from '../../constants/index.ts';\nimport type {\n  AttributeLimitedType,\n  LengthLimitedType,\n  LimitedBreadcrumb,\n  LimitedException,\n  LimitedLog,\n  LimitedSessionProperty,\n  LimitedType,\n  LimitManagerInternal,\n  LimitOperation,\n  LogLimitedType,\n  MaxLimitedType,\n  MXLLimitManagerArgs,\n} from './types.ts';\n\nconst LogSeverityToLimitType: Record<LogSeverity, LogLimitedType> = {\n  info: 'info_log',\n  warning: 'warning_log',\n  error: 'error_log',\n};\n\nexport class MXLLimitManager implements LimitManagerInternal {\n  private readonly _diag: DiagLogger;\n\n  private _diagnosticCounts: Record<string, number> = {};\n  private _currentCount: Record<MaxLimitedType, number> = {\n    exception: 0,\n    error_log: 0,\n    warning_log: 0,\n    info_log: 0,\n    breadcrumb: 0,\n    session_property: 0,\n    span: 0,\n    network_request: 0,\n  };\n  private readonly _maxAllowed: Record<MaxLimitedType, number>;\n  private readonly _maxLength: Record<LengthLimitedType, number>;\n  private readonly _maxAttributes: Record<AttributeLimitedType, number>;\n\n  public constructor({\n    diag: diagParam,\n    maxAllowed,\n    maxLength,\n    maxAttributes,\n  }: MXLLimitManagerArgs) {\n    this._diag =\n      diagParam ??\n      diag.createComponentLogger({\n        namespace: 'MXLLimitManager',\n      });\n\n    this._maxAllowed = maxAllowed;\n    this._maxLength = maxLength;\n    this._maxAttributes = maxAttributes;\n  }\n\n  private _dropIfMaxReached(type: MaxLimitedType): boolean {\n    if (this._currentCount[type] >= this._maxAllowed[type]) {\n      this._diag.warn(\n        `disallowing ${type} because the maximum number of ${this._maxAllowed[type].toString()} has already been reached for this session`,\n      );\n\n      this._incrDiagnosticCount(type, 'drop');\n      return true;\n    }\n\n    this._currentCount[type] = (this._currentCount[type] || 0) + 1;\n    return false;\n  }\n\n  public truncateString(type: LengthLimitedType, body: string) {\n    if (body.length > this._maxLength[type]) {\n      this._diag.warn(\n        `truncating ${type} because it is longer than ${this._maxLength[type].toString()} characters: \"${body}\"`,\n      );\n\n      this._incrDiagnosticCount(type, 'truncate_string');\n      return body.substring(0, this._maxLength[type]);\n    }\n\n    return body;\n  }\n\n  private _truncateAttributes(\n    type: AttributeLimitedType,\n    attributes: Record<string, AttributeValue | undefined>,\n    keyType: LengthLimitedType,\n    valueType: LengthLimitedType,\n  ) {\n    const keys = Object.keys(attributes);\n\n    if (keys.length > this._maxAttributes[type]) {\n      this._diag.warn(\n        `truncating ${type} attributes because there are more than ${this._maxAttributes[type].toString()} set`,\n      );\n      this._incrDiagnosticCount(type, 'truncate_attributes');\n    }\n\n    const truncatedAttributes: Record<string, AttributeValue | undefined> = {};\n\n    for (let i = 0; i < Math.min(keys.length, this._maxAttributes[type]); i++) {\n      const truncatedKey = this.truncateString(keyType, keys[i]);\n      truncatedAttributes[truncatedKey] = this.truncateString(\n        valueType,\n        attributes[keys[i]]?.toString() || '',\n      );\n    }\n\n    return truncatedAttributes;\n  }\n\n  public limitBreadcrumb(name: string): LimitedBreadcrumb | 'dropped' {\n    if (this._dropIfMaxReached('breadcrumb')) {\n      return 'dropped';\n    }\n\n    return {\n      name: this.truncateString('breadcrumb', name),\n    };\n  }\n\n  public limitException(\n    message: string,\n    attributes: Record<string, AttributeValue | undefined>,\n  ): LimitedException | 'dropped' {\n    if (this._dropIfMaxReached('exception')) {\n      return 'dropped';\n    }\n\n    return {\n      message: this.truncateString('exception', message),\n      attributes: this._truncateAttributes(\n        'exception',\n        attributes,\n        'exception_attribute_key',\n        'exception_attribute_value',\n      ),\n    };\n  }\n\n  public limitLog(\n    message: string,\n    severity: LogSeverity,\n    attributes: Record<string, AttributeValue | undefined>,\n  ): LimitedLog | 'dropped' {\n    const logType = LogSeverityToLimitType[severity];\n\n    if (this._dropIfMaxReached(logType)) {\n      return 'dropped';\n    }\n\n    return {\n      message: this.truncateString(logType, message),\n      attributes: this._truncateAttributes(\n        logType,\n        attributes,\n        'log_attribute_key',\n        'log_attribute_value',\n      ),\n    };\n  }\n\n  public limitSessionProperty(\n    key: string,\n    value: string,\n  ): LimitedSessionProperty | 'dropped' {\n    if (this._dropIfMaxReached('session_property')) {\n      return 'dropped';\n    }\n\n    return {\n      key: this.truncateString('session_property_key', key),\n      value: this.truncateString('session_property_value', value),\n    };\n  }\n\n  public dropReadableSpan(span: ReadableSpan): boolean {\n    const type =\n      span.attributes[KEY_EMB_TYPE] === EMB_TYPES.Network\n        ? 'network_request'\n        : 'span';\n\n    return this._dropIfMaxReached(type);\n  }\n\n  public reset(): void {\n    this._diagnosticCounts = {};\n    this._currentCount = {\n      exception: 0,\n      error_log: 0,\n      warning_log: 0,\n      info_log: 0,\n      breadcrumb: 0,\n      session_property: 0,\n      span: 0,\n      network_request: 0,\n    };\n  }\n\n  private _incrDiagnosticCount(type: LimitedType, operation: LimitOperation) {\n    const key = `mxl.app.applied_limit.${type}.${operation}.count`;\n\n    this._diagnosticCounts[key] = (this._diagnosticCounts[key] || 0) + 1;\n  }\n  public getDiagnosticCounts(): Record<string, number> {\n    return this._diagnosticCounts;\n  }\n}\n"],"mappings":";;;;AAoBA,MAAM,yBAA8D;CAClE,MAAM;CACN,SAAS;CACT,OAAO;CACR;AAED,IAAa,kBAAb,MAA6D;CAC3D,AAAiB;CAEjB,AAAQ,oBAA4C,EAAE;CACtD,AAAQ,gBAAgD;EACtD,WAAW;EACX,WAAW;EACX,aAAa;EACb,UAAU;EACV,YAAY;EACZ,kBAAkB;EAClB,MAAM;EACN,iBAAiB;EAClB;CACD,AAAiB;CACjB,AAAiB;CACjB,AAAiB;CAEjB,AAAO,YAAY,EACjB,MAAM,WACN,YACA,WACA,iBACsB;AACtB,OAAK,QACH,aACA,KAAK,sBAAsB,EACzB,WAAW,mBACZ,CAAC;AAEJ,OAAK,cAAc;AACnB,OAAK,aAAa;AAClB,OAAK,iBAAiB;;CAGxB,AAAQ,kBAAkB,MAA+B;AACvD,MAAI,KAAK,cAAc,SAAS,KAAK,YAAY,OAAO;AACtD,QAAK,MAAM,KACT,eAAe,KAAK,iCAAiC,KAAK,YAAY,MAAM,UAAU,CAAC,4CACxF;AAED,QAAK,qBAAqB,MAAM,OAAO;AACvC,UAAO;;AAGT,OAAK,cAAc,SAAS,KAAK,cAAc,SAAS,KAAK;AAC7D,SAAO;;CAGT,AAAO,eAAe,MAAyB,MAAc;AAC3D,MAAI,KAAK,SAAS,KAAK,WAAW,OAAO;AACvC,QAAK,MAAM,KACT,cAAc,KAAK,6BAA6B,KAAK,WAAW,MAAM,UAAU,CAAC,gBAAgB,KAAK,GACvG;AAED,QAAK,qBAAqB,MAAM,kBAAkB;AAClD,UAAO,KAAK,UAAU,GAAG,KAAK,WAAW,MAAM;;AAGjD,SAAO;;CAGT,AAAQ,oBACN,MACA,YACA,SACA,WACA;EACA,MAAM,OAAO,OAAO,KAAK,WAAW;AAEpC,MAAI,KAAK,SAAS,KAAK,eAAe,OAAO;AAC3C,QAAK,MAAM,KACT,cAAc,KAAK,0CAA0C,KAAK,eAAe,MAAM,UAAU,CAAC,MACnG;AACD,QAAK,qBAAqB,MAAM,sBAAsB;;EAGxD,MAAM,sBAAkE,EAAE;AAE1E,OAAK,IAAI,IAAI,GAAG,IAAI,KAAK,IAAI,KAAK,QAAQ,KAAK,eAAe,MAAM,EAAE,KAAK;GACzE,MAAM,eAAe,KAAK,eAAe,SAAS,KAAK,GAAG;AAC1D,uBAAoB,gBAAgB,KAAK,eACvC,WACA,WAAW,KAAK,KAAK,UAAU,IAAI,GACpC;;AAGH,SAAO;;CAGT,AAAO,gBAAgB,MAA6C;AAClE,MAAI,KAAK,kBAAkB,aAAa,CACtC,QAAO;AAGT,SAAO,EACL,MAAM,KAAK,eAAe,cAAc,KAAK,EAC9C;;CAGH,AAAO,eACL,SACA,YAC8B;AAC9B,MAAI,KAAK,kBAAkB,YAAY,CACrC,QAAO;AAGT,SAAO;GACL,SAAS,KAAK,eAAe,aAAa,QAAQ;GAClD,YAAY,KAAK,oBACf,aACA,YACA,2BACA,4BACD;GACF;;CAGH,AAAO,SACL,SACA,UACA,YACwB;EACxB,MAAM,UAAU,uBAAuB;AAEvC,MAAI,KAAK,kBAAkB,QAAQ,CACjC,QAAO;AAGT,SAAO;GACL,SAAS,KAAK,eAAe,SAAS,QAAQ;GAC9C,YAAY,KAAK,oBACf,SACA,YACA,qBACA,sBACD;GACF;;CAGH,AAAO,qBACL,KACA,OACoC;AACpC,MAAI,KAAK,kBAAkB,mBAAmB,CAC5C,QAAO;AAGT,SAAO;GACL,KAAK,KAAK,eAAe,wBAAwB,IAAI;GACrD,OAAO,KAAK,eAAe,0BAA0B,MAAM;GAC5D;;CAGH,AAAO,iBAAiB,MAA6B;EACnD,MAAM,OACJ,KAAK,WAAW,kBAAkB,UAAU,UACxC,oBACA;AAEN,SAAO,KAAK,kBAAkB,KAAK;;CAGrC,AAAO,QAAc;AACnB,OAAK,oBAAoB,EAAE;AAC3B,OAAK,gBAAgB;GACnB,WAAW;GACX,WAAW;GACX,aAAa;GACb,UAAU;GACV,YAAY;GACZ,kBAAkB;GAClB,MAAM;GACN,iBAAiB;GAClB;;CAGH,AAAQ,qBAAqB,MAAmB,WAA2B;EACzE,MAAM,MAAM,yBAAyB,KAAK,GAAG,UAAU;AAEvD,OAAK,kBAAkB,QAAQ,KAAK,kBAAkB,QAAQ,KAAK;;CAErE,AAAO,sBAA8C;AACnD,SAAO,KAAK"}

package/dist/managers/MXLLimitManager/constants.cjs

@@ -0,0 +1,39 @@
+
+//#region src/managers/MXLLimitManager/constants.ts
+const DEFAULT_MAX_LOG_ATTRIBUTES = 50;
+const DEFAULT_LIMITS = {
+	maxAllowed: {
+		error_log: 500,
+		warning_log: 200,
+		info_log: 100,
+		exception: 500,
+		breadcrumb: 100,
+		session_property: 100,
+		span: 1e3,
+		network_request: 1e4
+	},
+	maxLength: {
+		error_log: 128,
+		warning_log: 128,
+		info_log: 128,
+		exception: 1024,
+		breadcrumb: 256,
+		session_property_key: 128,
+		session_property_value: 256,
+		log_attribute_key: 128,
+		log_attribute_value: 256,
+		exception_attribute_key: 128,
+		exception_attribute_value: 256
+	},
+	maxAttributes: {
+		error_log: DEFAULT_MAX_LOG_ATTRIBUTES,
+		warning_log: DEFAULT_MAX_LOG_ATTRIBUTES,
+		info_log: DEFAULT_MAX_LOG_ATTRIBUTES,
+		exception: DEFAULT_MAX_LOG_ATTRIBUTES
+	}
+};
+
+//#endregion
+exports.DEFAULT_LIMITS = DEFAULT_LIMITS;
+exports.DEFAULT_MAX_LOG_ATTRIBUTES = DEFAULT_MAX_LOG_ATTRIBUTES;
+//# sourceMappingURL=constants.cjs.map

package/dist/managers/MXLLimitManager/constants.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.cjs","names":[],"sources":["../../../src/managers/MXLLimitManager/constants.ts"],"sourcesContent":["import type { MXLLimitManagerArgs } from './types.ts';\n\nexport const DEFAULT_MAX_LOG_ATTRIBUTES = 50;\n\nexport const DEFAULT_LIMITS: MXLLimitManagerArgs = {\n  // These are per session limits, the counts of items against these maximums start over when `reset` is called on the\n  // limit manager which is done whenever a session ends\n  maxAllowed: {\n    error_log: 500,\n    warning_log: 200,\n    info_log: 100,\n    exception: 500,\n    breadcrumb: 100,\n    session_property: 100,\n    span: 1_000,\n    network_request: 10_000,\n  },\n  maxLength: {\n    error_log: 128,\n    warning_log: 128,\n    info_log: 128,\n    exception: 1024,\n    breadcrumb: 256,\n    session_property_key: 128,\n    session_property_value: 256,\n    log_attribute_key: 128,\n    log_attribute_value: 256,\n    exception_attribute_key: 128,\n    exception_attribute_value: 256,\n  },\n  maxAttributes: {\n    error_log: DEFAULT_MAX_LOG_ATTRIBUTES,\n    warning_log: DEFAULT_MAX_LOG_ATTRIBUTES,\n    info_log: DEFAULT_MAX_LOG_ATTRIBUTES,\n    exception: DEFAULT_MAX_LOG_ATTRIBUTES,\n  },\n};\n"],"mappings":";;AAEA,MAAa,6BAA6B;AAE1C,MAAa,iBAAsC;CAGjD,YAAY;EACV,WAAW;EACX,aAAa;EACb,UAAU;EACV,WAAW;EACX,YAAY;EACZ,kBAAkB;EAClB,MAAM;EACN,iBAAiB;EAClB;CACD,WAAW;EACT,WAAW;EACX,aAAa;EACb,UAAU;EACV,WAAW;EACX,YAAY;EACZ,sBAAsB;EACtB,wBAAwB;EACxB,mBAAmB;EACnB,qBAAqB;EACrB,yBAAyB;EACzB,2BAA2B;EAC5B;CACD,eAAe;EACb,WAAW;EACX,aAAa;EACb,UAAU;EACV,WAAW;EACZ;CACF"}

package/dist/managers/MXLLimitManager/constants.d.cts

@@ -0,0 +1,8 @@
+import { MXLLimitManagerArgs } from "./types.cjs";
+
+//#region src/managers/MXLLimitManager/constants.d.ts
+declare const DEFAULT_MAX_LOG_ATTRIBUTES = 50;
+declare const DEFAULT_LIMITS: MXLLimitManagerArgs;
+//#endregion
+export { DEFAULT_LIMITS, DEFAULT_MAX_LOG_ATTRIBUTES };
+//# sourceMappingURL=constants.d.cts.map

package/dist/managers/MXLLimitManager/constants.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.cts","names":[],"sources":["../../../src/managers/MXLLimitManager/constants.ts"],"sourcesContent":[],"mappings":";;;cAEa,0BAAA;cAEA,gBAAgB"}

package/dist/managers/MXLLimitManager/constants.d.ts

@@ -0,0 +1,8 @@
+import { MXLLimitManagerArgs } from "./types.js";
+
+//#region src/managers/MXLLimitManager/constants.d.ts
+declare const DEFAULT_MAX_LOG_ATTRIBUTES = 50;
+declare const DEFAULT_LIMITS: MXLLimitManagerArgs;
+//#endregion
+export { DEFAULT_LIMITS, DEFAULT_MAX_LOG_ATTRIBUTES };
+//# sourceMappingURL=constants.d.ts.map

package/dist/managers/MXLLimitManager/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","names":[],"sources":["../../../src/managers/MXLLimitManager/constants.ts"],"sourcesContent":[],"mappings":";;;cAEa,0BAAA;cAEA,gBAAgB"}

package/dist/managers/MXLLimitManager/constants.js

@@ -0,0 +1,37 @@
+//#region src/managers/MXLLimitManager/constants.ts
+const DEFAULT_MAX_LOG_ATTRIBUTES = 50;
+const DEFAULT_LIMITS = {
+	maxAllowed: {
+		error_log: 500,
+		warning_log: 200,
+		info_log: 100,
+		exception: 500,
+		breadcrumb: 100,
+		session_property: 100,
+		span: 1e3,
+		network_request: 1e4
+	},
+	maxLength: {
+		error_log: 128,
+		warning_log: 128,
+		info_log: 128,
+		exception: 1024,
+		breadcrumb: 256,
+		session_property_key: 128,
+		session_property_value: 256,
+		log_attribute_key: 128,
+		log_attribute_value: 256,
+		exception_attribute_key: 128,
+		exception_attribute_value: 256
+	},
+	maxAttributes: {
+		error_log: DEFAULT_MAX_LOG_ATTRIBUTES,
+		warning_log: DEFAULT_MAX_LOG_ATTRIBUTES,
+		info_log: DEFAULT_MAX_LOG_ATTRIBUTES,
+		exception: DEFAULT_MAX_LOG_ATTRIBUTES
+	}
+};
+
+//#endregion
+export { DEFAULT_LIMITS, DEFAULT_MAX_LOG_ATTRIBUTES };
+//# sourceMappingURL=constants.js.map

package/dist/managers/MXLLimitManager/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","names":[],"sources":["../../../src/managers/MXLLimitManager/constants.ts"],"sourcesContent":["import type { MXLLimitManagerArgs } from './types.ts';\n\nexport const DEFAULT_MAX_LOG_ATTRIBUTES = 50;\n\nexport const DEFAULT_LIMITS: MXLLimitManagerArgs = {\n  // These are per session limits, the counts of items against these maximums start over when `reset` is called on the\n  // limit manager which is done whenever a session ends\n  maxAllowed: {\n    error_log: 500,\n    warning_log: 200,\n    info_log: 100,\n    exception: 500,\n    breadcrumb: 100,\n    session_property: 100,\n    span: 1_000,\n    network_request: 10_000,\n  },\n  maxLength: {\n    error_log: 128,\n    warning_log: 128,\n    info_log: 128,\n    exception: 1024,\n    breadcrumb: 256,\n    session_property_key: 128,\n    session_property_value: 256,\n    log_attribute_key: 128,\n    log_attribute_value: 256,\n    exception_attribute_key: 128,\n    exception_attribute_value: 256,\n  },\n  maxAttributes: {\n    error_log: DEFAULT_MAX_LOG_ATTRIBUTES,\n    warning_log: DEFAULT_MAX_LOG_ATTRIBUTES,\n    info_log: DEFAULT_MAX_LOG_ATTRIBUTES,\n    exception: DEFAULT_MAX_LOG_ATTRIBUTES,\n  },\n};\n"],"mappings":";AAEA,MAAa,6BAA6B;AAE1C,MAAa,iBAAsC;CAGjD,YAAY;EACV,WAAW;EACX,aAAa;EACb,UAAU;EACV,WAAW;EACX,YAAY;EACZ,kBAAkB;EAClB,MAAM;EACN,iBAAiB;EAClB;CACD,WAAW;EACT,WAAW;EACX,aAAa;EACb,UAAU;EACV,WAAW;EACX,YAAY;EACZ,sBAAsB;EACtB,wBAAwB;EACxB,mBAAmB;EACnB,qBAAqB;EACrB,yBAAyB;EACzB,2BAA2B;EAC5B;CACD,eAAe;EACb,WAAW;EACX,aAAa;EACb,UAAU;EACV,WAAW;EACZ;CACF"}

package/dist/managers/MXLLimitManager/index.cjs

@@ -0,0 +1,6 @@
+const require_managers_MXLLimitManager_constants = require('./constants.cjs');
+const require_managers_MXLLimitManager_MXLLimitManager = require('./MXLLimitManager.cjs');
+
+exports.DEFAULT_LIMITS = require_managers_MXLLimitManager_constants.DEFAULT_LIMITS;
+exports.DEFAULT_MAX_LOG_ATTRIBUTES = require_managers_MXLLimitManager_constants.DEFAULT_MAX_LOG_ATTRIBUTES;
+exports.MXLLimitManager = require_managers_MXLLimitManager_MXLLimitManager.MXLLimitManager;

package/dist/managers/MXLLimitManager/index.d.cts

@@ -0,0 +1,4 @@
+import { LimitManagerInternal } from "./types.cjs";
+import { DEFAULT_LIMITS, DEFAULT_MAX_LOG_ATTRIBUTES } from "./constants.cjs";
+import { MXLLimitManager } from "./MXLLimitManager.cjs";
+export { DEFAULT_LIMITS, DEFAULT_MAX_LOG_ATTRIBUTES, type LimitManagerInternal, MXLLimitManager };

package/dist/managers/MXLLimitManager/index.d.ts

@@ -0,0 +1,4 @@
+import { LimitManagerInternal } from "./types.js";
+import { DEFAULT_LIMITS, DEFAULT_MAX_LOG_ATTRIBUTES } from "./constants.js";
+import { MXLLimitManager } from "./MXLLimitManager.js";
+export { DEFAULT_LIMITS, DEFAULT_MAX_LOG_ATTRIBUTES, type LimitManagerInternal, MXLLimitManager };

package/dist/managers/MXLLimitManager/index.js

@@ -0,0 +1,4 @@
+import { DEFAULT_LIMITS, DEFAULT_MAX_LOG_ATTRIBUTES } from "./constants.js";
+import { MXLLimitManager } from "./MXLLimitManager.js";
+
+export { DEFAULT_LIMITS, DEFAULT_MAX_LOG_ATTRIBUTES, MXLLimitManager };

package/dist/managers/MXLLimitManager/types.d.cts

@@ -0,0 +1,45 @@
+import { LogSeverity } from "../../api-logs/manager/types.cjs";
+import { AttributeValue, DiagLogger } from "@opentelemetry/api";
+import { ReadableSpan } from "@opentelemetry/sdk-trace-web";
+
+//#region src/managers/MXLLimitManager/types.d.ts
+interface MXLLimitManagerArgs {
+  diag?: DiagLogger;
+  maxAllowed: Record<MaxLimitedType, number>;
+  maxLength: Record<LengthLimitedType, number>;
+  maxAttributes: Record<AttributeLimitedType, number>;
+}
+type LogLimitedType = 'error_log' | 'warning_log' | 'info_log';
+type MaxLimitedType = LogLimitedType | 'exception' | 'span' | 'network_request' | 'breadcrumb' | 'session_property';
+type LengthLimitedType = LogLimitedType | 'exception' | 'breadcrumb' | 'session_property_key' | 'session_property_value' | 'log_attribute_key' | 'log_attribute_value' | 'exception_attribute_key' | 'exception_attribute_value';
+type AttributeLimitedType = LogLimitedType | 'exception';
+type LimitedType = MaxLimitedType | LengthLimitedType | AttributeLimitedType;
+type LimitOperation = 'drop' | 'truncate_string' | 'truncate_attributes';
+type LimitedBreadcrumb = {
+  name: string;
+};
+type LimitedLog = {
+  message: string;
+  attributes: Record<string, AttributeValue | undefined>;
+};
+type LimitedException = {
+  message: string;
+  attributes: Record<string, AttributeValue | undefined>;
+};
+type LimitedSessionProperty = {
+  key: string;
+  value: string;
+};
+interface LimitManagerInternal {
+  dropReadableSpan: (span: ReadableSpan) => boolean;
+  limitLog: (message: string, severity: LogSeverity, attributes: Record<string, AttributeValue | undefined>) => LimitedLog | 'dropped';
+  limitException: (message: string, attributes: Record<string, AttributeValue | undefined>) => LimitedException | 'dropped';
+  limitSessionProperty: (key: string, value: string) => LimitedSessionProperty | 'dropped';
+  limitBreadcrumb: (name: string) => LimitedBreadcrumb | 'dropped';
+  reset: () => void;
+  getDiagnosticCounts: () => Record<string, number>;
+  truncateString: (type: LengthLimitedType, body: string) => string;
+}
+//#endregion
+export { AttributeLimitedType, LengthLimitedType, LimitManagerInternal, LimitOperation, LimitedBreadcrumb, LimitedException, LimitedLog, LimitedSessionProperty, LimitedType, LogLimitedType, MXLLimitManagerArgs, MaxLimitedType };
+//# sourceMappingURL=types.d.cts.map

package/dist/managers/MXLLimitManager/types.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.cts","names":[],"sources":["../../../src/managers/MXLLimitManager/types.ts"],"sourcesContent":[],"mappings":";;;;;UAIiB,mBAAA;SACR;EADQ,UAAA,EAEH,MAFG,CAEI,cAFe,EAAA,MAAA,CAAA;EAC3B,SAAA,EAEI,MAFJ,CAEW,iBAFX,EAAA,MAAA,CAAA;EACY,aAAA,EAEJ,MAFI,CAEG,oBAFH,EAAA,MAAA,CAAA;;AACD,KAIR,cAAA,GAJQ,WAAA,GAAA,aAAA,GAAA,UAAA;AAAP,KAMD,cAAA,GACR,cAPS,GAAA,WAAA,GAAA,MAAA,GAAA,iBAAA,GAAA,YAAA,GAAA,kBAAA;AACW,KAaZ,iBAAA,GACR,cAdoB,GAAA,WAAA,GAAA,YAAA,GAAA,sBAAA,GAAA,wBAAA,GAAA,mBAAA,GAAA,qBAAA,GAAA,yBAAA,GAAA,2BAAA;AAAP,KAwBL,oBAAA,GAAuB,cAxBlB,GAAA,WAAA;AAAM,KA0BX,WAAA,GACR,cA3BmB,GA4BnB,iBA5BmB,GA6BnB,oBA7BmB;AAGX,KA4BA,cAAA,GA5Bc,MAAA,GAAA,iBAAA,GAAA,qBAAA;AAEd,KA4BA,iBAAA,GA5Bc;EAQd,IAAA,EAAA,MAAA;AAWZ,CAAA;AAEY,KAWA,UAAA,GAXW;EACnB,OAAA,EAAA,MAAA;EACA,UAAA,EAWU,MAXV,CAAA,MAAA,EAWyB,cAXzB,GAAA,SAAA,CAAA;CACA;AAAoB,KAaZ,gBAAA,GAbY;EAEZ,OAAA,EAAA,MAAA;EAEA,UAAA,EAWE,MAXF,CAAA,MAAiB,EAWA,cAXA,GAAA,SAAA,CAAA;AAI7B,CAAA;AAKY,KAKA,sBAAA,GAHiB;EAGjB,GAAA,EAAA,MAAA;EAKK,KAAA,EAAA,MAAA;CACU;AAGb,UAJG,oBAAA,CAIH;EACiB,gBAAA,EAAA,CAAA,IAAA,EAJJ,YAII,EAAA,GAAA,OAAA;EAAf,QAAA,EAAA,CAAA,OAAA,EAAA,MAAA,EAAA,QAAA,EADF,WACE,EAAA,UAAA,EAAA,MAAA,CAAA,MAAA,EAAe,cAAf,GAAA,SAAA,CAAA,EAAA,GACT,UADS,GAAA,SAAA;EACT,cAAA,EAAA,CAAA,OAAA,EAAA,MAAA,EAAA,UAAA,EAGS,MAHT,CAAA,MAAA,EAGwB,cAHxB,GAAA,SAAA,CAAA,EAAA,GAIA,gBAJA,GAAA,SAAA;EAGwB,oBAAA,EAAA,CAAA,GAAA,EAAA,MAAA,EAAA,KAAA,EAAA,MAAA,EAAA,GAKxB,sBALwB,GAAA,SAAA;EAAf,eAAA,EAAA,CAAA,IAAA,EAAA,MAAA,EAAA,GAMqB,iBANrB,GAAA,SAAA;EACT,KAAA,EAAA,GAAA,GAAA,IAAA;EAIA,mBAAA,EAAA,GAAA,GAGsB,MAHtB,CAAA,MAAA,EAAA,MAAA,CAAA;EAC8B,cAAA,EAAA,CAAA,IAAA,EAGZ,iBAHY,EAAA,IAAA,EAAA,MAAA,EAAA,GAAA,MAAA"}

package/dist/managers/MXLLimitManager/types.d.ts

@@ -0,0 +1,46 @@
+import { LogSeverity } from "../../api-logs/manager/types.js";
+import "../../api-logs/index.js";
+import { AttributeValue, DiagLogger } from "@opentelemetry/api";
+import { ReadableSpan } from "@opentelemetry/sdk-trace-web";
+
+//#region src/managers/MXLLimitManager/types.d.ts
+interface MXLLimitManagerArgs {
+  diag?: DiagLogger;
+  maxAllowed: Record<MaxLimitedType, number>;
+  maxLength: Record<LengthLimitedType, number>;
+  maxAttributes: Record<AttributeLimitedType, number>;
+}
+type LogLimitedType = 'error_log' | 'warning_log' | 'info_log';
+type MaxLimitedType = LogLimitedType | 'exception' | 'span' | 'network_request' | 'breadcrumb' | 'session_property';
+type LengthLimitedType = LogLimitedType | 'exception' | 'breadcrumb' | 'session_property_key' | 'session_property_value' | 'log_attribute_key' | 'log_attribute_value' | 'exception_attribute_key' | 'exception_attribute_value';
+type AttributeLimitedType = LogLimitedType | 'exception';
+type LimitedType = MaxLimitedType | LengthLimitedType | AttributeLimitedType;
+type LimitOperation = 'drop' | 'truncate_string' | 'truncate_attributes';
+type LimitedBreadcrumb = {
+  name: string;
+};
+type LimitedLog = {
+  message: string;
+  attributes: Record<string, AttributeValue | undefined>;
+};
+type LimitedException = {
+  message: string;
+  attributes: Record<string, AttributeValue | undefined>;
+};
+type LimitedSessionProperty = {
+  key: string;
+  value: string;
+};
+interface LimitManagerInternal {
+  dropReadableSpan: (span: ReadableSpan) => boolean;
+  limitLog: (message: string, severity: LogSeverity, attributes: Record<string, AttributeValue | undefined>) => LimitedLog | 'dropped';
+  limitException: (message: string, attributes: Record<string, AttributeValue | undefined>) => LimitedException | 'dropped';
+  limitSessionProperty: (key: string, value: string) => LimitedSessionProperty | 'dropped';
+  limitBreadcrumb: (name: string) => LimitedBreadcrumb | 'dropped';
+  reset: () => void;
+  getDiagnosticCounts: () => Record<string, number>;
+  truncateString: (type: LengthLimitedType, body: string) => string;
+}
+//#endregion
+export { AttributeLimitedType, LengthLimitedType, LimitManagerInternal, LimitOperation, LimitedBreadcrumb, LimitedException, LimitedLog, LimitedSessionProperty, LimitedType, LogLimitedType, MXLLimitManagerArgs, MaxLimitedType };
+//# sourceMappingURL=types.d.ts.map

package/dist/managers/MXLLimitManager/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","names":[],"sources":["../../../src/managers/MXLLimitManager/types.ts"],"sourcesContent":[],"mappings":";;;;;;UAIiB,mBAAA;SACR;cACK,OAAO;EAFJ,SAAA,EAGJ,MAHI,CAGG,iBAHgB,EAAA,MAAA,CAAA;EAC3B,aAAA,EAGQ,MAHR,CAGe,oBAHf,EAAA,MAAA,CAAA;;AACK,KAKF,cAAA,GALE,WAAA,GAAA,aAAA,GAAA,UAAA;AACM,KAMR,cAAA,GACR,cAPgB,GAAA,WAAA,GAAA,MAAA,GAAA,iBAAA,GAAA,YAAA,GAAA,kBAAA;AAAP,KAcD,iBAAA,GACR,cAfS,GAAA,WAAA,GAAA,YAAA,GAAA,sBAAA,GAAA,wBAAA,GAAA,mBAAA,GAAA,qBAAA,GAAA,yBAAA,GAAA,2BAAA;AACW,KAwBZ,oBAAA,GAAuB,cAxBX,GAAA,WAAA;AAAP,KA0BL,WAAA,GACR,cA3Ba,GA4Bb,iBA5Ba,GA6Bb,oBA7Ba;AAAM,KA+BX,cAAA,GA/BW,MAAA,GAAA,iBAAA,GAAA,qBAAA;AAGX,KA8BA,iBAAA,GA9Bc;EAEd,IAAA,EAAA,MAAA;AAQZ,CAAA;AAWY,KAaA,UAAA,GAbA;EAEA,OAAA,EAAA,MAAW;EACnB,UAAA,EAYU,MAZV,CAAA,MAAA,EAYyB,cAZzB,GAAA,SAAA,CAAA;CACA;AACA,KAaQ,gBAAA,GAbR;EAAoB,OAAA,EAAA,MAAA;EAEZ,UAAA,EAaE,MAbY,CAAA,MAAA,EAaG,cAbH,GAAA,SAAA,CAAA;AAE1B,CAAA;AAIY,KAUA,sBAAA,GARiB;EAGjB,GAAA,EAAA,MAAA;EAKA,KAAA,EAAA,MAAA;AAKZ,CAAA;AAC2B,UADV,oBAAA,CACU;EAGb,gBAAA,EAAA,CAAA,IAAA,EAHa,YAGb,EAAA,GAAA,OAAA;EACiB,QAAA,EAAA,CAAA,OAAA,EAAA,MAAA,EAAA,QAAA,EADjB,WACiB,EAAA,UAAA,EAAf,MAAe,CAAA,MAAA,EAAA,cAAA,GAAA,SAAA,CAAA,EAAA,GACxB,UADwB,GAAA,SAAA;EAAf,cAAA,EAAA,CAAA,OAAA,EAAA,MAAA,EAAA,UAAA,EAIA,MAJA,CAAA,MAAA,EAIe,cAJf,GAAA,SAAA,CAAA,EAAA,GAKT,gBALS,GAAA,SAAA;EACT,oBAAA,EAAA,CAAA,GAAA,EAAA,MAAA,EAAA,KAAA,EAAA,MAAA,EAAA,GAQA,sBARA,GAAA,SAAA;EAGwB,eAAA,EAAA,CAAA,IAAA,EAAA,MAAA,EAAA,GAMM,iBANN,GAAA,SAAA;EAAf,KAAA,EAAA,GAAA,GAAA,IAAA;EACT,mBAAA,EAAA,GAAA,GAOsB,MAPtB,CAAA,MAAA,EAAA,MAAA,CAAA;EAIA,cAAA,EAAA,CAAA,IAAA,EAIkB,iBAJlB,EAAA,IAAA,EAAA,MAAA,EAAA,GAAA,MAAA"}

package/dist/managers/MXLLogManager/MXLLogManager.cjs

@@ -0,0 +1,148 @@
+const require_rolldown_runtime = require('../../_virtual/rolldown_runtime.cjs');
+const require_utils_getIncrementedCount = require('../../utils/getIncrementedCount.cjs');
+const require_constants_attributes = require('../../constants/attributes.cjs');
+const require_utils_getVisibilityState = require('../../utils/getVisibilityState.cjs');
+const require_utils_globalConfig = require('../../utils/globalConfig.cjs');
+const require_utils_PerformanceManager_OTelPerformanceManager = require('../../utils/PerformanceManager/OTelPerformanceManager.cjs');
+let _opentelemetry_api = require("@opentelemetry/api");
+let _opentelemetry_semantic_conventions = require("@opentelemetry/semantic-conventions");
+let _opentelemetry_api_logs = require("@opentelemetry/api-logs");
+
+//#region src/managers/MXLLogManager/MXLLogManager.ts
+const MXL_EXCEPTION_NUMBER_STORAGE_KEY = "mxl_exception_number";
+/**
+* GLOBAL_CONFIG._MXLFileBundleIDs is populated at runtime when each file is loaded,
+* based on the contents injected by the mxl-web-cli.
+*/
+const getJSFileBundleIDs = () => JSON.stringify(require_utils_globalConfig.GLOBAL_CONFIG._MXLFileBundleIDs || {});
+var MXLLogManager = class MXLLogManager {
+	_diag;
+	_perf;
+	_logger;
+	_spanSessionManager;
+	_limitManager;
+	_visibilityDoc;
+	_storage;
+	constructor({ diag: diagParam, perf, spanSessionManager, limitManager, loggerProvider: globalLoggerProviderOverride, visibilityDoc = window.document, storage = window.localStorage }) {
+		const loggerProvider = globalLoggerProviderOverride ?? _opentelemetry_api_logs.logs;
+		this._diag = diagParam ?? _opentelemetry_api.diag.createComponentLogger({ namespace: "MXLLogManager" });
+		this._perf = perf ?? new require_utils_PerformanceManager_OTelPerformanceManager.OTelPerformanceManager();
+		this._logger = loggerProvider.getLogger("mxl-web-sdk-logs");
+		this._spanSessionManager = spanSessionManager;
+		this._limitManager = limitManager;
+		this._visibilityDoc = visibilityDoc;
+		this._storage = storage;
+	}
+	_validateAttributes(attributes) {
+		if (Object.prototype.toString.call(attributes) !== "[object Object]") {
+			this._diag.warn("attributes must be a plain object", attributes);
+			return {};
+		}
+		return attributes;
+	}
+	static _logSeverityToSeverityNumber(severity) {
+		switch (severity) {
+			case "info": return _opentelemetry_api_logs.SeverityNumber.INFO;
+			case "warning": return _opentelemetry_api_logs.SeverityNumber.WARN;
+			default: return _opentelemetry_api_logs.SeverityNumber.ERROR;
+		}
+	}
+	logException(error, { handled = true, attributes = {}, timestamp = this._perf.getNowMillis(), handler = "manual" } = {}) {
+		const validAttrs = this._validateAttributes(attributes);
+		if (!handled) this._spanSessionManager.incrSessionCountForKey(require_constants_attributes.KEY_EMB_UNHANDLED_EXCEPTIONS_COUNT);
+		const type = error?.constructor?.name || typeof error;
+		let errMessage = "";
+		let errName = type;
+		let errStack = "";
+		let errCause = "";
+		if (error instanceof Error) {
+			errMessage = String(error.message || "").trim();
+			errName = error.name || "";
+			errStack = error.stack || "";
+			errCause = error.cause ? "present" : "";
+		} else if (error && typeof error === "object") try {
+			errMessage = JSON.stringify(error);
+		} catch {
+			errMessage = String(error).trim();
+		}
+		else errMessage = String(error).trim();
+		const limited = this._limitManager.limitException(errMessage, validAttrs);
+		if (limited === "dropped") return;
+		this._logger.emit({
+			timestamp,
+			severityNumber: _opentelemetry_api_logs.SeverityNumber.ERROR,
+			severityText: "ERROR",
+			body: limited.message,
+			attributes: {
+				...limited.attributes,
+				[require_constants_attributes.KEY_EMB_TYPE]: require_constants_attributes.EMB_TYPES.SystemException,
+				[require_constants_attributes.KEY_EMB_EXCEPTION_HANDLING]: MXLLogManager._exceptionHandlingType(handled, handler),
+				[require_constants_attributes.KEY_EMB_EXCEPTION_CAUSE]: errCause,
+				[_opentelemetry_semantic_conventions.ATTR_EXCEPTION_TYPE]: type,
+				["exception.name"]: errName,
+				[_opentelemetry_semantic_conventions.ATTR_EXCEPTION_MESSAGE]: limited.message,
+				[_opentelemetry_semantic_conventions.ATTR_EXCEPTION_STACKTRACE]: errStack,
+				[require_constants_attributes.KEY_EMB_JS_FILE_BUNDLE_IDS]: getJSFileBundleIDs(),
+				[require_constants_attributes.KEY_EMB_STATE]: require_utils_getVisibilityState.getVisibilityState(this._visibilityDoc),
+				[require_constants_attributes.KEY_EMB_EXCEPTION_NUMBER]: require_utils_getIncrementedCount.getIncrementedCount(this._storage, MXL_EXCEPTION_NUMBER_STORAGE_KEY, this._diag)
+			}
+		});
+	}
+	message(message, severity, { attributes = {}, includeStacktrace = true, stacktrace } = {}) {
+		if (typeof message !== "string" || !message.trim()) {
+			this._diag.warn("Message must be a non-empty string");
+			return;
+		}
+		if (![
+			"info",
+			"warning",
+			"error"
+		].includes(severity)) {
+			this._diag.warn("Severity must be info, warning, or error");
+			return;
+		}
+		const validAttrs = this._validateAttributes(attributes);
+		if (severity === "error") this._spanSessionManager.incrSessionCountForKey(require_constants_attributes.KEY_EMB_ERROR_LOG_COUNT);
+		let stack = "";
+		if (severity !== "info") {
+			if (typeof stacktrace === "string") stack = stacktrace;
+			else if (includeStacktrace) stack = (/* @__PURE__ */ new Error()).stack || "";
+		}
+		this._logMessage({
+			message: message.trim(),
+			severity,
+			timestamp: this._perf.getNowMillis(),
+			attributes: validAttrs,
+			stack
+		});
+	}
+	_logMessage({ message, severity, timestamp, attributes = {}, stack }) {
+		const limitedLog = this._limitManager.limitLog(message, severity, attributes);
+		if (limitedLog === "dropped") return;
+		this._logger.emit({
+			timestamp,
+			severityNumber: MXLLogManager._logSeverityToSeverityNumber(severity),
+			severityText: severity.toUpperCase(),
+			body: limitedLog.message,
+			attributes: {
+				...limitedLog.attributes,
+				[require_constants_attributes.KEY_EMB_TYPE]: require_constants_attributes.EMB_TYPES.SystemLog,
+				...stack ? {
+					[require_constants_attributes.KEY_EMB_JS_EXCEPTION_STACKTRACE]: stack,
+					[require_constants_attributes.KEY_EMB_JS_FILE_BUNDLE_IDS]: getJSFileBundleIDs()
+				} : {},
+				[require_constants_attributes.KEY_EMB_STATE]: require_utils_getVisibilityState.getVisibilityState(this._visibilityDoc)
+			}
+		});
+	}
+	static _exceptionHandlingType(handled, handler) {
+		if (handled) return "handled";
+		if (handler === "global_exception") return "unhandled_error";
+		if (handler === "promise_rejection") return "unhandled_rejection";
+		return "unhandled";
+	}
+};
+
+//#endregion
+exports.MXLLogManager = MXLLogManager;
+//# sourceMappingURL=MXLLogManager.cjs.map

package/dist/managers/MXLLogManager/MXLLogManager.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"MXLLogManager.cjs","names":["GLOBAL_CONFIG","logs","diag","OTelPerformanceManager","SeverityNumber","KEY_EMB_UNHANDLED_EXCEPTIONS_COUNT","KEY_EMB_TYPE","EMB_TYPES","KEY_EMB_EXCEPTION_HANDLING","KEY_EMB_EXCEPTION_CAUSE","ATTR_EXCEPTION_TYPE","ATTR_EXCEPTION_MESSAGE","ATTR_EXCEPTION_STACKTRACE","KEY_EMB_JS_FILE_BUNDLE_IDS","KEY_EMB_STATE","getVisibilityState","KEY_EMB_EXCEPTION_NUMBER","getIncrementedCount","KEY_EMB_ERROR_LOG_COUNT","KEY_EMB_JS_EXCEPTION_STACKTRACE"],"sources":["../../../src/managers/MXLLogManager/MXLLogManager.ts"],"sourcesContent":["import type { Attributes, DiagLogger } from '@opentelemetry/api';\nimport { diag } from '@opentelemetry/api';\nimport type { Logger } from '@opentelemetry/api-logs';\nimport { logs, SeverityNumber } from '@opentelemetry/api-logs';\nimport {\n  ATTR_EXCEPTION_MESSAGE,\n  ATTR_EXCEPTION_STACKTRACE,\n  ATTR_EXCEPTION_TYPE,\n} from '@opentelemetry/semantic-conventions';\nimport type { LogManager, LogSeverity } from '../../api-logs/index.ts';\nimport type {\n  LogExceptionOptions,\n  LogMessageOptions,\n} from '../../api-logs/manager/index.ts';\nimport type { ExceptionHandlerType } from '../../api-logs/manager/types.ts';\nimport type { VisibilityStateDocument } from '../../common/index.ts';\nimport {\n  KEY_EMB_ERROR_LOG_COUNT,\n  KEY_EMB_EXCEPTION_CAUSE,\n  KEY_EMB_JS_FILE_BUNDLE_IDS,\n  KEY_EMB_UNHANDLED_EXCEPTIONS_COUNT,\n} from '../../constants/attributes.ts';\nimport {\n  EMB_TYPES,\n  KEY_EMB_EXCEPTION_HANDLING,\n  KEY_EMB_EXCEPTION_NUMBER,\n  KEY_EMB_JS_EXCEPTION_STACKTRACE,\n  KEY_EMB_STATE,\n  KEY_EMB_TYPE,\n} from '../../constants/index.ts';\nimport type { PerformanceManager } from '../../utils/index.ts';\nimport {\n  GLOBAL_CONFIG,\n  getIncrementedCount,\n  getVisibilityState,\n  OTelPerformanceManager,\n} from '../../utils/index.ts';\nimport type { LimitManagerInternal } from '../MXLLimitManager/index.ts';\nimport type { SpanSessionManagerInternal } from '../MXLSpanSessionManager/index.ts';\nimport type { MXLLogManagerArgs } from './types.ts';\n\nconst MXL_EXCEPTION_NUMBER_STORAGE_KEY = 'mxl_exception_number';\n/**\n * GLOBAL_CONFIG._MXLFileBundleIDs is populated at runtime when each file is loaded,\n * based on the contents injected by the mxl-web-cli.\n */\nconst getJSFileBundleIDs = () =>\n  JSON.stringify(GLOBAL_CONFIG._MXLFileBundleIDs || {});\n\nexport class MXLLogManager implements LogManager {\n  private readonly _diag: DiagLogger;\n  private readonly _perf: PerformanceManager;\n  private readonly _logger: Logger;\n  private readonly _spanSessionManager: SpanSessionManagerInternal;\n  private readonly _limitManager: LimitManagerInternal;\n  private readonly _visibilityDoc: VisibilityStateDocument;\n  private readonly _storage: Storage;\n\n  public constructor({\n    diag: diagParam,\n    perf,\n    spanSessionManager,\n    limitManager,\n    loggerProvider: globalLoggerProviderOverride,\n    visibilityDoc = window.document,\n    storage = window.localStorage,\n  }: MXLLogManagerArgs) {\n    const loggerProvider = globalLoggerProviderOverride ?? logs;\n\n    this._diag =\n      diagParam ??\n      diag.createComponentLogger({\n        namespace: 'MXLLogManager',\n      });\n    this._perf = perf ?? new OTelPerformanceManager();\n    this._logger = loggerProvider.getLogger('mxl-web-sdk-logs');\n    this._spanSessionManager = spanSessionManager;\n    this._limitManager = limitManager;\n    this._visibilityDoc = visibilityDoc;\n    this._storage = storage;\n  }\n\n  private _validateAttributes(attributes: unknown): Attributes {\n    if (Object.prototype.toString.call(attributes) !== '[object Object]') {\n      this._diag.warn('attributes must be a plain object', attributes);\n      return {};\n    }\n    return attributes as Attributes;\n  }\n\n  private static _logSeverityToSeverityNumber(\n    severity: LogSeverity,\n  ): SeverityNumber {\n    switch (severity) {\n      case 'info':\n        return SeverityNumber.INFO;\n      case 'warning':\n        return SeverityNumber.WARN;\n      default:\n        return SeverityNumber.ERROR;\n    }\n  }\n\n  public logException(\n    error: unknown,\n    {\n      handled = true,\n      attributes = {},\n      timestamp = this._perf.getNowMillis(),\n      handler = 'manual',\n    }: LogExceptionOptions = {},\n  ) {\n    const validAttrs = this._validateAttributes(attributes);\n\n    if (!handled) {\n      this._spanSessionManager.incrSessionCountForKey(\n        KEY_EMB_UNHANDLED_EXCEPTIONS_COUNT,\n      );\n    }\n\n    const type = error?.constructor?.name || typeof error;\n    let errMessage = '';\n    let errName = type;\n    let errStack = '';\n    let errCause = '';\n\n    if (error instanceof Error) {\n      errMessage = String(error.message || '').trim();\n      errName = error.name || '';\n      errStack = error.stack || '';\n      errCause = error.cause ? 'present' : '';\n    } else if (error && typeof error === 'object') {\n      try {\n        errMessage = JSON.stringify(error);\n      } catch {\n        errMessage = String(error).trim();\n      }\n    } else {\n      errMessage = String(error).trim();\n    }\n\n    const limited = this._limitManager.limitException(errMessage, validAttrs);\n    if (limited === 'dropped') {\n      return;\n    }\n\n    this._logger.emit({\n      timestamp,\n      severityNumber: SeverityNumber.ERROR,\n      severityText: 'ERROR',\n      body: limited.message,\n      attributes: {\n        ...limited.attributes,\n        [KEY_EMB_TYPE]: EMB_TYPES.SystemException,\n        [KEY_EMB_EXCEPTION_HANDLING]: MXLLogManager._exceptionHandlingType(\n          handled,\n          handler,\n        ),\n        [KEY_EMB_EXCEPTION_CAUSE]: errCause,\n        [ATTR_EXCEPTION_TYPE]: type,\n        ['exception.name']: errName,\n        [ATTR_EXCEPTION_MESSAGE]: limited.message,\n        [ATTR_EXCEPTION_STACKTRACE]: errStack,\n        [KEY_EMB_JS_FILE_BUNDLE_IDS]: getJSFileBundleIDs(),\n        [KEY_EMB_STATE]: getVisibilityState(this._visibilityDoc),\n        [KEY_EMB_EXCEPTION_NUMBER]: getIncrementedCount(\n          this._storage,\n          MXL_EXCEPTION_NUMBER_STORAGE_KEY,\n          this._diag,\n        ),\n      },\n    });\n  }\n\n  public message(\n    message: string,\n    severity: LogSeverity,\n    {\n      attributes = {},\n      includeStacktrace = true,\n      stacktrace,\n    }: LogMessageOptions = {},\n  ) {\n    if (typeof message !== 'string' || !message.trim()) {\n      this._diag.warn('Message must be a non-empty string');\n      return;\n    }\n\n    if (!['info', 'warning', 'error'].includes(severity)) {\n      this._diag.warn('Severity must be info, warning, or error');\n      return;\n    }\n\n    const validAttrs = this._validateAttributes(attributes);\n\n    if (severity === 'error') {\n      this._spanSessionManager.incrSessionCountForKey(KEY_EMB_ERROR_LOG_COUNT);\n    }\n\n    let stack = '';\n    if (severity !== 'info') {\n      if (typeof stacktrace === 'string') {\n        stack = stacktrace;\n      } else if (includeStacktrace) {\n        stack = new Error().stack || '';\n      }\n    }\n\n    this._logMessage({\n      message: message.trim(),\n      severity,\n      timestamp: this._perf.getNowMillis(),\n      attributes: validAttrs,\n      stack,\n    });\n  }\n\n  private _logMessage({\n    message,\n    severity,\n    timestamp,\n    attributes = {},\n    stack,\n  }: {\n    message: string;\n    severity: LogSeverity;\n    timestamp: number;\n    attributes?: Attributes;\n    stack?: string;\n  }) {\n    const limitedLog = this._limitManager.limitLog(\n      message,\n      severity,\n      attributes,\n    );\n\n    if (limitedLog === 'dropped') {\n      return;\n    }\n\n    this._logger.emit({\n      timestamp,\n      severityNumber: MXLLogManager._logSeverityToSeverityNumber(severity),\n      severityText: severity.toUpperCase(),\n      body: limitedLog.message,\n      attributes: {\n        ...limitedLog.attributes,\n        [KEY_EMB_TYPE]: EMB_TYPES.SystemLog,\n        ...(stack\n          ? {\n              [KEY_EMB_JS_EXCEPTION_STACKTRACE]: stack,\n              [KEY_EMB_JS_FILE_BUNDLE_IDS]: getJSFileBundleIDs(),\n            }\n          : {}),\n        [KEY_EMB_STATE]: getVisibilityState(this._visibilityDoc),\n      },\n    });\n  }\n\n  private static _exceptionHandlingType(\n    handled: boolean,\n    handler: ExceptionHandlerType,\n  ): string {\n    if (handled) {\n      return 'handled';\n    }\n\n    if (handler === 'global_exception') {\n      return 'unhandled_error';\n    }\n\n    if (handler === 'promise_rejection') {\n      return 'unhandled_rejection';\n    }\n\n    return 'unhandled';\n  }\n}\n"],"mappings":"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"}

package/dist/managers/MXLLogManager/MXLLogManager.d.cts

@@ -0,0 +1,40 @@
+import { LogExceptionOptions, LogManager, LogMessageOptions, LogSeverity } from "../../api-logs/manager/types.cjs";
+import { MXLLogManagerArgs } from "./types.cjs";
+
+//#region src/managers/MXLLogManager/MXLLogManager.d.ts
+declare class MXLLogManager implements LogManager {
+  private readonly _diag;
+  private readonly _perf;
+  private readonly _logger;
+  private readonly _spanSessionManager;
+  private readonly _limitManager;
+  private readonly _visibilityDoc;
+  private readonly _storage;
+  constructor({
+    diag: diagParam,
+    perf,
+    spanSessionManager,
+    limitManager,
+    loggerProvider: globalLoggerProviderOverride,
+    visibilityDoc,
+    storage
+  }: MXLLogManagerArgs);
+  private _validateAttributes;
+  private static _logSeverityToSeverityNumber;
+  logException(error: unknown, {
+    handled,
+    attributes,
+    timestamp,
+    handler
+  }?: LogExceptionOptions): void;
+  message(message: string, severity: LogSeverity, {
+    attributes,
+    includeStacktrace,
+    stacktrace
+  }?: LogMessageOptions): void;
+  private _logMessage;
+  private static _exceptionHandlingType;
+}
+//#endregion
+export { MXLLogManager };
+//# sourceMappingURL=MXLLogManager.d.cts.map

package/dist/managers/MXLLogManager/MXLLogManager.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MXLLogManager.d.cts","names":[],"sources":["../../../src/managers/MXLLogManager/MXLLogManager.ts"],"sourcesContent":[],"mappings":";;;;cAiDa,aAAA,YAAyB;EAAzB,iBAAc,KAAA;EAUjB,iBAAA,KAAA;EACN,iBAAA,OAAA;EACA,iBAAA,mBAAA;EACA,iBAAA,aAAA;EACgB,iBAAA,cAAA;EAChB,iBAAA,QAAA;EACA,WAAA,CAAA;IAAA,IAAA,EANM,SAMN;IAAA,IAAA;IAAA,kBAAA;IAAA,YAAA;IAAA,cAAA,EAFgB,4BAEhB;IAAA,aAAA;IAAA;EAAA,CAAA,EACC,iBADD;EACC,QAAA,mBAAA;EAwCC,eAAA,4BAAA;EACA,YAAA,CAAA,KAAA,EAAA,OAAA,EAAA;IAAA,OAAA;IAAA,UAAA;IAAA,SAAA;IAAA;EAAA,CAAA,CAAA,EAGC,mBAHD,CAAA,EAAA,IAAA;EACA,OAAA,CAAA,OAAA,EAAA,MAAA,EAAA,QAAA,EAoEQ,WApER,EAAA;IAAA,UAAA;IAAA,iBAAA;IAAA;EAAA,CAAA,CAAA,EAyEC,iBAzED,CAAA,EAAA,IAAA;EACA,QAAA,WAAA;EACC,eAAA,sBAAA"}