[sdk] Add JSDoc to exported API in swap builder

## Context
Small onboarding task for **swyftSdk**.

## Task
Add JSDoc to exported API in swap builder

## Acceptance criteria
- [ ] Params documented
- [ ] Return type described

## Notes
- Keep the PR focused on this task only
- Ask questions in the issue thread if scope is unclear