@magicvr/schema-ui-protocol 0.2.1 → 0.2.3

package/lib/fetch-timeout.js

@@ -0,0 +1,43 @@
+/**
+ * W10 F-002: fetch timeout wrapper.
+ *
+ * Wraps a fetch implementation so a hung request (slow network, stalled
+ * server) aborts after a bounded window instead of pending forever. The
+ * returned function is drop-in compatible with `typeof fetch`; a caller-
+ * provided AbortSignal in `init` is composed with the timeout signal (either
+ * firing aborts the request). Timers are cleared once the request settles, so
+ * no handles leak on the happy path.
+ */
+/** Default ceiling for a single request (30s). */
+export const DEFAULT_FETCH_TIMEOUT_MS = 30_000;
+export function withTimeout(fetchImpl, timeoutMs = DEFAULT_FETCH_TIMEOUT_MS) {
+    return async function fetchWithTimeout(input, init) {
+        // Resolved per call (not at wrap time) so a later global fetch stub —
+        // test doubles, service workers — is always honored.
+        const doFetch = fetchImpl ?? globalThis.fetch;
+        // RequestInit.signal is `AbortSignal | null | undefined`; normalize to
+        // undefined so the guards below stay simple.
+        const outer = init?.signal ?? undefined;
+        // An already-aborted caller signal must fail fast without touching the
+        // network (no fetch call, no timer).
+        if (outer?.aborted === true) {
+            throw new DOMException("The operation was aborted.", "AbortError");
+        }
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), timeoutMs);
+        // Relay the caller signal onto our controller; the relay listener is
+        // removed once the request settles so a long-lived shared signal does not
+        // accumulate listeners across calls (A-003 recommended F-002).
+        const relayAbort = () => controller.abort();
+        if (outer !== undefined) {
+            outer.addEventListener("abort", relayAbort, { once: true });
+        }
+        try {
+            return await doFetch(input, { ...init, signal: controller.signal });
+        }
+        finally {
+            clearTimeout(timer);
+            outer?.removeEventListener("abort", relayAbort);
+        }
+    };
+}

package/package.json

@@ -1,13 +1,13 @@
 {
   "name": "@magicvr/schema-ui-protocol",
-  "version": "0.2.1",
+  "version": "0.2.3",
   "type": "module",
-  "description": "schema-ui-core 协议面（v0.2.0 · R4 升级演练=normalizePageID additive）",
-  "main": "index.js",
-  "types": "./protocol/index.d.ts",
+  "description": "schema-ui-core 包面（protocol）",
+  "main": "protocol/index.js",
+  "types": "protocol/index.d.ts",
   "exports": {
     ".": {
-      "types": "./protocol/index.d.ts",
+      "types": "protocol/index.d.ts",
       "import": "./index.js"
     },
     "./*": "./*"