Skip to content

feat: implement contract compatibility validation (BE-32)#520

Open
neyij wants to merge 1 commit into
Pulsefy:mainfrom
neyij:feat/be-contract-compat
Open

feat: implement contract compatibility validation (BE-32)#520
neyij wants to merge 1 commit into
Pulsefy:mainfrom
neyij:feat/be-contract-compat

Conversation

@neyij
Copy link
Copy Markdown

@neyij neyij commented May 31, 2026

  • Add ContractCompatibilityService for version/schema checks
  • Add ContractCompatibilityGuard for write endpoint validation
  • Add ContractCompatibilityInterceptor for response metadata
  • Add contract compatibility DTOs and error codes
  • Add /contracts/compatibility/check endpoint
  • Add compatibility metadata to links/metadata and payment-links/status responses
  • Reject write requests with unsupported contract versions
  • Add unit tests for contract compatibility validation
  • Update ERROR-CODES.md with new contract compatibility error codes

Acceptance Criteria:

  • Unsupported clients receive deterministic, actionable errors
  • Compatibility metadata is consistent across endpoints
  • Upgrade rollouts do not break clients silently

Closes #418

- Add ContractCompatibilityService for version/schema checks
- Add ContractCompatibilityGuard for write endpoint validation
- Add ContractCompatibilityInterceptor for response metadata
- Add contract compatibility DTOs and error codes
- Add /contracts/compatibility/check endpoint
- Add compatibility metadata to links/metadata and payment-links/status responses
- Reject write requests with unsupported contract versions
- Add unit tests for contract compatibility validation
- Update ERROR-CODES.md with new contract compatibility error codes

Acceptance Criteria:
- Unsupported clients receive deterministic, actionable errors
- Compatibility metadata is consistent across endpoints
- Upgrade rollouts do not break clients silently
@drips-wave
Copy link
Copy Markdown

drips-wave Bot commented May 31, 2026

@neyij Great news! 🎉 Based on an automated assessment of this PR, the linked Wave issue(s) no longer count against your application limits.

You can now already apply to more issues while waiting for a review of this PR. Keep up the great work! 🚀

Learn more about application limits

@Cedarich
Copy link
Copy Markdown
Contributor

Please fix workflow

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

BE-32: Client Contract Compatibility Validation (Schema + Version Checks)

3 participants