fix(core): resolve KSUID crypto source lazily so importing friendlyId never throws

d-cs · d-cs · commit a2261e9c055e · 2026-07-03T10:39:00.000+01:00
diff --git a/packages/core/src/v3/isomorphic/friendlyId.ts b/packages/core/src/v3/isomorphic/friendlyId.ts
@@ -39,7 +39,11 @@ function loadNodeWebCrypto(): Crypto | undefined {
   }
 }
 
-const getRandomValues: RandomFiller = resolveGetRandomValues();
+// Resolve the crypto source lazily on first use (memoized), so merely importing this
+// widely-used module never throws when crypto is unavailable — only minting a KSUID would.
+let cachedGetRandomValues: RandomFiller | undefined;
+const getRandomValues: RandomFiller = (array) =>
+  (cachedGetRandomValues ??= resolveGetRandomValues())(array);
 
 /** Encode raw bytes as base62 (big-endian), left-padded to the given length. */
 function base62Encode(bytes: Uint8Array, length: number): string {

Original file line number	Diff line number	Diff line change
`@@ -39,7 +39,11 @@ function loadNodeWebCrypto(): Crypto \| undefined {`
`39`	`39`	`}`
`40`	`40`	`}`
`41`	`41`
`42`		`-const getRandomValues: RandomFiller = resolveGetRandomValues();`
	`42`	`+// Resolve the crypto source lazily on first use (memoized), so merely importing this`
	`43`	`+// widely-used module never throws when crypto is unavailable — only minting a KSUID would.`
	`44`	`+let cachedGetRandomValues: RandomFiller \| undefined;`
	`45`	`+const getRandomValues: RandomFiller = (array) =>`
	`46`	`+ (cachedGetRandomValues ??= resolveGetRandomValues())(array);`
`43`	`47`
`44`	`48`	`/** Encode raw bytes as base62 (big-endian), left-padded to the given length. */`
`45`	`49`	`function base62Encode(bytes: Uint8Array, length: number): string {`