[#3310140] Allow other modules to alter the destination route

Includes tests to demonstrate it working.

Added guard against bad values being return from a module's attempt to alter the path.

Updated the README with details, and added API file.