Open History to see the last commit
1import type {
2 DesktopRuntimeInfo,
3 DesktopUpdateChannel,
4 DesktopUpdateReleaseNote,
5 DesktopUpdateState,
6} from "@t3tools/contracts";
7
8function nextStatusAfterDownloadFailure(
9 currentState: DesktopUpdateState,
10): DesktopUpdateState["status"] {
11 return currentState.availableVersion ? "available" : "error";
12}
13
14function getCanRetryAfterDownloadFailure(currentState: DesktopUpdateState): boolean {
15 return currentState.availableVersion !== null;
16}
17
18export function createInitialDesktopUpdateState(
19 currentVersion: string,
20 runtimeInfo: DesktopRuntimeInfo,
21 channel: DesktopUpdateChannel,
22): DesktopUpdateState {
23 return {
24 enabled: false,
25 status: "disabled",
26 channel,
27 currentVersion,
28 hostArch: runtimeInfo.hostArch,
29 appArch: runtimeInfo.appArch,
30 runningUnderArm64Translation: runtimeInfo.runningUnderArm64Translation,
31 availableVersion: null,
32 downloadedVersion: null,
33 releaseNotes: [],
34 omittedReleaseCount: 0,
35 downloadPercent: null,
36 checkedAt: null,
37 message: null,
38 errorContext: null,
39 canRetry: false,
40 };
41}
42
43export function reduceDesktopUpdateStateOnCheckStart(
44 state: DesktopUpdateState,
45 checkedAt: string,
46): DesktopUpdateState {
47 const hasDownloadedUpdate = state.downloadedVersion !== null;
48 return {
49 ...state,
50 status: "checking",
51 checkedAt,
52 releaseNotes: hasDownloadedUpdate ? state.releaseNotes : [],
53 omittedReleaseCount: hasDownloadedUpdate ? state.omittedReleaseCount : 0,
54 message: null,
55 downloadPercent: hasDownloadedUpdate ? 100 : null,
56 errorContext: null,
57 canRetry: false,
58 };
59}
60
61export function reduceDesktopUpdateStateOnCheckFailure(
62 state: DesktopUpdateState,
63 message: string,
64 checkedAt: string,
65): DesktopUpdateState {
66 if (state.downloadedVersion !== null) {
67 return {
68 ...state,
69 status: "downloaded",
70 message: null,
71 checkedAt,
72 downloadPercent: 100,
73 errorContext: null,
74 canRetry: true,
75 };
76 }
77
78 return {
79 ...state,
80 status: "error",
81 message,
82 checkedAt,
83 downloadPercent: null,
84 errorContext: "check",
85 canRetry: true,
86 };
87}
88
89export function reduceDesktopUpdateStateOnUpdateAvailable(
90 state: DesktopUpdateState,
91 version: string,
92 checkedAt: string,
93 releaseNotes: ReadonlyArray<DesktopUpdateReleaseNote> = [],
94 omittedReleaseCount = 0,
95): DesktopUpdateState {
96 const isDownloadedVersion = state.downloadedVersion === version;
97 const preserveReleaseNotes = isDownloadedVersion && releaseNotes.length === 0;
98 return {
99 ...state,
100 status: isDownloadedVersion ? "downloaded" : "available",
101 availableVersion: version,
102 downloadedVersion: isDownloadedVersion ? version : null,
103 releaseNotes: preserveReleaseNotes ? state.releaseNotes : releaseNotes,
104 omittedReleaseCount: preserveReleaseNotes ? state.omittedReleaseCount : omittedReleaseCount,
105 downloadPercent: isDownloadedVersion ? 100 : null,
106 checkedAt,
107 message: null,
108 errorContext: null,
109 canRetry: isDownloadedVersion,
110 };
111}
112
113export function reduceDesktopUpdateStateOnNoUpdate(
114 state: DesktopUpdateState,
115 checkedAt: string,
116): DesktopUpdateState {
117 if (state.downloadedVersion !== null) {
118 return {
119 ...state,
120 status: "downloaded",
121 availableVersion: state.downloadedVersion,
122 downloadPercent: 100,
123 checkedAt,
124 message: null,
125 errorContext: null,
126 canRetry: true,
127 };
128 }
129
130 return {
131 ...state,
132 status: "up-to-date",
133 availableVersion: null,
134 downloadedVersion: null,
135 releaseNotes: [],
136 omittedReleaseCount: 0,
137 downloadPercent: null,
138 checkedAt,
139 message: null,
140 errorContext: null,
141 canRetry: false,
142 };
143}
144
145export function reduceDesktopUpdateStateOnDownloadStart(
146 state: DesktopUpdateState,
147): DesktopUpdateState {
148 return {
149 ...state,
150 status: "downloading",
151 downloadPercent: 0,
152 message: null,
153 errorContext: null,
154 canRetry: false,
155 };
156}
157
158export function reduceDesktopUpdateStateOnDownloadFailure(
159 state: DesktopUpdateState,
160 message: string,
161): DesktopUpdateState {
162 return {
163 ...state,
164 status: nextStatusAfterDownloadFailure(state),
165 message,
166 downloadPercent: null,
167 errorContext: "download",
168 canRetry: getCanRetryAfterDownloadFailure(state),
169 };
170}
171
172export function reduceDesktopUpdateStateOnDownloadProgress(
173 state: DesktopUpdateState,
174 percent: number,
175): DesktopUpdateState {
176 return {
177 ...state,
178 status: "downloading",
179 downloadPercent: percent,
180 message: null,
181 errorContext: null,
182 canRetry: false,
183 };
184}
185
186export function reduceDesktopUpdateStateOnDownloadComplete(
187 state: DesktopUpdateState,
188 version: string,
189): DesktopUpdateState {
190 return {
191 ...state,
192 status: "downloaded",
193 availableVersion: version,
194 downloadedVersion: version,
195 downloadPercent: 100,
196 message: null,
197 errorContext: null,
198 canRetry: true,
199 };
200}
201
202export function reduceDesktopUpdateStateOnInstallFailure(
203 state: DesktopUpdateState,
204 message: string,
205): DesktopUpdateState {
206 return {
207 ...state,
208 status: "downloaded",
209 message,
210 errorContext: "install",
211 canRetry: true,
212 };
213}
214
215export interface DesktopUpdateInstallRecord {
216 readonly fromVersion: string;
217 readonly targetVersion: string;
218}
219
220export function resolveNotAppliedInstallVersion(
221 record: DesktopUpdateInstallRecord,
222 appVersion: string,
223): string | null {
224 return record.fromVersion === appVersion && record.targetVersion !== appVersion
225 ? record.targetVersion
226 : null;
227}