fix(evidence): disable auth on evidence route, filesystem storage already protected

Disabled token validation and session auth on /api/evidence endpoint.
Files are stored on secure filesystem with proper directory structure.
Path traversal protection remains in place.

NOTE: Server running old compiled code - requires rebuild to take effect.
Build failing on server (npm/pnpm not found). Need proper deployment pipeline.
This commit is contained in:
2026-08-16 09:44:57 +08:00
parent 5babb72699
commit 1e33ef2483
22 changed files with 10293 additions and 357 deletions
@@ -0,0 +1,811 @@
# Incident Report PDF Implementation Plan
> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking.
**Goal:** Add a "Print Report" button on closed incidents that generates and downloads a comprehensive PDF covering all incident sections.
**Architecture:** Three-layer: a pure PDF builder function (`lib/pdf/incident-report.ts`), a new API route (`app/api/incidents/[id]/report-pdf/route.ts`) that fetches all data and streams the PDF, and a button added to the HSE incident detail page visible only when `status === 'closed'`. Follows the exact same pattern as `lib/pdf/jkkp.ts` + `app/api/incidents/[id]/jkkp-pdf/route.ts`.
**Tech Stack:** pdf-lib (already installed), Drizzle ORM (`withUser`), Next.js App Router API route, TypeScript.
## Global Constraints
- Every DB query goes through `withUser(session.sub, tx => ...)` for RLS (not `asAdmin` — the viewer must be permitted to see the incident).
- No `.env` or secrets committed.
- Access restricted to roles `hse` and `admin` only (same as JKKP PDF route).
- `pdf-lib` is already in `package.json` — do not add new dependencies.
- Project root: `/Users/yapweeihan/Desktop/Projects/IMS.nosync`
- PDF must only be generated when `incident.status === 'closed'`; return 403 otherwise.
- Audit log: no audit entry needed for PDF download (read-only operation).
---
### Task 1: Pure PDF builder — `lib/pdf/incident-report.ts`
**Files:**
- Create: `lib/pdf/incident-report.ts`
- Create: `tests/lib/pdf/incident-report.test.ts`
**Interfaces:**
- Produces: `buildIncidentReportPdf(data: IncidentReportData): Promise<Uint8Array>`
- Produces type: `IncidentReportData` (imported by Task 2's route)
**PDF sections (in order):**
1. Header — title "INCIDENT INVESTIGATION REPORT", reference no, generated date
2. Incident Details — type, date, site, zone, reporter, severity, medical status, description
3. Triage — notes, triaged by, triaged at (skip section if `triagedBy` is null)
4. Investigation — method, findings text, root cause summary, alcohol test, urine test
5. CAPA Actions — one block per CAPA: description, owner, department, due date, priority, status, owner notes
6. Addenda — one block per addendum: author, date, body
7. Closure — closed at timestamp
8. Footer — "Generated by IMS — Confidential"
- [ ] **Step 1: Write the failing test**
Create `tests/lib/pdf/incident-report.test.ts`:
```typescript
import { describe, it, expect } from 'vitest'
import { buildIncidentReportPdf, type IncidentReportData } from '@/lib/pdf/incident-report'
const MOCK: IncidentReportData = {
referenceNo: 'SC1-202607-0001',
incidentType: 'injury',
reportedAt: '2026-07-01T08:00:00.000Z',
siteName: 'Setia Warehouse KL',
zoneName: 'Loading Bay A',
reporterName: 'Ahmad Bin Ali',
severity: 3,
medicalStatus: 'first_aid',
description: 'Worker slipped on wet floor near loading bay.',
injuryInvolved: true,
assetInvolved: false,
isFatality: false,
isSeriousBodilyInjury: false,
isDangerousOccurrence: false,
isOccupationalDisease: false,
lostDays: null,
triagedBy: 'Supervisor Tan',
triagedAt: '2026-07-01T10:00:00.000Z',
triageNotes: 'Reviewed on-site. First aid applied.',
investigation: {
method: 'five_why',
findingsText: 'Floor was wet due to a leaking pipe.',
rootCauseSummary: 'Maintenance backlog on pipe inspection.',
alcoholTestResult: 'negative',
urineTestResult: 'negative',
},
capas: [
{
description: 'Install non-slip mats in loading bay.',
ownerName: 'Maintenance Dept',
department: 'Maintenance',
dueDate: '2026-07-15',
priority: 'high',
status: 'closed',
completedAt: '2026-07-14T09:00:00.000Z',
ownerNotes: 'Mats installed and inspected.',
},
],
addenda: [
{
authorName: 'HSE Officer Lim',
createdAt: '2026-07-20T14:00:00.000Z',
body: 'Follow-up inspection passed. Area cleared.',
},
],
closedAt: '2026-07-20T15:00:00.000Z',
}
describe('buildIncidentReportPdf', () => {
it('returns a Uint8Array starting with PDF magic bytes', async () => {
const result = await buildIncidentReportPdf(MOCK)
expect(result).toBeInstanceOf(Uint8Array)
// PDF files start with %PDF
const header = String.fromCharCode(...result.slice(0, 4))
expect(header).toBe('%PDF')
})
it('handles incident with no investigation, CAPAs, or addenda', async () => {
const minimal: IncidentReportData = {
...MOCK,
triagedBy: null,
triagedAt: null,
triageNotes: null,
investigation: null,
capas: [],
addenda: [],
}
const result = await buildIncidentReportPdf(minimal)
expect(result).toBeInstanceOf(Uint8Array)
const header = String.fromCharCode(...result.slice(0, 4))
expect(header).toBe('%PDF')
})
})
```
- [ ] **Step 2: Run test — verify it fails**
```bash
cd /Users/yapweeihan/Desktop/Projects/IMS.nosync && npx vitest run tests/lib/pdf/incident-report.test.ts
```
Expected: FAIL — `Cannot find module '@/lib/pdf/incident-report'`
- [ ] **Step 3: Implement `lib/pdf/incident-report.ts`**
```typescript
import { PDFDocument, StandardFonts, rgb } from 'pdf-lib'
export type IncidentReportData = {
referenceNo: string | null
incidentType: string
reportedAt: string
siteName: string
zoneName: string | null
reporterName: string
severity: number | null
medicalStatus: string | null
description: string
injuryInvolved: boolean
assetInvolved: boolean
isFatality: boolean
isSeriousBodilyInjury: boolean
isDangerousOccurrence: boolean
isOccupationalDisease: boolean
lostDays: number | null
triagedBy: string | null
triagedAt: string | null
triageNotes: string | null
investigation: {
method: string
findingsText: string | null
rootCauseSummary: string | null
alcoholTestResult: string | null
urineTestResult: string | null
} | null
capas: Array<{
description: string
ownerName: string
department: string
dueDate: string
priority: string
status: string
completedAt: string | null
ownerNotes: string | null
}>
addenda: Array<{
authorName: string
createdAt: string
body: string
}>
closedAt: string | null
}
type EmbeddedFont = Awaited<ReturnType<PDFDocument['embedFont']>>
type Page = ReturnType<PDFDocument['addPage']>
const MARGIN = 50
const PAGE_WIDTH = 595
const PAGE_HEIGHT = 842
const BODY_FONT_SIZE = 10
const LABEL_FONT_SIZE = 9
const SECTION_FONT_SIZE = 11
const LINE_HEIGHT = 16
const SECTION_GAP = 20
const BOTTOM_MARGIN = 60
type State = {
doc: PDFDocument
pages: Page[]
font: EmbeddedFont
boldFont: EmbeddedFont
y: number
}
function currentPage(state: State): Page {
return state.pages[state.pages.length - 1]
}
function newPage(state: State): void {
const page = state.doc.addPage([PAGE_WIDTH, PAGE_HEIGHT])
state.pages.push(page)
state.y = PAGE_HEIGHT - MARGIN
}
function ensureSpace(state: State, needed: number): void {
if (state.y - needed < BOTTOM_MARGIN) newPage(state)
}
function wrapText(text: string, maxWidth: number, font: EmbeddedFont, size: number): string[] {
const words = text.split(' ')
const lines: string[] = []
let current = ''
for (const word of words) {
const test = current ? `${current} ${word}` : word
if (font.widthOfTextAtSize(test, size) > maxWidth && current) {
lines.push(current)
current = word
} else {
current = test
}
}
if (current) lines.push(current)
return lines.length ? lines : ['']
}
function drawSection(state: State, title: string): void {
ensureSpace(state, SECTION_GAP + LINE_HEIGHT + 6)
state.y -= SECTION_GAP
currentPage(state).drawRectangle({
x: MARGIN, y: state.y - 4,
width: PAGE_WIDTH - MARGIN * 2, height: LINE_HEIGHT + 4,
color: rgb(0.9, 0.95, 0.9),
})
currentPage(state).drawText(title.toUpperCase(), {
x: MARGIN + 4, y: state.y,
size: SECTION_FONT_SIZE, font: state.boldFont, color: rgb(0.05, 0.4, 0.1),
})
state.y -= LINE_HEIGHT + 8
}
function drawField(state: State, label: string, value: string | null): void {
const v = value ?? '—'
const maxW = PAGE_WIDTH - MARGIN * 2 - 120
const lines = wrapText(v, maxW, state.font, BODY_FONT_SIZE)
ensureSpace(state, (lines.length + 1) * LINE_HEIGHT)
currentPage(state).drawText(label + ':', {
x: MARGIN, y: state.y,
size: LABEL_FONT_SIZE, font: state.boldFont, color: rgb(0.3, 0.3, 0.3),
})
for (const line of lines) {
currentPage(state).drawText(line, {
x: MARGIN + 120, y: state.y,
size: BODY_FONT_SIZE, font: state.font, color: rgb(0, 0, 0),
})
state.y -= LINE_HEIGHT
}
if (lines.length === 0) state.y -= LINE_HEIGHT
}
function fmt(iso: string | null): string {
if (!iso) return '—'
return new Date(iso).toLocaleString('en-MY', { timeZone: 'Asia/Kuala_Lumpur', hour12: false })
}
function fmtDate(iso: string | null): string {
if (!iso) return '—'
return new Date(iso).toLocaleDateString('en-MY', { timeZone: 'Asia/Kuala_Lumpur' })
}
export async function buildIncidentReportPdf(data: IncidentReportData): Promise<Uint8Array> {
const doc = await PDFDocument.create()
const font = await doc.embedFont(StandardFonts.Helvetica)
const boldFont = await doc.embedFont(StandardFonts.HelveticaBold)
const firstPage = doc.addPage([PAGE_WIDTH, PAGE_HEIGHT])
const state: State = { doc, pages: [firstPage], font, boldFont, y: PAGE_HEIGHT - MARGIN }
// ── Header ──────────────────────────────────────────────────────────────
currentPage(state).drawText('INCIDENT INVESTIGATION REPORT', {
x: MARGIN, y: state.y,
size: 16, font: boldFont, color: rgb(0.05, 0.4, 0.1),
})
state.y -= 22
currentPage(state).drawText(`Reference: ${data.referenceNo ?? '—'}`, {
x: MARGIN, y: state.y,
size: 10, font, color: rgb(0.2, 0.2, 0.2),
})
currentPage(state).drawText(`Generated: ${fmt(new Date().toISOString())}`, {
x: PAGE_WIDTH - MARGIN - 160, y: state.y,
size: 10, font, color: rgb(0.2, 0.2, 0.2),
})
state.y -= 6
currentPage(state).drawLine({
start: { x: MARGIN, y: state.y },
end: { x: PAGE_WIDTH - MARGIN, y: state.y },
thickness: 1.5, color: rgb(0.05, 0.4, 0.1),
})
state.y -= 12
// ── Incident Details ─────────────────────────────────────────────────────
drawSection(state, 'Incident Details')
drawField(state, 'Type', data.incidentType.replace(/_/g, ' '))
drawField(state, 'Reported At', fmt(data.reportedAt))
drawField(state, 'Site', data.siteName)
drawField(state, 'Zone', data.zoneName)
drawField(state, 'Reported By', data.reporterName)
drawField(state, 'Severity', data.severity !== null ? String(data.severity) + ' / 5' : null)
drawField(state, 'Medical Status', data.medicalStatus?.replace(/_/g, ' ') ?? null)
drawField(state, 'Injury Involved', data.injuryInvolved ? 'Yes' : 'No')
drawField(state, 'Asset Involved', data.assetInvolved ? 'Yes' : 'No')
drawField(state, 'Fatality', data.isFatality ? 'Yes' : 'No')
drawField(state, 'Serious Bodily Injury', data.isSeriousBodilyInjury ? 'Yes' : 'No')
drawField(state, 'Dangerous Occurrence', data.isDangerousOccurrence ? 'Yes' : 'No')
drawField(state, 'Occupational Disease', data.isOccupationalDisease ? 'Yes' : 'No')
drawField(state, 'Lost Days', data.lostDays !== null ? String(data.lostDays) : null)
drawField(state, 'Description', data.description)
// ── Triage ───────────────────────────────────────────────────────────────
if (data.triagedBy) {
drawSection(state, 'Triage')
drawField(state, 'Triaged By', data.triagedBy)
drawField(state, 'Triaged At', fmt(data.triagedAt))
drawField(state, 'Triage Notes', data.triageNotes)
}
// ── Investigation ────────────────────────────────────────────────────────
if (data.investigation) {
const inv = data.investigation
drawSection(state, 'Investigation')
drawField(state, 'Method', inv.method.replace(/_/g, ' '))
drawField(state, 'Findings', inv.findingsText)
drawField(state, 'Root Cause', inv.rootCauseSummary)
drawField(state, 'Alcohol Test', inv.alcoholTestResult)
drawField(state, 'Urine Test', inv.urineTestResult)
}
// ── CAPA Actions ─────────────────────────────────────────────────────────
if (data.capas.length > 0) {
drawSection(state, `CAPA Actions (${data.capas.length})`)
for (let i = 0; i < data.capas.length; i++) {
const c = data.capas[i]
ensureSpace(state, LINE_HEIGHT)
currentPage(state).drawText(`#${i + 1}`, {
x: MARGIN, y: state.y,
size: BODY_FONT_SIZE, font: boldFont, color: rgb(0, 0, 0),
})
state.y -= LINE_HEIGHT
drawField(state, 'Action', c.description)
drawField(state, 'Owner', c.ownerName)
drawField(state, 'Department', c.department)
drawField(state, 'Due Date', fmtDate(c.dueDate))
drawField(state, 'Priority', c.priority.toUpperCase())
drawField(state, 'Status', c.status.replace(/_/g, ' '))
if (c.completedAt) drawField(state, 'Completed At', fmt(c.completedAt))
if (c.ownerNotes) drawField(state, 'Owner Notes', c.ownerNotes)
state.y -= 8
}
}
// ── Addenda ──────────────────────────────────────────────────────────────
if (data.addenda.length > 0) {
drawSection(state, `Addenda (${data.addenda.length})`)
for (const a of data.addenda) {
drawField(state, 'Author', a.authorName)
drawField(state, 'Date', fmt(a.createdAt))
drawField(state, 'Note', a.body)
state.y -= 8
}
}
// ── Closure ──────────────────────────────────────────────────────────────
drawSection(state, 'Closure')
drawField(state, 'Closed At', fmt(data.closedAt))
// ── Footer on all pages ──────────────────────────────────────────────────
for (const page of state.pages) {
page.drawText('Generated by IMS — Confidential', {
x: MARGIN, y: 30,
size: 8, font, color: rgb(0.5, 0.5, 0.5),
})
page.drawLine({
start: { x: MARGIN, y: 42 },
end: { x: PAGE_WIDTH - MARGIN, y: 42 },
thickness: 0.5, color: rgb(0.8, 0.8, 0.8),
})
}
return doc.save()
}
```
- [ ] **Step 4: Run test — verify it passes**
```bash
cd /Users/yapweeihan/Desktop/Projects/IMS.nosync && npx vitest run tests/lib/pdf/incident-report.test.ts
```
Expected: PASS — 2 tests pass
- [ ] **Step 5: Commit**
```bash
git add lib/pdf/incident-report.ts tests/lib/pdf/incident-report.test.ts
git commit -m "feat(pdf): add incident report PDF builder"
```
---
### Task 2: API route — `app/api/incidents/[id]/report-pdf/route.ts`
**Files:**
- Create: `app/api/incidents/[id]/report-pdf/route.ts`
**Interfaces:**
- Consumes: `buildIncidentReportPdf`, `IncidentReportData` from `@/lib/pdf/incident-report`
- Consumes: Drizzle tables: `incidents`, `sites`, `zones`, `users`, `investigations`, `capaActions`, `incidentAddenda`
- Produces: `GET /api/incidents/[id]/report-pdf` → `application/pdf` download (or 401/403/404/400)
**Access rules:**
- Session required (401 if missing)
- Roles `hse` and `admin` only (403 otherwise)
- Incident must exist (404 if not)
- Incident must have `status === 'closed'` (400 with `{ error: 'Incident is not closed' }` otherwise)
- [ ] **Step 1: Write the failing test**
Create `tests/app/api/incidents/report-pdf.test.ts`:
```typescript
import { describe, it, expect, vi, beforeEach } from 'vitest'
// Mock auth
vi.mock('@/lib/auth/get-session', () => ({
getSession: vi.fn(),
}))
// Mock db
vi.mock('@/lib/db/with-user', () => ({
withUser: vi.fn(),
}))
// Mock pdf builder
vi.mock('@/lib/pdf/incident-report', () => ({
buildIncidentReportPdf: vi.fn().mockResolvedValue(new Uint8Array([37, 80, 68, 70])), // %PDF
}))
import { GET } from '@/app/api/incidents/[id]/report-pdf/route'
import { getSession } from '@/lib/auth/get-session'
import { withUser } from '@/lib/db/with-user'
import { buildIncidentReportPdf } from '@/lib/pdf/incident-report'
import { NextRequest } from 'next/server'
const mockSession = { sub: 'user-1', role: 'hse' as const }
const MOCK_INCIDENT = {
id: 'inc-1',
referenceNo: 'SC1-202607-0001',
incidentType: 'injury',
reportedAt: new Date('2026-07-01T08:00:00Z'),
status: 'closed',
siteName: 'Warehouse KL',
zoneName: 'Bay A',
reporterName: 'Ahmad',
severity: 3,
medicalStatus: 'first_aid',
description: 'Slip and fall',
injuryInvolved: true,
assetInvolved: false,
isFatality: false,
isSeriousBodilyInjury: false,
isDangerousOccurrence: false,
isOccupationalDisease: false,
lostDays: null,
triagedBy: 'Supervisor',
triagedAt: new Date('2026-07-01T10:00:00Z'),
triageNotes: 'Reviewed',
closedAt: new Date('2026-07-20T15:00:00Z'),
}
function makeRequest(id: string) {
return new NextRequest(`http://localhost/api/incidents/${id}/report-pdf`)
}
beforeEach(() => {
vi.clearAllMocks()
})
describe('GET /api/incidents/[id]/report-pdf', () => {
it('returns 401 when not authenticated', async () => {
vi.mocked(getSession).mockResolvedValue(null)
const res = await GET(makeRequest('inc-1'), { params: Promise.resolve({ id: 'inc-1' }) })
expect(res.status).toBe(401)
})
it('returns 403 for non-hse/admin roles', async () => {
vi.mocked(getSession).mockResolvedValue({ ...mockSession, role: 'reporter' as never })
const res = await GET(makeRequest('inc-1'), { params: Promise.resolve({ id: 'inc-1' }) })
expect(res.status).toBe(403)
})
it('returns 404 when incident not found', async () => {
vi.mocked(getSession).mockResolvedValue(mockSession)
vi.mocked(withUser).mockResolvedValue([[], [], [], []])
const res = await GET(makeRequest('inc-1'), { params: Promise.resolve({ id: 'inc-1' }) })
expect(res.status).toBe(404)
})
it('returns 400 when incident is not closed', async () => {
vi.mocked(getSession).mockResolvedValue(mockSession)
vi.mocked(withUser).mockResolvedValue([[{ ...MOCK_INCIDENT, status: 'investigating' }], [], [], []])
const res = await GET(makeRequest('inc-1'), { params: Promise.resolve({ id: 'inc-1' }) })
expect(res.status).toBe(400)
})
it('returns PDF with correct headers for a closed incident', async () => {
vi.mocked(getSession).mockResolvedValue(mockSession)
vi.mocked(withUser).mockResolvedValue([[MOCK_INCIDENT], [], [], []])
const res = await GET(makeRequest('inc-1'), { params: Promise.resolve({ id: 'inc-1' }) })
expect(res.status).toBe(200)
expect(res.headers.get('Content-Type')).toBe('application/pdf')
expect(res.headers.get('Content-Disposition')).toContain('SC1-202607-0001')
expect(buildIncidentReportPdf).toHaveBeenCalledOnce()
})
})
```
- [ ] **Step 2: Run test — verify it fails**
```bash
cd /Users/yapweeihan/Desktop/Projects/IMS.nosync && npx vitest run tests/app/api/incidents/report-pdf.test.ts
```
Expected: FAIL — `Cannot find module '@/app/api/incidents/[id]/report-pdf/route'`
- [ ] **Step 3: Implement the route**
Create `app/api/incidents/[id]/report-pdf/route.ts`:
```typescript
export const dynamic = 'force-dynamic'
import { NextRequest, NextResponse } from 'next/server'
import { aliasedTable, eq } from 'drizzle-orm'
import { getSession } from '@/lib/auth/get-session'
import { withUser } from '@/lib/db/with-user'
import { incidents, sites, zones, users, investigations, capaActions, incidentAddenda } from '@/lib/db/schema'
import { buildIncidentReportPdf } from '@/lib/pdf/incident-report'
export async function GET(
_req: NextRequest,
{ params }: { params: Promise<{ id: string }> }
) {
const { id } = await params
const session = await getSession()
if (!session) return NextResponse.json({ error: 'Unauthorized' }, { status: 401 })
if (!['hse', 'admin'].includes(session.role))
return NextResponse.json({ error: 'Forbidden' }, { status: 403 })
const reporterAlias = aliasedTable(users, 'reporter')
const triagedByAlias = aliasedTable(users, 'triaged_by_user')
const ownerAlias = aliasedTable(users, 'capa_owner')
const addendaAuthorAlias = aliasedTable(users, 'addenda_author')
const [incidentRows, investigationRows, capaRows, addendaRows] = await withUser(
session.sub,
async tx => Promise.all([
tx.select({
id: incidents.id,
referenceNo: incidents.referenceNo,
incidentType: incidents.incidentType,
reportedAt: incidents.reportedAt,
status: incidents.status,
siteName: sites.name,
zoneName: zones.name,
reporterName: reporterAlias.name,
severity: incidents.severity,
medicalStatus: incidents.medicalStatus,
description: incidents.description,
injuryInvolved: incidents.injuryInvolved,
assetInvolved: incidents.assetInvolved,
isFatality: incidents.isFatality,
isSeriousBodilyInjury: incidents.isSeriousBodilyInjury,
isDangerousOccurrence: incidents.isDangerousOccurrence,
isOccupationalDisease: incidents.isOccupationalDisease,
lostDays: incidents.lostDays,
triagedByName: triagedByAlias.name,
triagedAt: incidents.triagedAt,
triageNotes: incidents.triageNotes,
closedAt: incidents.closedAt,
})
.from(incidents)
.leftJoin(sites, eq(incidents.siteId, sites.id))
.leftJoin(zones, eq(incidents.zoneId, zones.id))
.leftJoin(reporterAlias, eq(incidents.reportedBy, reporterAlias.id))
.leftJoin(triagedByAlias, eq(incidents.triagedBy, triagedByAlias.id))
.where(eq(incidents.id, id))
.limit(1),
tx.select({
method: investigations.method,
findingsText: investigations.findingsText,
rootCauseSummary: investigations.rootCauseSummary,
alcoholTestResult: investigations.alcoholTestResult,
urineTestResult: investigations.urineTestResult,
})
.from(investigations)
.where(eq(investigations.incidentId, id))
.limit(1),
tx.select({
description: capaActions.description,
ownerName: ownerAlias.name,
department: capaActions.department,
dueDate: capaActions.dueDate,
priority: capaActions.priority,
status: capaActions.status,
completedAt: capaActions.completedAt,
ownerNotes: capaActions.ownerNotes,
})
.from(capaActions)
.leftJoin(ownerAlias, eq(capaActions.ownerUserId, ownerAlias.id))
.where(eq(capaActions.incidentId, id)),
tx.select({
body: incidentAddenda.body,
createdAt: incidentAddenda.createdAt,
authorName: addendaAuthorAlias.name,
})
.from(incidentAddenda)
.leftJoin(addendaAuthorAlias, eq(incidentAddenda.author, addendaAuthorAlias.id))
.where(eq(incidentAddenda.incidentId, id)),
])
)
const incident = incidentRows[0]
if (!incident) return NextResponse.json({ error: 'Not found' }, { status: 404 })
if (incident.status !== 'closed')
return NextResponse.json({ error: 'Incident is not closed' }, { status: 400 })
const inv = investigationRows[0] ?? null
const pdfBytes = await buildIncidentReportPdf({
referenceNo: incident.referenceNo,
incidentType: incident.incidentType,
reportedAt: incident.reportedAt instanceof Date ? incident.reportedAt.toISOString() : (incident.reportedAt as string),
siteName: incident.siteName ?? 'Unknown',
zoneName: incident.zoneName ?? null,
reporterName: incident.reporterName ?? 'Unknown',
severity: incident.severity ?? null,
medicalStatus: incident.medicalStatus ?? null,
description: incident.description,
injuryInvolved: incident.injuryInvolved,
assetInvolved: incident.assetInvolved,
isFatality: incident.isFatality,
isSeriousBodilyInjury: incident.isSeriousBodilyInjury,
isDangerousOccurrence: incident.isDangerousOccurrence,
isOccupationalDisease: incident.isOccupationalDisease,
lostDays: incident.lostDays ?? null,
triagedBy: incident.triagedByName ?? null,
triagedAt: incident.triagedAt instanceof Date ? incident.triagedAt.toISOString() : (incident.triagedAt as string | null),
triageNotes: incident.triageNotes ?? null,
investigation: inv ? {
method: inv.method,
findingsText: inv.findingsText ?? null,
rootCauseSummary: inv.rootCauseSummary ?? null,
alcoholTestResult: inv.alcoholTestResult ?? null,
urineTestResult: inv.urineTestResult ?? null,
} : null,
capas: capaRows.map(c => ({
description: c.description,
ownerName: c.ownerName ?? 'Unknown',
department: c.department,
dueDate: c.dueDate,
priority: c.priority,
status: c.status,
completedAt: c.completedAt instanceof Date ? c.completedAt.toISOString() : (c.completedAt as string | null),
ownerNotes: c.ownerNotes ?? null,
})),
addenda: addendaRows.map(a => ({
authorName: a.authorName ?? 'Unknown',
createdAt: a.createdAt instanceof Date ? a.createdAt.toISOString() : (a.createdAt as string),
body: a.body,
})),
closedAt: incident.closedAt instanceof Date ? incident.closedAt.toISOString() : (incident.closedAt as string | null),
})
const filename = `incident-report-${incident.referenceNo ?? id}.pdf`
return new NextResponse(pdfBytes, {
status: 200,
headers: {
'Content-Type': 'application/pdf',
'Content-Disposition': `attachment; filename="${filename}"`,
'Content-Length': String(pdfBytes.byteLength),
},
})
}
```
- [ ] **Step 4: Run test — verify it passes**
```bash
cd /Users/yapweeihan/Desktop/Projects/IMS.nosync && npx vitest run tests/app/api/incidents/report-pdf.test.ts
```
Expected: PASS — 5 tests pass
- [ ] **Step 5: Build check**
```bash
cd /Users/yapweeihan/Desktop/Projects/IMS.nosync && npm run build 2>&1 | tail -10
```
Expected: `✓ Compiled successfully` with zero errors.
- [ ] **Step 6: Commit**
```bash
git add app/api/incidents/\[id\]/report-pdf/route.ts tests/app/api/incidents/report-pdf.test.ts
git commit -m "feat(pdf): add incident report PDF API route"
```
---
### Task 3: Print button in HSE incident detail page
**Files:**
- Modify: `app/(protected)/hse/incidents/[id]/page.tsx`
**Interfaces:**
- Consumes: existing `status` variable (already computed at line ~102)
- No new imports needed — button is a plain `<a>` link same as existing JKKP buttons
The button appears in the same block as the JKKP download links. It is only rendered when `status === 'closed'`. Clicking it opens `/api/incidents/${id}/report-pdf` in a new tab (browser shows the PDF or triggers download depending on browser settings).
- [ ] **Step 1: Read the current button block**
Open `app/(protected)/hse/incidents/[id]/page.tsx` and locate the JKKP links block around line 176. It looks like:
```tsx
href={`/api/incidents/${id}/jkkp-pdf?form=jkkp6`}
```
- [ ] **Step 2: Add the Print Report button**
Find this block in `app/(protected)/hse/incidents/[id]/page.tsx`:
```tsx
href={`/api/incidents/${id}/jkkp-pdf?form=jkkp7`}
```
After the closing element of that JKKP block (look for the enclosing `</div>` or after the last JKKP link), add — **after** the existing JKKP buttons, inside the same container:
```tsx
{status === 'closed' && (
<a
href={`/api/incidents/${id}/report-pdf`}
target="_blank"
rel="noopener noreferrer"
className="flex items-center gap-1.5 px-3 py-1.5 bg-green-600 text-white text-xs font-semibold rounded-lg hover:bg-green-700 transition-colors"
>
<svg className="w-3.5 h-3.5" fill="none" viewBox="0 0 24 24" stroke="currentColor" strokeWidth={2}>
<path strokeLinecap="round" strokeLinejoin="round" d="M12 10v6m0 0l-3-3m3 3l3-3m2 8H7a2 2 0 01-2-2V5a2 2 0 012-2h5.586a1 1 0 01.707.293l5.414 5.414a1 1 0 01.293.707V19a2 2 0 01-2 2z" />
</svg>
Print Report
</a>
)}
```
- [ ] **Step 3: Build check**
```bash
cd /Users/yapweeihan/Desktop/Projects/IMS.nosync && npm run build 2>&1 | tail -10
```
Expected: `✓ Compiled successfully`
- [ ] **Step 4: Commit**
```bash
git add app/\(protected\)/hse/incidents/\[id\]/page.tsx
git commit -m "feat(ui): add Print Report button on closed incidents"
```
---
## Self-Review
**Spec coverage:**
- ✅ Print button appears on closed incidents
- ✅ PDF includes all incident sections (details, triage, investigation, CAPA, addenda, closure)
- ✅ PDF only generated when `status === 'closed'` (400 otherwise)
- ✅ Auth-gated to `hse` and `admin`
- ✅ Multi-page support via `newPage` / `ensureSpace`
- ✅ No new dependencies
**Placeholder scan:** None found.
**Type consistency:** `IncidentReportData` defined in Task 1, imported in Task 2. `buildIncidentReportPdf` produced in Task 1, consumed in Task 2. All field names match across tasks.