mirror of
https://github.com/morluto/rea.git
synced 2026-11-22 06:25:44 +00:00
17 lines
714 B
TypeScript
17 lines
714 B
TypeScript
import { isStrictUtf8 } from "../domain/strictUtf8.js";
|
|
|
|
/** A filesystem basename is usable as a logical path only after UTF-8 validity is established. */
|
|
export type DirectoryEntryName =
|
|
| { readonly kind: "decoded"; readonly name: string }
|
|
| { readonly kind: "unrepresentable"; readonly rawHex: string };
|
|
|
|
/** Decode POSIX directory-entry bytes without allowing replacement-character aliases. */
|
|
export const decodeDirectoryEntryName = (
|
|
raw: string | Buffer,
|
|
): DirectoryEntryName => {
|
|
if (typeof raw === "string") return { kind: "decoded", name: raw };
|
|
return isStrictUtf8(raw)
|
|
? { kind: "decoded", name: raw.toString("utf8") }
|
|
: { kind: "unrepresentable", rawHex: raw.toString("hex") };
|
|
};
|