mirror of
https://github.com/morluto/rea.git
synced 2026-11-20 05:32:44 +00:00
74 lines
2.3 KiB
TypeScript
74 lines
2.3 KiB
TypeScript
import type { AsarHeaderAdmission } from "../config/asarHeaderAdmission.js";
|
|
import { createHash } from "node:crypto";
|
|
import type { Readable } from "node:stream";
|
|
|
|
import { ArtifactReaderFailure } from "./ArtifactReader.js";
|
|
import { streamChunkToBuffer } from "./StreamBytes.js";
|
|
import {
|
|
createArtifactClassificationProbe,
|
|
type ArtifactClassificationEvidence,
|
|
} from "./ArtifactClassificationProbe.js";
|
|
|
|
/** Full stream digest and byte count with bounded classification evidence. */
|
|
export type HashResult = ArtifactClassificationEvidence & {
|
|
readonly sha256: string;
|
|
readonly bytes: number;
|
|
readonly md5?: string;
|
|
};
|
|
|
|
/** Preserve the inventory cancellation reason at a stream boundary. */
|
|
export const abortIfNeeded = (signal?: AbortSignal): void => {
|
|
if (signal?.aborted === true)
|
|
throw new ArtifactReaderFailure(
|
|
"cancelled",
|
|
"Artifact inventory cancelled",
|
|
{ cause: signal.reason },
|
|
);
|
|
};
|
|
|
|
/** Hash every stream byte and retain its bounded classification prefix. */
|
|
export const hashReadable = async (
|
|
stream: Readable,
|
|
signal?: AbortSignal,
|
|
integrityAlgorithm?: "sha256" | "md5",
|
|
asarHeaderAdmission?: AsarHeaderAdmission,
|
|
): Promise<HashResult> => {
|
|
const completed = await hashReadableToCompletion(
|
|
stream,
|
|
signal,
|
|
integrityAlgorithm,
|
|
asarHeaderAdmission,
|
|
);
|
|
abortIfNeeded(signal);
|
|
return completed;
|
|
};
|
|
|
|
/** Keep a fully delivered digest so its owner can validate before late cancellation.
|
|
* Source stability remains the stream or caller's responsibility.
|
|
*/
|
|
export const hashReadableToCompletion = async (
|
|
stream: Readable,
|
|
signal?: AbortSignal,
|
|
integrityAlgorithm?: "sha256" | "md5",
|
|
asarHeaderAdmission?: AsarHeaderAdmission,
|
|
): Promise<HashResult> => {
|
|
const hash = createHash("sha256");
|
|
const md5 = integrityAlgorithm === "md5" ? createHash("md5") : undefined;
|
|
const probe = createArtifactClassificationProbe(asarHeaderAdmission);
|
|
let bytes = 0;
|
|
for await (const raw of stream) {
|
|
abortIfNeeded(signal);
|
|
const chunk = streamChunkToBuffer(raw);
|
|
bytes += chunk.length;
|
|
hash.update(chunk);
|
|
md5?.update(chunk);
|
|
probe.write(chunk);
|
|
}
|
|
return {
|
|
sha256: hash.digest("hex"),
|
|
...(md5 === undefined ? {} : { md5: md5.digest("hex") }),
|
|
bytes,
|
|
...probe.finish(bytes),
|
|
};
|
|
};
|