feat(sdk): add ergonomic Resource constructors for authorization

[marythought]

Summary

• Add Resources utility class with forAttributeValues(String... fqns) and forRegisteredResourceValueFqn(String fqn) helpers
• Follows the same pattern as EntityIdentifiers from feat(sdk): add EntityIdentifier convenience constructors #346
• Reduces verbose nested protobuf builder chains to single-line calls

Before:

Resource.newBuilder()
    .setAttributeValues(
        Resource.AttributeValues.newBuilder()
            .addFqns("https://example.com/attr/department/value/finance"))
    .build();

After:

Resources.forAttributeValues("https://example.com/attr/department/value/finance");

Example — GetDecision authorization call:

import io.opentdf.platform.sdk.EntityIdentifiers;
import io.opentdf.platform.sdk.Resources;

GetDecisionRequest request = GetDecisionRequest.newBuilder()
    .setEntityIdentifier(EntityIdentifiers.forEmail("user@company.com"))
    .setAction(Action.newBuilder().setName("decrypt"))
    .setResource(Resources.forAttributeValues(
        "https://company.com/attr/clearance/value/confidential",
        "https://company.com/attr/department/value/finance"))
    .build();

GetDecisionResponse resp = sdk.getServices()
    .authorization()
    .getDecision(request)
    .get();

Test plan

• Unit tests for forAttributeValues (single, multiple, empty-string FQN, empty array throws)
• Unit tests for forRegisteredResourceValueFqn (valid + empty string)
• Null safety tests (null array, null element, null fqn all throw NPE)
• Full SDK test suite passes (157 tests, 0 failures)
• CI checks pass

🤖 Generated with Claude Code

[coderabbitai]

Warning

Rate limit exceeded

@marythought has exceeded the limit for the number of commits that can be reviewed per hour. Please wait 59 minutes and 38 seconds before requesting another review.

Your organization is not enrolled in usage-based pricing. Contact your admin to enable usage-based pricing to continue reviews beyond the rate limit, or try again in 59 minutes and 38 seconds.

⌛ How to resolve this issue?

After the wait time has elapsed, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

We recommend that you space out your commits to avoid hitting the rate limit.

🚦 How do rate limits work?

CodeRabbit enforces hourly rate limits for each developer per organization.

Our paid plans have higher rate limits than the trial, open-source and free plans. In all cases, we re-allow further reviews after a brief timeout.

Please see our FAQ for further information.

ℹ️ Review info

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: 3f9b63cc-37e7-45ae-a2cd-42ec09e39bbc

📥 Commits

Reviewing files that changed from the base of the PR and between 2c55e31 and 4690691.

📒 Files selected for processing (2)

• sdk/src/main/java/io/opentdf/platform/sdk/Resources.java
• sdk/src/test/java/io/opentdf/platform/sdk/ResourcesTest.java

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch DSPX-2815-resource-constructors

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[gemini-code-assist]

Code Review

This pull request introduces a new Resources utility class in the Java SDK to simplify the creation of Resource protocol buffer objects. It includes static factory methods forAttributeValues and forRegisteredResourceValueFqn, along with comprehensive unit tests covering various input scenarios and error handling. I have no feedback to provide.

[github-actions]

X-Test Results

✅ java-v0.13.0
✅ java-main
✅ js-main
✅ js-v0.13.0
✅ go-main
✅ go-v0.13.0

[sonarqubecloud]

Quality Gate passed

Issues
1 New issue
0 Accepted issues

Measures
0 Security Hotspots
100.0% Coverage on New Code
0.0% Duplication on New Code

See analysis details on SonarQube Cloud

[github-actions]

X-Test Results

✅ java-v0.13.0
✅ java-main
✅ js-main
✅ js-v0.13.0
✅ go-main
✅ go-v0.13.0

[marythought]

@coderabbitai review

[coderabbitai]

✅ Actions performed

Review triggered.

Note: CodeRabbit is an incremental review system and does not re-review already reviewed commits. This command is applicable only when automatic reviews are paused.