@wevu/web-apis 1.4.3 → 1.5.0

package/README.md

@@ -155,6 +155,8 @@ pnpm --filter @wevu/web-apis typecheck
 - 新项目建议使用 `installWebRuntimeGlobals()`
 - `installRequestGlobals()` 仍保留为兼容别名，后续会逐步淡出文档主叙事
 
+`crypto.getRandomValues()` 同步填充并返回原 TypedArray，优先使用原生 Web Crypto。微信等小程序宿主的同名接口接收 options 并异步返回结果，兼容层不会调用它来完成同步填充。缺少原生 Web Crypto 时沿用 `Math.random()` fallback；该 fallback 不提供密码学安全保证，不能用于密钥或认证令牌。
+
 ## 11. Body 与 Blob 契约
 
 `RequestPolyfill` 和 `ResponsePolyfill` 提供可读 `body`，以及 `bytes()`、`arrayBuffer()`、`text()`、`json()`、`blob()`。非 null body 只能消费一次；调用消费方法或开始读取、取消 body 流时，`bodyUsed` 会变成 `true`。仅获取 reader 会锁定流，但不改变 `bodyUsed`。body 已消费或锁定时，重复读取和 `clone()` 都会以 `TypeError` 失败。需要多种读取方式时，请在消费前 clone：

package/dist/index.d.mts

@@ -14,8 +14,13 @@ export declare function btoaPolyfill(input?: string): string;
 export declare function atobPolyfill(input?: string): string;
 type IntegerTypedArray = Int8Array | Uint8Array | Uint8ClampedArray | Int16Array | Uint16Array | Int32Array | Uint32Array | BigInt64Array | BigUint64Array;
 declare function getRandomValuesPolyfill<T extends IntegerTypedArray>(typedArray: T): (T & Int8Array<ArrayBufferLike>) | (T & Uint8Array<ArrayBufferLike>) | (T & Uint8ClampedArray<ArrayBufferLike>) | (T & Int16Array<ArrayBufferLike>) | (T & Uint16Array<ArrayBufferLike>) | (T & Int32Array<ArrayBufferLike>) | (T & Uint32Array<ArrayBufferLike>) | (T & BigInt64Array<ArrayBufferLike>) | (T & BigUint64Array<ArrayBufferLike>);
+/**
+ * @description 基于 `getRandomValues` 生成符合 RFC 4122 version 4 的 UUID。
+ */
+export declare function randomUUIDPolyfill(): string;
 export declare const cryptoPolyfill: {
   getRandomValues: typeof getRandomValuesPolyfill;
+  randomUUID: typeof randomUUIDPolyfill;
 };
 declare const performancePolyfill: {
   __weappVitePerformancePolyfill: boolean;

package/dist/index.mjs

@@ -1,9 +1,9 @@
 import { AbortControllerPolyfill, AbortSignalPolyfill } from "./abort.mjs";
-import { c as installRequestGlobalBinding, f as resolveRequestGlobalsHost, p as resolveRequestGlobalsHosts, t as RequestGlobalsEventTarget, v as getMiniProgramRuntimeGlobalKeys } from "./shared-CARmZrDA.mjs";
 import { i as EventPolyfill, r as CustomEventPolyfill, t as EventSourcePolyfill } from "./eventsource-cHN0nNB1.mjs";
 import { t as fetch } from "./fetch-Cw1K3y4n.mjs";
 import { n as RequestPolyfill, t as ResponsePolyfill, u as HeadersPolyfill } from "./http-BJOhNGfL.mjs";
 import { getMiniProgramNetworkDefaults, resetMiniProgramNetworkDefaults, setMiniProgramNetworkDefaults } from "./networkDefaults.mjs";
+import { c as installRequestGlobalBinding, f as resolveRequestGlobalsHost, p as resolveRequestGlobalsHosts, t as RequestGlobalsEventTarget, v as getMiniProgramRuntimeGlobalKeys } from "./shared-CARmZrDA.mjs";
 import { a as TransformStreamPolyfill, i as TransformStream, n as ReadableStreamPolyfill, o as WritableStream, r as TextDecoderStreamPolyfill, s as WritableStreamPolyfill, t as ReadableStream } from "./streams-CcHd-MmG.mjs";
 import { n as TextEncoderPolyfill, r as hasUsableTextDecoderConstructor, t as TextDecoderPolyfill } from "./textCodec-muWByCAW.mjs";
 import { n as URLSearchParamsPolyfill, t as URLPolyfill } from "./url-DjMmeEth.mjs";
@@ -71,26 +71,34 @@ function fillArrayWithMathRandom(target) {
 	const bytes = new Uint8Array(target.buffer, target.byteOffset, target.byteLength);
 	for (let index = 0; index < bytes.length; index++) bytes[index] = Math.floor(Math.random() * 256);
 }
-function fillArrayWithHostRandomValues(target) {
-	for (const hostKey of getMiniProgramRuntimeGlobalKeys()) {
-		const host = globalThis[hostKey];
-		if (!host || typeof host.getRandomValues !== "function") continue;
-		try {
-			host.getRandomValues(target);
-			return true;
-		} catch {}
-	}
-	return false;
-}
 function getRandomValuesPolyfill(typedArray) {
 	if (!isIntegerTypedArray(typedArray)) throw new TypeError("Failed to execute 'getRandomValues': input must be an integer TypedArray");
 	if (typedArray.byteLength > MAX_RANDOM_VALUES_BYTE_LENGTH) throw new TypeError("Failed to execute 'getRandomValues': byteLength exceeds 65536");
 	const nativeCrypto = getNativeCrypto();
 	if (nativeCrypto && nativeCrypto.getRandomValues !== getRandomValuesPolyfill) return nativeCrypto.getRandomValues(typedArray);
-	if (!fillArrayWithHostRandomValues(typedArray)) fillArrayWithMathRandom(typedArray);
+	fillArrayWithMathRandom(typedArray);
 	return typedArray;
 }
-const cryptoPolyfill = { getRandomValues: getRandomValuesPolyfill };
+function bytesToHex(bytes) {
+	let result = "";
+	for (let index = 0; index < bytes.length; index++) result += bytes[index].toString(16).padStart(2, "0");
+	return result;
+}
+/**
+* @description 基于 `getRandomValues` 生成符合 RFC 4122 version 4 的 UUID。
+*/
+function randomUUIDPolyfill() {
+	const bytes = /* @__PURE__ */ new Uint8Array(16);
+	getRandomValuesPolyfill(bytes);
+	bytes[6] = bytes[6] & 15 | 64;
+	bytes[8] = bytes[8] & 63 | 128;
+	const hex = bytesToHex(bytes);
+	return `${hex.slice(0, 8)}-${hex.slice(8, 12)}-${hex.slice(12, 16)}-${hex.slice(16, 20)}-${hex.slice(20, 32)}`;
+}
+const cryptoPolyfill = {
+	getRandomValues: getRandomValuesPolyfill,
+	randomUUID: randomUUIDPolyfill
+};
 // src/performance.ts
 const performanceTimeOrigin = Date.now();
 const PERFORMANCE_POLYFILL_MARKER = "__weappVitePerformancePolyfill";
@@ -416,4 +424,4 @@ function installRequestGlobals(options = {}) {
 function installAbortGlobals() {
 	return installWebRuntimeGlobals({ targets: ["AbortController", "AbortSignal"] });
 }
-export { AbortControllerPolyfill, AbortSignalPolyfill, BlobPolyfill, CustomEventPolyfill, EventPolyfill, EventSourcePolyfill, FilePolyfill, FormDataPolyfill, HeadersPolyfill, ReadableStreamPolyfill, RequestGlobalsEventTarget, RequestPolyfill, ResponsePolyfill, TextDecoderPolyfill, TextDecoderStreamPolyfill, TextEncoderPolyfill, TransformStreamPolyfill, URLPolyfill, URLSearchParamsPolyfill, WebSocketPolyfill, WritableStreamPolyfill, XMLHttpRequestPolyfill, atobPolyfill, btoaPolyfill, cryptoPolyfill, fetch, getMiniProgramNetworkDefaults, installAbortGlobals, installRequestGlobals, installWebRuntimeGlobals, performancePolyfill, queueMicrotaskPolyfill, resetMiniProgramNetworkDefaults, setMiniProgramNetworkDefaults };
+export { AbortControllerPolyfill, AbortSignalPolyfill, BlobPolyfill, CustomEventPolyfill, EventPolyfill, EventSourcePolyfill, FilePolyfill, FormDataPolyfill, HeadersPolyfill, ReadableStreamPolyfill, RequestGlobalsEventTarget, RequestPolyfill, ResponsePolyfill, TextDecoderPolyfill, TextDecoderStreamPolyfill, TextEncoderPolyfill, TransformStreamPolyfill, URLPolyfill, URLSearchParamsPolyfill, WebSocketPolyfill, WritableStreamPolyfill, XMLHttpRequestPolyfill, atobPolyfill, btoaPolyfill, cryptoPolyfill, fetch, getMiniProgramNetworkDefaults, installAbortGlobals, installRequestGlobals, installWebRuntimeGlobals, performancePolyfill, queueMicrotaskPolyfill, randomUUIDPolyfill, resetMiniProgramNetworkDefaults, setMiniProgramNetworkDefaults };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@wevu/web-apis",
   "type": "module",
-  "version": "1.4.3",
+  "version": "1.5.0",
   "description": "Web API polyfills and global installers for mini-program runtimes",
   "author": "ice breaker <1324318532@qq.com>",
   "license": "MIT",
@@ -87,9 +87,9 @@
     "node": "^22.23.4 || ^24.22.1 || >=26.12.1"
   },
   "dependencies": {
-    "@weapp-core/api": "0.4.2",
-    "@weapp-core/constants": "0.5.3",
-    "@wevu/api": "0.4.2",
+    "@weapp-core/api": "0.4.3",
+    "@weapp-core/constants": "0.5.4",
+    "@wevu/api": "0.4.3",
     "web-streams-polyfill": "4.5.1"
   },
   "publishConfig": {