It is not possible to test code that uses this library

[RShergold]

We use Moq in our unit tests. For a simple query like this

var stack = new ContentstackClient(config);
var query = stack.ContentType("blog").Query();
var results = await query.Find();

We would normally mock ContentstackClient, ContentType, Query but we cant do this because they are concrete classes.

Can you please introduce the following interfaces IContentstackClient, IContentType, IQuery.

If this is not possible can you provide some documentation explaining how code using the contentstack client can be tested in isolation without connecting to the content stack servers. This would ideally cover scenarios involving mocking the fluent API chain.

[cs-raj]

Hi @RShergold we'll review this on our end and provide an update soon.
cc: @netrajpatel @nadeem-cs

[nadeem-cs]

Thanks for raising this and providing your use case.

Introducing interfaces such as IContentstackClient, IContentType, and IQuery would indeed make mocking easier, but doing so would introduce breaking changes in the SDK’s design and public API. Given the potential impact, we’ll need to discuss this internally and decide whether it’s something we can introduce in a future release.

In the meantime, we’re sharing a TESTING_GUIDE.md file with this reply. It outlines an alternate testing strategy for isolating code and mocking the SDK’s behavior without requiring direct interfaces. This should help you test your integration without connecting to Contentstack servers.

TESTING_GUIDE.md