feat: add branch support to browser extension plugin

[dkrizan]

Summary

• Add branch to DevCredentials type so overrideCredentials can pass branch to the SDK
• Read __tolgee_branch from sessionStorage in BrowserExtensionPlugin and include it in credentials
• Add branch to LibConfig type so the SDK sends its configured branch in the TOLGEE_READY handshake message
• Clear __tolgee_branch from sessionStorage on credential reset

Related PRs

• chrome-plugin: feat: add branching support chrome-plugin#38
• tolgee-platform: feat: add branchingEnabled to API key endpoint (chrome-extension) tolgee-platform#3536

Test plan

• Verify SDK reads branch from sessionStorage when set by chrome extension
• Verify ?branch=X query parameter is appended to translation API calls
• Verify SDK's own branch config is not overridden when sessionStorage key is absent
• Verify branch is included in TOLGEE_READY handshake message to the extension

Summary by CodeRabbit

• New Features
  • Added an optional "branch" configuration to the SDK and browser extension so users can target specific content branches and have that choice persist across sessions.
• Tests
  • Expanded test coverage to validate branch handling, propagation, and session persistence.

[coderabbitai]

Walkthrough

Adds an optional branch field to credential/config types, persists branch in sessionStorage via a new BRANCH_LOCAL_STORAGE constant, surfaces branch in BrowserExtensionPlugin credentials/config, and updates tests to cover SDK-provided and sessionStorage-provided branch propagation.

Changes

Cohort / File(s)	Summary
Core types packages/core/src/types/plugin.ts	Added optional branch?: string to the DevCredentials object shape.
Web types packages/web/src/package/tools/extension.ts	Added optional branch?: string to LibConfig.config.
Browser extension plugin packages/web/src/package/BrowserExtensionPlugin/BrowserExtensionPlugin.ts	Added export const BRANCH_LOCAL_STORAGE = '__tolgee_branch'; read/write/clear branch from sessionStorage; include branch in credentials and plugin config initialization.
Core tests packages/core/src/__test__/options.test.ts	Added tests verifying overrideCredentials accepts branch and that overriding credentials updates initial options.branch.
Web tests packages/web/src/package/__test__/browser.extension.test.ts	Imported BRANCH_LOCAL_STORAGE; added test cleanup; added tests ensuring branch propagation from SDK config and from sessionStorage; adjusted test payloads to include branch.

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~20 minutes

Poem

🐰 A tiny branch hops into place,
Stored in session with gentle grace,
From SDK to extension it will stream,
A quiet path for a new branch dream. 🌿

🚥 Pre-merge checks | ✅ 2 | ❌ 1

❌ Failed checks (1 warning)

Check name	Status	Explanation	Resolution
Docstring Coverage	⚠️ Warning	Docstring coverage is 0.00% which is insufficient. The required threshold is 80.00%.	Write docstrings for the functions missing them to satisfy the coverage threshold.

✅ Passed checks (2 passed)

Check name	Status	Explanation
Title check	✅ Passed	The title 'feat: add branch support to browser extension plugin' directly and concisely summarizes the main change: adding branch support to the browser extension plugin. It matches the primary objectives of the PR.
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.

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

✨ Finishing Touches

• 📝 Generate docstrings (stacked PR)
• 📝 Generate docstrings (commit on current branch)

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch dkrizan/chrome-plugin-branching

📝 Coding Plan

• Generate coding plan for human review comments

---

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

[coderabbitai]

Actionable comments posted: 1

🤖 Prompt for all review comments with AI agents

Verify each finding against the current code and only fix it if needed.

Inline comments:
In `@packages/web/src/package/BrowserExtensionPlugin/BrowserExtensionPlugin.ts`:
- Around line 18-22: getCredentials currently always returns { apiKey, apiUrl,
branch } which can overwrite a configured SDK branch with undefined when
__tolgee_branch is missing; update getCredentials so it only includes branch in
the returned object when branch is defined (e.g., conditionally add branch or
filter undefined values) so merging with devCredentials or initial options does
not wipe an existing branch; look for the getCredentials function and the
variables apiKey, apiUrl, branch, and places where devCredentials/initial
options are merged to implement the conditional inclusion.

---

ℹ️ Review info

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: 959cc751-3a7a-4a5e-a43f-827685c958da

📥 Commits

Reviewing files that changed from the base of the PR and between ad3f340 and df7e870.

📒 Files selected for processing (3)

• packages/core/src/types/plugin.ts
• packages/web/src/package/BrowserExtensionPlugin/BrowserExtensionPlugin.ts
• packages/web/src/package/tools/extension.ts

[coderabbitai]

Actionable comments posted: 1

🤖 Prompt for all review comments with AI agents

Verify each finding against the current code and only fix it if needed.

Inline comments:
In `@packages/web/src/package/__test__/browser.extension.test.ts`:
- Around line 81-91: The test currently only asserts loadInContextLib call count
but must also verify the branch value; update the test so after running tolgee
you assert that loadInContextLib was called with an initializer object whose
credentials.branch equals 'my-branch' (e.g. use
expect(loadInContextLib).toHaveBeenCalledWith(expect.objectContaining({
credentials: expect.objectContaining({ branch: 'my-branch' }) })) so the
BrowserExtensionPlugin/TolgeeCore integration actually consumes
BRANCH_LOCAL_STORAGE.

---

ℹ️ Review info

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: c0d35c1c-062c-4354-99fd-ab43de72c3ad

📥 Commits

Reviewing files that changed from the base of the PR and between df7e870 and f708990.

📒 Files selected for processing (2)

• packages/core/src/__test/options.test.ts
• packages/web/src/package/__test__/browser.extension.test.ts