feat(generator): restore model-generator and regenerate models from OpenAPI (#2)

* feat(generator): restore OpenAPI-driven model generator

Reintroduce tools/model-generator with OpenAPI Generator templates, spec fetch, and post-processing for model and enum output under src/main/java.

Co-authored-by: Cursor <cursoragent@cursor.com>

* chore(spec): refresh prime-public-spec.yaml from live OpenAPI

Update the committed Prime REST API spec to match the current public OpenAPI document.

Co-authored-by: Cursor <cursoragent@cursor.com>

* chore: regenerate models and enums from OpenAPI spec

Regenerate model/ and model/enums/ from the refreshed spec, including new cross-margin and staking types and XM naming alignment.

Co-authored-by: Cursor <cursoragent@cursor.com>

* fix: align service requests with spec and remove legacy APIs

Add staking metadata and validator provider fields, remove deprecated service aliases, and delete unused legacy request/response types superseded by canonical names.

Co-authored-by: Cursor <cursoragent@cursor.com>

* chore(release): bump to v1.10.0 and update CHANGELOG

Document customer-facing model, request, and removal changes for the OpenAPI sync release.

Co-authored-by: Cursor <cursoragent@cursor.com>

* address review: restore getPortfolioCounterpartyId on AdvancedTransferService

The OpenAPI spec tags this route under Advanced Transfer. Keep PortfoliosService
as a deprecated shim for backward compatibility.

Co-authored-by: Cursor <cursoragent@cursor.com>

* address review: update generated model headers and DateOfBirth primitives

Remove OpenAPI Generator attribution from generated file headers and convert
DateOfBirth year/month/day fields to int primitives via post-processor.

Co-authored-by: Cursor <cursoragent@cursor.com>

* address review: enforce XM acronym casing across generated models

Add post-processor normalization so Xm* type and accessor names become XM*
for parity with TS/Go SDKs, including case-variant file cleanup on regen.

Co-authored-by: Cursor <cursoragent@cursor.com>

* chore: regenerate models with updated generator formatting

Re-run the OpenAPI model generator to apply consistent 4-space indentation, expanded Javadoc blocks, and enum doc formatting across all 209 model and enum files.

Co-authored-by: Cursor <cursoragent@cursor.com>

* add make commands for format and run format

* update changelog date

---------

Co-authored-by: Cursor <cursoragent@cursor.com>

Author: nmorgan-cb

.gitignore

@@ -7,6 +7,8 @@ dependency-reduced-pom.xml
 .classpath
 .project
 .settings
+.factorypath
+.metadata/
 .claude/settings.local.json
 
 .envrc

CHANGELOG.md

@@ -1,5 +1,45 @@
 # Changelog
 
+## [1.10.0] - 2026-JUN-17
+
+### Added
+
+#### New & Updated Models
+
+- **`CrossMarginPrimeDerivativesEquityBreakdown`**, **`CrossMarginPrimeRiskNettingInfo`**, **`CrossMarginPrimeSpotEquityBreakdown`**, **`CrossMarginPrimeXMPosition`**: Cross-margin Prime overview breakdown types
+- **`CustomStablecoinRewardDetails`**: Custom stablecoin reward metadata
+- **`PrimeXMMarginCallThresholds`**, **`PrimeXMMarginRequirementBreakdown`**, **`PrimeXMMarginThreshold`**, **`PrimeXMOffsetCreditBreakdown`**: Prime XM margin detail types
+- **`WalletStakingMetadata`**: Wallet staking metadata payload
+- **`DateOfBirth`**: Date-of-birth value type
+- Regenerated models include class and field Javadoc from OpenAPI `title` / `description`
+
+#### New Enums
+
+- **`PrimeXMHealthStatus`**, **`PrimeXMMarginRequirementType`**, **`PrimeXMMarginThresholdType`**
+- **`XMControlStatus`**, **`XMEntityCallStatus`**, **`XMMarginLevel`**
+- **`ValidatorProvider`**: ETH validator service providers for staking unstake requests
+
+### Changed
+
+- **Cross-margin model renames** (update imports): `XmLoan` → **`XMLoan`**, `XmMarginCall` → **`XMMarginCall`**, `XmPosition` → **`XMPosition`**, `XmRiskNettingInfo` → **`XMRiskNettingInfo`**, `XmSummary` → **`XMSummary`**
+- **Cross-margin enum renames** (update imports): `XmCallStatus` → **`XMCallStatus`**, `XmCallType` → **`XMCallType`**, `XmControlStatus` → **`XMControlStatus`**, `XmEntityCallStatus` → **`XMEntityCallStatus`**, `XmLiquidationStatus` → **`XMLiquidationStatus`**, `XmParty` → **`XMParty`**
+- **`CreateStakeRequest`** / **`CreateUnstakeRequest`**: Added `metadata` (`WalletStakingMetadata`) for wallet staking initiate/unstake
+- **`PortfolioStakingUnstakeRequest`**: Added `validatorProvider` (`ValidatorProvider`) for portfolio unstake
+- Regenerated **`model/`** and **`model/enums/`** from the latest OpenAPI spec via restored **`tools/model-generator`**
+
+### Removed
+
+- **`TravelRuleEntry`**, **`TravelRuleWalletDetails`**, **`Vasp`**: Removed from the public OpenAPI spec
+- **`XmMarginLevel`**: Replaced by **`XMMarginLevel`** (wire values unchanged; update imports)
+- **`PositionsService.listAggregatePositions()`** / **`listPositions()`**: Use **`listAggregateEntityPositions()`** / **`listEntityPositions()`**
+- **`AdvancedTransferService.getPortfolioCounterpartyId()`**: Use **`PortfoliosService.getPortfolioCounterpartyId()`**
+- Unused legacy request/response types superseded by canonical names: **`ListUsersRequest`/`Response`** (use **`ListEntityUsersRequest`/`Response`**), **`CreateTransferRequest`/`Response`** (use **`CreateWalletTransferRequest`/`Response`**), **`CreateWithdrawalRequest`/`Response`** (use **`CreateWalletWithdrawalRequest`/`Response`**), **`CreatePortfolioStakeRequest`/`Response`** (use **`PortfolioStakingInitiateRequest`/`Response`**), **`CreatePortfolioUnstakeRequest`/`Response`** (use **`PortfolioStakingUnstakeRequest`/`Response`**), **`ClaimStakingRewardsRequest`/`Response`** (use **`ClaimRewardsRequest`/`Response`**), **`GetOrderRequest`/`Response`** (use **`GetOrderByOrderIdRequest`/`Response`**), **`ListAggregatePositionsRequest`/`Response`**, **`ListPositionsRequest`/`Response`**, **`advancedtransfer.GetPortfolioCounterpartyIdRequest`/`Response`**
+
+### Notes
+
+- Minor release: OpenAPI spec sync, regenerated models/enums, and service-layer request alignment. No new service methods.
+- Consumers on deprecated position/counterparty helpers or removed legacy types should migrate to the replacements listed above.
+
 ## [1.9.0] - 2026-06-03
 
 ### Changed
@@ -69,7 +109,7 @@
 - **`PositionsService.listAggregatePositions()`** / **`listPositions()`**: same routes as **`listAggregateEntityPositions()`** / **`listEntityPositions()`**; prefer the spec-aligned entity-named methods.
 - **`AdvancedTransferService.getPortfolioCounterpartyId()`**: prefer **`PortfoliosService.getPortfolioCounterpartyId()`** (same HTTP route).
 
-
+### Removed
 
 - **`tools/model-generator`**: removed; maintain models, requests, responses, and services against `apiSpec/prime-public-spec.yaml`
 - **`com.coinbase.prime.advancedtransfers`** package and **`AdvancedTransfersService`**: renamed to **`com.coinbase.prime.advancedtransfer`** and **`AdvancedTransferService`**; **`PrimeServiceFactory.createAdvancedTransfersService()`** replaced by **`createAdvancedTransferService()`**

Makefile

@@ -1,4 +1,10 @@
-.PHONY: fetch-spec
+.PHONY: fetch-spec compile format
 fetch-spec:
 	@mkdir -p apiSpec
 	@curl -fsSL -o apiSpec/prime-public-spec.yaml https://api.prime.coinbase.com/v1/openapi.yaml
+
+compile:
+	mvn -B compile
+
+format:
+	mvn -B spotless:apply