Winglet.Party.Client 0.4.0

Winglet.Party.Client

Typed .NET 10 client for the Winglet.Party API v1.

Package version: 0.4.0, aligned with Winglet.Client 0.2.0 and Winglet.Party.Contracts 0.2.0.

The reusable Party request and response types are owned by Winglet.Party.Contracts and are brought transitively by this package. The Client package owns HTTP, DI, routes, headers and Party-specific error semantics; Winglet.Client owns generic transport, authentication delegation, correlation and Problem Details handling. Consumers that use the contracts directly should import Winglet.Party.Contracts.

Registration

Configure Winglet:Clients:Party:BaseUrl and register the shared client pipeline:

services.AddPartyClient(configuration);

The shared Winglet.Client infrastructure supplies authentication, correlation and transport error handling. Configure its supported token provider; this package never creates or parses JWTs.

Usage

var party = await client.GetPartyAsync(partyId);
var matches = await client.SearchPartiesAsync(new Winglet.Party.Contracts.PartySearchRequest(Query: "Acme"));
await client.UpdateNameAsync(partyId, name, party.ETag!);
var check = await client.StartCheckAsync(partyId, new PartyCheckStartRequest("identity", operationId), "check-key");
var challenge = await client.StartContactPointVerificationAsync(partyId, contactId, contactPointId, "verification-key");
await client.ConfirmContactPointVerificationAsync(partyId, contactId, contactPointId, challenge.Id, new ConfirmContactPointVerificationRequest(proof));

Write operations accept an explicit If-Match ETag and applicable caller-supplied Idempotency-Key. No hidden cache or retry identity is created. PartyConflictException represents HTTP 409 and PartyConcurrencyException HTTP 412.

The client intentionally omits internal/smoke endpoints and does not add /self in this release. It also does not add generated SDK tooling, JWT handling, tenant inference or client-side polling.

Migration from 0.2.0

Winglet.Party.Client 0.2.0 remains unchanged and must not be overwritten. Upgrade to 0.4.0; add using Winglet.Party.Contracts (or fully qualify the types) for Party request/response DTOs that previously came from the Client assembly. Winglet.Client.ResourceResponse<T> remains owned by Winglet.Client. Winglet.Party.Contracts may be referenced directly when a consumer needs wire models without the HTTP client.

External Stamp creation remains intentionally omitted from the typed Client; the host exposes it, but no current service-to-service consumer requirement justifies expanding the Client surface merely for endpoint symmetry. /self is likewise delegated-human functionality rather than ordinary service-to-service usage.