Refactor SDK configuration into a strongly typed builder pattern

[Lakes41]

Difficulty: Advanced
Type: Refactor

Background

As the SDK gains support for additional networking options, authentication methods, middleware, retry policies, and logging features, initialization becomes increasingly complex. Passing numerous configuration options directly into constructors can reduce readability and make future expansion more difficult.

A builder pattern would provide a more discoverable and maintainable initialization experience.

Problem

SDK configuration is becoming increasingly difficult to manage as additional options are introduced, increasing the likelihood of invalid or inconsistent configurations.

Expected outcome

Introduce a fluent configuration builder that validates SDK configuration before client creation while preserving backwards compatibility.

Suggested implementation

1. Audit all SDK initialization options.
2. Design a fluent builder interface for constructing SDK clients.
3. Validate required configuration before initialization.
4. Provide sensible defaults for optional configuration values.
5. Preserve compatibility with existing initialization methods.
6. Update documentation and examples to demonstrate the new builder.

Acceptance criteria

• SDK clients can be initialized using the new builder.
• Invalid configuration is detected before runtime.
• Existing initialization APIs continue functioning.
• Documentation includes migration examples.
• Unit tests verify configuration validation.

Likely affected files/directories

src/client/, src/config/, src/index.ts, src/types/, docs/

[spartan124]

Hi maintainer, I would love to work on this. I have implemeted similar solutions on several projects and I can do same here cleanly and efficiently. Allow me the opportunity to contribute to your project while following contribution guidelines for your project. Kindly assign.

[grantfox-oss]

🦊 GrantFox — @spartan124 has been assigned to this issue as part of the Official Campaign | FWC26 campaign!

Next steps:

1. Open a Pull Request referencing this issue (e.g., Closes #353)
2. Your PR will be reviewed by the Adamantine-guild maintainers

Good luck! Track your progress on GrantFox.

[grantfox-oss]

🎉 This issue has been marked as completed on GrantFox as part of the Official Campaign | FWC26 campaign!

@spartan124's PR #378 was approved and merged by @Lakes41.

🏆 @spartan124: You earned 35 FoxPoints for this contribution! Your current tier: Explorer (414 total points). Track your full progress on GrantFox.

👏 Great work, @spartan124! Keep contributing to Adamantine-guild.