feat(replay): guard replay endpoints with granular user permissions

[shellmayr]

• Implement the guarding of endpoints by granular permissions for replays, building on the data model established in feat(replay): add model to allow per-user access control for replays #104446,
• Introduce base endpoint classes OrganizationReplayEndpoint and ProjectReplayEndpoint to centralize feature and permission checks for replay access, ensuring consistent enforcement across all replay endpoints.
• Updated all replay endpoints to use the new base classes and enforce granular permissions, returning appropriate HTTP status codes for unauthorized access.
• More information on the plan & product impact can be found here Research granular permissions for viewing Replays

Closes TET-1564

[linear]

TET-1564 Granular replay permissions - gate endpoints by permissions

TET-1566 Granular replay permissions - add ability to edit permissions via API endpoint

[codecov]

Codecov Report

❌ Patch coverage is 95.34884% with 6 lines in your changes missing coverage. Please review.
✅ All tests successful. No failed tests found.

Files with missing lines	Patch %	Lines
...plays/endpoints/organization_replay_events_meta.py	66.66%	1 Missing ⚠️
...sentry/replays/endpoints/project_replay_details.py	90.00%	1 Missing ⚠️
...points/project_replay_recording_segment_details.py	75.00%	1 Missing ⚠️
...ndpoints/project_replay_recording_segment_index.py	75.00%	1 Missing ⚠️
.../replays/endpoints/project_replay_video_details.py	90.00%	1 Missing ⚠️
...ntry/replays/endpoints/project_replay_viewed_by.py	85.71%	1 Missing ⚠️

Additional details and impacted files

@@                                  Coverage Diff                                  @@
##           shellmayr/feat/add-model-for-granular-replay-access   #104452   +/-   ##
=====================================================================================
  Coverage                                                80.53%    80.53%           
=====================================================================================
  Files                                                     9336      9339    +3     
  Lines                                                   401206    401273   +67     
  Branches                                                 25744     25744           
=====================================================================================
+ Hits                                                    323105    323167   +62     
- Misses                                                   77659     77664    +5     
  Partials                                                   442       442