mirror of
https://github.com/MBombeck/HealthLog.git
synced 2026-11-19 08:12:52 +00:00
feat(nutrients): store daily nutrient targets per account
A nullable users.nutrient_targets_json column (migration 0499) holds a target or limit per catalog code in the code's canonical unit. GET and PATCH /api/nutrients/targets read and merge it behind the nutrients module; PATCH refuses unknown codes and values above the code's plausibility cap, and audits the codes set, never the amounts.
This commit is contained in:
1 parent
d32036b003
commit
a68ec9421f
6 files changed
+262
No files matched your search
@@ -0,0 +1,76 @@
|
||||
/**
|
||||
* GET / PATCH the caller's daily nutrient targets (#1402).
|
||||
*
|
||||
* Every target is optional and set by the person; there is no default. PATCH
|
||||
* replaces the codes the body names (`null` clears one) and keeps the rest; an
|
||||
* unknown code or an out-of-range value is refused with the multi-issue 422.
|
||||
* The targets live on their own `User` column (`nutrient_targets_json`);
|
||||
* `GET /api/nutrients/daily` and the MCP `get_nutrients` tool return the one
|
||||
* for the code they serve. Behind the opt-in `nutrients` module, like every
|
||||
* other nutrient route.
|
||||
*/
|
||||
import { apiHandler, requireAuth } from "@/lib/api-handler";
|
||||
import { apiSuccess, getClientIp } from "@/lib/api-response";
|
||||
import { parseJsonBody } from "@/lib/api/body";
|
||||
import { auditLog } from "@/lib/auth/audit";
|
||||
import { Prisma } from "@/generated/prisma/client";
|
||||
import { prisma, toJson } from "@/lib/db";
|
||||
import { annotate } from "@/lib/logging/context";
|
||||
import { requireModuleEnabled } from "@/lib/modules/gate";
|
||||
import { readNutrientTargets } from "@/lib/nutrients/targets";
|
||||
import {
|
||||
mergeNutrientTargets,
|
||||
nutrientTargetCodes,
|
||||
nutrientTargetsPatchSchema,
|
||||
} from "@/lib/validations/nutrient-targets";
|
||||
|
||||
export const dynamic = "force-dynamic";
|
||||
|
||||
export const GET = apiHandler(async () => {
|
||||
const { user } = await requireAuth();
|
||||
const gate = await requireModuleEnabled(user.id, "nutrients");
|
||||
if (!gate.enabled) return gate.response;
|
||||
|
||||
const targets = await readNutrientTargets(user.id);
|
||||
annotate({
|
||||
action: { name: "nutrient.targets.read" },
|
||||
meta: { set: nutrientTargetCodes(targets) },
|
||||
});
|
||||
return apiSuccess({ targets });
|
||||
});
|
||||
|
||||
export const PATCH = apiHandler(async (request: Request) => {
|
||||
const { user } = await requireAuth();
|
||||
const gate = await requireModuleEnabled(user.id, "nutrients");
|
||||
if (!gate.enabled) return gate.response;
|
||||
|
||||
const parsed = await parseJsonBody(request, nutrientTargetsPatchSchema, {
|
||||
maxBytes: 8 * 1024,
|
||||
action: "nutrient.targets.validation-failed",
|
||||
});
|
||||
if (!parsed.ok) return parsed.error;
|
||||
|
||||
const next = mergeNutrientTargets(
|
||||
await readNutrientTargets(user.id),
|
||||
parsed.data,
|
||||
);
|
||||
const set = nutrientTargetCodes(next);
|
||||
await prisma.user.update({
|
||||
where: { id: user.id },
|
||||
data: {
|
||||
nutrientTargetsJson: set.length === 0 ? Prisma.DbNull : toJson(next),
|
||||
},
|
||||
});
|
||||
|
||||
// Codes only, never the amounts: a target is a health figure.
|
||||
await auditLog("nutrient.targets.update", {
|
||||
userId: user.id,
|
||||
ipAddress: getClientIp(request),
|
||||
details: { set },
|
||||
});
|
||||
annotate({
|
||||
action: { name: "nutrient.targets.update" },
|
||||
meta: { set },
|
||||
});
|
||||
return apiSuccess({ targets: next });
|
||||
});
|
||||
File renamed without changes.
@@ -0,0 +1,19 @@
|
||||
/**
|
||||
* The read side of the person's daily nutrient targets (#1402), shared by the
|
||||
* targets route, the daily series and the MCP `get_nutrients` tool.
|
||||
*/
|
||||
import { prisma } from "@/lib/db";
|
||||
import {
|
||||
parseNutrientTargets,
|
||||
type NutrientTargets,
|
||||
} from "@/lib/validations/nutrient-targets";
|
||||
|
||||
export async function readNutrientTargets(
|
||||
userId: string,
|
||||
): Promise<NutrientTargets> {
|
||||
const row = await prisma.user.findUnique({
|
||||
where: { id: userId },
|
||||
select: { nutrientTargetsJson: true },
|
||||
});
|
||||
return parseNutrientTargets(row?.nutrientTargetsJson ?? null);
|
||||
}
|
||||
@@ -0,0 +1,141 @@
|
||||
/**
|
||||
* Daily nutrient targets a person sets for themselves (#1402).
|
||||
*
|
||||
* Stored in `User.nutrientTargetsJson`, keyed by catalog code. Each target is
|
||||
* an amount in the code's canonical unit and a direction: `target` is an
|
||||
* amount to reach (protein), `limit` one to stay under (sugar, sodium). Every
|
||||
* code is optional and `null` clears it; an account that never set one stores
|
||||
* nothing. The charts prefer the person's own number over the dietary
|
||||
* reference; nothing here judges whether a target is sensible beyond the
|
||||
* code's plausibility cap, which only stops a unit slip.
|
||||
*/
|
||||
import { z } from "zod/v4";
|
||||
|
||||
import {
|
||||
NUTRIENT_CATALOG,
|
||||
NUTRIENT_CODES,
|
||||
type NutrientCode,
|
||||
} from "@/lib/nutrients/catalog";
|
||||
|
||||
export interface NutrientTarget {
|
||||
value: number;
|
||||
direction: "target" | "limit";
|
||||
}
|
||||
|
||||
/** The resolved targets: only the codes that carry one. */
|
||||
export type NutrientTargets = Partial<Record<NutrientCode, NutrientTarget>>;
|
||||
|
||||
function targetSchema(code: NutrientCode) {
|
||||
return z
|
||||
.object({
|
||||
value: z
|
||||
.number()
|
||||
.finite()
|
||||
.positive()
|
||||
.max(NUTRIENT_CATALOG[code].plausibleDailyMax),
|
||||
direction: z.enum(["target", "limit"]),
|
||||
})
|
||||
.strict();
|
||||
}
|
||||
|
||||
const targetShape = Object.fromEntries(
|
||||
NUTRIENT_CODES.map((code) => [
|
||||
code,
|
||||
targetSchema(code).nullable().optional(),
|
||||
]),
|
||||
) as Record<
|
||||
NutrientCode,
|
||||
z.ZodOptional<z.ZodNullable<ReturnType<typeof targetSchema>>>
|
||||
>;
|
||||
|
||||
/**
|
||||
* The PATCH body: `targets` names the codes to change, each a target or
|
||||
* `null` to clear it. An unknown code is refused.
|
||||
*/
|
||||
export const nutrientTargetsPatchSchema = z
|
||||
.object({
|
||||
targets: z
|
||||
.object(targetShape)
|
||||
.strict()
|
||||
.describe(
|
||||
"The codes to change, each `{ value, direction }` in the code's canonical unit (see the catalogue) or `null` to clear it. Codes left out stay as they were. `value` is above 0 and at most the code's plausibility cap.",
|
||||
),
|
||||
})
|
||||
.strict()
|
||||
.meta({
|
||||
id: "NutrientTargetsPatchRequest",
|
||||
description: "Set or clear daily nutrient targets, code by code.",
|
||||
});
|
||||
|
||||
export type NutrientTargetsPatch = z.infer<typeof nutrientTargetsPatchSchema>;
|
||||
|
||||
export const nutrientTargetsResponseSchema = z
|
||||
.object({
|
||||
targets: z
|
||||
.record(
|
||||
z.string(),
|
||||
z.object({
|
||||
value: z.number(),
|
||||
direction: z.enum(["target", "limit"]),
|
||||
}),
|
||||
)
|
||||
.describe(
|
||||
"Only the codes that carry a target. Decode unknown keys leniently.",
|
||||
),
|
||||
})
|
||||
.meta({
|
||||
id: "NutrientTargets",
|
||||
description:
|
||||
"The daily nutrient targets the user set, keyed by catalog code, each in the code's canonical unit.",
|
||||
});
|
||||
|
||||
/** Whether one stored entry is a valid target for `code`. */
|
||||
export function parseNutrientTarget(
|
||||
code: NutrientCode,
|
||||
raw: unknown,
|
||||
): NutrientTarget | null {
|
||||
const parsed = targetSchema(code).safeParse(raw);
|
||||
return parsed.success ? parsed.data : null;
|
||||
}
|
||||
|
||||
/**
|
||||
* Read a stored value. Anything that does not parse (a hand-edited row, a
|
||||
* code a later release removed) reads code by code: a valid target survives,
|
||||
* an invalid one reads as not set. Never throws.
|
||||
*/
|
||||
export function parseNutrientTargets(raw: unknown): NutrientTargets {
|
||||
const out: NutrientTargets = {};
|
||||
if (raw === null || typeof raw !== "object" || Array.isArray(raw)) {
|
||||
return out;
|
||||
}
|
||||
const record = raw as Record<string, unknown>;
|
||||
for (const code of NUTRIENT_CODES) {
|
||||
const target = parseNutrientTarget(code, record[code]);
|
||||
if (target)
|
||||
out[code] = { value: target.value, direction: target.direction };
|
||||
}
|
||||
return out;
|
||||
}
|
||||
|
||||
/**
|
||||
* Apply a validated PATCH: a code the body names replaces the stored target
|
||||
* (`null` clears it), a code it leaves out stays. Built code by code, never by
|
||||
* spreading the body.
|
||||
*/
|
||||
export function mergeNutrientTargets(
|
||||
current: NutrientTargets,
|
||||
patch: NutrientTargetsPatch,
|
||||
): NutrientTargets {
|
||||
const next: NutrientTargets = {};
|
||||
for (const code of NUTRIENT_CODES) {
|
||||
const change = patch.targets[code];
|
||||
const kept = change === undefined ? current[code] : change;
|
||||
if (kept) next[code] = { value: kept.value, direction: kept.direction };
|
||||
}
|
||||
return next;
|
||||
}
|
||||
|
||||
/** The codes that carry a target, in catalogue order. */
|
||||
export function nutrientTargetCodes(targets: NutrientTargets): NutrientCode[] {
|
||||
return NUTRIENT_CODES.filter((code) => targets[code] !== undefined);
|
||||
}
|
||||
Reference in new issue
Block a user