clickgo 7.0.0 → 7.1.0

package/dist/lib/native/update.d.ts

@@ -0,0 +1,48 @@
+import * as lCore from '../core';
+/** --- 下载进度：百分比 0–100，其余值为字节数或字节/秒 --- */
+export interface IUpdateProgress {
+    'percent': number;
+    'transferred': number;
+    'total': number;
+    'bytesPerSecond': number;
+}
+/** --- Native 软件级更新状态，不含更新源、凭据和安装路径 --- */
+export interface IUpdateState {
+    'status': 'idle' | 'checking' | 'available' | 'up-to-date' | 'disabled' | 'error' | 'downloading' | 'downloaded' | 'restarting';
+    'currentVersion': string;
+    'version'?: string;
+    'progress'?: IUpdateProgress;
+    'reason'?: 'not-enabled' | 'development' | 'portable';
+    'errorCode'?: 'check-failed' | 'download-failed' | 'not-ready' | 'install-failed';
+}
+/**
+ * --- 检测软件更新，主进程须 launcher({ updates: true }) 并配置 build.publish ---
+ * @param current 当前 App 或窗体，要求 root 权限
+ * @returns 检测状态；开发/便携/未启用返回 disabled，无权限为 false，网页/旧宿主为 null
+ */
+export declare function checkUpdates(current: lCore.TCurrent): Promise<IUpdateState | null | false>;
+/**
+ * --- 下载检测到的版本，合并并发下载，由 Native 校验文件 ---
+ * @param current 当前 App 或窗体，要求 root 权限，业务须先取得用户确认
+ * @returns downloaded 表示校验完成，未就绪/失败为 error；无权限为 false，不支持为 null
+ */
+export declare function downloadUpdate(current: lCore.TCurrent): Promise<IUpdateState | null | false>;
+/**
+ * --- 安装本进程已下载的版本并重启，业务须先保存文档并确认 ---
+ * @param current 当前 App 或窗体，要求 root 权限
+ * @returns restarting 表示安装开始；异步失败由 onUpdateState 通知，无权限为 false，不支持为 null
+ */
+export declare function installUpdate(current: lCore.TCurrent): Promise<IUpdateState | null | false>;
+/**
+ * --- 读取 Native 软件级更新状态快照 ---
+ * @param current 当前 App 或窗体，要求 root 权限
+ * @returns 当前状态，无权限为 false，网页或旧宿主不支持为 null
+ */
+export declare function getUpdateState(current: lCore.TCurrent): Promise<IUpdateState | null | false>;
+/**
+ * --- 监听软件级公开状态及下载进度；不包含 URL、凭据或文件路径 ---
+ * @param current 当前 App 或窗体，不要求 root；控制更新仍须 root
+ * @param handler 状态回调，业务不需要定义 Native 事件名
+ * @returns 无返回值；窗体或任务销毁时自动解除，网页/旧宿主不会投递
+ */
+export declare function onUpdateState(current: lCore.TCurrent, handler: (state: IUpdateState) => void | Promise<void>): void;

package/dist/lib/native.d.ts

@@ -2,11 +2,20 @@ import * as lCore from './core';
 import type * as lNativeStorage from './native/storage';
 export * as storage from './native/storage';
 export * as secret from './native/secret';
+export { checkUpdates, downloadUpdate, installUpdate, getUpdateState, onUpdateState } from './native/update';
+export type { IUpdateState, IUpdateProgress } from './native/update';
 /**
  * --- 初始化系统级 ID，仅能设置一次 ---
  * @param id 系统级 ID
  */
 export declare function initSysId(id: string): void;
+/**
+ * --- 接入固定的软件更新动作，不允许网页提供地址或安装路径 ---
+ * @param current 已确认有效的任务
+ * @param action 固定更新动作
+ * @returns 更新状态；任务失效为 false，旧宿主缺少能力时为 null
+ */
+export declare function invokeUpdate(current: lCore.TCurrent, action: 'check' | 'download' | 'install' | 'state'): Promise<import('./native/update').IUpdateState | null | false>;
 /** --- 本地 MCP 客户端连接设置；仅向已授权 root 的 App 提供 --- */
 export interface IMcpInfo {
     'transport': 'streamable-http';