add-data-source

Create a custom Coalesce data source by implementing a class that overrides GetQuery in a StandardDataSource<T> to apply project-specific filtering, and optionally add TransformResults to shape the projected entity data.

Enforce tenant-scoped or user-scoped access controls by binding a custom Coalesce data source to the current context, overriding GetQuery to filter entity records based on the current user or tenant authorization rules.

You can extend the default Coalesce data source by integrating with base data sources, preserving the original query behavior while composing new custom filtering and projection logic for your specific domain requirements.

The best way to organize custom Coalesce data source classes for maintainability is to place them within a dedicated DataSources/ folder, keeping your entity filtering and scoping logic separated from the main domain models.

Coalesce supports projection-based access controls by utilizing the TransformResults method within a custom data source, allowing you to shape and restrict the specific entity data fields returned beyond the default API.

You need a custom data source instead of the default API query when your software project requires precise domain-specific filtering, secure tenant-scoping, or custom projections that the default Coalesce entity API cannot enforce.