app/lib/content/hashes.mjs

Functions

Imports

It imports app/lib/bytes.mjs. Imported by app/kb/procedures/compile.mjs, app/kb/registry/compile.mjs, app/lib/content/pipeline.mjs, app/lib/cv/compile.mjs, app/lib/dictionary/compile.mjs, app/lib/health/checks.server.ts, app/lib/llms/save.server.ts, app/lib/pages/compile.mjs, app/lib/phages/compile.mjs, app/lib/publications/compile.mjs, app/lib/roster/compile.mjs.

Source

1// Every writer and comparer of posts.source_blob_sha and posts.render_hash uses this module;
2// a second implementation is drift. The git header counts UTF-8 BYTES, not string.length.
3
4import { toHex } from "../bytes.mjs";
5
6const encoder = new TextEncoder();
7
8/**
9 * @param {"SHA-1" | "SHA-256"} algorithm
10 * @param {Uint8Array<ArrayBuffer>} bytes
11 * @returns {Promise<string>} lowercase hex
12 */
13async function digestHex(algorithm, bytes) {
14  const digest = await crypto.subtle.digest(algorithm, bytes);
15  return toHex(digest);
16}
17
18/**
19 * @param {string} source the whole file, frontmatter included
20 * @returns {Promise<string>}
21 */
22export async function gitBlobSha(source) {
23  const body = encoder.encode(source);
24  const header = encoder.encode(`blob ${body.byteLength}\0`);
25  const framed = new Uint8Array(header.byteLength + body.byteLength);
26  framed.set(header, 0);
27  framed.set(body, header.byteLength);
28  return digestHex("SHA-1", framed);
29}
30
31/**
32 * @param {string} html
33 * @returns {Promise<string>}
34 */
35export async function renderHash(html) {
36  return digestHex("SHA-256", encoder.encode(html));
37}