Files
mrp-qrcode/lib/qr.ts
T
jason fc5bce4868
Build and Push Docker Image / build (push) Successful in 1m6s
stage 4
2026-04-21 09:29:44 -05:00

40 lines
1.2 KiB
TypeScript

import { randomBytes } from "node:crypto";
import QRCode from "qrcode";
import { env } from "@/lib/env";
/**
* Operation QR tokens are opaque, URL-safe, high-entropy identifiers
* printed on traveler cards. 24 bytes = 192 bits of entropy, encoded
* as base64url -> 32 characters.
*/
export function generateQrToken(): string {
return randomBytes(24)
.toString("base64")
.replace(/\+/g, "-")
.replace(/\//g, "_")
.replace(/=+$/, "");
}
/**
* The payload baked into the QR image is a full absolute URL so any phone
* camera app (which opens scans in a browser) goes straight to the scan page.
* APP_URL must match the externally reachable origin — see docs/DEPLOY.md.
*/
export function scanUrlForToken(token: string): string {
const base = env.APP_URL.replace(/\/+$/, "");
return `${base}/op/scan/${token}`;
}
/**
* Render the scan URL as a data-URL PNG suitable for <img src=...> on the
* admin detail page and, later, on the printable traveler card. Error
* correction level M balances density against smudge tolerance on paper.
*/
export async function renderQrPng(token: string): Promise<string> {
return QRCode.toDataURL(scanUrlForToken(token), {
errorCorrectionLevel: "M",
margin: 1,
width: 256,
});
}