feat(analytics): introduce @metamask/analytics-client package and consolidate tracking types

[abretonc7s]

Description

Overview

This PR introduces a new dedicated package @metamask/analytics-client to encapsulate analytics functionality that was previously scattered across multiple packages. It also refactors related types into a new @metamask/sdk-types package to promote consistency and code reuse.

Depends on #1259

Key Changes

• Created new @metamask/analytics-client package that centralizes analytics handling logic
• Introduced new @metamask/sdk-types package with shared types like OriginatorInfo and TrackingEvents
• Migrated analytics functions from sdk-communication-layer to the dedicated package
• Updated imports across the codebase to use the new packages
• Improved test coverage with proper cleanup of mocked globals
• Enhanced Jest configuration with module name mappings for better test integration
• Updated build configurations and dependencies to support new package structure

Implementation Details

• Types Consolidation: Moved shared types (TrackingEvents, OriginatorInfo) to a dedicated types package
• Code Reuse: Eliminated duplicate analytics handling logic across packages
• Modern TypeScript Patterns: Using type exports rather than interfaces for better compatibility
• Better Testing: Added proper cleanup of global mocks in tests to prevent interference between test cases
• Dependency Management: Updated project configs to reflect the new dependencies between packages

Breaking Changes

This refactoring introduces some breaking changes for internal package consumers:

• Applications importing analytics functions directly from sdk-communication-layer will need to update imports to use @metamask/analytics-client
• Types like TrackingEvents and OriginatorInfo should now be imported from @metamask/sdk-types

Migration Guide

1. Replace imports of SendAnalytics and AnalyticsProps from @metamask/sdk-communication-layer with imports from @metamask/analytics-client
2. Replace imports of TrackingEvents and OriginatorInfo from @metamask/sdk-communication-layer with imports from @metamask/sdk-types
3. If your code used commLayer in analytics events, this field has been removed as it's now handled internally

Testing Completed

• Verified the new analytics client works correctly with existing code
• Ensured Jest tests pass with the updated module structure
• Tested package building and resolved circular dependencies
• Validated proper type exports and imports across packages

Review Checklist

• Verify analytics events are still being sent correctly
• Check for any missed imports that need updating
• Ensure all tests pass in CI
• Validate building of all affected packages
• Update documentation to reflect new package structure

[codecov]

Codecov Report

Attention: Patch coverage is 80.30303% with 13 lines in your changes missing coverage. Please review.

Project coverage is 74.00%. Comparing base (768e716) to head (10f23b7).

Files with missing lines	Patch %	Lines
...tion/EventListeners/handleClientsConnectedEvent.ts	50.00%	4 Missing ⚠️
...rvice/ConnectionManager/handleJoinChannelResult.ts	40.00%	3 Missing ⚠️
...emoteCommunication/ConnectionManager/disconnect.ts	66.66%	1 Missing ⚠️
...teCommunication/ConnectionManager/rejectChannel.ts	66.66%	1 Missing ⚠️
...ketService/EventListeners/handleChannelRejected.ts	66.66%	1 Missing ⚠️
...ices/SocketService/EventListeners/handleMessage.ts	66.66%	1 Missing ⚠️
...SocketService/MessageHandlers/handleSendMessage.ts	66.66%	1 Missing ⚠️
...s/MetaMaskSDK/InitializerManager/setupAnalytics.ts	87.50%	1 Missing ⚠️

Additional details and impacted files

@@                   Coverage Diff                   @@
##           redis-consolidation    #1263      +/-   ##
=======================================================
+ Coverage                73.73%   74.00%   +0.27%     
=======================================================
  Files                      182      181       -1     
  Lines                     4355     4301      -54     
  Branches                  1067     1061       -6     
=======================================================
- Hits                      3211     3183      -28     
+ Misses                    1144     1118      -26     

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
• 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

[sonarqubecloud]

Quality Gate passed

Issues
1 New issue
0 Accepted issues

Measures
0 Security Hotspots
0.0% Coverage on New Code
0.0% Duplication on New Code

See analysis details on SonarQube Cloud