feat(item): add Open Finance resources endpoint and Item fields

[cernadasjuan]

Draft until the corresponding Pluggy API release is live — see API availability below.

Summary

Adds SDK support for the resources a financial institution declares for an item's Open Finance consent.

• New endpoint — GET /items/{id}/resources:
  • service().getItemResources(itemId)
  • service().getItemResources(itemId, new ItemResourcesSearchRequest().page(1).pageSize(100).status(ItemResourceStatus.PENDING_AUTHORISATION))
  • Returns ItemResourcesResponse (page, total, totalPages, results), each result an ItemResource with resourceId, type and status.
  • Items on connectors other than Open Finance return an empty page, not an error.
• New ItemResponse fields:
  • resourcesCollectedAt (Date, nullable) — when the institution's resource list was last read; null if it never was. An empty resources page means the institution shared nothing only when this is set.
  • hasResourcesPendingAuthorization (Boolean, nullable) — Open Finance only. true when the institution declares at least one resource PENDING_AUTHORISATION (the user still has to approve it at their bank), false when the resource list was read and none is. null for connectors other than Open Finance, and while the resource list has not been read yet (resourcesCollectedAt is null), e.g. before the item's first execution finishes.

Modeling notes

• status is an enum, ItemResourceStatus (AVAILABLE, UNAVAILABLE, TEMPORARILY_UNAVAILABLE, PENDING_AUTHORISATION), following the existing @SerializedName enum pattern. PENDING_AUTHORISATION keeps Open Finance's British spelling. As with every enum in this SDK, a value added server-side later deserializes as null rather than failing.
• type is a String. The documented values are listed in the Javadoc, but other values can appear, and an enum would silently turn them into null.

API availability

GET /items/{id}/resources and Item.resourcesCollectedAt are already in the public spec (https://api.pluggy.ai/oas3.json). The status filter and Item.hasResourcesPendingAuthorization require the corresponding API release: before it, the API does not apply status (it returns every resource) and hasResourcesPendingAuthorization deserializes as null. Merge after that release.

Tests

• Unit (ItemResourcesTest, no network): request path and query params, page parsing, empty page, an undocumented type passed through, an unknown status parsed as null without throwing, and both new ItemResponse fields.
• Integration (GetItemResourcesTest): a non-Open-Finance sandbox item returns an empty page; a non-existing item returns 404.
• mvn -B package and mvn -B test (12 tests) pass locally.

Release

Bumps pom.xml to 1.14.0 (minor: feat commits since v1.13.0, this one and the unreleased health.incidents from #110), so merging cuts the v1.14.0 tag and GitHub Release. Publishing to GitHub Packages still has to be dispatched by hand after the merge:

gh workflow run maven-publish.yml -f tag_version=v1.14.0

🤖 Generated with Claude Code

[jhonatan-pluggy]

LGTM

[jhonatan-pluggy]

LGTM