feat(client): add debug mode with configurable log levels

[drichar]

Summary

Adds a debug logging system to the Deflex SDK with configurable log levels (none, info, debug, trace). This enables developers to get visibility into SDK operations during development and troubleshoot swap failures without exposing sensitive data like API keys.

Changes

• Logger utility (logger.ts) - Level-based logging with automatic sanitization of sensitive fields (apiKey, algodToken, signatures, encrypted payloads)
• Debug config - New debugLevel option in DeflexConfigParams with four levels: none (default), info, debug, trace
• Swap failure diagnostics (debug.ts) - Detailed context logging when swap execution fails, including quote details, route info, and transaction state
• Test coverage - 300 lines of comprehensive tests for the logger functionality

Usage

const client = new DeflexClient({
  apiKey: 'your-api-key',
  debugLevel: 'debug', // Enable debug logging
})

Test plan

• Unit tests pass (pnpm test)
• Type checking passes (pnpm typecheck)
• Existing tests updated to accommodate logger changes

[github-actions]

🎉 This PR is included in version 1.8.0 🎉

The release is available on:

• npm package (@latest dist-tag)
• GitHub release

Your semantic-release bot 📦🚀