[Enhancement] Implement WebSocket message delivery guarantees and an offline message queue

[Tybravo]

📁 Implementation Directory

backend/src/sockets/messageQueue.ts

🎯 Goal

Ensure drivers do not lose critical messages when briefly offline.

📋 Requirements

• Require acknowledgements (ACK) from clients.\n- Queue unacknowledged messages.\n- Flush the queue when the driver reconnects.

🔧 Technical Scope

• Node.js / Express
• TypeScript
• MongoDB / Mongoose
• Stellar Soroban RPC

🌿 Branch

git checkout -b feat/websocket-message-guarantees

✅ Acceptance Criteria

• Using an AI Agent to submit a PR is DISALLOWED.
• Strict Layered Architecture (Non-Negotiable): Implement using the Controller -> Service -> Model pattern.
• Data Source: Response data must be retrieved from the database. No Inline Mock Objects or Hardcoded Values usage for integration.
• Environment: Contributors must use the requested .env credentials to enable implementation with real-life data.
• API Versioning: API Must Be Versioned (e.g., /api/v1/...).
• Production Ready: Code must look production-ready (robust error handling, strong typings).
• Proof of Work: Upload a screenshot of work done (i.e., API Response Success via Postman/Browser, or all unit tests passed successfully).
• PR Content: Must include Closes #[issue_id] with a work done summary.

📌 PR Requirements

• ⚠️ Assignment required before starting — comment on this issue to request assignment.
• PR must comply fully with the CONTRIBUTING.md.
• AI Agent submissions are DISALLOWED and will be closed without review.
• No Inline Mock Objects or Hardcoded Values usage for integration.

[yeswanth08]

Can I work on this issue??

[Adeiza15]

@Adeiza15 has applied to work on this issue as part of the Stellar Wave Program's 8th wave.

Hello Maintainer, I’d like to work on this issue.
I’ve read through the issue and traced the relevant logic in the codebase, so I have a clear picture of where the change needs to sit and what it touches elsewhere

ℹ️ Repo Maintainers: To accept this application, review their application or assign @Adeiza15 to this issue.

[azahjessica49-commits]

@azahjessica49-commits has applied to work on this issue as part of the Stellar Wave Program's 8th wave.

I will like to work on this issue please assign it to me

ℹ️ Repo Maintainers: To accept this application, review their application or assign @azahjessica49-commits to this issue.

[Songu3020]

@Songu3020 has applied to work on this issue as part of the Stellar Wave Program's 8th wave.

Hi! I’m a full-stack developer with a strong blockchain background. I’d love to handle this issue and can deliver a clean, reliable solution. Kindly assign it to me.

ℹ️ Repo Maintainers: To accept this application, review their application or assign @Songu3020 to this issue.

[drips-wave]

Congratulations, @Songu3020! 🎉 Your application was accepted by the repo's maintainers, and the issue is due on August 31, 2026.

🧑‍💻 @Songu3020: Please resolve the issue such that the repo's maintainers have enough time to review your contribution before the due date. You'll earn Points for completing the issue on-time, which will make you eligible for a share of the Stellar Wave Program's reward pool.

Warning

When opening a PR, please link it to this issue to ensure it gets tracked accurately. Points are awarded when this issue is marked as completed by the maintainer.

🤠 Repo maintainers: Please keep an eye on the contributor's progress and review their work before the due date. You can manage this issue, including adjusting its complexity and points, here.

🌊 Happy Wave 🌊

[drips-wave]

This issue has been marked as completed by a Drips Wave moderator for @Songu3020 as part of the Stellar Wave Program's 8th Wave 🥳

Moderator's reason: [Auto-assessed] PR #159 was successfully merged by maintainers on 2026-08-28T17:10:27Z, addressing the requirements of issue #147 by implementing a WebSocket message delivery guarantee and offline queue with proper unit tests.

😎 @Songu3020: You earned 200 Points for completing this issue! After the current Wave ends, you'll be eligible for a percentage of the Wave's reward pool based on the percentage of total points you've earned. Learn more here.

🧑‍💻 Repo maintainers: How'd the contributor do? Leave a review to share your experience working with them.

ℹ️ Note: This issue was marked complete via moderation. Points were issued even though the GitHub issue remains open.