/// Run behind your HTTPS reverse proxy. Inbox storage is a single-process /// demonstration. Use a transactional DB for several workers or business credit. import 'dart:convert'; import 'dart:io'; import 'package:qr_partner_example/webhook_verifier.dart'; Future main() async { final secret = Platform.environment['QR_WEBHOOK_SECRET']; if (secret == null || secret.isEmpty) { stderr.writeln('Missing QR_WEBHOOK_SECRET.'); exitCode = 64; return; } final file = File(Platform.environment['QR_WEBHOOK_INBOX'] ?? 'private/webhook-inbox.json'); await file.parent.create(recursive: true); var durable = await file.exists() ? jsonDecode(await file.readAsString()) as Map : {'seen': {}, 'orders': {}}; final server = await HttpServer.bind(InternetAddress.loopbackIPv4, int.parse(Platform.environment['PORT'] ?? '8088')); stdout.writeln('Webhook receiver listening on loopback.'); // Sequential processing prevents concurrent file writes. The JSON inbox is // never served publicly and contains payer/payment state: restrict its ACL. await for (final request in server) { try { if (request.method != 'POST' || request.uri.path != '/qr-webhook') { request.response.statusCode = HttpStatus.notFound; } else { final body = []; await for (final part in request.timeout(const Duration(seconds: 15))) { if (body.length + part.length > 65536) throw const FormatException('Body limit.'); body.addAll(part); } final event = verifyWebhook(body: body, timestamp: request.headers.value('x-qr-timestamp') ?? '', signature: request.headers.value('x-qr-signature') ?? '', eventId: request.headers.value('x-qr-event-id') ?? '', secret: secret); // Work on a copy; failed persistence must not mark a retry as handled. final inbox = WebhookInbox(jsonDecode(jsonEncode(durable)) as Map); inbox.accept(event); final temporary = File('${file.path}.tmp'); await temporary.writeAsString(jsonEncode(inbox.document), flush: true); await temporary.rename(file.path); durable = inbox.document; request.response.statusCode = HttpStatus.noContent; } } on FormatException { request.response.statusCode = HttpStatus.unauthorized; } catch (_) { request.response.statusCode = HttpStatus.serviceUnavailable; // server retries } await request.response.close(); } }