feat: v0.1.5 | Add CSCA masterlist's support

Author: li0ard

.gitignore

@@ -182,4 +182,8 @@ dist
 
 /index.ts
 
-docs/
+docs/
+
+# ICAO Masterlists
+
+*.ml

README.md

@@ -3,7 +3,7 @@
         <img src="https://raw.githubusercontent.com/li0ard/tsemrtd/main/.github/logo.svg" alt="tsemrtd logo" title="tsemrtd" width="120" /><br>
     </a><br>
     <b>tsemrtd</b><br>
-    <b>simple library for eMRTD Datagroups</b>
+    <b>simple library for eMRTD datagroups</b>
     <br><br>
     <a href="https://github.com/li0ard/tsemrtd/actions/workflows/test.yml"><img src="https://github.com/li0ard/tsemrtd/actions/workflows/test.yml/badge.svg" /></a>
     <a href="https://jsr.io/@li0ard/tsemrtd"><img src="https://jsr.io/badges/@li0ard/tsemrtd" /></a>
@@ -24,6 +24,7 @@
 - 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
 

jsr.json

@@ -1,6 +1,6 @@
 {
     "name": "@li0ard/tsemrtd",
-    "version": "0.1.4",
+    "version": "0.1.5",
     "exports": "./src/index.ts",
     "publish": {
         "include": [

package.json

@@ -1,7 +1,7 @@
 {
   "name": "tsemrtd",
   "module": "index.ts",
-  "version": "0.1.4",
+  "version": "0.1.5",
   "type": "module",
   "author": "li0ard",
   "repository": {

src/asn1/pkd.ts

@@ -0,0 +1,17 @@
+import { AsnProp, AsnType, AsnPropTypes, AsnTypeTypes, AsnArray } from "@peculiar/asn1-schema";
+import { Certificate } from "@peculiar/asn1-x509";
+
+/** Class for ASN1 schema of Certificates set */
+@AsnType({ type: AsnTypeTypes.Set, itemType: Certificate })
+export class Certificates extends AsnArray<Certificate> {}
+
+/** Class for ASN1 schema of CSCA master list. Described by ICAO 9303 p.12 section 9.2 */
+export class CSCAMasterList {
+    /** Master list version */
+    @AsnProp({ type: AsnPropTypes.Integer })
+    version: number = 0;
+
+    /** CSCA certificates */
+    @AsnProp({ type: Certificates })
+    certificates: Certificates = new Certificates()
+}

src/index.ts

@@ -10,5 +10,6 @@ export { DG12 } from "./dg12"
 export { DG14 } from "./dg14"
 export { DG15 } from "./dg15"
 export { SOD } from "./sod"
+export { PKD } from "./pkd"
 export * as Enums from "./consts/enums"
 export * as Interfaces from "./consts/interfaces"

src/pkd.ts

@@ -0,0 +1,20 @@
+import { AsnConvert, OctetString } from "@peculiar/asn1-schema";
+import { ContentInfo, SignedData } from "@peculiar/asn1-cms";
+import { CSCAMasterList } from "./asn1/pkd";
+
+/**
+ * Class for working with CSCA master list
+*/
+export class PKD {
+    /**
+     * Get CSCA certificates from master list
+     * @param data Data of ICAO master list file (.ml)
+     */
+    static load(data: string | Buffer): CSCAMasterList {
+        if(typeof data == "string") data = Buffer.from(data, "hex");
+
+        let contentInfo = AsnConvert.parse(data, ContentInfo)
+        let signedData = AsnConvert.parse(contentInfo.content, SignedData)
+        return AsnConvert.parse(signedData.encapContentInfo.eContent?.single as OctetString, CSCAMasterList)
+    }
+}