app/lab/forms.mjs

Functions

Imports

It imports no other module of this repo. Imported by app/lab/inventory.server.ts, app/lab/members.server.ts, app/lab/runs.server.ts, app/routes/workspace.inventory.lot.tsx, app/routes/workspace.inventory.tsx, app/routes/workspace.runs.run.tsx.

Source

1/**
2 * What every /lab form reads the same way: a trimmed field, a real calendar date, today's date in UTC, and an amount.
3 * Pure, so the members, inventory and run pages refuse the same bad input with the same words.
4 */
5
6const DATE = /^\d{4}-\d{2}-\d{2}$/;
7
8/** A field's trimmed text, or "" when it is absent or a file. @param {FormData} form @param {string} name */
9export function field(form, name) {
10  const value = form.get(name);
11  return typeof value === "string" ? value.trim() : "";
12}
13
14/** A real calendar date in YYYY-MM-DD: 2027-02-30 and 2026-13-01 are not. @param {string} text */
15export function isDate(text) {
16  const ms = Date.parse(`${text}T00:00:00Z`);
17  return DATE.test(text) && !Number.isNaN(ms) && new Date(ms).toISOString().slice(0, 10) === text;
18}
19
20/** Today in UTC, as YYYY-MM-DD. @param {number} nowMs */
21export function today(nowMs) {
22  return new Date(nowMs).toISOString().slice(0, 10);
23}
24
25/**
26 * An optional amount: null when blank, a finite number of zero or more, or a refusal in words.
27 * @param {string} text
28 * @returns {{ ok: true, value: number | null } | { ok: false, reason: string }}
29 */
30export function amountOf(text) {
31  if (text === "") return { ok: true, value: null };
32  const value = Number(text);
33  if (!Number.isFinite(value) || value < 0) return { ok: false, reason: `Not an amount: ${text}.` };
34  return { ok: true, value };
35}
36
37/** A positive whole number from an address or a form, or null: "abc", "1.5" and "0" are not ids. @param {unknown} text */
38export function idOf(text) {
39  const id = Number(text);
40  return Number.isInteger(id) && id > 0 ? id : null;
41}
42
43/** "5 mL", or "5" when a lot has no unit. @param {number} amount @param {string | null} unit */
44export function amountText(amount, unit) {
45  return unit ? `${amount} ${unit}` : String(amount);
46}