refactor: Improve JsonSerializable type to be recursive

[vdusek]

Summary

Replace the loose dict[str, Any] | list[Any] variants of JsonSerializable with recursive references so nested JSON values are properly typed instead of falling back to Any. Based on the definition discussed in python/typing#182.

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 95.29%. Comparing base (6c3b84d) to head (73ae4bd).
⚠️ Report is 6 commits behind head on master.

Additional details and impacted files

@@            Coverage Diff             @@
##           master     #745      +/-   ##
==========================================
- Coverage   95.36%   95.29%   -0.08%     
==========================================
  Files          45       45              
  Lines        5118     5118              
==========================================
- Hits         4881     4877       -4     
- Misses        237      241       +4     

Flag	Coverage Δ
integration	95.29% <100.00%> (-0.08%)	⬇️

Flags with carried forward coverage won't be shown. Click here to find out more.

☔ 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.

[janbuchar]

This is part of the public interface via UserData, right? So the change is technically breaking for users of type checkers that cannot handle recursive types. Do we consider it a problem?

[vdusek]

See this comment from the end of 2022:

All major type checkers now support recursive type aliases by default, so this should largely work:

JSON: TypeAlias = dict[str, "JSON"] | list["JSON"] | str | int | float | bool | None

So I wouldn't be afraid of it.

[janbuchar]

LGTM then!