Enhanced Data Retrieval: Implement Join Conditions

[ZaidMaslouhi]

Description:

This PR introduces join filters for dataui-nestjs-crud, empowering you with greater control over related data queries. Users can now specify WHERE conditions within the ON clause of joins, enabling the creation of more intricate and specific queries.

Key Improvements:

• Increased Flexibility: Craft complex queries by filtering related entities based on custom conditions.
• Enhanced Data Retrieval: Retrieve specific subsets of related data, improving efficiency and focus.

Implementation Details:

• Introduces a new 'ON' property to the QueryJoin interface within @dataui/crud-request.
• Leverages this property to specify 'ON' conditions for joins.
• Implements comprehensive unit and integration tests for guaranteed functionality.

Benefits:

• Simplifies querying related data with precise control.
• Enables more efficient and targeted data retrieval.
• This PR elevates dataui-nestjs-crud's capabilities by empowering you with flexible join filtering.

#38

[coveralls]

Pull Request Test Coverage Report for Build 8606035890

Details

• 33 of 34 (97.06%) changed or added relevant lines in 4 files are covered.
• No unchanged relevant lines lost coverage.
• Overall coverage decreased (-0.08%) to 98.589%

---

Changes Missing Coverage	Covered Lines	Changed/Added Lines	%
packages/crud-request/src/request-query.validator.ts	1	2	50.0%

Totals
Change from base Build 8555637572:	-0.08%
Covered Lines:	1270
Relevant Lines:	1278

---

💛 - Coveralls

[zaro]

@ZaidMaslouhi Thank you for the good work.

I hope you are willing to add at least one example in the documenation here : https://github.com/gid-oss/dataui-nestjs-crud/blob/master/docs/requests.md#join !

Apart from that it's good to merge and release and I will do so soon after I hear from you on the docs.

[Dragomir-Ivanov]

While at it guys, I really think that relations need to have ability to be paginated/sorted as well.
Example, getting an User entity, and jointing Comment entity. But get last 10 comments only.

Oh, Hi @zaro ! What a small world. We were colleagues at Concurrent ages ago :)

[ZaidMaslouhi]

Hi @zaro!
Absolutely, I'd be happy to add an example for the join condition on the docs.

[zaro]

@Dragomir-Ivanov Hey :) Indeed , quite some time ago.

Regarding your suggestion, this is not the place to discuss it. If you want maybe open a new issue where this can be discussed properly. Because if I understand you correctly, this is actually quite complicated feature and most certainly not possible with a single SQL query. So maybe also provide a simple example in plain SQL how it is supposed to work.

Keep in mind that this CRUD library is just a think layer over TypeORM and TypeORM itself doesn't have support for what you are requesting.

Happy to hear more for you .

[afilp]

@ZaidMaslouhi FYI: I think this is related to the docs you wrote?

#53

Maybe you can do the change if this is what happening?

Thanks.