Build a transport abstraction supporting multiple networking implementations

[Lakes41]

Difficulty: Advanced
Type: Architecture

Background

The SDK currently communicates with GuildPass services using a single networking implementation. Future consumers may require custom transports for browser environments, React Native, Node.js, serverless platforms, testing, or mocked environments.

Separating transport concerns from SDK business logic would improve portability and extensibility.

Problem

Networking logic is tightly coupled to SDK internals, making alternative transport implementations difficult to introduce without modifying core functionality.

Expected outcome

Create a transport abstraction that allows multiple HTTP implementations to be used interchangeably while preserving the SDK's public API.

Suggested implementation

1. Audit the existing networking layer.
2. Define a transport interface responsible for request execution.
3. Refactor SDK clients to depend on the transport abstraction.
4. Provide a default HTTP implementation.
5. Demonstrate custom transports for testing and non-browser environments.
6. Document extension points for third-party transport implementations.

Acceptance criteria

• Networking is abstracted behind a transport interface.
• Existing SDK functionality remains backwards compatible.
• Consumers can register custom transports.
• Documentation explains transport customization.
• Automated tests verify multiple transport implementations.

Likely affected files/directories

src/network/, src/client/, src/config/, src/index.ts, 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.

[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 #356)
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 #377 was approved and merged by @Lakes41.

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

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