Expose swagger schema

[rizo]

Exposes the internal Swagger schema in the public interface of the library. This is useful for use cases when the Swagger schema needs to be generated programatically by, for example, HTTP APIs.

I think at some point it would be nice to split the code generator from the type definitions and JSON encoders. In this PR I tried to be conservative and kept backwards compatibility.