npm - @nsnanocat/preference-panes - Versions diffs - 0.9.15 → 1.0.0 - Mend

@nsnanocat/preference-panes 0.9.15 → 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (26) hide show

package/README.md +21 -15
package/dist/api.js +1454 -967
package/dist/module/app.mjs +296 -412
package/dist/module/index.html +1 -1
package/dist/module/navigation.mjs +17 -28
package/dist/preference-panes.mjs +259 -374
package/dist/web.js +1202 -0
package/package.json +1 -1
package/src/api.mjs +191 -0
package/src/browser/ModuleStatus.mjs +17 -28
package/src/browser/Navigation.d.mts +12 -32
package/src/browser/app.mjs +5 -7
package/src/{lib → browser}/boxjs.mjs +72 -16
package/src/browser/client.d.mts +44 -129
package/src/browser/client.mjs +61 -179
package/src/browser/index.d.ts +7 -11
package/src/browser/index.mjs +15 -7
package/src/browser/panel.mjs +31 -22
package/src/build.mjs +2 -3
package/src/index.d.ts +16 -2
package/src/web.mjs +52 -0
package/src/BoxJS.mjs +0 -72
package/src/Store.mjs +0 -114
package/src/lib/response.mjs +0 -16
package/src/proxy/handler.mjs +0 -39
package/src/proxy/response.mjs +0 -16

package/dist/module/index.html CHANGED Viewed

@@ -9,6 +9,6 @@
     </head>
     <body>
         <main id="preferences"></main>
-        <script type="module" src="/settings/assets/app.mjs?v=0.9.15"></script>
+        <script type="module" src="/settings/assets/app.mjs?v=1.0.0"></script>
     </body>
 </html>

package/dist/module/navigation.mjs CHANGED Viewed

@@ -269,44 +269,31 @@ class ModuleFrame extends EventTarget {
     }
 }
-/**
- * 模块 JSON Mock 的 HEAD 探测结果。
- * Result returned by a module JSON Mock HEAD probe.
- * @typedef {object} ModuleProbeResult
- * @property {"installed" | "missing"} state 安装状态 / Installation state.
- * @property {string | null} version 业务版本，缺失时为 null / Business version, or null when absent.
- * @property {number | null} httpStatus HTTP 状态码，网络错误时为 null / HTTP status, or null for network errors.
- */
 /**
  * 模块探测请求选项。
  * Options for a module probe request.
  * @typedef {object} ModuleProbeOptions
  * @property {typeof globalThis.fetch} [fetch] 可注入的 fetch / Injectable fetch.
  * @property {AbortSignal} [signal] 外部取消信号 / External cancellation signal.
+ * @property {string} [json] BoxJS JSON 来源，将随探测请求头传递 / BoxJS JSON source sent in the probe header.
  * @property {number} [timeout] 超时毫秒数，默认 3500 / Timeout in milliseconds, defaults to 3500.
  */
 /**
- * 通过模块 JSON Mock 的 HEAD 响应检测安装状态和业务版本。
- * Detect module installation and business version from a module JSON Mock HEAD response.
- * @param {string | URL} url 配置 Mock 地址 / Configuration Mock URL.
+ * 通过模块 API 的 HEAD 响应检测安装状态和业务版本。
+ * Probe installation and business version from the module API HEAD response.
+ * @param {string | URL} url 模块 API 地址 / Module API URL.
  * @param {ModuleProbeOptions} [options] 请求选项 / Request options.
- * @returns {Promise<ModuleProbeResult>} 探测结果 / Probe result.
- * @throws {Error} 外部取消请求 / External cancellation.
+ * @returns {Promise<Response>} 原始 HTTP 响应，可直接读取 status 和响应头 / Native HTTP response; read status and headers directly.
  */
-async function probeModule(url, { fetch: request = globalThis.fetch, signal, timeout = 3500 } = {}) {
+async function probeModule(url, { fetch: request = globalThis.fetch, json, signal, timeout = 3500 } = {}) {
     const controller = new AbortController();
     const abort = () => controller.abort();
     if (signal?.aborted) abort();
     signal?.addEventListener("abort", abort, { once: true });
     const timer = setTimeout(() => controller.abort(), timeout);
     try {
-        const response = await request(url, { method: "HEAD", cache: "no-store", credentials: "omit", signal: controller.signal });
-        return response.status === 200 ? { state: "installed", version: response.headers.get("X-PreferencePanes-Version")?.trim() || null, httpStatus: 200 } : { state: "missing", version: null, httpStatus: response.status };
-    } catch (error) {
-        if (signal?.aborted) throw error;
-        return { state: "missing", version: null, httpStatus: null };
+        return await request(url, { method: "HEAD", cache: "no-store", credentials: "omit", signal: controller.signal, headers: json ? { "X-PreferencePanes-JSON": json } : undefined });
     } finally {
         clearTimeout(timer);
         signal?.removeEventListener("abort", abort);
@@ -344,9 +331,9 @@ class ModuleStatus extends EventTarget {
     /**
      * 每次进入重新探测，取消旧请求并忽略其迟到结果。
      * Reprobe on entry, cancelling old requests and ignoring late results.
-     * @param {string | URL} url 配置 Mock 地址 / Configuration Mock URL.
+     * @param {string | URL} url 模块 API 地址 / Module API URL.
      * @param {ModuleProbeOptions} [options] 请求选项 / Request options.
-     * @returns {Promise<ModuleProbeResult>} 探测结果 / Probe result.
+     * @returns {Promise<Response | undefined>} 原始响应；被取消时无返回值 / Native response; undefined when cancelled.
      */
     async check(url, options = {}) {
         this.#controller?.abort();
@@ -358,13 +345,15 @@ class ModuleStatus extends EventTarget {
         externalSignal?.addEventListener("abort", abort, { once: true });
         this.#render("checking");
         try {
-            const result = await probeModule(url, { ...options, signal: controller.signal });
-            if (controller !== this.#controller) return result;
-            this.#render(result.state, result.version);
-            return result;
+            const response = await probeModule(url, { ...options, signal: controller.signal });
+            if (controller !== this.#controller) return response;
+            const version = response.status === 200 ? response.headers.get("X-PreferencePanes-Version")?.trim() || null : null;
+            this.#render(response.status === 200 ? "installed" : "missing", version);
+            return response;
         } catch (error) {
-            if (controller !== this.#controller) return { state: "missing", version: null, httpStatus: null };
-            throw error;
+            if (controller !== this.#controller) return;
+            if (externalSignal?.aborted) throw error;
+            this.#render("missing");
         } finally {
             externalSignal?.removeEventListener("abort", abort);
         }