release: v0.6.0

[rhamzeh]

Description

Note: This is being rolled out first so that the v0.7.0 can focus on the .NET Standard 2.0 support, allowing users who face issues with that release to still be able to benefit from these other fixes.

Changes:

• feat: add support for start_time parameter in ReadChanges endpoint
• feat: update API definitions
• feat: support assertions context and contextual tuples
• feat: support contextual tuples in Expand
• feat!: support passing in name to filter in ListStores
• fix: remove dependency on OpenTelemetry.Api (chore: remove dependecy to OpenTelemetry.Api #100) - thanks @m4tchl0ck
• fix: limit default retries to 3 from 15 (fix : change default retry policy sdk-generator#420) - thanks @ovindu-a
• fix: ListRelations should not swallow errors
• chore(docs): replace readable names with uuid to discourage storing PII in OpenFGA (docs:replace readable names with uuid sdk-generator#433) - thanks @sccalabr

[!WARNING]
BREAKING CHANGES:

• The ListStores method now accepts a body parameter with an optional Name to filter the stores. This is a breaking change as it changes the method contract to allow passing in a body with the name.

What problem is being solved?

How is it being solved?

What changes are made to solve it?

References

Review Checklist

• I have clicked on "allow edits by maintainers".
• I have added documentation for new/changed functionality in this PR or in a PR to openfga.dev [Provide a link to any relevant PRs in the references section above]
• The correct base branch is being used, if not main
• I have added tests to validate that the change in functionality is working as expected

Summary by CodeRabbit

• Documentation

  • Updated changelog with a new v0.6.0 release section, date, features, fixes, and noted breaking changes.
  • Adjusted Unreleased link to track from v0.6.0.

• Chores

  • Bumped package version to 0.6.0.
  • Updated default user agent string to reflect version 0.6.0.

[coderabbitai]

Walkthrough

Version bump to 0.6.0 across SDK and project metadata, plus changelog updates introducing an Unreleased section and a new v0.6.0 release entry. Public constant Version and DefaultUserAgent updated; project file Version property updated. No code logic or control-flow changes.

Changes

Cohort / File(s)	Summary of Changes
Documentation CHANGELOG.md	Added Unreleased baseline for v0.6.0; added v0.6.0 release section with date, features, fixes, and a breaking change note; updated compare links from v0.5.1...HEAD to v0.6.0...HEAD.
SDK configuration constants src/OpenFga.Sdk/Configuration/Configuration.cs	Updated public constant Version from "0.5.1" to "0.6.0"; updated DefaultUserAgent string to reflect "0.6.0".
Project metadata src/OpenFga.Sdk/OpenFga.Sdk.csproj	Bumped <Version> property from 0.5.1 to 0.6.0.

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~3 minutes

Pre-merge checks and finishing touches

✅ Passed checks (3 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title Check	✅ Passed	The title succinctly communicates that this pull request is focused on releasing version 0.6.0, which aligns directly with the version updates in Configuration.cs, the project file, and the changelog, making it an accurate and clear summary of the primary change.
Docstring Coverage	✅ Passed	No functions found in the changes. Docstring coverage check skipped.

✨ Finishing touches

• 📝 Generate Docstrings

🧪 Generate unit tests

• Create PR with unit tests
• Post copyable unit tests in a comment
• Commit unit tests in branch release/v0.6.0

---

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.}

[codecov-commenter]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 31.69%. Comparing base (7d62993) to head (387f5d0).

❌ Your project status has failed because the head coverage (31.69%) is below the target coverage (80.00%). You can increase the head coverage or adjust the target coverage.

Additional details and impacted files

@@           Coverage Diff           @@
##             main     #125   +/-   ##
=======================================
  Coverage   31.69%   31.69%           
=======================================
  Files         135      135           
  Lines        6862     6862           
  Branches      900      900           
=======================================
  Hits         2175     2175           
  Misses       4499     4499           
  Partials      188      188           

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

[coderabbitai]

Actionable comments posted: 0

Caution

Some comments are outside the diff and can’t be posted inline due to platform limitations.

⚠️ Outside diff range comments (1)

src/OpenFga.Sdk/Configuration/Configuration.cs (1)

100-112: Bug: BasePath fallback uses ApiUrl in the ApiHost check (likely typo).

The second branch reads if (ApiHost != null && ApiUrl != ""), which prevents the deprecated ApiHost/Scheme fallback from ever triggering when ApiUrl is empty. Should check ApiHost instead of ApiUrl.

Apply:

-            if (ApiHost != null && ApiUrl != "") {
+            if (!string.IsNullOrEmpty(ApiHost)) {
                 return $"{ApiScheme ?? "https"}://{ApiHost}";
             }

🧹 Nitpick comments (1)

CHANGELOG.md (1)

19-21: Fix GitHub admonition formatting for the breaking changes.

Bare [!WARNING] won’t render as an admonition on GitHub without a blockquote. Either remove it (you already have “BREAKING CHANGES:”) or format properly.

-[!WARNING]
-BREAKING CHANGES:
+> [!WARNING]
+> BREAKING CHANGES:

📜 Review details

Configuration used: CodeRabbit UI

Review profile: CHILL

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between 7d62993 and 387f5d0.

📒 Files selected for processing (3)

• CHANGELOG.md (1 hunks)
• src/OpenFga.Sdk/Configuration/Configuration.cs (1 hunks)
• src/OpenFga.Sdk/OpenFga.Sdk.csproj (1 hunks)

🔇 Additional comments (3)

src/OpenFga.Sdk/Configuration/Configuration.cs (1)

76-79: Version and default User-Agent updated to 0.6.0 — good.

Aligned with the package version; no functional risk.

CHANGELOG.md (1)

3-7: Unreleased anchor and v0.6.0 section look correct.

Links and date align with the release.

src/OpenFga.Sdk/OpenFga.Sdk.csproj (1)

15-15: Verify no stale ‘0.5.1’ references remain

Version bump aligns with Configuration.Version and CHANGELOG. Manually search across the repo—for example:

grep -R --exclude-dir=bin --exclude-dir=obj -n '0\.5\.1' .