Create strict typing

[Verdagio]

Seen as how we are using Typescript for this API we should be leveraging its type casting. This means that our objects are what we expect every time. With the absence of these types the code inherits some of the same shortcomings as raw JavaScript.

In the event that a type does not exist or contain all the data required for a variable we can create our own type (combine 2 or more types), and we can also use the object spread operator to combine objects together if necessary.

[Ryan-Gordon]

I agree with this suggestion. Type casting will definitely help add some predictability to how our responses are structured.
One point that makes this even more viable is the OpenAPI spec supports the use of Models to help mock out what a solution will look like.

I have prepared 3 models in the API spec but at the moment the API doesn't use them to cast results. This is a area of improvement for sure.
The three models I have already defined are Route, Busstop and Schedule. There are also 3 other models defined RoutesArray, StopsArray and SchedulesArray; Each of these is an array composed on the relevant type.
Example: RoutesArray is a JSON array of Routes models.

Assigning this to both of you also, either of you can take a crack at this also but if neither want to do it I will get it done.