40 lines
1.2 KiB
TypeScript
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,
|
|
});
|
|
}
|