Add API for sending exception data

[vijayupadya]

Add API for sending exception data

[Copilot]

Pull request overview

Adds a public API for sending exception telemetry (bypassing opt-in checks) and wires it through the telemetry sender/client abstraction so Application Insights can emit real ExceptionData when supported.

Changes:

• Extend the telemetry client abstraction with optional logException and use it from BaseTelemetrySender.sendErrorData when available.
• Add sendDangerousTelemetryException(...) to the reporter (and update public typings/docs).
• Refactor App Insights event property preparation and bump package version to 1.5.0.

Reviewed changes

Copilot reviewed 5 out of 7 changed files in this pull request and generated 4 comments.

Show a summary per file

File	Description
src/common/baseTelemetrySender.ts	Adds logException support and changes error fallback payload shaping.
src/common/baseTelemetryReporter.ts	Adds sendDangerousTelemetryException(...) API and routes it through the sender.
src/common/appInsightsClientFactory.ts	Implements logException and refactors event data preparation/merging.
dist/telemetryReporter.d.ts	Exposes new API in public typings.
README.md	Documents new “Dangerous Methods” section and updates version gate.
package.json	Version bump to 1.5.0.
package-lock.json	Lockfile version bump alignment.

Comments suppressed due to low confidence (1)

src/common/baseTelemetrySender.ts:88

• sendErrorData no longer preserves the documented/previous behavior where data can be either a SenderData object or a plain properties bag. In the fallback branch you currently treat data as SenderData and only read senderData.properties, so calls like sendErrorData(err, { prop1: 1 }) will drop prop1 entirely (and existing unit tests expect those keys to be included). Consider normalizing data first: if it has a properties field use that, otherwise treat data itself as the properties object, then merge in the standard { name, message, stack } fields.

			// Fallback for clients without exception support (e.g., 1DS)
			const errorData = { stack: exception.stack, message: exception.message, name: exception.name };
			const senderData = data as SenderData | undefined;
			const errorProperties = senderData?.properties ?? {};
			const fallbackData: SenderData = {
				properties: { ...errorProperties, ...errorData },
				measurements: senderData?.measurements,
				tagOverrides: senderData?.tagOverrides
			};

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.