feat(api): upgrade /api/live to surety standard

src/lib/version.ts

@@ -0,0 +1,3 @@
+import pkg from "../../package.json" with { type: "json" };
+
+export const version = `v${pkg.version}`;

src/server.ts

@@ -1,21 +1,30 @@
 import { Hono } from "hono";
 import { extractClientIp } from "./utils/ip.js";
 import { lookupIp, type LookupResult } from "./services/ipLookup.js";
-import pkg from "../package.json" with { type: "json" };
+import { version } from "./lib/version.js";
 
 type LookupFn = (ip: string | null) => Promise<LookupResult | null>;
 
 const attribution =
   "IP2Region data provided by https://ip2region.net (Apache-2.0).";
 
+const bootedAt = Date.now();
+
 export function createApp(
   lookup: LookupFn = lookupIp,
   apiKey: string | undefined = process.env.ECHO_API_KEY,
 ) {
   const app = new Hono();
 
   app.get("/api/live", (c) => {
-    return c.json({ status: "ok", version: `v${pkg.version}` });
+    c.header("Cache-Control", "no-store");
+    return c.json({
+      status: "ok",
+      version,
+      component: "echo",
+      timestamp: new Date().toISOString(),
+      uptime: Math.round((Date.now() - bootedAt) / 1000),
+    });
   });
 
   app.get("/", (c) => {

tests/unit/health.test.ts

@@ -1,18 +1,25 @@
 import { describe, expect, test } from "bun:test";
 import { createApp } from "../../src/server.js";
-import pkg from "../../package.json" with { type: "json" };
+import { version } from "../../src/lib/version.js";
 
 const testApiKey = "test-secret-key";
 
 describe("GET /api/live", () => {
-  test("returns ok status and version", async () => {
+  test("returns surety-standard health response", async () => {
     const app = createApp();
     const res = await app.request("/api/live");
 
     expect(res.status).toBe(200);
+    expect(res.headers.get("cache-control")).toBe("no-store");
 
     const body = await res.json();
-    expect(body).toEqual({ status: "ok", version: `v${pkg.version}` });
+    expect(body.status).toBe("ok");
+    expect(body.version).toBe(version);
+    expect(body.component).toBe("echo");
+    expect(typeof body.timestamp).toBe("string");
+    expect(new Date(body.timestamp).toISOString()).toBe(body.timestamp);
+    expect(typeof body.uptime).toBe("number");
+    expect(body.uptime).toBeGreaterThanOrEqual(0);
   });
 });