feat: add /api/stats endpoint for drop statistics (110 tests)

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: alexandre-mrt

src/routes/drop.ts

@@ -164,3 +164,13 @@ dropRouter.get("/:id/download", async (c) => {
 		return c.json({ error: message }, 500);
 	}
 });
+
+// Public stats
+dropRouter.get("/stats", (c) => {
+	const stats = queries.stats.get();
+	return c.json({
+		totalDrops: stats?.total_drops ?? 0,
+		totalSize: stats?.total_size ?? 0,
+		totalDownloads: stats?.total_downloads ?? 0,
+	});
+});

src/services/db.ts

@@ -72,4 +72,8 @@ export const queries = {
 	recentDrops: db.prepare<DropRow, [string]>(
 		"SELECT * FROM drops WHERE ip_address = ? ORDER BY created_at DESC LIMIT 10",
 	),
+
+	stats: db.prepare<{ total_drops: number; total_size: number; total_downloads: number }, []>(
+		"SELECT COUNT(*) as total_drops, COALESCE(SUM(file_size), 0) as total_size, COALESCE(SUM(downloads), 0) as total_downloads FROM drops",
+	),
 };

tests/stats.test.ts

@@ -0,0 +1,42 @@
+import { describe, expect, test } from "bun:test";
+import { Hono } from "hono";
+
+process.env.DATABASE_URL = ":memory:";
+const { dropRouter } = await import("../src/routes/drop");
+const { queries } = await import("../src/services/db");
+
+const app = new Hono();
+app.route("/api", dropRouter);
+
+// Seed data
+queries.insertDrop.run({
+	$id: "stats-1", $rootHash: "0xs1", $fileName: "a.txt",
+	$fileSize: 1000, $mimeType: "text/plain", $passwordHash: null,
+	$maxDownloads: null, $expiresAt: null, $ipAddress: null,
+});
+queries.insertDrop.run({
+	$id: "stats-2", $rootHash: "0xs2", $fileName: "b.txt",
+	$fileSize: 2000, $mimeType: "text/plain", $passwordHash: null,
+	$maxDownloads: null, $expiresAt: null, $ipAddress: null,
+});
+queries.incrementDownloads.run("stats-1");
+queries.incrementDownloads.run("stats-1");
+queries.incrementDownloads.run("stats-2");
+
+describe("GET /api/stats", () => {
+	test("returns aggregate statistics", async () => {
+		const res = await app.request("/api/stats");
+		expect(res.status).toBe(200);
+		const json = await res.json();
+		expect(json.totalDrops).toBeGreaterThanOrEqual(2);
+		expect(json.totalSize).toBeGreaterThanOrEqual(3000);
+		expect(json.totalDownloads).toBeGreaterThanOrEqual(3);
+	});
+
+	test("returns numeric values", async () => {
+		const json = await (await app.request("/api/stats")).json();
+		expect(typeof json.totalDrops).toBe("number");
+		expect(typeof json.totalSize).toBe("number");
+		expect(typeof json.totalDownloads).toBe("number");
+	});
+});