@matter/types 0.15.0-alpha.0-20250620-16e218ed3 → 0.15.0-alpha.0-20250624-e8c89f458

package/src/dcl/operational-certificate.ts

@@ -0,0 +1,90 @@
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+/**
+ * Operational Root and Intermediate Certificate Schema
+ * @see {@link MatterSpecification.v141.Core} § 11.23.5.
+ */
+export interface OperationalCertificateDclSchema {
+    /**
+     * This field uniquely identifies a certificate and SHALL contain the body of a certificate that has been
+     * added in the DCL. It SHALL be encoded in PEM format. The certificate SHALL respect the format
+     * constraints provided for that certificate type.
+     */
+    pemCert: string;
+
+    /**
+     * The field SHALL be used to identify the serial number field in the Matter certificate structure. A
+     * Matter certificate follows the same limitation on admissible serial numbers as in [RFC 5280], i.e.,
+     * that implementations SHALL admit serial numbers up to 20 octets in length, and certificate authorities
+     * SHALL NOT use serial numbers longer than 20 octets in length.
+     */
+    serialNumber: string;
+
+    /**
+     * The field SHALL be used to identify the Certificate Authority that issues the certificate. For a
+     * Operational Root CA Certificates (RCAC), this field is OPTIONAL because Issuer and
+     * Subject are the same.
+     */
+    issuer?: string;
+
+    /**
+     * The authority key identifier extension provides a means of identifying the public key corresponding
+     * to the private key used to sign a Matter certificate. This is OPTIONAL for Operational Root CA
+     * Certificates (RCAC).
+     */
+    authorityKeyID?: string;
+
+    /**
+     * This field SHALL contain the PAA certificate’s Subject field, as defined Operational Root CA Certificates
+     * (RCAC). This is OPTIONAL for Operational Root CA Certificates (RCAC). This is encoded as
+     * defined in Section 6.1, “Certificate Common Conventions”.
+     */
+    rootSubject?: string;
+
+    /**
+     * This field SHALL uniquely identify the PAA certificate’s Subject Key Identifier mandatory extension.
+     * It is defined in PAA Certificate and Operational Root CA Certificates (RCAC). This is OPTIONAL
+     * for Operational Root CA Certificates (RCAC). This is encoded as defined in Section 6.1, “Certificate
+     * Common Conventions”.
+     */
+    rootSubjectKeyID?: string;
+
+    /**
+     * This field SHALL signify whether the associated certificates is a Operational Root CA Certificate
+     * (RCAC).
+     */
+    isRoot: boolean;
+
+    /**
+     * This field uniquely identifies the DCL key that was used to register the certificate in DCL, pursuant
+     * to DCL policies.
+     */
+    owner: string;
+
+    /**
+     * This field SHALL contain the certificate’s Subject field. This is encoded as defined in Section 6.1,
+     * “Certificate Common Conventions”.
+     */
+    subject: string;
+
+    /**
+     * This field SHALL uniquely identify the PAA certificate’s Subject Key Identifier mandatory extension.
+     * This is encoded as defined in Section 6.1.2, “Key Identifier Extension Constraints”.
+     */
+    subjectKeyID: string;
+
+    /**
+     * This field SHALL contain the Vendor ID of the vendor that issued the certificate.
+     */
+    vid: number;
+
+    /**
+     * The SchemaVersion field value history for this schema is provided below:
+     * * ???
+     */
+    schemaVersion: number;
+}

package/src/dcl/vendor.ts

@@ -0,0 +1,53 @@
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+import { VendorId } from "../datatype/VendorId.js";
+
+/**
+ * Vendor Schema
+ * @see {@link MatterSpecification.v141.Core} § 11.23.3.
+ * DCL Endpoint: /dcl/vendorinfo/vendors or /dcl/vendorinfo/vendors/{vendorID}
+ */
+export interface VendorDclSchema {
+    /**
+     * This field SHALL uniquely identify this Vendor Schema entry and it SHALL match the Vendor’s
+     * assigned Vendor ID.
+     */
+    vendorID: VendorId;
+
+    /**
+     * This field SHALL provide a human readable (displayable) name for the product manufacturer associated
+     * with this record. Maximum length is 128 characters.
+     */
+    vendorName: string;
+
+    /**
+     * The CompanyLegalName field SHALL specify the legal name for the product manufacturer.
+     * Maximum length is 256 characters.
+     */
+    companyLegalName: string;
+
+    /**
+     * The CompanyPreferredName field, if provided, SHALL specify the Preferred Name that MAY be
+     * used for display purposes instead of the CompanyLegalName. Maximum length is 256 characters.
+     */
+    companyPreferredName?: string;
+
+    /**
+     * The VendorLandingPageUrl field (when provided) SHALL contain a link to a maintained web page
+     * containing more information about the device manufacturer, such as contact information, address,
+     * etc. During the lifetime of the products of this manufacturer, the specified URL SHOULD resolve to a
+     * maintained web page. The syntax of this field SHALL follow the syntax as specified in RFC 1738 and
+     * SHALL use the https scheme. The maximum length of this field is 256 ASCII characters.
+     */
+    vendorLandingPageUrl?: string;
+
+    /**
+     * The SchemaVersion field value history for this schema is provided below:
+     * * 0: Initial Release
+     */
+    schemaVersion: number;
+}

package/src/index.ts

@@ -10,6 +10,7 @@ export * from "./cluster/index.js";
 export * from "./commissioning/index.js";
 export * from "./common/index.js";
 export * from "./datatype/index.js";
+export * from "./dcl/index.js";
 export * from "./globals/index.js";
 export * from "./protocol/index.js";
 export * from "./schema/index.js";