feat: server play frontend

.github/workflows/theseus-build.yml

@@ -16,6 +16,11 @@ on:
       - 'packages/utils/**'
   workflow_dispatch:
     inputs:
+      sign-macos-binaries:
+        description: Sign macOS binaries
+        type: boolean
+        default: false
+        required: false
       sign-windows-binaries:
         description: Sign Windows binaries
         type: boolean
@@ -170,9 +175,9 @@ jobs:
             dasel delete -f apps/app/tauri-release.conf.json 'bundle.windows.signCommand'
           fi
 
-      - name: Build macOS app
+      - name: Build signed macOS app
         run: ${{ (github.ref == 'refs/heads/main' || startsWith(github.ref, 'refs/tags/v') || inputs.app-version-override != '') && 'pnpm --filter=@modrinth/app run tauri build --target universal-apple-darwin --config tauri-release.conf.json' || 'pnpm --filter=@modrinth/app run tauri build --target universal-apple-darwin --config tauri-dev.conf.json' }}
-        if: contains(matrix.artifact-target-name, 'darwin')
+        if: contains(matrix.artifact-target-name, 'darwin') && (github.event_name != 'workflow_dispatch' || inputs.sign-macos-binaries)
         env:
           TAURI_BUNDLER_DMG_IGNORE_CI: 'true'
           ENABLE_CODE_SIGNING: ${{ secrets.APPLE_CERTIFICATE }}
@@ -185,6 +190,14 @@ jobs:
           TAURI_SIGNING_PRIVATE_KEY: ${{ secrets.TAURI_PRIVATE_KEY }}
           TAURI_SIGNING_PRIVATE_KEY_PASSWORD: ${{ secrets.TAURI_KEY_PASSWORD }}
 
+      - name: Build unsigned macOS app
+        run: ${{ (github.ref == 'refs/heads/main' || startsWith(github.ref, 'refs/tags/v') || inputs.app-version-override != '') && 'pnpm --filter=@modrinth/app run tauri build --target universal-apple-darwin --config tauri-release.conf.json' || 'pnpm --filter=@modrinth/app run tauri build --target universal-apple-darwin --config tauri-dev.conf.json' }}
+        if: contains(matrix.artifact-target-name, 'darwin') && github.event_name == 'workflow_dispatch' && !inputs.sign-macos-binaries
+        env:
+          TAURI_BUNDLER_DMG_IGNORE_CI: 'true'
+          TAURI_SIGNING_PRIVATE_KEY: ${{ secrets.TAURI_PRIVATE_KEY }}
+          TAURI_SIGNING_PRIVATE_KEY_PASSWORD: ${{ secrets.TAURI_KEY_PASSWORD }}
+
       - name: Build Linux app
         run: ${{ (github.ref == 'refs/heads/main' || startsWith(github.ref, 'refs/tags/v') || inputs.app-version-override != '') && 'pnpm --filter=@modrinth/app run tauri build --config tauri-release.conf.json' || 'pnpm --filter=@modrinth/app run tauri build --config tauri-dev.conf.json' }}
         if: contains(matrix.artifact-target-name, 'linux')

apps/app-frontend/src/App.vue

@@ -27,19 +27,27 @@ import {
 	commonSettingsMessages,
 	ContentInstallModal,
 	ContentUpdaterModal,
+	createServerInviteHandoff,
+	createServerOnboardingFlow,
 	CreationFlowModal,
 	defineMessages,
 	I18nDebugPanel,
 	IconButton,
 	LoadingBar,
 	NotificationPanel,
 	PopupNotificationPanel,
+	provideFileDownload,
+	provideIconCache,
 	provideLoadingState,
 	provideModalBehavior,
 	provideModrinthClient,
 	provideNotificationManager,
 	providePageContext,
 	providePopupNotificationManager,
+	provideServerInviteHandoff,
+	provideServerOnboardingFlow,
+	provideServerPlay,
+	ServerOnboardingModal,
 	TeleportOverflowMenu,
 	TooltipDirective,
 	useDebugLogger,
@@ -64,6 +72,7 @@ import { RouterView, useRoute, useRouter } from 'vue-router'
 import { useRouteLoading } from '@/app/runtime/use-route-loading'
 import AppSidebar from '@/app/shell/sidebar/index.vue'
 import AppTitleBar from '@/app/shell/title-bar/index.vue'
+import { trackExternalFileDownload } from '@/components/ui/download-manager/external-file-downloads'
 import ErrorModal from '@/components/ui/ErrorModal.vue'
 import HostingUpdateRequired from '@/components/ui/HostingUpdateRequired.vue'
 import AddServerToInstanceModal from '@/components/ui/install_flow/AddServerToInstanceModal.vue'
@@ -89,6 +98,12 @@ import { useInstanceMetadataRefresh } from '@/composables/use-instance-metadata-
 import { useQuickInstanceLimit } from '@/composables/use-quick-instance-limit.ts'
 import { isDarkTheme, useTheme } from '@/composables/use-theme.ts'
 import { config } from '@/config'
+import ServerPlayHandler from '@/features/hosting/play-handler.vue'
+import { prefetchHostingData } from '@/features/hosting/prefetch'
+import {
+	createInstanceLaunchState,
+	provideInstanceLaunchState,
+} from '@/features/instances/launch-state'
 import { provideMinecraftAccounts } from '@/features/minecraft-accounts/context'
 import NewUpdateModal from '@/features/updates/new-update-modal/index.vue'
 import { getAccountAppearance, rememberAccountAppearance } from '@/helpers/account-appearance.ts'
@@ -156,6 +171,8 @@ import {
 	instanceListQueryOptions,
 	screenshotKeys,
 } from '@/pages/instance/query-options'
+import { createFileDownload } from '@/platform/adapters/file-download'
+import { createIconCache } from '@/platform/adapters/icon-cache'
 import { createAppClient } from '@/platform/modrinth-client'
 import {
 	appUpdateState,
@@ -286,6 +303,12 @@ useAppEvent('ads_consent_required', handleAdsConsentRequired, appEvents)
 
 const tauriApiClient = createAppClient()
 provideModrinthClient(tauriApiClient)
+provideServerOnboardingFlow(createServerOnboardingFlow())
+provideServerInviteHandoff(createServerInviteHandoff())
+provideFileDownload(createFileDownload(tauriApiClient, trackExternalFileDownload))
+const iconCache = createIconCache()
+provideIconCache(iconCache)
+provideInstanceLaunchState(createInstanceLaunchState())
 const { data: authenticatedModrinthUser } = useQuery({
 	queryKey: computed(() => ['authenticated-user', 'campaigns', credentials.value?.user?.id]),
 	queryFn: () => tauriApiClient.labrinth.users_v3.getAuthenticated(),
@@ -807,8 +830,14 @@ async function setupApp() {
 }
 
 const stateFailed = ref(false)
-const { loading, canNavigateBack, canNavigateForward, onSuspensePending, onSuspenseResolve } =
-	useRouteLoading({ stateInitialized, stateFailed })
+const {
+	loading,
+	canNavigateBack,
+	canNavigateForward,
+	onboardingPageReady,
+	onSuspensePending,
+	onSuspenseResolve,
+} = useRouteLoading({ stateInitialized, stateFailed })
 provideLoadingState(loading)
 
 traceStartupStep('Initialize backend state', () => initialize_state(appEventChannel))
@@ -832,42 +861,19 @@ const handleClose = async () => {
 
 const queryClient = useQueryClient()
 
-watch(stateInitialized, (ready) => {
-	if (ready) {
-		queryClient.prefetchQuery({
-			queryKey: ['servers'],
-			queryFn: async () => {
-				const response = await tauriApiClient.archon.servers_v0.list({ limit: 100 })
-				const hasMedalServers = response.servers.some((s) => s.is_medal)
-				if (hasMedalServers) {
-					const subscriptions = await tauriApiClient.labrinth.billing_internal.getSubscriptions()
-					for (const server of response.servers) {
-						if (server.is_medal) {
-							const sub = subscriptions.find((s) => s.metadata?.id === server.server_id)
-							if (sub) {
-								server.medal_expires = new Date(
-									new Date(sub.created).getTime() + 5 * 86400000,
-								).toISOString()
-							}
-						}
-					}
-				}
-				return response
-			},
-			staleTime: 30_000,
-		})
-		queryClient.prefetchQuery({
-			queryKey: ['billing', 'subscriptions'],
-			queryFn: () => tauriApiClient.labrinth.billing_internal.getSubscriptions(),
-			staleTime: 30_000,
-		})
-		queryClient.prefetchQuery({
-			queryKey: ['billing', 'payments'],
-			queryFn: () => tauriApiClient.labrinth.billing_internal.getPayments(),
-			staleTime: 30_000,
-		})
-	}
-})
+watch(
+	() => stateInitialized.value && credentials.value?.session,
+	(session) => {
+		if (!session) return
+
+		void prefetchHostingData(
+			queryClient,
+			tauriApiClient,
+			iconCache,
+			() => credentials.value?.session === session,
+		)
+	},
+)
 
 const error = useError()
 const errorModal = ref()
@@ -957,6 +963,14 @@ const contentInstallModpackAlreadyInstalledModal = ref()
 const addServerToInstanceModal = ref()
 const incompatibilityWarningModal = ref()
 const installToPlayModal = ref()
+const serverPlayHandler = ref()
+const serverPlay = {
+	async play(target) {
+		if (!serverPlayHandler.value) throw new Error('Server play handler is not ready.')
+		await serverPlayHandler.value.play(target)
+	},
+}
+provideServerPlay(serverPlay)
 const sharedInstanceInviteHandler = ref()
 const updateToPlayModal = ref()
 
@@ -1537,6 +1551,8 @@ async function handleCommand(e) {
 		} else {
 			await run(e.id).catch(handleError)
 		}
+	} else if (e.event === 'PlayHostingServer') {
+		await serverPlay.play({ serverId: e.server_id, worldId: e.world_id }).catch(handleError)
 	} else if (e.event === 'InstallSharedInstanceInvite') {
 		await sharedInstanceInviteHandler.value?.installFromInviteId(e.invite_id)
 	} else if (e.event === 'InstallServer') {
@@ -2003,6 +2019,12 @@ provideAppUpdateDownloadProgress(appUpdateDownload)
 			@create="handleCreate"
 			@browse-modpacks="handleBrowseModpacks"
 		/>
+		<ServerOnboardingModal
+			browse-path="/browse/modpack"
+			:get-loader-manifest="getLoaderManifest"
+			:navigate="(to) => router.push(to)"
+			:page-ready="onboardingPageReady"
+		/>
 		<IconEditorModal
 			ref="creationIconEditorModal"
 			:config="creationGeneratedIcon?.config"
@@ -2272,6 +2294,7 @@ provideAppUpdateDownloadProgress(appUpdateDownload)
 		@create-anyway="handleContentInstallModpackDuplicateCreateAnyway"
 		@go-to-instance="handleContentInstallModpackDuplicateGoToInstance"
 	/>
+	<ServerPlayHandler ref="serverPlayHandler" />
 	<SharedInstanceInviteHandler ref="sharedInstanceInviteHandler" />
 	<InstallToPlayModal ref="installToPlayModal" :show-external-warnings="false" />
 	<UpdateToPlayModal ref="updateToPlayModal" :show-external-warnings="false" />

apps/app-frontend/src/app/runtime/use-route-loading.ts

@@ -16,6 +16,7 @@ export function useRouteLoading({ stateInitialized, stateFailed }: RouteLoadingO
 	const route = useRoute()
 	const canNavigateBack = ref(false)
 	const canNavigateForward = ref(false)
+	const onboardingPageReady = ref(true)
 	let initialLoadToken: symbol | null = null
 	let routerToken: symbol | null = null
 	let suspenseToken: symbol | null = null
@@ -81,13 +82,15 @@ export function useRouteLoading({ stateInitialized, stateFailed }: RouteLoadingO
 	})
 
 	function onSuspensePending() {
+		onboardingPageReady.value = false
 		debugStartup('Route Suspense pending', { route: route.path })
 		suspensePending = true
 		if (suspenseToken) loading.end(suspenseToken)
 		suspenseToken = loading.begin(`Route Suspense: ${route.path}`)
 	}
 
 	function onSuspenseResolve() {
+		onboardingPageReady.value = true
 		debugStartup('Route Suspense resolved', { route: route.path })
 		if (suspenseToken) {
 			loading.end(suspenseToken)
@@ -116,5 +119,12 @@ export function useRouteLoading({ stateInitialized, stateFailed }: RouteLoadingO
 		}
 	})
 
-	return { loading, canNavigateBack, canNavigateForward, onSuspensePending, onSuspenseResolve }
+	return {
+		loading,
+		canNavigateBack,
+		canNavigateForward,
+		onboardingPageReady,
+		onSuspensePending,
+		onSuspenseResolve,
+	}
 }

apps/app-frontend/src/components/ui/HostingUpdateRequired.vue

@@ -1,6 +1,6 @@
 <script setup lang="ts">
 import { DownloadIcon, ExcitedRinthbot, RefreshCwIcon, ServerStackIcon } from '@modrinth/assets'
-import { Button, commonMessages, defineMessages, useVIntl } from '@modrinth/ui'
+import { Button, defineMessages, useVIntl } from '@modrinth/ui'
 import { computed } from 'vue'
 
 import {
@@ -42,7 +42,7 @@ const messages = defineMessages({
 useRootBreadcrumb({
 	slot: 'root',
 	id: 'servers',
-	label: () => formatMessage(commonMessages.serversLabel),
+	label: 'Hosting',
 	to: '/hosting/manage/',
 	visual: { type: 'icon', component: ServerStackIcon },
 })

apps/app-frontend/src/components/ui/download-manager/download-manager-bar.vue

@@ -33,8 +33,8 @@ defineEmits<{ close: [] }>()
 
 const messages = defineMessages({
 	title: { id: 'app.download-manager.title', defaultMessage: 'Download manager' },
-	show: { id: 'app.download-manager.show', defaultMessage: 'Show installation tasks' },
-	hide: { id: 'app.download-manager.hide', defaultMessage: 'Hide installation tasks' },
+	show: { id: 'app.download-manager.show-tasks', defaultMessage: 'Show tasks' },
+	hide: { id: 'app.download-manager.hide-tasks', defaultMessage: 'Hide tasks' },
 	attention: { id: 'app.download-manager.attention', defaultMessage: 'Needs attention' },
 })
 

apps/app-frontend/src/components/ui/download-manager/download-manager-job.vue

@@ -4,6 +4,7 @@ import {
 	CheckIcon,
 	CopyIcon,
 	DownloadIcon,
+	MinecraftServerIcon,
 	PauseIcon,
 	PlayIcon,
 	TrashIcon,
@@ -20,6 +21,7 @@ import {
 	ProgressBar,
 	truncatedTooltip,
 	useRelativeTime,
+	useServerIcon,
 	useVIntl,
 } from '@modrinth/ui'
 import { computed, useTemplateRef } from 'vue'
@@ -28,6 +30,10 @@ import { RouterLink } from 'vue-router'
 import type { DownloadManagerJob } from './use-download-manager'
 
 const props = defineProps<{ job: DownloadManagerJob }>()
+const { icon: serverIcon } = useServerIcon(() => props.job.serverId ?? '')
+const displayIcon = computed(() =>
+	props.job.serverId ? (serverIcon.value ?? MinecraftServerIcon) : props.job.iconUrl,
+)
 defineEmits<{
 	retry: [id: string]
 	cancel: [id: string]
@@ -65,7 +71,7 @@ const cancelLabel = computed(() =>
 	formatMessage(
 		needsAttention.value
 			? messages.dismiss
-			: props.job.kind === 'debug-export'
+			: props.job.kind === 'external-file' || props.job.kind === 'debug-export'
 				? commonMessages.cancelButton
 				: messages.cancel,
 	),
@@ -94,8 +100,8 @@ const instanceLink = computed(() =>
 				@click="instanceLink && $emit('open')"
 			>
 				<Avatar
-					v-if="job.iconUrl"
-					:src="job.iconUrl"
+					v-if="displayIcon"
+					:src="displayIcon"
 					size="36px"
 					no-shadow
 					class="!rounded-xl border border-solid border-surface-5"
@@ -105,7 +111,9 @@ const instanceLink = computed(() =>
 					class="flex size-9 shrink-0 items-center justify-center rounded-xl border border-solid border-surface-5 bg-purple/10"
 				>
 					<component
-						:is="job.kind === 'debug-export' ? DownloadIcon : BoxIcon"
+						:is="
+							job.kind === 'external-file' || job.kind === 'debug-export' ? DownloadIcon : BoxIcon
+						"
 						class="size-6 text-primary"
 						aria-hidden="true"
 					/>
@@ -119,7 +127,7 @@ const instanceLink = computed(() =>
 						{{ job.title }}
 					</span>
 					<span
-						v-if="job.taskType && job.taskType !== job.text"
+						v-if="job.kind !== 'external-file' && job.taskType && job.taskType !== job.text"
 						class="truncate text-xs font-medium leading-4 text-primary"
 					>
 						{{ job.taskType }}
@@ -134,6 +142,12 @@ const instanceLink = computed(() =>
 								: 'text-primary'
 						"
 					>
+						<template
+							v-if="job.kind === 'external-file' && job.taskType && job.taskType !== job.text"
+						>
+							<span class="min-w-0 truncate text-primary">{{ job.taskType }}</span>
+							<BulletDivider class="shrink-0 text-primary" />
+						</template>
 						<template v-if="complete && job.finishedAt">
 							<time :datetime="job.finishedAt" class="shrink-0">
 								{{ formatRelativeTime(job.finishedAt) }}

apps/app-frontend/src/components/ui/download-manager/download-manager-panel.vue

@@ -44,7 +44,7 @@ const messages = defineMessages({
 		defaultMessage: 'Clear all completed tasks',
 	},
 	complete: { id: 'app.download-manager.complete', defaultMessage: 'Complete' },
-	empty: { id: 'app.download-manager.empty', defaultMessage: 'No installation tasks' },
+	empty: { id: 'app.download-manager.no-tasks', defaultMessage: 'No tasks' },
 	rate: { id: 'app.download-manager.estimated-rate', defaultMessage: 'Estimated download speed' },
 })
 const panel = useTemplateRef('panel')