search

docusign / docusign-esign-java-client

The Official Docusign Java Client Library used to interact with the eSignature REST API. Send, sign, and approve documents using this client.
https://javadoc.io/doc/com.docusign/docusign-esign-java/latest/index.html
MIT License
104 stars 95 forks source link

SDK is not typesafe #249

Closed jasonrberk closed 1 month ago

jasonrberk commented 1 year ago

seems like the whole point of an SDK in Java is invalidated when it's not typesafe.

I created https://stackoverflow.com/questions/74689092/why-is-the-docusign-java-sdk-is-not-typesafe as well.

at the very least, this would be a very nice improvement

Thoughts?

kollDocuSign commented 1 year ago

Jason,

The SDK does not have constants for these values but I understand why that would be useful. For added visibility you can also submit it as an idea here: https://feedback.docusign.com/forums/936834-apis

vinz commented 1 month ago

Hi,

We appreciate you bringing this up, @jasonrberk .

You're absolutely right; type safety is a crucial aspect of a modern SDK, and we understand the frustration of working with a non-typesafe one. We acknowledge the Stack Overflow question you linked (https://stackoverflow.com/questions/74689092/why-is-the-docusign-java-sdk-is-not-typesafe) and recognize the value typesafety brings to the developer experience.

However, introducing type safety to the existing SDK would necessitate significant changes, potentially resulting in breaking changes for existing APIs. While this is a desirable improvement for the future, it requires careful consideration due to its impact on current users.

Rest assured, we are keeping type safety in mind when developing future Docusign APIs. We'll continue to explore ways to improve the type safety of our SDK while maintaining compatibility with existing integrations.

In the meantime, if you have any other suggestions, please don't hesitate to share them. Your feedback is valuable in guiding future development.

Thanks, Vinay