fix(datastore): Switch to BFS in Join Builder for Alias, fixes - #2488

[ankpshah]

• PR title and description conform to Pull Request guidelines.

Issue #, if available:
#2488
Description of changes:
Replace DFS Join Builder with BFS to Improve Alias Management in Joins

• Replace the recursiveBuildJoins method (DFS-based) with buildJoinsUsingBFS to address issues with incorrect table alias usage in WHERE conditions.
• The BFS approach ensures that all tables directly related to the root table are assigned their original names without any numeric suffixes (alias), enhancing the readability and correctness of SQL queries, especially in WHERE clauses involving intermediate tables in multilevel joins.
• Implement a tracking mechanism for visited (table, FK) combinations to support multiple foreign keys and prevent infinite loops in cyclic relationships.
• This change aims to improve the reliability of SQL query construction, particularly by ensuring that WHERE conditions on intermediate tables in multilevel joins are more intuitive and less error-prone.

How did you test these changes?
(Please add a line here how the changes were tested)

Documentation update required?

• No
• Yes (Please include a PR link for the documentation update)

General Checklist

• Added Unit Tests
• Added Integration Tests
• Security oriented best practices and standards are followed (e.g. using input sanitization, principle of least privilege, etc)

By submitting this pull request, I confirm that my contribution is made under the terms of the Apache 2.0 license.

[codecov-commenter]

Codecov Report

Attention: 3 lines in your changes are missing coverage. Please review.

Comparison is base (1804551) 42.85% compared to head (3ff367e) 42.92%.

❗ Your organization needs to install the Codecov GitHub app to enable full functionality.

Additional details and impacted files

@@            Coverage Diff             @@
##             main    #2693      +/-   ##
==========================================
+ Coverage   42.85%   42.92%   +0.06%     
==========================================
  Files         905      905              
  Lines       29098    29114      +16     
  Branches     4142     4144       +2     
==========================================
+ Hits        12471    12497      +26     
+ Misses      15269    15260       -9     
+ Partials     1358     1357       -1     

[tylerjroach]

Changes Look great. Just as a reminder, we discussed addition of query using CPK, as well as multiple statements in where clause.

[ankpshah]

Thanks. I have added tests for querying using CPK, as well as multiple conditions in where statement.

[mattcreaser]

Just a few minor comments to add.

[mattcreaser]

🎉