comi-logic/cfw-autumn
8
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
3,910 Commits 1 Branch 0 Tags
46cf3e97b49ce2be7244fc644f7c8eaecdaa99d8
Commit Graph

14 Commits

Author SHA1 Message Date
John Yeo
62113f2355 wip 2025-12-18 15:48:20 +00:00
John Yeo
c3ac0bca48 fix: merging entity cus feature legacy data and passing ctx down to version change module 2025-12-02 10:12:57 +00:00
John Yeo
a6791162a1 chore: renamed attachBody and checkoutParam models to prep for new version 2025-11-26 16:27:44 +00:00
John Yeo
265b93f39c chore: moved checkout to hono router 2025-11-26 14:58:01 +00:00
amianthus
51d36984d8 fix: 🐛 list customers 2025-11-24 14:17:52 +00:00
John Yeo
4e68c3dc9a feat: created new features API version 2025-11-14 15:59:39 +00:00
John Yeo
27be22b48b fix: passing all track / check test cases 2025-11-12 15:55:01 +00:00
John Yeo
92510ed9c0 feat: deduct from redis new api schema 2025-11-11 16:01:14 +00:00
John Yeo
fb2f3bbd71 wip 2025-10-25 12:50:56 +01:00
John Yeo
908dd62eb1 feat: new versioning system 2025-10-08 09:16:42 +01:00
John Yeo
eefaf5b6c3 wip 2025-10-07 11:15:53 +01:00
John Yeo
1847470403 feat: implement resource-based API versioning system with strong typing 
## Summary
Implemented a comprehensive API versioning system with resource-level version changes,
strong typing using Zod schemas, and a composable getApi* pattern.

## Key Changes

### Versioning Infrastructure
- **VersionChange base class**: Now strongly typed with Zod schemas (TNewSchema, TOldSchema, TDataSchema)
- **Bidirectional transforms**: `transformRequest` (old→new) and `transformResponse` (new→old)
- **Input + Data pattern**: `input` for version-specific data, `data` for additional context
- **applyVersionChanges**: Fixed TypeScript errors and added biome-ignore comments for necessary `any` types

### Resource Organization
- **Folder structure**: Each resource gets its own `changes/` folder
  - `shared/api/customers/changes/` - Customer-level changes
  - `shared/api/customers/cusProducts/changes/` - Product-level changes
  - `shared/api/customers/cusFeatures/changes/` - Feature-level changes

### Version Changes (Strongly Typed)
- **V0_2_ProductItems**: Products gained items field (V0_2+ → V0_1)
- **V1_2_FeaturesArrayToObject**: Features object ↔ array (V1_2 → V1_1)
- **V1_1_MergedResponse**: Merged customer response ↔ split (V1_1+ → V1_0)
- **V1_1_LegacyExpandInvoices**: Side-effect only (invoices auto-expand in V1_0)

### getApi* Pattern (server/src/internal/customers/cusUtils/apiCusUtils/)
- **getApiCusProduct**: Builds product in latest format, applies V0_2_ProductItems transform
- **getApiCusFeature**: Transforms balances (used→usage), applies V1_2_FeaturesArrayToObject
- **getApiCustomer**: Orchestrates products/features, merges, applies V1_1_MergedResponse

### V2 Handler Demo
- **handleGetCustomerV2**: Demonstrates zero version branching in handler
- Calls `getApiCustomer` which handles all versioning internally
- Side effects handled explicitly (expand invoices for V1_0)

## Type Safety
- All version changes use Zod schemas for input/output types
- Runtime validation with `parse()` ensures data integrity
- Compile-time type checking catches transformation errors
- Context data support via optional `data` parameter

## Benefits
✅ No scattered if-else version checks
✅ Composable resource-based architecture
✅ Strong typing with Zod schemas
✅ Self-documenting version changes
✅ Easy to add new versions

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
 2025-10-06 19:25:21 +01:00
John Yeo
feca672fab working on get api cus feature 2025-10-06 14:16:51 +01:00
John Yeo
e7a78bfc8d working on api versioning system 2025-10-06 10:03:12 +01:00