Skip to content

Upgrade BTST to Better Auth 1.7 and companion UI 3 - #281

Merged
olliethedev merged 3 commits into
mainfrom
upgrade/upstream-auth-20260929
Sep 30, 2026
Merged

olliethedev merged 3 commits into
mainfrom
upgrade/upstream-auth-20260929

Conversation

@olliethedev

@olliethedev olliethedev commented Sep 30, 2026 •

Copy link
Copy Markdown
Collaborator

Summary

  • Upgrade Stack and Codegen to 4.0.0 with Better DB/adapters/CLI 3.0.0, Better Auth 1.7.6, and the packaged Better Auth UI 3.0.0 companion based on upstream 1.7.26. Raise React/Tailwind minimums and update generated consumers, playground templates, and migration guidance.
  • Preserve Kanban hydration under Better DB's canonical relation keys; cover column summaries so raw joined data does not escape the authorization/serialization boundary. Keep the default auth/account scaffold minimal while documenting optional organization, admin, billing, and other upstream feature plugins.
  • Align React Query and Query Core to 5.102.0 in the maintained workspace, generated apps, and playground templates. This prevents TanStack SSR from auto-installing a newer, incompatible hydration implementation. Preserve optional mutation arguments, callbacks, and identity-scoped refresh under the newer Query types.
  • Verify the coordinated packages through strict npm/pnpm packed consumers and all three generated framework production builds. CI builds a pinned companion candidate so it can test the release before the companion is published.

Type of change

  • Bug fix
  • New plugin
  • Feature / enhancement to an existing plugin
  • Documentation
  • Chore / refactor / tooling

Checklist

  • pnpm install --frozen-lockfile and pnpm build pass with published Better DB 3 packages
  • pnpm typecheck passes
  • pnpm lint passes
  • Tests added or updated: 1,073 Stack tests, 196 Codegen tests, 8 packed-harness tests, and 7 release-gate tests pass
  • Docs updated; docs and playground production builds pass
  • All three codegen-projects create successfully and pass hosted E2E: Next.js 192 passed, React Router 188 passed, TanStack Start 189 passed. Next.js and React Router each have one unchanged skip. All generated companion production builds/typechecks also pass.
  • New plugin: not applicable

Strict packed core/auth installations, dependency-tree checks, required peer checks, typechecks, and browser bundles passed under npm and pnpm. The direct Auth/Core/DB versions remain exact; upstream-declared nested better-call/utils implementations are allowed without overriding their versions or disabling peer validation.

The committed lockfile resolves published Better DB 3 packages without local overrides. CI pins Better Auth UI source 29e8dd41b50f1382f968078630aa00f15137a8ab for the coordinated companion release. The public install contract is checked before substituting that tarball in the init harness. All hosted checks and deployments must pass on the final commit before merge/publication.

Related coordinated upgrades: better-stack-ai/better-auth#51 and better-stack-ai/better-auth-ui#27.

The first hosted TanStack browser run exposed a mixed Query 5.90/Core 5.104 graph. The existing Todo SSR regression reproduced the error locally, then passed with the aligned 5.102 pair. Fifty maintained TanStack browser tests across Todo, Blog, CMS, and Kanban now pass locally; all hosted checks and deployments passed on the corrected head. Mutation callback/identity regressions pass for both sync and async calls.

The repository publication preflight passed for 775a9124ca1faf65a09db8fd5cf9059d00295cb9, including both package source ancestries. Final-head independent review found no blockers. The final automated review completed on the same commit after one infrastructure retry and reported no major issues.

@vercel

vercel Bot commented Sep 30, 2026 •

Copy link
Copy Markdown

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

Project Deployment Actions Updated
better-stack-docs Ready Ready Preview Sep 30, 2026 3:26am UTC
better-stack-playground Ready Ready Preview Sep 30, 2026 3:26am UTC

Request Review

@chatgpt-codex-connector

chatgpt-codex-connector Bot commented Sep 30, 2026 •

Copy link
Copy Markdown

Codex Review Summary

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

Review Status Commit Review trigger
📝 Code Review ✅ Completed 2026-09-30T03:42:11.486602Z 775a912 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.

@olliethedev

Copy link
Copy Markdown
Collaborator Author

@codex review

Please review the final Query/Core alignment and mutation-wrapper compatibility changes in 775a912. The TanStack SSR regression reproduced locally before the fix; 50 maintained browser tests and the mutation callback/identity regressions pass after it.

@chatgpt-codex-connector

Copy link
Copy Markdown

Codex Review: Something went wrong. Try again later by commenting “@codex review”.

Failed to set up container
ℹ️ 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

Copy link
Copy Markdown
Collaborator Author

@codex review

Retrying the final-head review once after the review container failed to initialize. All CI jobs and deployments on 775a912 are green, including the repaired TanStack browser suite (189 passed). The final source delta also received an independent local review with no blockers.

@chatgpt-codex-connector

Copy link
Copy Markdown

Codex Review: Didn't find any major issues. Keep it up!

Reviewed commit: 775a9124ca

ℹ️ 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
olliethedev merged commit fa0e81b into main Sep 30, 2026
14 checks passed

This branch was successfully deployed

2 active deployments
Preview – better-stack-docs — 775a9124 Deployed Sep 30, 2026 by vercel[bot]
Preview – better-stack-playground — 775a9124 Deployed Sep 30, 2026 by vercel[bot]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant