feat(stack): resolve Media and Route Docs client runtimes by olliethedev · Pull Request #239 · better-stack-ai/better-stack

olliethedev · 2026-08-29T01:23:29Z

Summary

migrate Media and Route Docs to canonical media / routeDocs resolved client definitions
drive Media SSR, browser resources, uploads, metadata, and provider-safe upload behavior from one stack runtime
keep Route Docs client-only while resolving introspection, metadata, and navigation from the registered stack
update generated framework templates, plugin docs, type fixtures, and the Media registry artifact

Verification

pnpm build
pnpm typecheck
pnpm lint
pnpm test -- --run (975 tests)
pnpm knip
pnpm --filter @btst/stack test-registry
cd docs && pnpm build

Closes #216

olliethedev · 2026-08-29T01:23:33Z

@codex security review

vercel · 2026-08-29T01:23:35Z

The latest updates on your projects. Learn more about Vercel for GitHub.

2 Skipped Deployments

Project	Deployment	Actions	Updated (UTC)
better-stack-docs	Ignored		Aug 29, 2026 7:24am
better-stack-playground	Ignored		Aug 29, 2026 7:24am

chatgpt-codex-connector · 2026-08-29T01:23:38Z

You have reached your Codex usage limits for security reviews. Please try again later.

chatgpt-codex-connector · 2026-08-29T01:23:43Z

Codex Review Summary

This comment shows the latest Codex review activity on this pull request.

Review	Status	Commit	Review trigger
📝 Code Review	✅ Completed 2026-08-29T07:32:37.091561Z	`010c3c9`	Manual request

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

Open a pull request for review
Mark a draft as ready
Comment "@codex review" or "@codex security review".

Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings.

chatgpt-codex-connector

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: d0e54ae2e9

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

Open a pull request for review
Mark a draft as ready
Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

github-actions · 2026-08-29T01:30:52Z

✅ Shadcn registry validated — no registry changes detected.

olliethedev · 2026-08-29T01:32:33Z

@codex review

chatgpt-codex-connector · 2026-08-29T01:38:58Z

Codex Review: Didn't find any major issues. Swish!

Reviewed commit: 998c404640

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

Open a pull request for review
Mark a draft as ready
Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

olliethedev · 2026-08-29T01:58:58Z

@codex review

chatgpt-codex-connector

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: aa1754c8a2

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

Open a pull request for review
Mark a draft as ready
Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

olliethedev · 2026-08-29T02:09:13Z

@codex review

chatgpt-codex-connector · 2026-08-29T02:16:29Z

Codex Review: Didn't find any major issues. 🚀

Reviewed commit: 2d8ad42785

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

Open a pull request for review
Mark a draft as ready
Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

olliethedev · 2026-08-29T02:29:36Z

@codex review

chatgpt-codex-connector

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: fa31c82c3a

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

Open a pull request for review
Mark a draft as ready
Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

olliethedev · 2026-08-29T02:46:25Z

@codex review

chatgpt-codex-connector

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: b8f54705e6

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

Open a pull request for review
Mark a draft as ready
Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

olliethedev · 2026-08-29T03:07:32Z

@codex review

chatgpt-codex-connector

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: f07cac4fd7

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

Open a pull request for review
Mark a draft as ready
Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

olliethedev · 2026-08-29T03:28:46Z

@codex review

chatgpt-codex-connector · 2026-08-29T03:46:29Z

💡 Codex Review

better-stack/packages/stack/src/plugins/route-docs/client/components/pages/docs-page.tsx

Lines 1122 to 1123 in c731919

    
           queryFn: loadSchema, 
        
           staleTime: Infinity, // Don't refetch - schema is static for this session

Scope the Route Docs query cache per stack

When two resolved stacks share a QueryClient, switching between their Route Docs pages—or rendering both providers—still reuses the global ROUTE_DOCS_QUERY_KEY. Because this query is fresh forever, the first stack's cached schema prevents the second stack's loadSchema from running, so it displays routes from the wrong stack despite the new provider-bound context. Include a stable stack/route-set discriminator in the query key.

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

Open a pull request for review
Mark a draft as ready
Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

chatgpt-codex-connector

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: e562a58054

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

Open a pull request for review
Mark a draft as ready
Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

olliethedev · 2026-08-29T05:32:00Z

@codex review

chatgpt-codex-connector

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 0318597265

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

Open a pull request for review
Mark a draft as ready
Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

olliethedev · 2026-08-29T05:47:19Z

@codex review

chatgpt-codex-connector

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: cd003b982c

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

Open a pull request for review
Mark a draft as ready
Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

olliethedev · 2026-08-29T06:02:06Z

@codex review

chatgpt-codex-connector

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 3edbd8e427

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

Open a pull request for review
Mark a draft as ready
Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

olliethedev · 2026-08-29T06:15:26Z

@codex review

olliethedev · 2026-08-29T06:32:25Z

@codex review

chatgpt-codex-connector

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 49fbc7f7cf

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

Open a pull request for review
Mark a draft as ready
Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

olliethedev · 2026-08-29T06:47:04Z

@codex review

olliethedev · 2026-08-29T06:54:31Z

@codex review

olliethedev · 2026-08-29T06:56:09Z

@codex review

chatgpt-codex-connector

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 558ce59435

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

Open a pull request for review
Mark a draft as ready
Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

olliethedev · 2026-08-29T07:20:19Z

@codex review

olliethedev · 2026-08-29T07:24:37Z

@codex review

chatgpt-codex-connector · 2026-08-29T07:32:36Z

Codex Review: Didn't find any major issues. Another round soon, please!

Reviewed commit: 010c3c9576

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

Open a pull request for review
Mark a draft as ready
Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

chatgpt-codex-connector Bot reviewed Aug 29, 2026

View reviewed changes

Comment thread packages/stack/src/plugins/media/client/upload.ts Resolved

chatgpt-codex-connector Bot reviewed Aug 29, 2026

View reviewed changes

Comment thread docs/content/docs/plugins/media.mdx Resolved

chatgpt-codex-connector Bot reviewed Aug 29, 2026

View reviewed changes

Comment thread packages/stack/src/plugins/route-docs/client/hooks.ts Resolved

olliethedev force-pushed the feat/216-media-route-docs-client branch from fa31c82 to b8f5470 Compare August 29, 2026 02:46

chatgpt-codex-connector Bot reviewed Aug 29, 2026

View reviewed changes

Comment thread packages/cli/src/utils/scaffold-plan.ts Resolved

olliethedev added 7 commits August 28, 2026 23:10

feat(stack): resolve media and route docs clients

20c6742

fix(media): authenticate Vercel Blob token exchange

7c5a44d

fix(stack): isolate resolved media and route docs runtimes

d1b6b09

docs(media): distinguish request and browser stacks

674b696

docs(media): clarify upload transport contracts

9a47fc6

fix(codegen): emit canonical media client factories

b95a741

fix(route-docs): bind introspection to client stack

c731919

chatgpt-codex-connector Bot reviewed Aug 29, 2026

View reviewed changes

Comment thread packages/stack/src/plugins/media/client/hooks/use-media.tsx Resolved

olliethedev force-pushed the feat/216-media-route-docs-client branch from f07cac4 to c731919 Compare August 29, 2026 03:28

fix(media): resolve assets against plugin origin

9232515

chatgpt-codex-connector Bot reviewed Aug 29, 2026

View reviewed changes

Comment thread packages/stack/src/plugins/media/client/hooks/use-media.tsx Resolved

fix(media): preserve mutation data identity

0318597

chatgpt-codex-connector Bot reviewed Aug 29, 2026

View reviewed changes

Comment thread packages/stack/src/plugins/route-docs/client/plugin.tsx Resolved

fix(route-docs): stabilize reconstructed cache keys

cd003b9

chatgpt-codex-connector Bot reviewed Aug 29, 2026

View reviewed changes

Comment thread packages/stack/src/plugins/route-docs/client/plugin.tsx Resolved

fix(route-docs): key schemas by sitemap output

3edbd8e

chatgpt-codex-connector Bot reviewed Aug 29, 2026

View reviewed changes

Comment thread packages/stack/src/plugins/route-docs/client/plugin.tsx Resolved

fix(stack): isolate client-only route docs caches

2a4fe1e

fix(media): lazy load library page

49fbc7f

chatgpt-codex-connector Bot reviewed Aug 29, 2026

View reviewed changes

Comment thread packages/stack/src/plugins/route-docs/client/plugin.tsx Resolved

Comment thread packages/stack/src/plugins/route-docs/client/plugin.tsx Resolved

fix(stack): bind media and route docs caches

1b78fc3

docs(media): describe loader context

f16ad13

docs(media): clarify identity hydration

558ce59

chatgpt-codex-connector Bot reviewed Aug 29, 2026

View reviewed changes

Comment thread packages/stack/src/plugins/media/client/hooks/use-media.tsx Resolved

Comment thread packages/stack/src/plugins/media/client/hooks/use-media.tsx Resolved

fix(media): partition resolved query caches

5034949

docs(media): explain endpoint-scoped query keys

010c3c9

olliethedev merged commit e9ff944 into v3 Aug 29, 2026
9 checks passed

olliethedev deleted the feat/216-media-route-docs-client branch August 29, 2026 07:36

olliethedev mentioned this pull request Aug 29, 2026

[v3 DX] Migrate Media and Route Docs client runtime boundaries #216

Closed

10 tasks

Conversation

olliethedev commented Aug 29, 2026

Summary

Verification

Uh oh!

olliethedev commented Aug 29, 2026

Uh oh!

vercel Bot commented Aug 29, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

chatgpt-codex-connector Bot commented Aug 29, 2026

Uh oh!

chatgpt-codex-connector Bot commented Aug 29, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Codex Review Summary

Uh oh!

chatgpt-codex-connector Bot left a comment

Choose a reason for hiding this comment

💡 Codex Review

Uh oh!

Uh oh!

github-actions Bot commented Aug 29, 2026

Uh oh!

olliethedev commented Aug 29, 2026

Uh oh!

chatgpt-codex-connector Bot commented Aug 29, 2026

Uh oh!

olliethedev commented Aug 29, 2026

Uh oh!

chatgpt-codex-connector Bot left a comment

Choose a reason for hiding this comment

💡 Codex Review

Uh oh!

Uh oh!

olliethedev commented Aug 29, 2026

Uh oh!

chatgpt-codex-connector Bot commented Aug 29, 2026

Uh oh!

olliethedev commented Aug 29, 2026

Uh oh!

chatgpt-codex-connector Bot left a comment

Choose a reason for hiding this comment

💡 Codex Review

Uh oh!

Uh oh!

olliethedev commented Aug 29, 2026

Uh oh!

chatgpt-codex-connector Bot left a comment

Choose a reason for hiding this comment

💡 Codex Review

Uh oh!

Uh oh!

olliethedev commented Aug 29, 2026

Uh oh!

chatgpt-codex-connector Bot left a comment

Choose a reason for hiding this comment

💡 Codex Review

Uh oh!

Uh oh!

olliethedev commented Aug 29, 2026

Uh oh!

chatgpt-codex-connector Bot commented Aug 29, 2026

💡 Codex Review

Uh oh!

chatgpt-codex-connector Bot left a comment

Choose a reason for hiding this comment

💡 Codex Review

Uh oh!

Uh oh!

olliethedev commented Aug 29, 2026

Uh oh!

chatgpt-codex-connector Bot left a comment

Choose a reason for hiding this comment

💡 Codex Review

Uh oh!

Uh oh!

olliethedev commented Aug 29, 2026

Uh oh!

chatgpt-codex-connector Bot left a comment

Choose a reason for hiding this comment

vercel Bot commented Aug 29, 2026 •

edited

Loading

chatgpt-codex-connector Bot commented Aug 29, 2026 •

edited

Loading