feat(ws): automate generation of types and HTTP client layer from Swagger definitions

Signed-off-by: Guilherme Caponetto <[email protected]>

Author: caponetto

workspaces/frontend/README.md

@@ -77,3 +77,25 @@ Automatically fix linting issues:
   ```bash
   npm run test:fix
   ```
+
+### API Types & Client Generation
+
+The TypeScript types and the HTTP client layer for interacting with the backend APIs are automatically generated from the backend's `swagger.json` file. This ensures the frontend remains aligned with the backend API contract at all times.
+
+#### Generated Code Location
+
+All generated files live in the `src/generated` directory.
+
+⚠️ Do not manually edit any files in this folder.
+
+#### Updating the Generated Code
+
+To update the generated code, first update the `swagger.version` file in the `scripts` directory to the desired commit hash of the backend's `swagger.json` file.
+
+Then run the following command to update the generated code:
+
+```bash
+npm run generate:api
+```
+
+Finally, make any necessary adaptations based on the changes in the generated code.