@matter/dcl-data 2026.5.1-5.1 → 2026.5.20

package/README.md

@@ -1,2 +1,75 @@
-# dcl-data
-Matter DCL data package to seed fresh installations
+# dcl-data — Matter DCL data package for offline seeding
+
+Part of the matter.js IoT Matter project. Pre-seeds commissioning-relevant data from the CSA Distributed Compliance Ledger (DCL) so matter.js-based projects work even when DCL is unreachable. The package includes:
+
+- Product Attestation Authority (PAA) root certificates
+- Certification Declaration (CD) signer certificates
+- Vendor list and metadata
+
+Besides the JSONL-style data files, the package exports async-iterable functions for each data type that can be used directly to pre-initialize `DclCertificateService` and `DclVendorInfoService` in a matter.js project.
+
+The goal is to provide baseline data for cases where the DCL is unavailable or unreachable during device commissioning, improving the user experience for offline matter.js usage.
+
+> **Not a replacement for live DCL access.** This package is a static snapshot. It does not include certificate revocation lists (CRLs), real-time vendor updates, or product-specific data fetched on demand. Production deployments should always combine this seed with a live `DclCertificateService` / `DclVendorInfoService` so revocations and new entries are picked up. Information about software updates for devices is also not included and only available live from the DCL.
+
+## Installation
+
+```bash
+npm install @matter/dcl-data
+```
+
+Requires Node.js ≥ 18. ESM-only.
+
+## Usage
+
+```ts
+import type { PaaRootEntry, CdSignerEntry, VendorEntry } from "@matter/dcl-data";
+import { paaRoots, cdSigners, vendors, readManifest } from "@matter/dcl-data/node";
+
+// production entries only (default)
+const paas = paaRoots();
+console.log(`PAA roots: ${paas.expectedCount}, built at ${paas.builtAt}`);
+for await (const entry of paas.entries) {
+    // entry.subjectKeyId (lowercase hex), entry.derHex, entry.kind
+}
+
+// include test-net + GitHub dev certificates
+const allCds = cdSigners({ includeTest: true });
+for await (const entry of allCds.entries) { /* ... */ }
+
+// vendor metadata (eager — small dataset)
+for await (const v of vendors().entries) {
+    // v.vendorId, v.vendorName, v.companyLegalName, ...
+}
+
+// snapshot metadata
+const manifest = readManifest();
+console.log(manifest.builtAt, manifest.counts);
+```
+
+Each function returns a `SeedSource<T>` with `builtAt` (ISO 8601 UTC), `expectedCount`, and `entries: AsyncIterable<T>`. Pass `{ includeTest: true }` to include test-net + GitHub dev certificates (default: production only).
+
+## Versioning
+
+CalVer: `YYYY.M.D` (e.g. `2026.5.15`). Same-day republishes append a patch counter (`2026.5.15.1`).
+
+Published nightly via GitHub Actions when the DCL snapshot changes. Each release is tagged (`vYYYY.M.D[.N]`) with a summary of added/removed/changed entries.
+
+## Data sources
+
+- CSA DCL production: <https://on.dcl.csa-iot.org>
+- CSA DCL test-net: <https://on.test-net.dcl.csa-iot.org> (test certificates only, requires `includeTest`)
+- GitHub: [`project-chip/connectedhomeip`](https://github.com/project-chip/connectedhomeip) `master` — development PAA roots and CD signer certificates
+
+The nightly build records the connectedhomeip commit SHA in `manifest.json` under `sources.github.commit`.
+
+## Notes and limitations
+
+- **`VendorEntry.kind` is currently always `"production"`.** `DclVendorInfoService` only fetches from the production DCL endpoint — no test-net vendor source exists. `manifest.counts.vendorsTest` is always `0`. The field is kept for API symmetry with cert entries; reserved Matter test vendor IDs (`0xFFF1`–`0xFFF4`) appear as production entries.
+- Certificate `derHex` is the raw DER bytes as lowercase hex. `subjectKeyId` is lowercase hex without colons.
+- Vendor entries preserve unknown DCL fields (forward-compatible).
+- The snapshot is a point-in-time view. For up-to-date data, prefer the live `DclCertificateService` / `DclVendorInfoService`; use this package only as a fallback or seed.
+
+## License
+
+Apache-2.0

package/data/vendors.json

@@ -3109,9 +3109,9 @@
     "vendorName": "Senscomm",
     "kind": "production",
     "companyLegalName": "Senscomm Semiconductor Co., Ltd.",
-    "companyPreferredName": "SCM",
+    "companyPreferredName": "SCM2",
     "vendorLandingPageURL": "https://www.senscomm.com/",
-    "creator": "cosmos19vjxxvk4fz8l929zusnk07rjupssmjxmqcjgcp"
+    "creator": "cosmos1nep46y6hl2uqvq4zquv86y3z6uuyl74ma76qym"
   },
   {
     "vendorId": 5634,
@@ -3332,6 +3332,13 @@
     "companyLegalName": "Airam Electric Oy Ab",
     "creator": "cosmos1eqmyx4c93uak4t2lcfuc7zjc5zn4dht7juygqk"
   },
+  {
+    "vendorId": 5728,
+    "vendorName": "NuWatt",
+    "kind": "production",
+    "companyLegalName": "NuWatt, Inc.",
+    "creator": "cosmos1jp0tfhj5qukdcf6guxe7cnpw9rqdz5a8en8glz"
+  },
   {
     "vendorId": 5732,
     "vendorName": "Lowe's",

package/dist/esm/types.d.ts

@@ -25,6 +25,11 @@ export type VendorEntry = {
     companyPreferredName?: string;
     vendorLandingPageURL?: string;
     creator?: string;
+    /**
+     * Currently always "production". DCL exposes no test-net vendor source — `DclVendorInfoService`
+     * fetches prod only. Field kept for API symmetry with cert entries; may classify Matter-reserved
+     * test vendor IDs (0xFFF1–0xFFF4) in the future.
+     */
     kind: "production" | "test";
     [extra: string]: unknown;
 };
@@ -48,6 +53,7 @@ export type Manifest = {
         cdSigners: number;
         cdSignersTest: number;
         vendors: number;
+        /** Currently always 0 — see {@link VendorEntry.kind}. */
         vendorsTest: number;
     };
 };

package/dist/esm/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,UAAU,CAAC,CAAC,IAAI;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,aAAa,CAAC,CAAC,CAAC,CAAC;CAC7B,CAAC;AAEF,MAAM,MAAM,SAAS,GAAG;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,YAAY,GAAG,MAAM,CAAC;IAC5B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG;IAAE,IAAI,EAAE,KAAK,CAAA;CAAE,CAAC;AACvD,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG;IAAE,IAAI,EAAE,WAAW,CAAA;CAAE,CAAC;AAE9D,MAAM,MAAM,WAAW,GAAG;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,YAAY,GAAG,MAAM,CAAC;IAC5B,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;CAC5B,CAAC;AAEF,MAAM,MAAM,QAAQ,GAAG;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE;QACL,GAAG,EAAE;YAAE,GAAG,EAAE,MAAM,CAAC;YAAC,iBAAiB,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;QACjD,MAAM,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,GAAG,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAA;SAAE,CAAC;KACzD,CAAC;IACF,MAAM,EAAE;QACJ,QAAQ,EAAE,MAAM,CAAC;QACjB,YAAY,EAAE,MAAM,CAAC;QACrB,SAAS,EAAE,MAAM,CAAC;QAClB,aAAa,EAAE,MAAM,CAAC;QACtB,OAAO,EAAE,MAAM,CAAC;QAChB,WAAW,EAAE,MAAM,CAAC;KACvB,CAAC;CACL,CAAC;AAEF,qBAAa,mBAAoB,SAAQ,KAAK;IAEtC,QAAQ,CAAC,IAAI,EAAE,MAAM;IACrB,QAAQ,CAAC,UAAU,EAAE,MAAM;IAF/B,YACa,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,MAAM,EAC3B,KAAK,EAAE,OAAO,EAIjB;CACJ"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,UAAU,CAAC,CAAC,IAAI;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,aAAa,CAAC,CAAC,CAAC,CAAC;CAC7B,CAAC;AAEF,MAAM,MAAM,SAAS,GAAG;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,YAAY,GAAG,MAAM,CAAC;IAC5B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG;IAAE,IAAI,EAAE,KAAK,CAAA;CAAE,CAAC;AACvD,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG;IAAE,IAAI,EAAE,WAAW,CAAA;CAAE,CAAC;AAE9D,MAAM,MAAM,WAAW,GAAG;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;OAIG;IACH,IAAI,EAAE,YAAY,GAAG,MAAM,CAAC;IAC5B,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;CAC5B,CAAC;AAEF,MAAM,MAAM,QAAQ,GAAG;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE;QACL,GAAG,EAAE;YAAE,GAAG,EAAE,MAAM,CAAC;YAAC,iBAAiB,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;QACjD,MAAM,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,GAAG,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAA;SAAE,CAAC;KACzD,CAAC;IACF,MAAM,EAAE;QACJ,QAAQ,EAAE,MAAM,CAAC;QACjB,YAAY,EAAE,MAAM,CAAC;QACrB,SAAS,EAAE,MAAM,CAAC;QAClB,aAAa,EAAE,MAAM,CAAC;QACtB,OAAO,EAAE,MAAM,CAAC;QAChB,yDAAyD;QACzD,WAAW,EAAE,MAAM,CAAC;KACvB,CAAC;CACL,CAAC;AAEF,qBAAa,mBAAoB,SAAQ,KAAK;IAEtC,QAAQ,CAAC,IAAI,EAAE,MAAM;IACrB,QAAQ,CAAC,UAAU,EAAE,MAAM;IAF/B,YACa,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,MAAM,EAC3B,KAAK,EAAE,OAAO,EAIjB;CACJ"}

package/dist/esm/types.js.map

@@ -1,6 +1,6 @@
 {
   "version": 3,
   "sources": ["../../src/types.ts"],
-  "mappings": "AA+CO,MAAM,4BAA4B,MAAM;AAAA,EAC3C,YACa,MACA,YACT,OACF;AACE,UAAM,oBAAoB,IAAI,YAAY,UAAU,IAAI,EAAE,MAAM,CAAC;AAJxD;AACA;AAIT,SAAK,OAAO;AAAA,EAChB;AAAA,EANa;AAAA,EACA;AAMjB;",
+  "mappings": "AAqDO,MAAM,4BAA4B,MAAM;AAAA,EAC3C,YACa,MACA,YACT,OACF;AACE,UAAM,oBAAoB,IAAI,YAAY,UAAU,IAAI,EAAE,MAAM,CAAC;AAJxD;AACA;AAIT,SAAK,OAAO;AAAA,EAChB;AAAA,EANa;AAAA,EACA;AAMjB;",
   "names": []
 }

package/manifest.json

@@ -1,5 +1,5 @@
 {
-  "builtAt": "2026-05-15T10:30:27.318Z",
+  "builtAt": "2026-05-20T09:39:05.824Z",
   "schemaVersion": 1,
   "sources": {
     "dcl": {
@@ -16,7 +16,7 @@
     "paaRootsTest": 95,
     "cdSigners": 6,
     "cdSignersTest": 6,
-    "vendors": 427,
+    "vendors": 428,
     "vendorsTest": 0
   }
 }

package/package.json

@@ -1,9 +1,13 @@
 {
     "name": "@matter/dcl-data",
-    "version": "2026.5.15.1",
+    "version": "2026.5.20",
     "type": "module",
     "description": "Daily snapshot of Matter DCL data for seeding matter.js services",
     "license": "Apache-2.0",
+    "repository": {
+        "type": "git",
+        "url": "git+https://github.com/matter-js/dcl-data.git"
+    },
     "engines": {
         "node": ">=18"
     },