0.2.0 • Published 10 months ago
@li0ard/tsemrtd v0.2.0
!WARNING tsemrtd is currently in alpha stage: the lib is not very stable yet, and there may be a lot of bugs feel free to try it out, though, any feedback is appreciated!
Features
- Simple: Hides decoding process and provides simple and modern API
- Type-Safe: Most of the APIs are strictly typed to help your workflow
- Compliance: Fully complies with ICAO 9303 and ISO/IEC 19794 standards
- Supports Bun, Node.js, Deno, Browsers, Cloudflare Workers
- Supports CSCA masterlist's (ICAO PKD)
Installation
# from NPM
npm i @li0ard/tsemrtd
# from JSR
bunx jsr add @li0ard/tsemrtd Usage
Get MRZ
import { DG1 } from "@li0ard/tsemrtd"
let file = await Bun.file("EF_DG1.bin").bytes()
let data = DG1.load(Buffer.from(file))
console.log(data)
// P<D<<MUSTERMANN<<ERIKA<<<<<<<<<<<<<<<<<<<<<<
// C11T002JM4D<<9608122F1310317<<<<<<<<<<<<<<<6Extract and save photo
import { DG2 } from "@li0ard/tsemrtd"
let file = await Bun.file("EF_DG2.bin").bytes()
let data = DG2.load(Buffer.from(file))
await Bun.write("image.jp2",data[0].imageData)Supported DG's
| Name | Descripion |
|---|---|
| COM | Manifest |
| DG1 | MRZ Info |
| DG2 | Face image |
| DG3 | Fingerprint image (Optional) |
| DG4 | Iris image (Optional) |
| DG5 | Displayed image (Optional) |
| DG7 | Signature image (Optional) |
| DG11 | Additional personal data (Optional) |
| DG12 | Additional document data (Optional) |
| DG14 | EAC/PACE data (Conditionally mandatory) |
| DG15 | Active authentication data (Conditionally mandatory) |
| SOD | Security object of document |
Library doesn't support datagroups #6,8,9,10,13,16 because they are defined for optional information for each state.
Links
- jmrtd - An Open Source Java Implementation of eMRTD
- ICAO 9303 - Specifications to MRTD
- ISO/IEC 19794(-4/-5/-6) - Specifications to Biometric Information Encoding (BioAPI)
- NIST IR 6529A - Specifications to CBEFF
- BSI TR-03110 - Specifications to EAC/PACE