read
Reads one complete file without retaining a stream.
Return
fresh caller-owned bytes, or null when the file does not exist.
Parameters
path
canonical pack-relative lookup path, which may be absent from paths.
Throws
when the path is unsafe.
when the source cannot be read.
Reads one asset under inclusive encoded-byte and path ceilings. Streaming implementations must stop before allocating oversized input and close streams on success and failure. The default checks the already bounded original read result before a loader copy.
Return
fresh caller-owned bytes or null for an absent file.
Parameters
path
canonical source-relative path, which may be absent from paths.
limits
immutable limits tightened to remaining snapshot byte capacity.
Throws
when reading or a ceiling check fails.