Typing and APIs

[pahjbo]

I just wanted to point out that there are two areas in the general code that are auto-generated from elsewhere and sometimes a deficiency in the code might be as a result of deficiencies in the auto-generation and it could be the case that problems are best solved by fixing the auto-generation rather than trying to work around it. There are some areas of existing concern that might need to be fixed

1. The underlying ProposalDM determines the API to the data model and the interaction with the database

   • where an existing field is actually a list - manipulations of the list might be sub-optimal.

2. The openapi definition that is generated from the Java api code is then further used to generate typescript type definitions for interacting with the API from the client side.

   • the openapi definition does not describe properly some of the places that an object might be referenced by the database key in the JSON or alternately by an actual instance of the object - this can sometimes lead to needing to do do some casting.