src/portal-trends.ts

Functions

Imports

It imports src/env.ts, src/ops-feed.ts, src/portal-auth.ts, src/trends.ts. Imported by src/routes.ts.

Source

1import type { Env } from "./env";
2import { OPS_RETURN_TO } from "./ops-feed";
3import { portalGate } from "./portal-auth";
4import { readTrends } from "./trends";
5
6// The Portal's trends: GET /portal/api/trends?weeks= (design-portal-evaluation.md, DECIDE 5:
7// "admin, read-only", ruled 2026-10-09). The series behind the charts, from src/trends.ts.
8// A route, not a tool, so no grant is checked here (one enforcement point, test/route-gates.test.ts):
9// it answers to portalGate, and src/scope.ts lists it among the routes gated some other
10// way. It writes only its own hour-long CI cache.
11
12export const PORTAL_TRENDS_PATH = "/portal/api/trends";
13const DEFAULT_WEEKS = 8;
14const MAX_WEEKS = 26;
15
16/** GET /portal/api/trends: every series, the weekly ones over ?weeks= (1 to 26, default 8). */
17export async function handlePortalTrends(request: Request, env: Env, now: Date = new Date()): Promise<Response> {
18  const gate = await portalGate(request, env, now, OPS_RETURN_TO);
19  if (!gate.ok) return gate.response;
20  const raw = new URL(request.url).searchParams.get("weeks")?.trim();
21  const weeks = raw ? Number(raw) : DEFAULT_WEEKS;
22  if (!Number.isInteger(weeks) || weeks < 1 || weeks > MAX_WEEKS) {
23    return new Response(JSON.stringify({ error: `weeks must be a whole number from 1 to ${MAX_WEEKS}.` }), { status: 400, headers: { "Content-Type": "application/json", "Cache-Control": "no-store" } });
24  }
25  const body = await readTrends(env, now, weeks);
26  return new Response(JSON.stringify(body), { headers: { "Content-Type": "application/json", "Cache-Control": "no-store" } });
27}