ThreadCount Community edition

Uniform stock management for healthcare linen rooms: the coordinator app, the phone counter and the staff app, for your own server. Built from 8685140 on 2026-09-13. Licensed under the Functional Source License (FSL-1.1-ALv2).

lib/twofactor.ts

@@ -0,0 +1,44 @@
+import { createHmac, timingSafeEqual } from "crypto";
+
+/* The short-lived ticket that carries "this password was correct" from the first step of sign-in
+ * to the second.
+ *
+ * It is emphatically not a session: it grants nothing on its own, is only accepted by the
+ * second-factor endpoint, and dies in five minutes. Keeping it stateless means a half-finished
+ * sign-in leaves nothing behind to clean up, and there is no table for an attacker to fill.
+ *
+ * It carries the password version, so a password changed between the two steps invalidates the
+ * ticket for exactly the same reason it invalidates a session.
+ */
+
+const TICKET_TTL_MS = 5 * 60 * 1000;
+
+function secret(): string {
+  const s = process.env.SESSION_SECRET;
+  if (!s) throw new Error("SESSION_SECRET is required");
+  return s;
+}
+
+const b64 = (b: Buffer) => b.toString("base64url");
+const sign = (payload: string) => b64(createHmac("sha256", secret()).update(`2fa.${payload}`).digest());
+
+export function mintTicket(userId: string, pv: string): string {
+  const payload = b64(Buffer.from(JSON.stringify({ uid: userId, pv, exp: Date.now() + TICKET_TTL_MS })));
+  return `${payload}.${sign(payload)}`;
+}
+
+export function readTicket(ticket: string): { uid: string; pv: string } | null {
+  const [payload, mac] = String(ticket || "").split(".");
+  if (!payload || !mac) return null;
+  const expect = sign(payload);
+  const a = Buffer.from(mac, "utf8");
+  const b = Buffer.from(expect, "utf8");
+  if (a.length !== b.length || !timingSafeEqual(a, b)) return null;
+  try {
+    const t = JSON.parse(Buffer.from(payload, "base64url").toString("utf8")) as { uid?: string; pv?: string; exp?: number };
+    if (!t.uid || !t.pv || !t.exp || t.exp < Date.now()) return null;
+    return { uid: t.uid, pv: t.pv };
+  } catch {
+    return null;
+  }
+}