@zturnlibs/ztron-api

---

updater#

Interfaces#

SignatureVerifyResult#

Defined in: updater.ts:5

镜像后端 minisign 校验门的结果形状（保持 wire 对齐）。

Properties#

alg?#

optional alg?: string

Defined in: updater.ts:9

error?#

optional error?: "format" | "keyid-mismatch" | "message-signature" | "global-signature"

Defined in: updater.ts:7

ok#

ok: boolean

Defined in: updater.ts:6

trustedComment?#

optional trustedComment?: string

Defined in: updater.ts:8

---

UpdateCheck#

Defined in: updater.ts:12

Properties#

artifactUrl?#

optional artifactUrl?: string

Defined in: updater.ts:17

currentVersion#

currentVersion: string

Defined in: updater.ts:14

hasUpdate#

hasUpdate: boolean

Defined in: updater.ts:13

latestVersion?#

optional latestVersion?: string

Defined in: updater.ts:15

notes?#

optional notes?: string

Defined in: updater.ts:16

sha256?#

optional sha256?: string

Defined in: updater.ts:18

signature?#

optional signature?: string

Defined in: updater.ts:20

产物之上的 minisign 签名文本（已发布时存在）。

Type Aliases#

InstallResult#

InstallResult = { ok: false; reason: "no-update"; } | { bytes: number; ok: true; path: string; }

Defined in: updater.ts:69

---

UpdateProgress#

UpdateProgress = { data: { contentLength?: number; }; event: "Started"; } | { data: { chunkLength: number; }; event: "Progress"; } | { event: "Finished"; }

Defined in: updater.ts:64

Variables#

updater#

const updater: object

Defined in: updater.ts:99

Type Declaration#

check#

check: (url?) => Promise<UpdateCheck>

Parameters#

url?#

string

Returns#

Promise<UpdateCheck>

download#

download: (url, destination) => Promise<{ bytes: number; path: string; }>

Parameters#

url#

string

destination#

string

Returns#

Promise<{ bytes: number; path: string; }>

downloadAndInstall#

downloadAndInstall: (onEvent, url?) => Promise<InstallResult>

流式下载+安装（Tauri downloadAndInstall 对位）：下载期间经 Channel 推送 Started → Progress×N → Finished，随后先执行 sha256 与（配置了 pubkey 时的）minisign 校验再重启。

Parameters#

onEvent#

(event) => void

url?#

string

Returns#

Promise<InstallResult>

install#

install: (url?) => Promise<InstallResult>

一次性应用更新（保留向后兼容）：check → download → 双重完整性门 → 重启。ok: false = 清单没有更新版本。

Parameters#

url?#

string

Returns#

Promise<InstallResult>

verify#

verify: (file, sha256) => Promise<{ actual: string; ok: boolean; }>

Parameters#

file#

string

sha256#

string

Returns#

Promise<{ actual: string; ok: boolean; }>

verifySignature#

verifySignature: (data, signature, pubkey, opts) => Promise<SignatureVerifyResult>

在 inline 数据上校验 minisign 签名（不落盘）——把更新器的签名门暴露给工具链和测试。

Parameters#

data#

Uint8Array

signature#

string

pubkey#

string

opts?#

allowLegacyPlain?#

boolean

Returns#

Promise<SignatureVerifyResult>

Functions#

check()#

check(url?): Promise<UpdateCheck>

Defined in: updater.ts:23

Parameters#

url?#

string

Returns#

Promise<UpdateCheck>

---

download()#

download(url, destination): Promise<{ bytes: number; path: string; }>

Defined in: updater.ts:27

Parameters#

url#

string

destination#

string

Returns#

Promise<{ bytes: number; path: string; }>

---

downloadAndInstall()#

downloadAndInstall(onEvent, url?): Promise<InstallResult>

Defined in: updater.ts:79

流式下载+安装（Tauri downloadAndInstall 对位）：下载期间经 Channel 推送 Started → Progress×N → Finished，随后先执行 sha256 与（配置了 pubkey 时的）minisign 校验再重启。

Parameters#

onEvent#

(event) => void

url?#

string

Returns#

Promise<InstallResult>

---

install()#

install(url?): Promise<InstallResult>

Defined in: updater.ts:95

一次性应用更新（保留向后兼容）：check → download → 双重完整性门 → 重启。ok: false = 清单没有更新版本。

Parameters#

url?#

string

Returns#

Promise<InstallResult>

---

verify()#

verify(file, sha256): Promise<{ actual: string; ok: boolean; }>

Defined in: updater.ts:34

Parameters#

file#

string

sha256#

string

Returns#

Promise<{ actual: string; ok: boolean; }>

---

verifySignature()#

verifySignature(data, signature, pubkey, opts?): Promise<SignatureVerifyResult>

Defined in: updater.ts:45

在 inline 数据上校验 minisign 签名（不落盘）——把更新器的签名门暴露给工具链和测试。

Parameters#

data#

Uint8Array

signature#

string

pubkey#

string

opts?#

allowLegacyPlain?#

boolean

Returns#

Promise<SignatureVerifyResult>