test(e2e): add Gemini TTS coverage to provider matrix by harshlocham · Pull Request #751 · TanStack/ai

harshlocham · 2026-06-12T10:25:00Z

🎯 Changes

Gemini TTS is already implemented and covered by unit tests, but it was not participating in the E2E TTS provider matrix because the provider-specific E2E wiring was incomplete.

This PR adds Gemini TTS to the existing E2E infrastructure by:

Adding a Gemini TTS adapter factory in media-providers.ts
Adding a Gemini generateContent audio mock in global-setup.ts
Adding gemini to the TTS provider support matrix
Exercising the adapter's PCM-to-WAV normalization path using raw PCM audio responses (audio/L16;codec=pcm;rate=24000)

No runtime behavior, public APIs, or package functionality are changed. This PR only extends test coverage for an existing feature.

Verification

Gemini TTS E2E tests pass (SSE, HTTP stream, and fetcher modes)
Full TTS provider matrix passes
No changes outside test infrastructure

✅ Checklist

I have followed the steps in the Contributing guide.
I have tested this code locally with pnpm run test:pr.

🚀 Release Impact

This change affects published code, and I have generated a changeset.
This change is docs/CI/dev-only (no release).

Summary by CodeRabbit

New Features
- Added end-to-end test coverage for Gemini text-to-speech support.
- Gemini is now included in the list of supported TTS providers in test feature checks.
- Test media handling now recognizes Gemini for TTS generation and audio normalization.

coderabbitai · 2026-06-12T10:25:14Z

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: 4fa61ee9-f6a3-453d-85c1-a3dbf379057d

📥 Commits

Reviewing files that changed from the base of the PR and between 78d182a and c4ba70d.

📒 Files selected for processing (3)

testing/e2e/global-setup.ts
testing/e2e/src/lib/feature-support.ts
testing/e2e/src/lib/media-providers.ts

🚧 Files skipped from review as they are similar to previous changes (3)

testing/e2e/src/lib/feature-support.ts
testing/e2e/src/lib/media-providers.ts
testing/e2e/global-setup.ts

📝 Walkthrough

Walkthrough

Adds Gemini text-to-speech support to the end-to-end test suite: registers gemini in the TTS feature matrix, wires a gemini factory entry in the TTS adapter using createGeminiSpeech, and mounts a mock Gemini generateContent endpoint that returns base64 PCM audio for adapter normalization testing.

Changes

Gemini TTS End-to-End Testing

Layer / File(s)	Summary
Feature support matrix `testing/e2e/src/lib/feature-support.ts`	Adds `gemini` to the `tts` entry in the provider support matrix.
Gemini TTS adapter factory `testing/e2e/src/lib/media-providers.ts`	Imports `createGeminiSpeech` and adds a `gemini` factory entry in `createTTSAdapter` configured with the TTS preview model, mock base URL, and shared test headers.
Gemini TTS mock endpoint and registration `testing/e2e/global-setup.ts`	Adds `FAKE_PCM_BYTES` fixture, implements `geminiTTSMount()` returning a Gemini `generateContent`-shaped JSON response with inline base64 PCM audio, and mounts it in `globalSetup`.

Estimated code review effort: 2 (Simple) | ~10 minutes

Sequence Diagram(s)

sequenceDiagram
participant Test as E2E Test
participant Adapter as createTTSAdapter (gemini)
participant Mount as geminiTTSMount
participant Endpoint as generateContent Endpoint
Test->>Adapter: Request TTS via Gemini provider
Adapter->>Endpoint: POST generateContent (model, headers)
Endpoint->>Mount: Route request to mock handler
Mount->>Endpoint: JSON response with inlineData PCM audio
Endpoint->>Adapter: Return base64 PCM payload
Adapter->>Test: Normalize PCM to WAV output

Possibly related PRs

TanStack/ai#462: Both PRs modify the same provider→feature matrix in testing/e2e/src/lib/feature-support.ts, adding a new provider entry for different features.

Suggested reviewers:tombeckenham

🚥 Pre-merge checks | ✅ 4 | ❌ 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 (4 passed)

Check name	Status	Explanation
Title check	✅ Passed	The title clearly summarizes the main change: adding Gemini TTS coverage to the E2E provider matrix.
Description check	✅ Passed	The description matches the template with Changes, Checklist, and Release Impact, and includes useful verification details.
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.

✨ Finishing Touches

🧪 Generate unit tests (beta)

Create PR with unit tests

Warning

There were issues while running some tools. Please review the errors and either fix the tool's configuration or disable the tool if it's a critical failure.

🔧 ESLint

If the error stems from missing dependencies, add them to the package.json file. For unrecoverable errors (e.g., due to private dependencies), disable the tool in the CodeRabbit configuration.

testing/e2e/global-setup.ts

Parsing error: "parserOptions.project" has been provided for @typescript-eslint/parser.
The file was not found in any of the provided project(s): testing/e2e/global-setup.ts

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

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

harshlocham · 2026-07-03T15:07:41Z

Hi @tombeckenham, I’ve updated the branch with the latest main and resolved the merge conflict. The full pnpm run test:pr suite still passes locally. This PR should now be ready for review. Thanks!

nx-cloud · 2026-07-08T01:43:53Z

View your CI Pipeline Execution ↗ for commit c4ba70d

Command	Status	Duration	Result
`nx run-many --targets=build --exclude=examples/...`	✅ Succeeded	1s	View ↗

☁️ Nx Cloud last updated this comment at 2026-07-09 04:27:17 UTC

pkg-pr-new · 2026-07-08T03:29:43Z

Open in StackBlitz

@tanstack/ai

npm i https://pkg.pr.new/@tanstack/ai@751

@tanstack/ai-acp

npm i https://pkg.pr.new/@tanstack/ai-acp@751

@tanstack/ai-angular

npm i https://pkg.pr.new/@tanstack/ai-angular@751

@tanstack/ai-anthropic

npm i https://pkg.pr.new/@tanstack/ai-anthropic@751

@tanstack/ai-bedrock

npm i https://pkg.pr.new/@tanstack/ai-bedrock@751

@tanstack/ai-claude-code

npm i https://pkg.pr.new/@tanstack/ai-claude-code@751

@tanstack/ai-client

npm i https://pkg.pr.new/@tanstack/ai-client@751

@tanstack/ai-code-mode

npm i https://pkg.pr.new/@tanstack/ai-code-mode@751

@tanstack/ai-code-mode-skills

npm i https://pkg.pr.new/@tanstack/ai-code-mode-skills@751

@tanstack/ai-codex

npm i https://pkg.pr.new/@tanstack/ai-codex@751

@tanstack/ai-devtools-core

npm i https://pkg.pr.new/@tanstack/ai-devtools-core@751

@tanstack/ai-elevenlabs

npm i https://pkg.pr.new/@tanstack/ai-elevenlabs@751

@tanstack/ai-event-client

npm i https://pkg.pr.new/@tanstack/ai-event-client@751

@tanstack/ai-fal

npm i https://pkg.pr.new/@tanstack/ai-fal@751

@tanstack/ai-gemini

npm i https://pkg.pr.new/@tanstack/ai-gemini@751

@tanstack/ai-grok

npm i https://pkg.pr.new/@tanstack/ai-grok@751

@tanstack/ai-grok-build

npm i https://pkg.pr.new/@tanstack/ai-grok-build@751

@tanstack/ai-groq

npm i https://pkg.pr.new/@tanstack/ai-groq@751

@tanstack/ai-isolate-cloudflare

npm i https://pkg.pr.new/@tanstack/ai-isolate-cloudflare@751

@tanstack/ai-isolate-node

npm i https://pkg.pr.new/@tanstack/ai-isolate-node@751

@tanstack/ai-isolate-quickjs

npm i https://pkg.pr.new/@tanstack/ai-isolate-quickjs@751

@tanstack/ai-mcp

npm i https://pkg.pr.new/@tanstack/ai-mcp@751

@tanstack/ai-mistral

npm i https://pkg.pr.new/@tanstack/ai-mistral@751

@tanstack/ai-ollama

npm i https://pkg.pr.new/@tanstack/ai-ollama@751

@tanstack/ai-openai

npm i https://pkg.pr.new/@tanstack/ai-openai@751

@tanstack/ai-opencode

npm i https://pkg.pr.new/@tanstack/ai-opencode@751

@tanstack/ai-openrouter

npm i https://pkg.pr.new/@tanstack/ai-openrouter@751

@tanstack/ai-preact

npm i https://pkg.pr.new/@tanstack/ai-preact@751

@tanstack/ai-react

npm i https://pkg.pr.new/@tanstack/ai-react@751

@tanstack/ai-react-ui

npm i https://pkg.pr.new/@tanstack/ai-react-ui@751

@tanstack/ai-sandbox

npm i https://pkg.pr.new/@tanstack/ai-sandbox@751

@tanstack/ai-sandbox-cloudflare

npm i https://pkg.pr.new/@tanstack/ai-sandbox-cloudflare@751

@tanstack/ai-sandbox-daytona

npm i https://pkg.pr.new/@tanstack/ai-sandbox-daytona@751

@tanstack/ai-sandbox-docker

npm i https://pkg.pr.new/@tanstack/ai-sandbox-docker@751

@tanstack/ai-sandbox-local-process

npm i https://pkg.pr.new/@tanstack/ai-sandbox-local-process@751

@tanstack/ai-sandbox-sprites

npm i https://pkg.pr.new/@tanstack/ai-sandbox-sprites@751

@tanstack/ai-sandbox-vercel

npm i https://pkg.pr.new/@tanstack/ai-sandbox-vercel@751

@tanstack/ai-solid

npm i https://pkg.pr.new/@tanstack/ai-solid@751

@tanstack/ai-solid-ui

npm i https://pkg.pr.new/@tanstack/ai-solid-ui@751

@tanstack/ai-svelte

npm i https://pkg.pr.new/@tanstack/ai-svelte@751

@tanstack/ai-utils

npm i https://pkg.pr.new/@tanstack/ai-utils@751

@tanstack/ai-vue

npm i https://pkg.pr.new/@tanstack/ai-vue@751

@tanstack/ai-vue-ui

npm i https://pkg.pr.new/@tanstack/ai-vue-ui@751

@tanstack/openai-base

npm i https://pkg.pr.new/@tanstack/openai-base@751

@tanstack/preact-ai-devtools

npm i https://pkg.pr.new/@tanstack/preact-ai-devtools@751

@tanstack/react-ai-devtools

npm i https://pkg.pr.new/@tanstack/react-ai-devtools@751

@tanstack/solid-ai-devtools

npm i https://pkg.pr.new/@tanstack/solid-ai-devtools@751

commit: c4ba70d

Wire Gemini TTS into the existing E2E test infrastructure. - Add Gemini TTS adapter factory in media-providers - Add Gemini generateContent audio mock - Add Gemini to TTS feature support - Exercise PCM-to-WAV normalization using raw PCM audio responses This extends existing TTS E2E coverage without changing runtime behavior or public APIs.

tombeckenham

Thank you for this

tombeckenham self-assigned this Jun 16, 2026

tombeckenham force-pushed the test/gemini-tts-e2e branch from 78d182a to 0f44d09Compare July 8, 2026 23:55

tombeckenham force-pushed the test/gemini-tts-e2e branch from 0f44d09 to c4ba70dCompare July 9, 2026 04:24

tombeckenham reviewed Jul 9, 2026
View reviewed changes

tombeckenham merged commit 9b85804 into TanStack:mainJul 9, 2026
10 checks passed

harshlocham deleted the test/gemini-tts-e2e branch August 11, 2026 17:14

Navigation Menu

Uh oh!

Uh oh!

test(e2e): add Gemini TTS coverage to provider matrix - #751

test(e2e): add Gemini TTS coverage to provider matrix#751
tombeckenham merged 1 commit into
TanStack:mainfrom
harshlocham:test/gemini-tts-e2e

harshlocham commented Jun 12, 2026•
edited by coderabbitai Bot
Loading

Uh oh!

coderabbitaiBot commented Jun 12, 2026•
edited
Loading

Walkthrough

Changes

Sequence Diagram(s)

❌ Failed checks (1 warning)

Uh oh!

harshlocham commented Jul 3, 2026

Uh oh!

nx-cloudBot commented Jul 8, 2026•
edited
Loading

Uh oh!

pkg-pr-newBot commented Jul 8, 2026•
edited
Loading

Uh oh!

tombeckenham left a comment

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

Uh oh!

Uh oh!

Conversation

harshlocham commented Jun 12, 2026• edited by coderabbitai BotLoading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

🎯 Changes

Verification

✅ Checklist

🚀 Release Impact

Summary by CodeRabbit

Uh oh!

coderabbitaiBot commented Jun 12, 2026• edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Walkthrough

Changes

Sequence Diagram(s)

❌ Failed checks (1 warning)

Uh oh!

harshlocham commented Jul 3, 2026

Uh oh!

nx-cloudBot commented Jul 8, 2026• edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

pkg-pr-newBot commented Jul 8, 2026• edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

tombeckenham left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

harshlocham commented Jun 12, 2026•
edited by coderabbitai Bot
Loading

coderabbitaiBot commented Jun 12, 2026•
edited
Loading

nx-cloudBot commented Jul 8, 2026•
edited
Loading

pkg-pr-newBot commented Jul 8, 2026•
edited
Loading