fix: compatibility with Node.js 18

packages/core/src/qr/index.ts

@@ -1,2 +1,13 @@
-export * from "./index.browser.js";
+export {
+	ProvisioningInformationType,
+	type ProvisioningInformation_MaxInclusionRequestInterval,
+	type ProvisioningInformation_ProductId,
+	type ProvisioningInformation_ProductType,
+	type ProvisioningInformation_SupportedProtocols,
+	type ProvisioningInformation_UUID16,
+	QRCodeVersion,
+	type QRProvisioningInformation,
+	minQRCodeLength,
+} from "./definitions.js";
 export { parseQRCodeString } from "./parse.node.js";
+export * from "./utils.js";

packages/core/src/qr/parse.browser.ts

@@ -11,10 +11,6 @@ import {
 } from "./definitions.js";
 import { fail, parseTLV, readLevel, readUInt16, readUInt8 } from "./utils.js";
 
-const subtleCrypto: typeof import("node:crypto").subtle =
-	// @ts-expect-error The type definitions for globalThis.crypto are missing from @types/node
-	globalThis.crypto.subtle;
-
 /** Parses a string that has been decoded from a Z-Wave (S2 or SmartStart) QR code */
 export async function parseQRCodeStringAsync(
 	qr: string,
@@ -32,6 +28,11 @@ export async function parseQRCodeStringAsync(
 	const checksum = readUInt16(qr, 4);
 	// The checksum covers the remaining data
 	const checksumInput = new TextEncoder().encode(qr.slice(9));
+
+	const subtleCrypto: typeof import("node:crypto").subtle =
+		// @ts-expect-error Node.js 18 does not support this yet
+		globalThis.crypto.subtle;
+
 	const hashResult = await subtleCrypto.digest("SHA-1", checksumInput);
 	const expectedChecksum = Bytes.view(hashResult).readUInt16BE(0);
 	if (checksum !== expectedChecksum) fail("invalid checksum");

packages/core/src/qr/parse.node.ts

@@ -84,3 +84,84 @@ export function parseQRCodeString(qr: string): QRProvisioningInformation {
 
 	return ret;
 }
+
+/** Parses a string that has been decoded from a Z-Wave (S2 or SmartStart) QR code */
+export async function parseQRCodeStringAsync(
+	qr: string,
+): Promise<QRProvisioningInformation> {
+	// Trim off whitespace that might have been copied by accident
+	qr = qr.trim();
+	// Validate the QR code
+	if (!qr.startsWith("90")) fail("must start with 90");
+	if (qr.length < minQRCodeLength) fail("too short");
+	if (!onlyDigitsRegex.test(qr)) fail("contains invalid characters");
+
+	const version = readLevel(qr, 2);
+	if (version > QRCodeVersion.SmartStart) fail("invalid version");
+
+	const checksum = readUInt16(qr, 4);
+	// The checksum covers the remaining data
+	const checksumInput = new TextEncoder().encode(qr.slice(9));
+
+	const subtleCrypto: typeof import("node:crypto").subtle =
+		// FIXME: This method is a copy of the one in parse.browser.ts, except for the node:crypto import
+		// Once the following @ts-expect-error is no longer needed, this method should be removed in favor of the one from parse.browser.ts
+		// and the exports in index.ts can be updated to be based on index.browser.ts
+		//
+		// @ts-expect-error Node.js 18 does not support globalThis.crypto yet
+		(globalThis.crypto ?? ((await import("node:crypto")).webcrypto)).subtle;
+
+	const hashResult = await subtleCrypto.digest("SHA-1", checksumInput);
+	const expectedChecksum = Bytes.view(hashResult).readUInt16BE(0);
+	if (checksum !== expectedChecksum) fail("invalid checksum");
+
+	const requestedKeysBitmask = readUInt8(qr, 9);
+	const requestedSecurityClasses = parseBitMask(
+		[requestedKeysBitmask],
+		SecurityClass.S2_Unauthenticated,
+	);
+	if (!requestedSecurityClasses.every((k) => k in SecurityClass)) {
+		fail("invalid security class requested");
+	}
+
+	let offset = 12;
+	const dsk = new Bytes(16);
+	for (let dskBlock = 0; dskBlock < 8; dskBlock++) {
+		const block = readUInt16(qr, offset);
+		dsk.writeUInt16BE(block, dskBlock * 2);
+		offset += 5;
+	}
+
+	const ret = {
+		version,
+		// This seems like a duplication, but it's more convenient for applications to not have to copy this field over
+		requestedSecurityClasses,
+		securityClasses: [...requestedSecurityClasses],
+		dsk: dskToString(dsk),
+	} as QRProvisioningInformation;
+
+	let hasProductID = false;
+	let hasProductType = false;
+
+	while (offset < qr.length) {
+		const {
+			entry: { type, ...data },
+			charsRead,
+		} = parseTLV(qr.slice(offset));
+		offset += charsRead;
+
+		if (type === ProvisioningInformationType.ProductId) {
+			hasProductID = true;
+		} else if (type === ProvisioningInformationType.ProductType) {
+			hasProductType = true;
+		}
+		Object.assign(ret, data);
+	}
+
+	// Ensure the required fields are present
+	if (!hasProductID || !hasProductType) {
+		fail("missing required fields");
+	}
+
+	return ret;
+}