Add WebSocket support for real-time payment confirmation #2

New Issue

hermes · 2026-03-18T22:00:59Z

hermes commented

2026-03-18 22:00:59 +00:00

Context

Currently payment confirmation is polling-based — client calls GET /jobs/:id
repeatedly until state changes. For the Three.js Workshop, we need instant feedback.

Requirements

Add a WebSocket endpoint (e.g. ws://host/api/ws)
When a Lightning invoice is paid, push state change to connected clients
Support both Job (Mode 1) and Session (Mode 2) payment events
Client subscribes by job ID or session ID
Use ws npm package (lightweight, no socket.io overhead)

Events to push

{"type": "payment_confirmed", "jobId": "...", "state": "evaluating"}
{"type": "eval_complete", "jobId": "...", "state": "awaiting_work_payment", "workInvoice": {...}}
{"type": "work_started", "jobId": "...", "state": "executing"}
{"type": "work_complete", "jobId": "...", "state": "complete", "result": "..."}
{"type": "session_active", "sessionId": "...", "balanceSats": 1000}
{"type": "session_debited", "sessionId": "...", "debitedSats": 45, "balanceAfter": 955}

Acceptance Criteria

WebSocket server starts alongside Express
Client can subscribe to job or session updates
Payment confirmation pushes within 1s of LNBits confirming
Graceful reconnection handling
Stub mode works (dev/stub/pay triggers WS push)
Tests updated

References

Parent epic: #{epic_num}

## Context Currently payment confirmation is polling-based — client calls `GET /jobs/:id` repeatedly until state changes. For the Three.js Workshop, we need instant feedback. ## Requirements - Add a WebSocket endpoint (e.g. `ws://host/api/ws`) - When a Lightning invoice is paid, push state change to connected clients - Support both Job (Mode 1) and Session (Mode 2) payment events - Client subscribes by job ID or session ID - Use `ws` npm package (lightweight, no socket.io overhead) ## Events to push ```json {"type": "payment_confirmed", "jobId": "...", "state": "evaluating"} {"type": "eval_complete", "jobId": "...", "state": "awaiting_work_payment", "workInvoice": {...}} {"type": "work_started", "jobId": "...", "state": "executing"} {"type": "work_complete", "jobId": "...", "state": "complete", "result": "..."} {"type": "session_active", "sessionId": "...", "balanceSats": 1000} {"type": "session_debited", "sessionId": "...", "debitedSats": 45, "balanceAfter": 955} ``` ## Acceptance Criteria - [ ] WebSocket server starts alongside Express - [ ] Client can subscribe to job or session updates - [ ] Payment confirmation pushes within 1s of LNBits confirming - [ ] Graceful reconnection handling - [ ] Stub mode works (dev/stub/pay triggers WS push) - [ ] Tests updated ## References - Parent epic: #{epic_num}

hermes added the api enhancement replit labels 2026-03-18 22:00:59 +00:00

replit self-assigned this 2026-03-18 22:02:21 +00:00

replit referenced this issue

2026-03-18 22:21:28 +00:00

WebSocket server not wired to HTTP server — issue #2 (ws payment push) is incomplete #15

replit referenced a pull request that will close this issue

2026-03-18 22:37:59 +00:00

feat: streaming, rate limiting, CORS, event bus, SSE — closes #2 #3 #4 #5; fixes #14 #16 #20

This repo is archived. You cannot comment on issues.