refactor: convert events module to TS

[jaissica12]

Background

• As part of the ongoing effort to migrate the mParticle Web SDK from JavaScript to TypeScript, this PR converts the events module and its corresponding test file to TypeScript for improved type safety and developer experience.

What Has Changed

• Converted src/events.js to src/events.ts with full type annotations on all method parameters, return types, and internal variables
• Converted test/src/tests-event-logging.js to test/src/tests-event-logging.ts with proper global type declarations and type casts for intentionally invalid test inputs
• Updated src/events.interfaces.ts to expand the logImpressionEvent signature to accept SDKImpression | SDKImpression[] | SDKProductImpression | SDKProductImpression[]
• Minor supporting type adjustments in src/sdkRuntimeModels.ts, src/serverModel.ts, and src/store.ts

Screenshots/Video

Checklist

• I have performed a self-review of my own code.
• I have made corresponding changes to the documentation.
• I have added tests that prove my fix is effective or that my feature works.
• I have tested this locally.

Additional Notes

Reference Issue (For employees only. Ignore if you are an outside contributor)

• Closes https://go/j/SDKE-1106

[cursor]

PR Summary

Medium Risk
Touches core event/commercial event logging code paths and broadens accepted input shapes for impressions/promotions, which could impact payload formatting if typings mask runtime differences. Most changes are refactors/type annotations, but they sit in a high-traffic area.

Overview
Converts the Events implementation and event-logging tests from JS to TypeScript, adding explicit types for event logging, location tracking, and DOM event handlers.

Expands commerce APIs to accept additional input shapes: logImpressionEvent now supports both SDKImpression and SDKProductImpression (single or array) with runtime branching to normalize payloads, and logPromotionEvent now accepts a single promotion or an array.

Includes supporting type tweaks (e.g., SDKPromotionAction.PromotionActionType union, SDKConfig.timeout optional) and minor runtime adjustments like safer error logging and globalThis.location usage, plus small casts in serverModel for DTO serialization.

^{Reviewed by Cursor Bugbot for commit 12da570. Bugbot is set up for automated code reviews on this repo. Configure here.}

[cursor]

Cursor Bugbot has reviewed your changes and found 2 potential issues.

^{❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, have a team admin enable autofix in the Cursor dashboard.}

^{Reviewed by Cursor Bugbot for commit 14dfc68. Configure here.}

[sonarqubecloud]

Quality Gate failed

Failed conditions
1 Security Hotspot
4.3% Duplication on New Code (required ≤ 3%)

See analysis details on SonarQube Cloud