feat: complete hosted mod sync and launcher interface updates

Add pack sync markers, tagged mod updates, parallel progress, JWT downloads and retry recovery. Include pending onboarding, about scene, compatibility data pack and download fixes.

apps/app-frontend/src/composables/skin-site-session.test.ts

@@ -1,10 +1,21 @@
 import assert from 'node:assert/strict'
 import test from 'node:test'
+import { useHostedSync } from './useHostedSync.ts'
+import { useHostedCreation, forgetHostedCreation } from './useHostedCreation.ts'
+import {
+	clearHostedSession,
+	hostedCreate,
+	hostedDefault,
+	hostedSync,
+	onHostedPackAttemptStarted,
+	setInstanceMode,
+} from '../helpers/hosted-packs.ts'
 
 import {
 	openSkinSiteLogin,
 	receiveSkinSiteMessage,
 	requestSkinSiteLuck,
+	requestSkinSiteDownloadToken,
 	requestSkinSitePlayers,
 	requestSkinSiteSkinUpdate,
 	resetSkinSiteSession,
@@ -17,6 +28,233 @@ import {
 	skinSiteUser,
 } from './skin-site-session.ts'
 
+test('hosted installation sends the JWT to native commands while Local needs no session', async () => {
+	const previousWindow = Object.getOwnPropertyDescriptor(globalThis, 'window')
+	const calls: Array<{ command: string; args: Record<string, unknown> }> = []
+	let syncResponse: (() => Promise<unknown>) | undefined
+	let createdId = 'instance'
+	let instanceExists = false
+	let tokenRequests = 0
+	const frame = {
+		postMessage(data: { type: string; requestId: string }) {
+			if (data.type !== 'starlight-pack-token-request') return
+			tokenRequests++
+			receiveSkinSiteMessage(
+				{
+					origin: SKIN_SITE_ORIGIN,
+					source: frame,
+					data: {
+						type: 'starlight-pack-token-result',
+						requestId: data.requestId,
+						token: 'site.jwt.secret',
+					},
+				} as MessageEvent,
+				frame,
+			)
+		},
+	} as unknown as Window
+	Object.defineProperty(globalThis, 'window', {
+		configurable: true,
+		value: {
+			__TAURI_INTERNALS__: {
+				async invoke(command: string, args: Record<string, unknown>) {
+					calls.push({ command, args })
+					if (command === 'plugin:install|hosted_sync' && syncResponse) return syncResponse()
+					if (command === 'plugin:instance|instance_get')
+						return instanceExists ? { id: args.instanceId } : null
+					return command === 'plugin:install|hosted_create' ? createdId : null
+				},
+			},
+		},
+	})
+	try {
+		resetSkinSiteSession()
+		setSkinSiteFrame(frame)
+		receiveSkinSiteMessage(
+			{
+				origin: SKIN_SITE_ORIGIN,
+				source: frame,
+				data: {
+					type: 'starlight-skin-session',
+					status: 'signed-in',
+					user: { uuid: 'site', username: 'Site' },
+				},
+			} as MessageEvent,
+			frame,
+		)
+		await hostedDefault()
+		assert.equal(await hostedCreate(), 'instance')
+		await hostedSync('instance')
+		await setInstanceMode('instance', 'starlight')
+		assert.equal(tokenRequests, 4)
+		assert.deepEqual(
+			calls.map(({ command }) => command),
+			[
+				'hosted_set_session',
+				'hosted_default',
+				'hosted_set_session',
+				'hosted_create',
+				'hosted_set_session',
+				'hosted_sync',
+				'hosted_set_session',
+				'hosted_set_instance_mode',
+			].map((name) => `plugin:install|${name}`),
+		)
+		for (const call of calls.filter(({ command }) => command.endsWith('hosted_set_session'))) {
+			assert.equal(call.args.token, 'site.jwt.secret')
+		}
+		let rejectSync!: (error: unknown) => void
+		let syncCalls = 0
+		syncResponse = () => {
+			syncCalls++
+			return new Promise((_, reject) => {
+				rejectSync = reject
+			})
+		}
+		const originalPage = useHostedSync(() => 'shared-progress-instance')
+		const pendingSync = originalPage.sync()
+		const reopenedPage = useHostedSync(() => 'shared-progress-instance')
+		assert.equal(reopenedPage.busy.value, true)
+		assert.equal(useHostedSync(() => 'other-instance').busy.value, false)
+		await reopenedPage.sync()
+		await new Promise((resolve) => setImmediate(resolve))
+		assert.equal(syncCalls, 1)
+		rejectSync({ message: 'download interrupted' })
+		await pendingSync
+		assert.equal(reopenedPage.busy.value, false)
+		assert.match(reopenedPage.error.value, /download interrupted/)
+		assert.equal(
+			useHostedSync(() => 'shared-progress-instance').error.value,
+			reopenedPage.error.value,
+		)
+		syncResponse = async () => ({ revision: 'new-version' })
+		await reopenedPage.sync()
+		assert.equal(originalPage.error.value, '')
+		assert.deepEqual(originalPage.result.value, { revision: 'new-version' })
+
+		const creation = useHostedCreation()
+		createdId = 'deleted-instance'
+		syncResponse = async () => {
+			throw new Error('download failed')
+		}
+		await creation.install()
+		assert.equal(creation.createdInstance.value, 'deleted-instance')
+		assert.match(creation.installError.value, /download failed/)
+		createdId = 'replacement-instance'
+		syncResponse = async () => ({
+			version: '1',
+			downloadedBytes: 0,
+			changedFiles: 0,
+			preservedFiles: [],
+		})
+		const retryCallStart = calls.length
+		assert.equal(await creation.install(), 'replacement-instance')
+		assert.equal(calls[retryCallStart].command, 'plugin:instance|instance_get')
+		assert.equal(
+			calls.filter((call) => call.command.endsWith('|hosted_sync')).at(-1)?.args.instanceId,
+			'replacement-instance',
+		)
+		assert.equal(creation.installError.value, '')
+		forgetHostedCreation('unrelated-instance')
+		assert.equal(creation.completed.value, true)
+		forgetHostedCreation('replacement-instance')
+		assert.equal(creation.createdInstance.value, undefined)
+		assert.equal(creation.completed.value, false)
+		createdId = 'third-instance'
+		syncResponse = () =>
+			new Promise((_, reject) => {
+				rejectSync = reject
+			})
+		const deletedDuringSync = creation.install()
+		await new Promise((resolve) => setImmediate(resolve))
+		forgetHostedCreation('third-instance')
+		rejectSync(new Error('Unknown instance'))
+		await deletedDuringSync
+		assert.equal(creation.installError.value, '')
+		assert.equal(creation.createdInstance.value, undefined)
+		createdId = 'existing-instance'
+		syncResponse = async () => {
+			throw new Error('download interrupted')
+		}
+		await creation.install()
+		instanceExists = true
+		syncResponse = async () => ({
+			version: '1',
+			downloadedBytes: 0,
+			changedFiles: 0,
+			preservedFiles: [],
+		})
+		const createCount = calls.filter((call) => call.command.endsWith('|hosted_create')).length
+		assert.equal(await creation.install(), 'existing-instance')
+		assert.equal(
+			calls.filter((call) => call.command.endsWith('|hosted_create')).length,
+			createCount,
+		)
+		creation.acknowledge('existing-instance')
+		const requestsBeforeLogout = tokenRequests
+		resetSkinSiteSession()
+		await clearHostedSession()
+		assert.equal(calls.at(-1)!.args.token, null)
+		await setInstanceMode('instance', 'local')
+		assert.equal(tokenRequests, requestsBeforeLogout)
+		const attempts: string[] = []
+		const stopListening = onHostedPackAttemptStarted((id) => attempts.push(id))
+		const unauthenticatedRetry = hostedSync('failed-instance')
+		assert.deepEqual(attempts, ['failed-instance'])
+		await assert.rejects(unauthenticatedRetry)
+		stopListening()
+		await assert.rejects(hostedSync('failed-instance'))
+		assert.equal(attempts.length, 1)
+		await assert.rejects(hostedCreate(), /无需选择玩家/)
+	} finally {
+		resetSkinSiteSession()
+		setSkinSiteFrame(null)
+		if (previousWindow) Object.defineProperty(globalThis, 'window', previousWindow)
+		else Reflect.deleteProperty(globalThis, 'window')
+	}
+})
+
+test('pack download gets the site JWT without choosing a player and rejects stale replies', async () => {
+	const sent: Array<{ type: string; requestId: string }> = []
+	const frame = {
+		postMessage(data: { type: string; requestId: string }) {
+			sent.push(data)
+		},
+	} as unknown as Window
+	const receive = (data: unknown, origin = SKIN_SITE_ORIGIN) =>
+		receiveSkinSiteMessage(
+			{
+				origin,
+				source: frame,
+				data,
+			} as MessageEvent,
+			frame,
+		)
+	resetSkinSiteSession()
+	setSkinSiteFrame(frame)
+	await assert.rejects(requestSkinSiteDownloadToken(), /无需选择玩家/)
+	receive({
+		type: 'starlight-skin-session',
+		status: 'signed-in',
+		user: { uuid: 'site-user', username: 'Site' },
+	})
+	const token = requestSkinSiteDownloadToken()
+	const requestId = sent.at(-1)!.requestId
+	const reply = { type: 'starlight-pack-token-result', requestId, token: 'site.jwt.secret' }
+	assert.equal(receive(reply, 'https://evil.example'), false)
+	assert.equal(receive(reply), true)
+	assert.equal(await token, 'site.jwt.secret')
+	assert.equal(skinSitePlayers.value.length, 0)
+	assert.equal(JSON.stringify(skinSiteUser.value).includes('secret'), false)
+	const stale = requestSkinSiteDownloadToken()
+	const staleId = sent.at(-1)!.requestId
+	const rejected = assert.rejects(stale, /登录状态已变化/)
+	resetSkinSiteSession()
+	await rejected
+	assert.equal(receive({ ...reply, requestId: staleId }), false)
+	setSkinSiteFrame(null)
+})
+
 test('skin site session accepts only the embedded origin and window, and redirects after verification', () => {
 	const frame = {} as Window
 	const message = (status: string, user?: unknown) =>

apps/app-frontend/src/composables/skin-site-session.ts

@@ -24,6 +24,49 @@ let connectedFrame: Window | null = null
 let luckRequestSequence = 0
 let playersRequestSequence = 0
 let skinUpdateRequestSequence = 0
+let packTokenRequestSequence = 0
+const pendingPackTokens = new Map<
+	string,
+	{
+		resolve: (token: string) => void
+		reject: (error: Error) => void
+		timeout: ReturnType<typeof setTimeout>
+	}
+>()
+
+function rejectPendingPackTokens() {
+	for (const request of pendingPackTokens.values()) {
+		clearTimeout(request.timeout)
+		request.reject(new Error('StarLight 登录状态已变化，请重试。'))
+	}
+	pendingPackTokens.clear()
+}
+
+export function requestSkinSiteDownloadToken(): Promise<string> {
+	if (!connectedFrame || status.value !== 'signed-in' || !user.value) {
+		return Promise.reject(
+			new Error('请先在启动器中登录 StarLight 皮肤站，再下载整合包。无需选择玩家。'),
+		)
+	}
+	const requestId = `pack-token-${Date.now()}-${++packTokenRequestSequence}`
+	return new Promise((resolve, reject) => {
+		const timeout = setTimeout(() => {
+			pendingPackTokens.delete(requestId)
+			reject(new Error('获取 StarLight 登录凭据超时，请重试。'))
+		}, 10_000)
+		pendingPackTokens.set(requestId, { resolve, reject, timeout })
+		try {
+			connectedFrame?.postMessage(
+				{ type: 'starlight-pack-token-request', requestId },
+				SKIN_SITE_ORIGIN,
+			)
+		} catch {
+			clearTimeout(timeout)
+			pendingPackTokens.delete(requestId)
+			reject(new Error('无法读取 StarLight 登录状态，请重新登录。'))
+		}
+	})
+}
 
 type PendingLuckRequest = {
 	resolve: (luck: number) => void
@@ -96,6 +139,7 @@ function rejectPendingSkinUpdateRequests(message: string) {
 
 export function setSkinSiteFrame(frame: Window | null) {
 	if (connectedFrame === frame) return
+	rejectPendingPackTokens()
 	rejectPendingLuckRequests('The skin site connection changed.')
 	rejectPendingPlayersRequests('The skin site connection changed.')
 	rejectPendingSkinUpdateRequests('The skin site connection changed.')
@@ -115,6 +159,7 @@ export function openSkinSiteLogin() {
 }
 
 export function resetSkinSiteSession() {
+	rejectPendingPackTokens()
 	rejectPendingLuckRequests('The skin site session ended.')
 	rejectPendingPlayersRequests('The skin site session ended.')
 	rejectPendingSkinUpdateRequests('The skin site session ended.')
@@ -224,6 +269,22 @@ export function receiveSkinSiteMessage(event: MessageEvent, frame: Window | null
 	if (!frame || event.source !== frame || event.origin !== SKIN_SITE_ORIGIN) return false
 	const data = event.data
 	if (!data || typeof data !== 'object') return false
+	if (data.type === 'starlight-pack-token-result') {
+		const pending = pendingPackTokens.get(data.requestId)
+		if (!pending) return false
+		clearTimeout(pending.timeout)
+		pendingPackTokens.delete(data.requestId)
+		if (
+			status.value === 'signed-in' &&
+			typeof data.token === 'string' &&
+			data.token.length > 0 &&
+			data.token.length <= 16_384 &&
+			!/\s/.test(data.token)
+		) {
+			pending.resolve(data.token)
+		} else pending.reject(new Error('StarLight 登录凭据不可用，请重新登录。'))
+		return true
+	}
 
 	if (data.type === 'starlight-skin-players-result') {
 		if (typeof data.requestId !== 'string') return false
@@ -331,6 +392,7 @@ export function receiveSkinSiteMessage(event: MessageEvent, frame: Window | null
 		)
 			return false
 		if (user.value?.uuid && user.value.uuid !== data.user.uuid) {
+			rejectPendingPackTokens()
 			rejectPendingPlayersRequests('The skin site account changed.')
 			rejectPendingSkinUpdateRequests('The skin site account changed.')
 			players.value = []
@@ -343,6 +405,7 @@ export function receiveSkinSiteMessage(event: MessageEvent, frame: Window | null
 		}
 		refreshPlayers = true
 	} else {
+		rejectPendingPackTokens()
 		rejectPendingLuckRequests('The skin site session is unavailable.')
 		rejectPendingPlayersRequests('The skin site session is unavailable.')
 		rejectPendingSkinUpdateRequests('The skin site session is unavailable.')

apps/app-frontend/src/composables/useHostedCreation.ts

@@ -0,0 +1,56 @@
+import { ref } from 'vue'
+import { invoke } from '@tauri-apps/api/core'
+import { hostedCreate, hostedSync } from '../helpers/hosted-packs.ts'
+
+const installing = ref(false)
+const installError = ref('')
+const createdInstance = ref<string>()
+const completed = ref(false)
+let generation = 0
+
+export function forgetHostedCreation(instanceId: string) {
+	if (createdInstance.value !== instanceId) return
+	generation++
+	createdInstance.value = undefined
+	completed.value = false
+	installError.value = ''
+}
+
+export function useHostedCreation() {
+	function acknowledge(instanceId: string) {
+		if (completed.value && createdInstance.value === instanceId) {
+			createdInstance.value = undefined
+			completed.value = false
+		}
+	}
+	async function install() {
+		if (installing.value) return
+		installing.value = true
+		installError.value = ''
+		const attempt = generation
+		try {
+			if (createdInstance.value) {
+				const instance = await invoke<unknown | null>('plugin:instance|instance_get', {
+					instanceId: createdInstance.value,
+				})
+				if (attempt !== generation) return
+				if (!instance) {
+					createdInstance.value = undefined
+					completed.value = false
+				}
+			}
+			if (completed.value) return createdInstance.value
+			createdInstance.value ??= await hostedCreate()
+			const instanceId = createdInstance.value
+			await hostedSync(instanceId)
+			if (attempt !== generation) return
+			completed.value = true
+			return instanceId
+		} catch (cause) {
+			if (attempt === generation) installError.value = String(cause)
+		} finally {
+			installing.value = false
+		}
+	}
+	return { installing, installError, createdInstance, completed, acknowledge, install }
+}

apps/app-frontend/src/composables/useHostedSync.ts

@@ -0,0 +1,37 @@
+import { computed, reactive } from 'vue'
+import { hostedSync, type HostedSyncResult } from '../helpers/hosted-packs.ts'
+
+const tasks = reactive(
+	new Map<string, { busy: boolean; result: HostedSyncResult | null; error: string }>(),
+)
+
+export function useHostedSync(instanceId: () => string) {
+	const task = computed(() => {
+		const id = instanceId()
+		if (!tasks.has(id)) tasks.set(id, { busy: false, result: null, error: '' })
+		return tasks.get(id)!
+	})
+
+	async function sync() {
+		const id = instanceId()
+		const current = task.value
+		if (current.busy) return
+		current.busy = true
+		current.error = ''
+		current.result = null
+		try {
+			current.result = await hostedSync(id)
+		} catch (error) {
+			current.error = String(error)
+		} finally {
+			current.busy = false
+		}
+	}
+
+	return {
+		busy: computed(() => task.value.busy),
+		result: computed(() => task.value.result),
+		error: computed(() => task.value.error),
+		sync,
+	}
+}