Add Brenger API v2 client and models

[mrlkn]

Summary

• Add v2 Pydantic models for the new Brenger partner API (V2Address, V2Stop, V2Item, V2ShipmentCreateRequest, etc.)
• Add BrengerV2APIClient with endpoints: get_quote, create_shipment, get_shipment_status, cancel_shipment, get_refund
• Bump version to 2.0.0
• Keep v1 client and models intact for backward compatibility

Test plan

• Verify v2 client connects to Brenger staging API
• Test create_shipment with valid payload
• Confirm v1 client still works unchanged

🤖 Generated with Claude Code

[Copilot]

Pull request overview

This PR adds support for the Brenger partner API v2 by introducing new Pydantic models and a dedicated client class. The implementation maintains backward compatibility by keeping all v1 code intact while adding parallel v2 functionality.

Changes:

• Added v2 Pydantic models (V2Address, V2Stop, V2Item, V2Amount, V2Price, V2QuoteRequest, V2ShipmentCreateRequest, and various response models)
• Added BrengerV2APIClient with methods for quote, create_shipment, get_shipment_status, cancel_shipment, and get_refund
• Bumped version from 0.1.8 to 2.0.0

Reviewed changes

Copilot reviewed 3 out of 3 changed files in this pull request and generated 18 comments.

File	Description
pyproject.toml	Version bumped to 2.0.0
brenger/models.py	Added 14 new V2 model classes for the v2 API including request/response models for quotes, shipments, status, refunds, and webhooks
brenger/client.py	Added BrengerV2APIClient class with 5 API endpoint methods and error handling

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[Copilot]

The error handling assumes response.json() will always succeed on error responses (line 123). If the server returns a non-JSON response for a 4xx error, this will raise a JSONDecodeError and mask the actual error. Consider adding a try-except block around response.json() to handle cases where the error response is not valid JSON, falling back to response.text or a generic error message.

[Copilot]

Similar to create_shipment, response.json() is called twice here - once for logging (line 82) and once for returning the parsed response. While requests.Response.json() typically caches the result, it's more efficient and clearer to store the parsed JSON in a variable and reuse it.

[Copilot]

The error message formatting has inconsistent spacing. Line 130 has an extra space at the beginning (" Status code:"), line 131 has no space after the hyphen ("description: {error_description} -"), and line 132 has spaces around the hyphen ("- Error hint:"). For consistency with the V1 client error formatting (lines 56-59), all parts should follow the same spacing pattern.

Suggested change

	f" Status code: {response.status_code} - "
	f"Error description: {error_description} -"
	f" Error hint: {error_hint} - "
	f" validation errors: {error_validation}"
	f"Status code: {response.status_code} - "
	f"Error description: {error_description} - "
	f"Error hint: {error_hint} - "
	f"Validation errors: {error_validation}"

[Copilot]

The V2Amount model is missing strip_whitespace validation on string fields 'currency' and 'value'. Following the codebase convention that all string fields should have strip_whitespace validation to prevent Brenger API failures, these fields should have the validator applied.

Suggested change

	_strip_whitespace = field_validator("currency", "value", mode="before")(
	strip_whitespace
	)

[Copilot]

The V2Event and V2WebhookPayload models use string types for the 'timestamp' field. This is less type-safe and makes it harder to work with dates/times programmatically. Consider using datetime type with proper validators (similar to the shipping_date validation in ShipmentCreateRequest) to ensure timestamp parsing and validation, unless the API specifically requires string format in a non-standard way.

[Copilot]

The V2Address model is missing strip_whitespace validation on the 'country' and 'administrative_area' fields. Following the codebase convention that all string fields should have strip_whitespace validation to prevent Brenger API failures, these fields should be included in the validator along with line1, line2, postal_code, and locality.

Suggested change

	"line1", "line2", "postal_code", "locality", mode="before"
	"country",
	"administrative_area",
	"line1",
	"line2",
	"postal_code",
	"locality",
	mode="before",

[Copilot]

The V2Stop model is missing strip_whitespace validation on the 'preferred_locale' field. Following the codebase convention that all string fields should have strip_whitespace validation to prevent Brenger API failures, this field should be included in the validator.

Suggested change

	"email", "first_name", "last_name", "company_name", mode="before"
	"email",
	"first_name",
	"last_name",
	"company_name",
	"preferred_locale",
	mode="before",

[Copilot]

The V2QuoteRequest model is missing strip_whitespace validation on the 'external_reference' field. Following the codebase convention that all string fields should have strip_whitespace validation to prevent Brenger API failures, this field should have the validator applied.

Suggested change

	_strip_whitespace = field_validator("external_reference", mode="before")(
	strip_whitespace
	)

[Copilot]

The version bump from 0.1.8 to 2.0.0 appears to be too aggressive. According to semantic versioning, a major version increment (0.x.x to 2.0.0) should only occur when there are backward-incompatible changes. Since the PR description explicitly states "Keep v1 client and models intact for backward compatibility", this suggests the changes are backward compatible. A more appropriate version would be 0.2.0 or 1.0.0 (if graduating from beta), not 2.0.0.

Suggested change

	version = "2.0.0"
	version = "0.2.0"

[Copilot]

The V2QuoteResponse model uses Dict types for 'pickup' and 'delivery' fields instead of strongly-typed models. This is inconsistent with V2ShipmentCreateResponse which uses V2Stop. Using Dict reduces type safety and makes the response structure unclear. Consider using V2Stop or a similar typed model for consistency.