[Enhancement] PDF generation in certificate download has no timeout guard

[RUKAYAT-CODER]

Overview

src/app/api/certificates/[id]/download/route.ts contains a TODO noting that a timeout should be added for PDF generation. Puppeteer-based PDF generation can hang indefinitely if the target page fails to load or the rendering process deadlocks, leaving the HTTP connection open and consuming a server process slot.

Specifications

Features:

• PDF generation is bounded by a configurable timeout defaulting to 30 seconds
• Timed-out requests return HTTP 504 with a retry-friendly error message

Tasks:

• Wrap the PDF generation call in a Promise.race([generatePDF(...), timeout(30_000)])
• Return HTTP 504 on timeout with { error: 'PDF generation timed out, please retry' }
• Set the Puppeteer timeout option: page.setDefaultTimeout(25000)
• Add an integration test that mocks a slow PDF generation and asserts the 504 response

Impacted Files:

• src/app/api/certificates/[id]/download/route.ts
• src/app/api/generate-pdf/route.ts

Acceptance Criteria

• PDF generation that exceeds 30 seconds returns HTTP 504
• The connection is closed and the Puppeteer browser is cleaned up on timeout
• Successful PDF generation under 30 seconds is unaffected

[CyberXpert607]

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

Hey team,

I'll take #762.

I'll wrap PDF generation with a Promise.race() and 30s timeout, return HTTP 504 with a clear retry message, set Puppeteer's default timeout to 25s, and ensure the browser cleans up properly on timeout. Integration test included for the slow-generation scenario.

Please assign me.

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

[drips-wave]

Congratulations, @CyberXpert607! 🎉 Your application was accepted by the repo's maintainers, and the issue is due on June 30, 2026.

🧑‍💻 @CyberXpert607: 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 🌊