ConsentManager

A widget for displaying, signing, and managing patient consent documents. Supports all four FHIR consent scopes, multiple verifications, and provision rules.

Usage

import { ConsentManager } from '@clinikapi/react';

<ConsentManager
  proxyUrl="/api/clinik"
  patientId="pt_abc123"
  theme="light"
/>

Props

Prop	Type	Required	Description
`proxyUrl`	`string`	Yes	Backend proxy URL
`patientId`	`string`	Yes	Patient ID
`theme`	`'light' \| 'dark'`	No	Color theme

Scope	Description
`patient-privacy`	Privacy and data sharing (HIPAA notices)
`research`	Research participation
`treatment`	Treatment consent
`adr`	Advance directive

Features

Consent document display with scope and category
Digital signature capture
Status tracking (draft → proposed → active → rejected → inactive)
Multiple verification entries
Policy URI linking
Provision rules (permit/deny) with nested exceptions
Source document attachment support

Proxy Action

The widget sends consents.sign with:

{
  "action": "consents.sign",
  "data": {
    "patientId": "pt_abc123",
    "status": "active",
    "scope": "patient-privacy",
    "category": "hipaa-notice",
    "verification": [{
      "verified": true,
      "verifiedWith": "pt_abc123",
      "verificationDate": "2025-01-15T10:00:00Z"
    }]
  }
}

Advanced: Provisions with Data Control

For more complex consent scenarios, your proxy can pass full provision rules:

{
  "provision": {
    "type": "permit",
    "period": { "start": "2025-01-01", "end": "2025-12-31" },
    "purpose": [{ "code": "TREAT", "display": "Treatment" }],
    "action": [{ "code": "access", "display": "Access" }],
    "data": [
      { "meaning": "instance", "reference": "DiagnosticReport/lab_001" }
    ]
  }
}

​ConsentManager

​Usage

​Props

​Consent Scopes

​Features

​Proxy Action

​Advanced: Provisions with Data Control