dsh-plugin-update 0.3.0 → 0.3.1

package/CHANGELOG.md

@@ -2,6 +2,11 @@
 
 格式为 Keep-a-Changelog 子集：`Added/Fixed/Changed` 必写，`Deprecated/Removed/Security` 有则透传，`Unreleased` 面板忽略，禁止 git-log 直倒。面板缺日志时中性提示，不挡安装。
 
+## [0.3.1] - 2026-10-05
+
+### Added
+- 新增 `dsh-plugin-update/http`：`createHttpCall`（单三电话 + 批量五电话同一内核，`batchPrefix` 独立）+ `mountUpdatePanelHttp`/`mountUpdateEntryHttp`/`mountUpdateBatchPanelHttp`，只传 pluginId + prefix/batchPrefix + baseUrl/routes 即跑通检查/安装/待重启/失败与批量总账/明细/动作；queue/env/session/rows/progress/diag 全透传，传输失败走 `http-transport-failed` 异常通道，取消整批走 `batchCancel` 电话。
+
 ## [0.3.0] - 2026-10-04
 
 ### Added

package/README.md

@@ -2,7 +2,7 @@
 
 给 DSH 插件加「检查更新 / 安装更新」能力的 npm 包。宿主侧一段接线，面板侧挂一个现成组件，装不上时给用户一条可复制的手工命令。
 
-要求 Node 22 或更高，零运行时依赖。当前版本 `0.3.0`。
+要求 Node 22 或更高，零运行时依赖。当前版本 `0.3.1`。
 
 装上它你会拿到六样东西：
 
@@ -144,6 +144,21 @@ mountUpdatePanel(slot, { pluginId: 'my-notes-plugin', prefix: 'notes', call: hos
 
 类型定义随包分发（`dsh-plugin-update/panel` 的 `.d.ts`），不用自编译；面板离线可读，与包版本绑定。
 
+整组件 HTTP 版（无 `host.call` 环境即跑：浏览器面板经 HTTP POST 直达宿主网关，只传三样）：
+
+```js
+import { mountUpdatePanelHttp } from 'dsh-plugin-update/http'
+
+mountUpdatePanelHttp(document.querySelector('#upd'), {
+  pluginId: 'my-plugin',
+  prefix: 'myplug',
+  baseUrl: 'https://host.local:3000/upd',
+  showOthers: false,
+  pollMs: 1000,
+})
+// 离开时 panel.unmount()：只停轮询，安装在宿主侧继续跑。
+```
+
 ### 第 2.5 节：更新入口件（配置页上那一颗按钮）
 
 目标只有一句：**让用户不用点开就知道有没有事。** 一行挂上：
@@ -221,6 +236,19 @@ const panel = mountUpdateBatchPanel(el, {
 })
 ```
 
+批量面板 HTTP 版（无 `host.call` 环境即跑：同一传输内核，五电话走同一映射，取消走 `batchCancel`）：
+
+```js
+import { mountUpdateBatchPanelHttp } from 'dsh-plugin-update/http'
+
+mountUpdateBatchPanelHttp(document.querySelector('#batch'), {
+  batchPrefix: 'life',
+  baseUrl: 'https://host.local:3000/upd',
+  pollMs: 1500,
+})
+// 取消整批走 batchCancel 电话；unmount 只停轮询，宿主侧照跑。
+```
+
 三条硬约束（都在实现里）：**一行只回答一个问题**（这家的下一步是什么，状态词全中文可执行）；
 **行内动作只作用于该行**，「全部更新」是宏而不是第二个状态机；**待重启与失败常驻横幅**，不藏进展开里。
 
@@ -250,7 +278,7 @@ const panel = mountUpdateBatchPanel(el, {
 
 宿主种类与安装出口都由本包自己探测和选择，**升级依赖即可，宿主侧与面板侧都不用改代码**：
 
-1. 依赖版本提到 `^0.3.0`。
+1. 依赖版本提到 `^0.3.1`。
 2. 重新装 / 发一版你自己的插件，让新依赖进当前使用范围（运行时用的是 `node_modules` 里那份）。
 3. 如果你自己接过一版宿主安装出口，把它删掉——它会挡在本包的路由前面。
 

package/dist/http.d.ts

@@ -0,0 +1,127 @@
+import { assertPollInterval } from './client.js';
+import { type UpdatePanelContainer, type UpdatePanelController, type UpdatePanelOptions } from './panel.js';
+import { type UpdateEntryController, type UpdateEntryOptions } from './entry.js';
+import { type BatchPanelContainer, type BatchPanelController, type BatchPanelOptions } from './panel-batch.js';
+/** 传输失败码：永不进面板 14 稳定码分支，只走抛异常通道。 */
+export declare const HTTP_TRANSPORT_FAILED = "http-transport-failed";
+/** 抓取超时默认：查 15s / 装 16min（#30 冻结，调用方可覆写 + AbortSignal 透入）。 */
+export declare const DEFAULT_HTTP_CHECK_TIMEOUT_MS = 15000;
+export declare const DEFAULT_HTTP_INSTALL_TIMEOUT_MS: number;
+export declare const DEFAULT_HTTP_STATUS_TIMEOUT_MS = 15000;
+/** 单插件三电话动作名（与 src/config.ts PHONE_ACTIONS 同字面，不另起字面）。 */
+export declare const HTTP_PHONE_ACTIONS: readonly ["updateStatus", "updateCheck", "updateInstall"];
+export type HttpPhoneAction = (typeof HTTP_PHONE_ACTIONS)[number];
+/** 批量五电话动作名（与 src/panel-batch.ts buildBatchPhoneNames 同字面，不另起字面；同一内核）。 */
+export declare const HTTP_BATCH_ACTIONS: readonly ["batchStatus", "batchCheck", "batchInstall", "batchResume", "batchCancel"];
+export type HttpBatchAction = (typeof HTTP_BATCH_ACTIONS)[number];
+/** 逐电话覆写表：键为全电话名（prefix.动作）或短动作名；未知键拒绝。 */
+export type HttpRoutes = Record<string, string>;
+/** 抓取函数形状：与 globalThis.fetch 同形（测试给内存假件）。 */
+export type HttpFetch = (url: string, init: {
+    method: string;
+    headers: Record<string, string>;
+    body: string;
+    signal?: unknown;
+}) => Promise<unknown>;
+export interface HttpTimeouts {
+    /** 查/状态超时毫秒（默认 15s）。 */
+    checkMs?: number;
+    /** 装超时毫秒（默认 16min）。 */
+    installMs?: number;
+    /** 状态超时毫秒（默认 15s，与查同值）。 */
+    statusMs?: number;
+}
+export interface CreateHttpCallOptions {
+    /** 单插件电话前缀（与宿主侧一致；电话名从它算出，不写字面量）。 */
+    prefix: string;
+    /** 批量电话前缀（独立于单插件前缀；给了即同时校验批量五电话键，同一内核）。 */
+    batchPrefix?: string;
+    /** 网关根：默认路径 = 网关根 + 全电话名（首尾斜杠归一）。 */
+    baseUrl: string;
+    /** 电话级覆写表（routes[全电话名] ?? routes[短动作] ?? 默认拼接）。 */
+    routes?: HttpRoutes;
+    /** 抓取注入点（不传即 globalThis.fetch；测试给假件）。 */
+    fetch?: HttpFetch;
+    /** 同上别名（与 fetch 二选一，fetch 优先）。 */
+    fetchImpl?: HttpFetch;
+    /** 超时覆写：数字即全电话统一；对象即按电话分设。 */
+    timeout?: number | HttpTimeouts;
+    /** 同上别名（与 timeout 二选一，timeout 优先）。 */
+    timeoutMs?: number | HttpTimeouts;
+}
+/** 覆写表未知键拒绝（创建即抛， fail-fast）。 */
+export declare function assertHttpRoutes(routes: HttpRoutes | undefined, prefix: string, batchPrefix?: string): void;
+/** 电话名 → POST 路径（默认拼接 + 电话级覆写 + 缺键回落 + 斜杠归一）。 */
+export declare function resolveHttpPath(options: {
+    prefix: string;
+    batchPrefix?: string;
+    baseUrl: string;
+    routes?: HttpRoutes;
+}, phoneName: string): string;
+/** 传输失败：断网/非 2xx/JSON 非法/超时，永不进稳定码分支。 */
+export declare function httpTransportFailed(reason: string, detail?: unknown): Error & {
+    code: string;
+    detail: string;
+};
+/** diag 宽容读：只留 16 键（DIAG_KEYS），detail 脱敏；diagnostic 原话丢弃。 */
+export declare function pickHttpDiag(raw: unknown): Record<string, unknown> | undefined;
+/** 回包整形：diagnostic 丢弃，diag 过滤，其余（queue/env/session/rows/progress/未知键）原样透传。
+ *
+ * 批量行内同理：rows[i].diagnostic 丢弃，rows[i].diag 只留 16 键且 detail 脱敏；
+ * 行内 queue/manual/snapshot/phoneNames 等原样透传（排队/续跑语义不裁剪）。 */
+export declare function shapeHttpReply(parsed: unknown): Record<string, unknown>;
+/** 建 HTTP 通话函数：(phoneName, args) => Promise<reply>，回包全透传，失败抛异常。 */
+export declare function createHttpCall(options: CreateHttpCallOptions): (phoneName: string, args: Record<string, unknown>) => Promise<Record<string, unknown>>;
+export interface UpdatePanelHttpOptions extends Omit<UpdatePanelOptions, "call" | "prefix"> {
+    /** 单插件电话前缀（与宿主侧一致）。 */
+    prefix?: string;
+    /** 网关根（必填）。 */
+    baseUrl: string;
+    /** 电话级覆写表（可选）。 */
+    routes?: HttpRoutes;
+    /** 抓取注入点（可选）。 */
+    fetch?: HttpFetch;
+    fetchImpl?: HttpFetch;
+    /** 超时覆写（可选）。 */
+    timeout?: number | HttpTimeouts;
+    timeoutMs?: number | HttpTimeouts;
+}
+/** 面板整组件 HTTP 直挂：只传三样即跑，内核复用 mountUpdatePanel。 */
+export declare function mountUpdatePanelHttp(container: UpdatePanelContainer, options: UpdatePanelHttpOptions): UpdatePanelController;
+export interface UpdateEntryHttpOptions extends Omit<UpdateEntryOptions, "call" | "prefix"> {
+    /** 单插件电话前缀（与宿主侧一致）。 */
+    prefix?: string;
+    /** 网关根（必填）。 */
+    baseUrl: string;
+    /** 电话级覆写表（可选）。 */
+    routes?: HttpRoutes;
+    /** 抓取注入点（可选）。 */
+    fetch?: HttpFetch;
+    fetchImpl?: HttpFetch;
+    /** 超时覆写（可选）。 */
+    timeout?: number | HttpTimeouts;
+    timeoutMs?: number | HttpTimeouts;
+}
+/** 入口件 HTTP 直挂：内部源码级禁安装电话，内核复用 mountUpdateEntry。 */
+export declare function mountUpdateEntryHttp(container: UpdatePanelContainer, options: UpdateEntryHttpOptions): UpdateEntryController;
+export interface UpdateBatchPanelHttpOptions extends Omit<BatchPanelOptions, "call" | "prefix"> {
+    /** 批量电话前缀（与宿主侧一致；五电话名从它算出，不写字面量）。 */
+    batchPrefix: string;
+    /** 单插件电话前缀（可选；给了即同一内核同时认单三电话，便于同网关共用一张 routes 表）。 */
+    prefix?: string;
+    /** 网关根（必填）。 */
+    baseUrl: string;
+    /** 电话级覆写表（可选；键为全电话名或短动作名，未知键拒绝）。 */
+    routes?: HttpRoutes;
+    /** 抓取注入点（可选）。 */
+    fetch?: HttpFetch;
+    fetchImpl?: HttpFetch;
+    /** 超时覆写（可选；batchInstall 走装时限 16min，其余走查/状态 15s）。 */
+    timeout?: number | HttpTimeouts;
+    timeoutMs?: number | HttpTimeouts;
+}
+/** 批量面板 HTTP 直挂：只传批量前缀加网关根即跑，内核复用 mountUpdateBatchPanel。
+ *
+ * 取消整批走 batchCancel 电话而不走中止等待（语义不混淆）；卸载只停轮询，宿主侧照跑。 */
+export declare function mountUpdateBatchPanelHttp(container: BatchPanelContainer, options: UpdateBatchPanelHttpOptions): BatchPanelController;
+export { assertPollInterval };

package/dist/http.js

@@ -0,0 +1,300 @@
+// AUTO-GENERATED by node build.mjs — DO NOT EDIT. Source: src/http.ts
+import { DEFAULT_PREFIX, assertPrefix } from "./config.js";
+import { assertPollInterval } from "./client.js";
+import { DIAG_KEYS } from "./diag.js";
+import { sanitizeDetail } from "./redaction.js";
+import { mountUpdatePanel } from "./panel.js";
+import { mountUpdateEntry } from "./entry.js";
+import { mountUpdateBatchPanel } from "./panel-batch.js";
+const HTTP_TRANSPORT_FAILED = "http-transport-failed";
+const DEFAULT_HTTP_CHECK_TIMEOUT_MS = 15e3;
+const DEFAULT_HTTP_INSTALL_TIMEOUT_MS = 16 * 6e4;
+const DEFAULT_HTTP_STATUS_TIMEOUT_MS = 15e3;
+const HTTP_PHONE_ACTIONS = ["updateStatus", "updateCheck", "updateInstall"];
+const HTTP_BATCH_ACTIONS = ["batchStatus", "batchCheck", "batchInstall", "batchResume", "batchCancel"];
+function isAbsoluteUrl(value) {
+  return /^https?:\/\//i.test(value);
+}
+function stripRightSlash(value) {
+  return String(value ?? "").replace(/\/+$/, "");
+}
+function joinBase(baseUrl, rel) {
+  const b = stripRightSlash(baseUrl);
+  let r = String(rel ?? "");
+  if (!r) return b;
+  if (!r.startsWith("/")) r = "/" + r;
+  return b + r;
+}
+function shortActionOf(phoneName) {
+  const name = String(phoneName ?? "");
+  const at = name.lastIndexOf(".");
+  return at >= 0 ? name.slice(at + 1) : name;
+}
+function allowedRouteKeys(prefix, batchPrefix) {
+  const out = /* @__PURE__ */ new Set();
+  for (const a of HTTP_PHONE_ACTIONS) {
+    out.add(a);
+    out.add(prefix + "." + a);
+  }
+  if (batchPrefix) {
+    for (const a of HTTP_BATCH_ACTIONS) {
+      out.add(a);
+      out.add(batchPrefix + "." + a);
+    }
+  }
+  return out;
+}
+function assertHttpRoutes(routes, prefix, batchPrefix) {
+  if (!routes) return;
+  const allowed = allowedRouteKeys(prefix, batchPrefix);
+  for (const key of Object.keys(routes)) {
+    if (!allowed.has(key)) {
+      throw new Error("[dsh-plugin-update] routes \u672A\u77E5\u952E\u62D2\u7EDD\uFF1A" + JSON.stringify(key));
+    }
+    const value = routes[key];
+    if (typeof value !== "string" || !value) {
+      throw new Error("[dsh-plugin-update] routes \u503C\u975E\u6CD5\uFF1A" + JSON.stringify(key));
+    }
+  }
+}
+function resolveHttpPath(options, phoneName) {
+  if (typeof phoneName !== "string" || !phoneName) {
+    throw new Error("[dsh-plugin-update] \u7535\u8BDD\u540D\u975E\u6CD5\uFF1A\u987B\u4E3A\u975E\u7A7A\u5B57\u7B26\u4E32");
+  }
+  const routes = options.routes ?? {};
+  assertHttpRoutes(routes, options.prefix, options.batchPrefix);
+  const short = shortActionOf(phoneName);
+  const hit = routes[phoneName] ?? routes[short];
+  if (hit !== void 0) {
+    if (isAbsoluteUrl(hit)) return hit;
+    return joinBase(options.baseUrl, hit);
+  }
+  return joinBase(options.baseUrl, phoneName);
+}
+function httpTransportFailed(reason, detail) {
+  const clean = sanitizeDetail(String(detail ?? reason ?? ""));
+  const err = new Error("[dsh-plugin-update] http-transport-failed: " + reason);
+  err.code = HTTP_TRANSPORT_FAILED;
+  err.detail = clean;
+  return err;
+}
+function isRecord(value) {
+  return !!value && typeof value === "object" && !Array.isArray(value);
+}
+function pickHttpDiag(raw) {
+  if (!isRecord(raw)) return void 0;
+  const out = {};
+  let kept = 0;
+  for (const key of DIAG_KEYS) {
+    const value = raw[key];
+    if (typeof value === "string" || typeof value === "number") {
+      out[key] = key === "detail" ? sanitizeDetail(String(value)) : value;
+      kept++;
+    }
+  }
+  return kept > 0 ? out : void 0;
+}
+function shapeHttpReply(parsed) {
+  if (!isRecord(parsed)) {
+    throw httpTransportFailed("\u56DE\u5305\u5F62\u72B6\u975E\u6CD5", String(parsed).slice(0, 120));
+  }
+  const out = { ...parsed };
+  if ("diagnostic" in out) delete out["diagnostic"];
+  if ("diag" in out) {
+    const kept = pickHttpDiag(out["diag"]);
+    if (kept) out["diag"] = kept;
+    else delete out["diag"];
+  }
+  if (Array.isArray(out["rows"])) {
+    out["rows"] = out["rows"].map((row) => {
+      if (!isRecord(row)) return row;
+      const copy = { ...row };
+      if ("diagnostic" in copy) delete copy["diagnostic"];
+      if ("diag" in copy) {
+        const kept = pickHttpDiag(copy["diag"]);
+        if (kept) copy["diag"] = kept;
+        else delete copy["diag"];
+      }
+      return copy;
+    });
+  }
+  return out;
+}
+function timeoutForPhone(phoneName, timeout) {
+  if (typeof timeout === "number" && Number.isFinite(timeout) && timeout > 0) return timeout;
+  const t = timeout ?? {};
+  if (phoneName.endsWith(".updateInstall") || phoneName.endsWith(".batchInstall")) {
+    if (typeof t.installMs === "number" && Number.isFinite(t.installMs) && t.installMs > 0) return t.installMs;
+    return DEFAULT_HTTP_INSTALL_TIMEOUT_MS;
+  }
+  if (phoneName.endsWith(".updateCheck") || phoneName.endsWith(".batchCheck")) {
+    if (typeof t.checkMs === "number" && Number.isFinite(t.checkMs) && t.checkMs > 0) return t.checkMs;
+    return DEFAULT_HTTP_CHECK_TIMEOUT_MS;
+  }
+  if (typeof t.statusMs === "number" && Number.isFinite(t.statusMs) && t.statusMs > 0) return t.statusMs;
+  if (typeof t.checkMs === "number" && Number.isFinite(t.checkMs) && t.checkMs > 0) return t.checkMs;
+  return DEFAULT_HTTP_STATUS_TIMEOUT_MS;
+}
+function resolveFetchImpl(options) {
+  const impl = options.fetch ?? options.fetchImpl ?? globalThis.fetch;
+  if (typeof impl !== "function") {
+    throw new Error("[dsh-plugin-update] HTTP \u4F20\u8F93\u7F3A\u5C11\u6293\u53D6\u51FD\u6570\uFF1A\u8BF7\u4F20 fetch \u6216\u5728\u6709 globalThis.fetch \u7684\u73AF\u5883\u8FD0\u884C");
+  }
+  return impl;
+}
+function createHttpCall(options) {
+  if (!options || typeof options !== "object") {
+    throw new Error("[dsh-plugin-update] \u5EFA HTTP \u4F20\u8F93\u7F3A\u5C11\u914D\u7F6E\uFF1A\u524D\u7F00 prefix \u4E0E\u7F51\u5173\u6839 baseUrl \u5FC5\u586B");
+  }
+  const prefix = options.prefix;
+  if (typeof prefix !== "string" || !prefix) {
+    throw new Error("[dsh-plugin-update] \u7535\u8BDD\u540D\u524D\u7F00 prefix \u975E\u6CD5\uFF1A\u987B\u4E3A\u975E\u7A7A\u5B57\u7B26\u4E32");
+  }
+  if (prefix.includes(".") || prefix.includes("/") || prefix.includes("\\") || /\s/.test(prefix)) {
+    throw new Error("[dsh-plugin-update] \u7535\u8BDD\u540D\u524D\u7F00 prefix \u975E\u6CD5\uFF1A\u4E0D\u5F97\u542B\u6709\u70B9\u3001\u8DEF\u5F84\u5206\u9694\u7B26\u6216\u7A7A\u767D");
+  }
+  const baseUrl = options.baseUrl;
+  if (typeof baseUrl !== "string" || !baseUrl.trim()) {
+    throw new Error("[dsh-plugin-update] \u7F51\u5173\u6839 baseUrl \u5FC5\u586B\uFF1A\u987B\u4E3A\u975E\u7A7A\u5B57\u7B26\u4E32");
+  }
+  const routes = options.routes ?? {};
+  assertHttpRoutes(routes, prefix, options.batchPrefix);
+  const fetchImpl = resolveFetchImpl(options);
+  const timeout = options.timeout ?? options.timeoutMs;
+  return async function httpCall(phoneName, args) {
+    if (typeof phoneName !== "string" || !phoneName) {
+      throw new Error("[dsh-plugin-update] \u7535\u8BDD\u540D\u975E\u6CD5\uFF1A\u987B\u4E3A\u975E\u7A7A\u5B57\u7B26\u4E32");
+    }
+    const url = resolveHttpPath({ prefix, batchPrefix: options.batchPrefix, baseUrl, routes }, phoneName);
+    const safeArgs = args && typeof args === "object" ? args : {};
+    const timeoutMs = timeoutForPhone(phoneName, timeout);
+    const body = JSON.stringify(stripSignal(safeArgs));
+    const AbortCtor = globalThis.AbortController;
+    const controller = typeof AbortCtor === "function" ? new AbortCtor() : null;
+    const callerSignal = safeArgs["signal"];
+    const onCallerAbort = () => {
+      try {
+        controller?.abort();
+      } catch {
+      }
+    };
+    if (callerSignal && typeof callerSignal.addEventListener === "function") {
+      try {
+        callerSignal.addEventListener.call(callerSignal, "abort", onCallerAbort, { once: true });
+      } catch {
+      }
+    }
+    let res;
+    const fetchPromise = fetchImpl(url, {
+      method: "POST",
+      headers: { "content-type": "application/json" },
+      body,
+      ...controller ? { signal: controller.signal } : {}
+    });
+    let timeoutTimer = null;
+    void fetchPromise.catch(() => {
+    });
+    try {
+      res = await Promise.race([
+        fetchPromise,
+        new Promise((_, reject) => {
+          timeoutTimer = setTimeout(() => {
+            try {
+              controller?.abort();
+            } catch {
+            }
+            reject(httpTransportFailed("\u8D85\u65F6", "\u6293\u53D6\u8D85\u65F6\uFF08" + String(timeoutMs) + "ms\uFF09\uFF1A" + phoneName));
+          }, timeoutMs);
+        })
+      ]);
+    } catch (e) {
+      if (timeoutTimer) clearTimeout(timeoutTimer);
+      if (e && typeof e === "object" && e.code === HTTP_TRANSPORT_FAILED) throw e;
+      throw httpTransportFailed(isAbortError(e) ? "\u8D85\u65F6\u6216\u53D6\u6D88" : "\u65AD\u7F51\u6216\u6293\u53D6\u5931\u8D25", e instanceof Error ? e.message : String(e));
+    }
+    if (timeoutTimer) clearTimeout(timeoutTimer);
+    const ok = res.ok === true;
+    if (!ok) {
+      const status = res.status;
+      const text2 = await readReplyText(res).catch(() => "");
+      throw httpTransportFailed("\u975E 2xx\uFF08" + String(status ?? "unknown") + "\uFF09", "HTTP " + String(status ?? "?") + ": " + String(text2).slice(0, 120));
+    }
+    const text = await readReplyText(res);
+    let parsed;
+    try {
+      parsed = JSON.parse(text);
+    } catch {
+      throw httpTransportFailed("JSON \u975E\u6CD5", String(text).slice(0, 120));
+    }
+    return shapeHttpReply(parsed);
+  };
+}
+function stripSignal(args) {
+  if (!("signal" in args)) return args;
+  const out = { ...args };
+  delete out["signal"];
+  return out;
+}
+function isAbortError(e) {
+  const name = e.name;
+  return name === "AbortError" || name === "TimeoutError";
+}
+async function readReplyText(res) {
+  const textFn = res.text;
+  if (typeof textFn === "function") return String(await textFn.call(res));
+  const jsonFn = res.json;
+  if (typeof jsonFn === "function") return JSON.stringify(await jsonFn.call(res));
+  throw httpTransportFailed("\u56DE\u5305\u5F62\u72B6\u975E\u6CD5", "\u6293\u53D6\u56DE\u5305\u65E2\u65E0 text() \u4E5F\u65E0 json()");
+}
+function mountUpdatePanelHttp(container, options) {
+  if (!options || typeof options !== "object") {
+    throw new Error("[dsh-plugin-update] \u6302 HTTP \u9762\u677F\u7F3A\u5C11\u914D\u7F6E\uFF1A\u63D2\u4EF6\u6807\u8BC6 pluginId \u4E0E\u7F51\u5173\u6839 baseUrl \u5FC5\u586B");
+  }
+  const prefix = options.prefix ?? DEFAULT_PREFIX;
+  const call = createHttpCall({ prefix, baseUrl: options.baseUrl, routes: options.routes, fetch: options.fetch, fetchImpl: options.fetchImpl, timeout: options.timeout, timeoutMs: options.timeoutMs });
+  const { baseUrl: _b, routes: _r, fetch: _f, fetchImpl: _fi, timeout: _t, timeoutMs: _tm, prefix: _p, ...panelRest } = options;
+  return mountUpdatePanel(container, { ...panelRest, pluginId: options.pluginId, prefix, call });
+}
+function mountUpdateEntryHttp(container, options) {
+  if (!options || typeof options !== "object") {
+    throw new Error("[dsh-plugin-update] \u6302 HTTP \u5165\u53E3\u4EF6\u7F3A\u5C11\u914D\u7F6E\uFF1A\u63D2\u4EF6\u6807\u8BC6 pluginId \u4E0E\u7F51\u5173\u6839 baseUrl \u5FC5\u586B");
+  }
+  const prefix = options.prefix ?? DEFAULT_PREFIX;
+  const rawCall = createHttpCall({ prefix, baseUrl: options.baseUrl, routes: options.routes, fetch: options.fetch, fetchImpl: options.fetchImpl, timeout: options.timeout, timeoutMs: options.timeoutMs });
+  const guarded = async (name, args) => {
+    if (shortActionOf(name) === "updateInstall") {
+      throw new Error("[dsh-plugin-update] \u5165\u53E3\u4EF6\u53EA\u5141\u8BB8\u53EA\u8BFB\u7535\u8BDD\uFF0CupdateInstall \u7981\u6B62\uFF08\u6E90\u7801\u7EA7\uFF09");
+    }
+    return rawCall(name, args);
+  };
+  const { baseUrl: _b, routes: _r, fetch: _f, fetchImpl: _fi, timeout: _t, timeoutMs: _tm, prefix: _p, ...entryRest } = options;
+  return mountUpdateEntry(container, { ...entryRest, pluginId: options.pluginId, prefix, call: guarded });
+}
+function mountUpdateBatchPanelHttp(container, options) {
+  if (!options || typeof options !== "object") {
+    throw new Error("[dsh-plugin-update] \u6302 HTTP \u6279\u91CF\u9762\u677F\u7F3A\u5C11\u914D\u7F6E\uFF1A\u6279\u91CF\u524D\u7F00 batchPrefix \u4E0E\u7F51\u5173\u6839 baseUrl \u5FC5\u586B");
+  }
+  const batchPrefix = assertPrefix(options.batchPrefix, "\u6279\u91CF\u7535\u8BDD\u524D\u7F00 batchPrefix");
+  const kernelPrefix = typeof options.prefix === "string" && options.prefix ? assertPrefix(options.prefix, "\u7535\u8BDD\u540D\u524D\u7F00 prefix") : batchPrefix;
+  const call = createHttpCall({ prefix: kernelPrefix, batchPrefix, baseUrl: options.baseUrl, routes: options.routes, fetch: options.fetch, fetchImpl: options.fetchImpl, timeout: options.timeout, timeoutMs: options.timeoutMs });
+  const { baseUrl: _b, routes: _r, fetch: _f, fetchImpl: _fi, timeout: _t, timeoutMs: _tm, prefix: _p, batchPrefix: _bp, ...batchRest } = options;
+  return mountUpdateBatchPanel(container, { ...batchRest, prefix: batchPrefix, call });
+}
+export {
+  DEFAULT_HTTP_CHECK_TIMEOUT_MS,
+  DEFAULT_HTTP_INSTALL_TIMEOUT_MS,
+  DEFAULT_HTTP_STATUS_TIMEOUT_MS,
+  HTTP_BATCH_ACTIONS,
+  HTTP_PHONE_ACTIONS,
+  HTTP_TRANSPORT_FAILED,
+  assertHttpRoutes,
+  assertPollInterval,
+  createHttpCall,
+  httpTransportFailed,
+  mountUpdateBatchPanelHttp,
+  mountUpdateEntryHttp,
+  mountUpdatePanelHttp,
+  pickHttpDiag,
+  resolveHttpPath,
+  shapeHttpReply
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-plugin-update",
-  "version": "0.3.0",
+  "version": "0.3.1",
   "description": "可复用的更新系统装成的 npm 包：任何 DSH 插件照文档能集成检查更新等功能（地图 #579）",
   "license": "MIT",
   "author": "王辰浩",
@@ -38,6 +38,10 @@
       "types": "./dist/entry.d.ts",
       "default": "./dist/entry.js"
     },
+    "./http": {
+      "types": "./dist/http.d.ts",
+      "default": "./dist/http.js"
+    },
     "./package.json": "./package.json"
   },
   "files": [