release: v0.9.6

[SoulPancake]

Release-As: 0.9.6

Description

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

Release Notes v0.9.6

• New Features

  • Added dedicated APIExecutor examples.

• Bug Fixes

  • Corrected default retry parameters.
  • Prevented token refresh thundering herd issue.

• Documentation

  • Added guidance for parsing raw streams.

[coderabbitai]

Important

Review skipped

Auto incremental reviews are disabled on this repository.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: 0b623f06-9a80-4dad-8287-3462c7ac12fc

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

• 🔍 Trigger review

Walkthrough

This PR bumps the SDK version from 0.9.5 to 0.9.6 across the release manifest, version constant, package metadata, example dependencies, and changelog.

Changes

Version Release Bump

Layer / File(s)	Summary
Release Manifest .release-please-manifest.json	Release-please manifest version updated from 0.9.5 to 0.9.6.
Version Declaration constants/index.ts	SdkVersion constant updated from "0.9.5" to "0.9.6".
Package Metadata package.json	Root package version field updated from 0.9.5 to 0.9.6.
Example Dependencies example/example1/package.json, example/streamed-list-objects/package.json	@openfga/sdk dependency in examples updated from ^0.9.5 to ^0.9.6.
Release Documentation CHANGELOG.md	New entry for version 0.9.6 (2026-05-06) documenting added APIExecutor examples, fixed retry parameters and token refresh thundering herd, and parsing raw stream documentation.

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~3 minutes

Possibly related PRs

• openfga/js-sdk#365: Performs the same release bump changes across SdkVersion, package.json, example dependencies, and CHANGELOG.
• openfga/js-sdk#283: Modifies the same release-related files (package.json, CHANGELOG.md, example package deps) and updates SdkVersion.
• openfga/js-sdk#362: Updates release metadata and versioned files (.release-please-manifest.json, constants/index.ts SdkVersion, CHANGELOG, and package.json entries).

Suggested reviewers

• rhamzeh
• ewanharris

🚥 Pre-merge checks | ✅ 5

✅ Passed checks (5 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The title 'release: v0.9.6' directly matches the PR's primary objective of releasing version 0.9.6, with version bumps across all relevant files.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch release-please--branches--release

Tip

💬 Introducing Slack Agent: The best way for teams to turn conversations into code.

Slack Agent is built on CodeRabbit's deep understanding of your code, so your team can collaborate across the entire SDLC without losing context.

• Generate code and open pull requests
• Plan features and break down work
• Investigate incidents and troubleshoot customer tickets together
• Automate recurring tasks and respond to alerts with triggers
• Summarize progress and report instantly

Built for teams:

• Shared memory across your entire org—no repeating context
• Per-thread sandboxes to safely plan and execute work
• Governance built-in—scoped access, auditability, and budget controls

One agent for your entire SDLC. Right inside Slack.

👉 Get started

---

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 85.74%. Comparing base (1ca65d8) to head (c335fe1).

Additional details and impacted files

@@           Coverage Diff           @@
##             main     #397   +/-   ##
=======================================
  Coverage   85.74%   85.74%           
=======================================
  Files          25       25           
  Lines        1305     1305           
  Branches      265      265           
=======================================
  Hits         1119     1119           
  Misses        108      108           
  Partials       78       78           

☔ 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.
• 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

[dosubot]

Documentation Updates

2 document(s) were updated by changes in this PR:

Contextual Tuples Support

View Changes

@@ -8,7 +8,7 @@
 - **Write Assertions**: Supported from OpenFGA server v1.5.8+.
 - **ListUsers**: Supported from OpenFGA server v1.5.4+ (experimental, enable with `OPENFGA_EXPERIMENTALS=enable-list-users`).
 - **BatchCheck, ListObjects, ListRelations**: Supported in recent OpenFGA versions; see SDK and server documentation for details.
-- **JS SDK**: Contextual tuple support for assertions and Expand is available from v0.8.0+ (latest: v0.9.5) and requires OpenFGA server v1.8.0+ for full compatibility.
+- **JS SDK**: Contextual tuple support for assertions and Expand is available from v0.8.0+ (latest: v0.9.6) and requires OpenFGA server v1.8.0+ for full compatibility.
 
 ## Data Model Changes
 
@@ -115,7 +115,7 @@
 - **Expand**: OpenFGA server v1.8.0+.
 - **Write Assertions**: OpenFGA server v1.5.8+.
 - **ListUsers**: OpenFGA server v1.5.4+ (experimental, enable with `OPENFGA_EXPERIMENTALS=enable-list-users`).
-- **JS SDK**: v0.8.0+ (latest: v0.9.5) for contextual tuples in assertions and Expand (requires server v1.8.0+).
+- **JS SDK**: v0.8.0+ (latest: v0.9.6) for contextual tuples in assertions and Expand (requires server v1.8.0+).
 - **Conditional relationships (ABAC)**: Officially supported from OpenFGA v1.4.0+; enable with `enable-conditions` flag in earlier versions.
 - **Tuple validation constraints**: OpenFGA server v1.12.0+ (validation of Unicode control characters and null bytes in tuple fields).
 

Retry-After Header and Retry Strategy

View Changes

@@ -18,7 +18,7 @@
 ## SDK-Specific Details
 ### JavaScript SDK (`@openfga/sdk`)
 
-**Version Introduced:** v0.9.1 (Current version: v0.9.5)  
+**Version Introduced:** v0.9.1 (Current version: v0.9.6)  
 **[Changelog](https://github.com/openfga/js-sdk/blob/ca4b9fcf9eaed35170d44a4b3697f439b81187f6/CHANGELOG.md#L8-L10)**
 
 #### Node.js Version Support (JavaScript SDK)
@@ -61,7 +61,7 @@
 The SDK adds `executeApiRequest` and `executeStreamedApiRequest` methods to `OpenFgaClient` for calling arbitrary API endpoints with full SDK support (authentication, retries, telemetry, error handling).
 
 #### Migration Guidance
-- Upgrade to v0.9.5+ for the latest features and fixes.
+- Upgrade to v0.9.6+ for the latest features and fixes.
 - If you previously relied on custom retry logic, review the new defaults and configuration.
 - The minimum supported Node.js version is **v20.19.0** (v16 and v18 are no longer supported). Update your runtime accordingly.
 - The maximum allowed `maxRetry` is now enforced at 15.

^{How did I do? Any feedback?}  

[Copilot]

Pull request overview

This PR performs the release version bump to v0.9.6 across the SDK package metadata and release artifacts, and updates bundled example projects to depend on the new SDK version.

Changes:

• Bump SDK version from 0.9.5 → 0.9.6 in package.json, package-lock.json, and constants/index.ts.
• Add the 0.9.6 entry to CHANGELOG.md.
• Update example projects to reference @openfga/sdk@^0.9.6, and update the release-please manifest to 0.9.6.

Reviewed changes

Copilot reviewed 6 out of 7 changed files in this pull request and generated 1 comment.

Show a summary per file

File	Description
package.json	Bumps published package version to 0.9.6.
package-lock.json	Updates lockfile version metadata to 0.9.6.
constants/index.ts	Updates SdkVersion constant to 0.9.6.
CHANGELOG.md	Adds release notes section for 0.9.6.
.release-please-manifest.json	Updates release-please tracked version to 0.9.6.
example/example1/package.json	Updates example dependency to @openfga/sdk@^0.9.6.
example/streamed-list-objects/package.json	Updates example dependency to @openfga/sdk@^0.9.6.

Comments suppressed due to low confidence (2)

example/example1/package.json:16

• This example’s engines.node says >=16.13.0, but the SDK itself requires Node >=20.19.0 (per the root package). This can mislead users into running the example on an unsupported Node version; consider aligning the example’s engine requirement with the SDK’s.

    "@openfga/sdk": "^0.9.6"
  },
  "engines": {
    "node": ">=16.13.0"
  }

example/streamed-list-objects/package.json:17

• This example’s engines.node is >=16.15.0, but the SDK requires Node >=20.19.0. Also, this example has a committed package-lock.json that still pins @openfga/sdk to 0.9.5, so npm ci will keep installing the old version; the lockfile should be regenerated/updated to match the dependency bump.

  "dependencies": {
    "@openfga/sdk": "^0.9.6",
    "@openfga/syntax-transformer": "^0.2.0"
  },
  "engines": {
    "node": ">=16.15.0"
  }

---

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