<img alttext="COVID Green Logo" src="https://raw.githubusercontent.com/lfph/artwork/master/projects/covidgreen/stacked/color/covidgreen-stacked-color.png" width="300" />
npm install dcc-decoder
A node module for decoding DCC certs, validaiong signature and optionally running country specific business rules
For more on DCC see:
- https://github.com/ehn-dcc-development
- https://github.com/eu-digital-green-certificates
- Getting Started
- Usage
- Methods
- Team
- License
To install this module
```with npm
npm install --save dcc-decoder
This module supports decoding DCC data from the QR data.
The module can directly load and utilise the trust list from a url provided or you can pass in the trust list, valuesets and business rules.
The response will contain the raw cert (rawCert), the populated cert (cert) using the valudset provided, an errors array that will contain any errors encountered during decoding such as invalid signatire, cert expired etc
#### Example
`javascript
import { decodeOnly, loadDCCConfigData } from 'dcc-decoder';
(async () => {
const dcc = await loadDCCConfigData('https://url_for_config')
const result = await decodeOnly({
source: 'HC1:....',
dccData: dcc
})
if (result.errors) {
console.log('Decoding error', result.errors)
}
console.log(result.cert)
})()
`
#### Methods
##### loadDCCConfigData()
`javascript`
const dccData = await loadDCCConfigData('https://url_for_config')
Used to load the dcc config data needed to decode and validate a DCC. Returns the config.
---
##### decodeOnly()
`javascript`
const result = await decodeOnly({source: 'HC1:....', dccData: {dcc...}});
Decodes a DCC qr code. Will accept input as string. Returns a promise which includes the raw cert data, populated cert, cert type and any error.
---
##### decodeAndValidateRules()
`javascript``
const result = await decodeAndValidateRules({source: 'HC1:....', dccData: {dcc...}}, ruleCountry: 'IE'});
Decodes a DCC qr code an then runs the provided business rules against the DCC data. Will accept input as string. Returns a promise which includes the raw cert data, populated cert, cert type and any error.
---
* @colmharte - Colm Harte
* @colmharte - Colm Harte
* @salmanm - Salman Mitha

Linux Foundation Public Health
Copyright (c) The COVID Green Contributors
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.