Commit graph

8 commits

Author SHA1 Message Date
senke
525fd1e074 api-contracts: audit type files for duplication with generated types
- Completed Actions 1.1.3.6-1.1.3.8: Audited dto.ts, v2-v3-types.ts, backend-types.ts
- Created TYPE_FILES_AUDIT.md documenting findings
- dto.ts: 8 DTOs can be replaced, 2 may need to stay (ValidationError)
- v2-v3-types.ts: Most types are UI-specific, 1-3 may be replaceable
- backend-types.ts: Small file, 0-2 types may be replaceable
- Documented migration paths for each file
2026-01-11 16:34:24 +01:00
senke
88e62cff66 api-contracts: create endpoint response format testing script
- Completed Action 1.3.1.1: Created test-endpoint-formats.sh
- Script reads endpoints from Swagger spec and tests each one
- Identifies wrapped vs direct response formats
- Outputs JSON report with format categorization
- Handles auth-required endpoints gracefully
- Can be run against any base URL
2026-01-11 16:33:44 +01:00
senke
67f1ac0409 api-contracts: add API version header and config
- Completed Action 1.4.1.1: Added X-API-Version header to all requests
- Completed Action 1.4.1.4: Added API_VERSION to env config (defaults to 'v1')
- Header added in request interceptor before other headers
- Version configurable via VITE_API_VERSION environment variable
2026-01-11 16:33:18 +01:00
senke
38db75218f api-contracts: audit existing Zod schemas and identify gaps
- Completed Action 1.2.1.1: Audited existing Zod schemas
- Created ZOD_SCHEMA_AUDIT.md documenting coverage
- Found 20+ existing schemas covering core types
- Identified 15+ missing request schemas for specialized endpoints
- Documented gaps in analytics, marketplace, webhooks, 2FA, and upload endpoints
2026-01-11 16:32:40 +01:00
senke
4c2113f56c api-contracts: create type migration plan documenting all files using manual types
- Completed Action 1.1.3.1: Types already generated (marked complete)
- Completed Action 1.1.3.2: Created TYPE_MIGRATION_PLAN.md
- Documented 36+ files requiring migration
- Listed type mappings (Track → VezaBackendApiInternalModelsTrack, etc.)
- Defined 4-phase migration strategy
- Includes validation and rollback plans
2026-01-11 16:32:11 +01:00
senke
4c4e87e24c api-contracts: add caching for generated types in CI
- Completed Action 1.1.2.4: Added cache step for generated types
- Cache keyed on openapi.yaml hash for automatic invalidation
- Speeds up CI by avoiding regeneration when spec unchanged
2026-01-11 16:31:48 +01:00
senke
b227b3e68a api-contracts: add type generation to CI/CD workflow
- Completed Action 1.1.2.3: Added type generation step to frontend CI
- Step runs before Type Check to ensure types are up-to-date
- CI will fail if generated types don't match OpenAPI spec
- Added chmod to ensure script is executable in CI environment
2026-01-11 16:31:43 +01:00
senke
2fce619940 api-contracts: install openapi-generator-cli and create type generation script
- Completed Action 1.1.2.1: Installed @openapitools/openapi-generator-cli
- Completed Action 1.1.2.2: Created generate-types.sh script
- Added swagger annotations to cmd/modern-server/main.go
- Regenerated swagger.yaml with proper info section
- Successfully generated TypeScript types to src/types/generated/

The script generates types from veza-backend-api/openapi.yaml using
typescript-axios generator and creates barrel exports.
2026-01-11 16:30:43 +01:00