feat: add a public statistics page (#826)

* feat: add a public statistics page

* hmm

* Update +layout.svelte

Author: baseplate-admin

src/backend/app/models/information.py

@@ -1,8 +1,7 @@
-from datetime import datetime, timedelta, timezone
 from http import HTTPStatus
 
 from fastapi import APIRouter, BackgroundTasks, HTTPException
-from sqlmodel import col, func, select
+from sqlmodel import col, select
 
 from app.deps import CurrentUser, PaginationDep, SessionDep
 from app.models.files import (
@@ -22,60 +21,8 @@ async def show_all_files(
     session: SessionDep,
     pagination: PaginationDep,
 ):
-    now = datetime.now(timezone.utc)
-    soon = now + timedelta(days=1)
-
-    # Total bytes
-    sum_bytes_query = select(func.coalesce(func.sum(File.size), 0)).select_from(File)
-    total_bytes = (await session.exec(sum_bytes_query)).one()
-
-    # Active URLs
-    active_urls_query = (
-        select(func.count())
-        .select_from(File)
-        .where(
-            (File.expires_at >= now)
-            & (File.download_count < File.expire_after_n_download)
-        )
-    )
-    active_urls = (await session.exec(active_urls_query)).one()
-
-    # Expiring soon (within 24h and not already expired)
-    expiring_soon_query = (
-        select(func.count())
-        .select_from(File)
-        .where(
-            (File.expires_at >= now)
-            & (File.expires_at <= soon)
-            & (File.download_count < File.expire_after_n_download)
-        )
-    )
-    expiring_soon = (await session.exec(expiring_soon_query)).one()
-
-    # Links with download caps
-    # Assuming any file has a download cap as it's not nullable in DB
-    links_with_download_caps_query = select(func.count()).select_from(File)
-    links_with_download_caps = (
-        await session.exec(links_with_download_caps_query)
-    ).one()
-
-    # Latest expiry
-    latest_expiry_query = select(func.max(File.expires_at)).where(
-        (File.expires_at >= now) & (File.download_count < File.expire_after_n_download)
-    )
-    latest_expiry = (await session.exec(latest_expiry_query)).one()
-
-    meta = {
-        "total_bytes": total_bytes,
-        "active_urls": active_urls,
-        "links_with_download_caps": links_with_download_caps,
-        "expiring_soon": expiring_soon,
-    }
-    if latest_expiry:
-        meta["latest_expiry"] = int(latest_expiry.timestamp())
-
     return await paginate(
-        select(File).order_by(col(File.id).desc()), session, pagination, meta=meta
+        select(File).order_by(col(File.id).desc()), session, pagination
     )
 
 

src/backend/app/routes/http/admin/files.py

@@ -1,16 +1,22 @@
+from app.schemas.information import InstanceStatisticsOut
 import contextlib
 import json
 import platform
+from datetime import datetime, timedelta, timezone
 
 from fastapi import (
     APIRouter,
     Request,
     __version__ as fastapi_version,
 )
 from sqlalchemy import text
+from sqlmodel import func, select
 
 from app.deps import RedisDep, SessionDep
-from app.models.information import InformationOut
+from app.models.files import (
+    File,
+)
+from app.schemas.information import InformationOut
 
 router = APIRouter()
 
@@ -66,3 +72,78 @@ async def get_instance_information(
         commit=build_info["commit"],
         is_release=build_info["is_release"],
     )
+
+
+@router.get("/instance/statistics")
+async def get_instance_statistics(
+    session: SessionDep,
+    redis: RedisDep,
+):
+    now = datetime.now(timezone.utc)
+    soon = now + timedelta(days=1)
+
+    # Redis Execution
+    active_rooms_keys = await redis.keys("chithi:room:*")
+    active_rooms = len(active_rooms_keys)
+
+    # Total bytes
+    sum_bytes_query = select(func.coalesce(func.sum(File.size), 0)).select_from(File)
+    total_bytes = (await session.exec(sum_bytes_query)).one()
+
+    # Total files
+    total_files_query = select(func.count()).select_from(File)
+    total_files = (await session.exec(total_files_query)).one()
+
+    # Total downloads
+    total_downloads_query = select(func.coalesce(func.sum(File.download_count), 0)).select_from(File)
+    total_downloads = (await session.exec(total_downloads_query)).one()
+
+    # Active URLs
+    active_urls_query = (
+        select(func.count())
+        .select_from(File)
+        .where(
+            (File.expires_at >= now)
+            & (File.download_count < File.expire_after_n_download)
+        )
+    )
+    active_urls = (await session.exec(active_urls_query)).one()
+
+    # Expiring soon (within 24h and not already expired)
+    expiring_soon_query = (
+        select(func.count())
+        .select_from(File)
+        .where(
+            (File.expires_at >= now)
+            & (File.expires_at <= soon)
+            & (File.download_count < File.expire_after_n_download)
+        )
+    )
+    expiring_soon = (await session.exec(expiring_soon_query)).one()
+
+    # Links with download caps
+    # Assuming any file has a download cap as it's not nullable in DB
+    links_with_download_caps_query = select(func.count()).select_from(File)
+    links_with_download_caps = (
+        await session.exec(links_with_download_caps_query)
+    ).one()
+
+    # Latest expiry
+    latest_expiry_query = select(func.max(File.expires_at)).where(
+        (File.expires_at >= now) & (File.download_count < File.expire_after_n_download)
+    )
+    latest_expiry = (await session.exec(latest_expiry_query)).one()
+
+    meta = {
+        "total_bytes": total_bytes,
+        "total_files": total_files,
+        "total_downloads": total_downloads,
+        "active_urls": active_urls,
+        "active_rooms": active_rooms,
+        "links_with_download_caps": links_with_download_caps,
+        "expiring_soon": expiring_soon,
+    }
+    if latest_expiry:
+        meta["latest_expiry"] = int(latest_expiry.timestamp())
+
+    return InstanceStatisticsOut(**meta)

src/backend/app/routes/http/instance.py

@@ -0,0 +1,30 @@
+from typing import Optional
+from sqlmodel import Field, SQLModel
+
+
+class InformationOut(SQLModel):
+    python_version: str
+    fastapi_version: str
+    redis_version: str
+    postgres_version: str
+    version: str
+    commit: str
+    is_release: bool
+
+
+class InstanceStatisticsOut(SQLModel):
+    total_bytes: int = Field(description="Total size of all stored files in bytes")
+    total_files: int = Field(description="Total number of files stored")
+    total_downloads: int = Field(description="Total number of downloads across all files")
+    active_urls: int = Field(description="Number of currently active URLs")
+    active_rooms: int = Field(description="Number of currently active reverse rooms")
+    links_with_download_caps: int = Field(
+        description="Total number of links with download limits"
+    )
+    expiring_soon: int = Field(
+        description="Number of URLs expiring within the next 24 hours"
+    )
+    latest_expiry: Optional[int] = Field(
+        default=None,
+        description="Unix timestamp of the latest expiry among active URLs",
+    )

src/backend/app/schemas/information.py

@@ -45,6 +45,10 @@ export class Api {
 		return this.#url('instance/information');
 	}
 
+	static get INSTANCE_STATISTICS() {
+		return this.#url('instance/statistics');
+	}
+
 	static get UPLOAD() {
 		return this.#url('upload');
 	}

src/frontend/src/lib/consts/backend.ts

@@ -20,13 +20,6 @@ export type PaginatedFiles = {
 	total_pages: number;
 	current_page: number;
 	current_page_size: number;
-	meta: {
-		total_bytes: number;
-		active_urls: number;
-		links_with_download_caps: number;
-		expiring_soon: number;
-		latest_expiry?: number;
-	};
 };
 
 const queryKey = ['admin-files'];

src/frontend/src/lib/queries/files.ts

@@ -11,10 +11,26 @@ const fetchInstanceInformation = async () => {
 	return res.json();
 };
 
+const fetchInstanceStatistics = async () => {
+	const res = await fetch(Api.INSTANCE_STATISTICS);
+	if (!res.ok) {
+		throw new Error('Failed to fetch instance statistics');
+	}
+	return res.json();
+};
+
 export const useInstanceInformationQuery = () => {
 	return createQuery(() => ({
-		queryKey,
+		queryKey: ['instance-information'],
 		queryFn: fetchInstanceInformation,
 		staleTime: 1000 * 60 * 5 // 5 minutes
 	}));
 };
+
+export const useInstanceStatisticsQuery = () => {
+	return createQuery(() => ({
+		queryKey: ['instance-statistics'],
+		queryFn: fetchInstanceStatistics,
+		staleTime: 1000 * 60 * 5 // 5 minutes
+	}));
+};

src/frontend/src/lib/queries/instance.ts

@@ -2,10 +2,9 @@
 	import * as Dialog from '$lib/components/ui/dialog';
 	import { Button } from '$lib/components/ui/button';
 	import * as Pagination from '$lib/components/ui/pagination';
-	import { useFilesQuery, type FileInfo } from '#queries/files';
+	import { useFilesQuery } from '#queries/files';
 	import { toast } from 'svelte-sonner';
 	import { page } from '$app/state';
-	import UrlMetricsCard from './url_metrics_card.svelte';
 	import OutstandingUrlsCard from './outstanding_urls_card.svelte';
 
 	let currentPage = $state(1);
@@ -14,33 +13,6 @@
 	const { files, revokeFile } = useFilesQuery(() => currentPage, pageSize);
 
 	let totalItems = $derived(files.data?.total_items ?? 0);
-	let totalBytes = $derived(files.data?.meta?.total_bytes ?? 0);
-	let activeUrls = $derived(files.data?.meta?.active_urls ?? 0);
-	let linksWithDownloadCaps = $derived(files.data?.meta?.links_with_download_caps ?? 0);
-	let expiringSoon = $derived(files.data?.meta?.expiring_soon ?? 0);
-	let latestExpiryMs = $derived(
-		files.data?.meta?.latest_expiry ? files.data.meta.latest_expiry * 1000 : 0
-	);
-	let hasIndefiniteActiveUrls = $derived(activeUrls > 0 && !latestExpiryMs);
-
-	function formatDuration(ms: number) {
-		if (ms <= 0) return 'Now';
-		const totalMinutes = Math.ceil(ms / 60000);
-		const days = Math.floor(totalMinutes / (60 * 24));
-		const hours = Math.floor((totalMinutes % (60 * 24)) / 60);
-		const minutes = totalMinutes % 60;
-
-		if (days > 0) return `${days}d ${hours}h`;
-		if (hours > 0) return `${hours}h ${minutes}m`;
-		return `${minutes}m`;
-	}
-
-	let timeToClearLabel = $derived.by(() => {
-		if (activeUrls === 0) return 'Cleared';
-		if (hasIndefiniteActiveUrls) return 'Indefinite';
-		if (!latestExpiryMs) return 'Unknown';
-		return formatDuration(latestExpiryMs - Date.now());
-	});
 
 	// States
 	let isRevoking = $state(false);
@@ -87,13 +59,6 @@
 </div>
 
 <div class="space-y-6">
-	<UrlMetricsCard
-		totalUrls={totalItems}
-		{timeToClearLabel}
-		{totalBytes}
-		{linksWithDownloadCaps}
-		{expiringSoon}
-	/>
 	<OutstandingUrlsCard {files} {isRevoking} {openRevokeDialog} {formatDate} />
 
 	<div class="flex items-center justify-end py-4">