Find current page type and which products are on the page?

Within an Add-On (extension), how do I programmatically ascertain the current page type (product page, category page, cart etc.) and find out which products (IDs) are displayed on the current page?

I see a PageType enum in the Javadoc but I don't know which API to use to get at it.

Thanks...