just some comments clarification

Maybe I'm wrong, but it's more about "id" than "type". It does not help to understand the code (prettily documented otherwise, congrats !)