tweak the typescript declaration file, meant to provide with api caller just enough information, and hide all implementation detail.