feat: add support for joining entities to other schemas

[aaron-steinfeld]

Description

This change makes it easy to join entities to other schemas by simply providing a collection of items to join against and a getter to extract entity IDs from it. Internally, it then optimizes this into parallel queries (one per entity type) and returns a result table mapping the provided item to each entity object.

Testing

Have tested this e2e, will be adding unit tests before merging

Checklist:

• My changes generate no new warnings
• I have added tests that prove my fix is effective or that my feature works
• Any dependent changes have been merged and published in downstream modules

[codecov]

Codecov Report

Merging #72 (f7ac0fb) into main (4d77f67) will decrease coverage by 28.24%.
The diff coverage is 79.83%.

@@              Coverage Diff              @@
##               main      #72       +/-   ##
=============================================
- Coverage     56.26%   28.02%   -28.25%     
- Complexity       41       48        +7     
=============================================
  Files            20       43       +23     
  Lines           375     1092      +717     
  Branches         18       34       +16     
=============================================
+ Hits            211      306       +95     
- Misses          160      780      +620     
- Partials          4        6        +2     

Flag	Coverage Δ	Complexity Δ
unit	28.02% <79.83%> (-28.25%)	0.00 <7.00> (ø)

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

Impacted Files	Coverage Δ	Complexity Δ
.../hypertrace/graphql/entity/EntitySchemaModule.java	0.00% <0.00%> (ø)	0.00 <0.00> (?)
...y/deserialization/EntityDeserializationModule.java	0.00% <0.00%> (ø)	0.00 <0.00> (?)
...hypertrace/graphql/entity/joiner/EntityJoiner.java	0.00% <0.00%> (ø)	0.00 <0.00> (?)
...race/graphql/entity/joiner/EntityJoinerModule.java	0.00% <0.00%> (ø)	0.00 <0.00> (?)
...phql/entity/joiner/DefaultEntityJoinerBuilder.java	93.13% <93.13%> (ø)	7.00 <7.00> (?)
...ace/graphql/entity/request/EdgeRequestBuilder.java	0.00% <0.00%> (ø)	0.00% <0.00%> (?%)
...ql/entity/dao/GatewayServiceEntityEdgeFetcher.java	0.00% <0.00%> (ø)	0.00% <0.00%> (?%)
...rtrace/graphql/entity/dao/InteractionResponse.java	0.00% <0.00%> (ø)	0.00% <0.00%> (?%)
...GatewayServiceEntityInteractionRequestBuilder.java	0.00% <0.00%> (ø)	0.00% <0.00%> (?%)
... and 18 more

---

Continue to review full report at Codecov.

Legend - Click here to learn more
Δ = absolute <relative> (impact), ø = not affected, ? = missing data
Powered by Codecov. Last update 4d77f67...f7ac0fb. Read the comment docs.

[github-actions]

Unit Test Results

  8 files  +1    8 suites  +1   9s ⏱️ -2s
18 tests +3  18 ✔️ +3  0 💤 ±0  0 ❌ ±0 

Results for commit ec389ef. ± Comparison against base commit 4d77f67.