Skip to content

feat!: extract independently versioned BTST plugin packages for v6 - #335

Merged
olliethedev merged 195 commits into
mainfrom
feat/v6-plugin-packages-310
Nov 6, 2026
Merged

olliethedev merged 195 commits into
mainfrom
feat/v6-plugin-packages-310

Conversation

@olliethedev

@olliethedev olliethedev commented Nov 4, 2026 •

Copy link
Copy Markdown
Collaborator

Summary

Extract all 19 built-in plugins into independent packages and keep @btst/stack as the shared Core v6 runtime. Preserve routes, IDs, authorization, data, ESM/CommonJS and SSR/SSG contracts. Optional standalone APIs move to @btst/components; Blog–Newsletter integration is opt-in, and page context no longer requires AI Chat.

@btst/stack, @btst/codegen       6.0.0-beta.0
19 plugins, @btst/components    1.0.0-beta.0
matching Auth UI beta           3.0.3-beta.0

This is the published beta implementation. Stable promotion #349 advances Core/CLI to 6.0.0 and plugins/Components to 1.0.0 after real-consumer validation. The migration guide maps all 157 baseline public imports. Core ships no legacy feature/component facade or corresponding dependencies.

Evidence

  • Before: v5.2.0 features share one package. After: 25 selected/core-only/component/integration setups are verified with npm and pnpm against inspected archives outside the workspace, including strict peers, public types, ESM/CommonJS, browser/SSR behavior, authorization, provider identity, dependency ownership, CSS and deferred imports. All 157 migrated imports resolve.
  • All 22 packages build; source typechecks, lint, Core knip and unit CI pass. All 92 baseline plugin test files remain with their owners. Native Next.js/React Router/TanStack apps, Next SSG, strict Auth fixtures, real CLI initialization/migration/idempotence and registry generation/installation are covered by required CI. The React Router all-feature build measured 17.8 GiB local peak RSS; CI adds 8 GiB temporary swap and limits workspace build concurrency to two. Final exact-head checks remain the merge gate.
  • All 23 public beta archives were audited for actual bytes, source identity and channels. better-stack-web PR84 is merged and its exact production deployment passed 14 HTTP checks, 15 desktop/mobile browser checks and same-origin session checks. Local authenticated roles, PostgreSQL CRUD, real Blob upload/delete, real AI streaming, form rate limits and comment moderation passed. The compatible Auth stable 3.0.3 is separately published and verified; this beta CLI retains its matching 3.0.3-beta.0 pin.
  • Package-selected release gates retain source/tag/SRI and ancestry checks, actual preview deployments and two fresh observations. New-owner stable promotion requires verified beta history; npm staging placeholders are excluded only after bounded, integrity-verified inert-archive inspection. All 30 release-tooling tests pass.
  • Standards, spec and security reviews have no outstanding findings. A Feature Flags test response-completion race is fixed with controlled mock responses, preserving every context/tenant/UTF-8 assertion; deliberately broken isolation variants still fail.
  • Controlled rendering benchmarks and raw evidence cover 330 measurements / 15 paired runs with no failures. Cold throttled LCP improved 62.6–72% across four matched routes; JavaScript transfer was roughly flat and warm/navigation results were mixed. Archive sizes and overlapping module costs are reported separately.

Verification limits: API-key-dependent local cases skip without configured credentials; CI uses its configured provider key. Existing registry peer/type exceptions remain explicit. The production smoke is read-only; authenticated/provider writes ran against the isolated local application. Preview auth CORS predates this migration and does not occur on the production domain. Mail delivery, Firecrawl and payment-provider calls were not exercised by the web migration checks.

Merge Danger

Door: two-way

Source changes can be reverted. Core v6 requires the documented import migration; database identities and existing data are preserved. Published npm versions are immutable.

Blast Radius: consumers

Applications, CLI scaffolding, registry consumers and release automation use the new ownership boundaries. Stable publication and a stable-pin web follow-up remain coordinated in #349.

Closes #310
Closes #311
Closes #312
Closes #313
Closes #314
Closes #315
Closes #316
Closes #317
Closes #318
Closes #319
Closes #320
Closes #321
Closes #322
Closes #323
Closes #324
Closes #325
Closes #326
Closes #327
Closes #328
Closes #329
Closes #330
Closes #331
Closes #332
Closes #333
Closes #334

@vercel

vercel Bot commented Nov 4, 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 Nov 5, 2026 11:20pm UTC
better-stack-playground Ready Ready Preview Nov 5, 2026 11:20pm UTC

Request Review

@github-actions

github-actions Bot commented Nov 4, 2026 •

Copy link
Copy Markdown
Contributor

Bundle size

322 of 339 bundles changed.

Module Gzip base → PR Gzip change Minified change
plugins/blog/client (removed) 1585902 → 0 B -1585902 B (-100.0%) -5032283 B (-100.0%)
plugins/blog/client/components (removed) 1582418 → 0 B -1582418 B (-100.0%) -5018630 B (-100.0%)
@btst/plugin-ui-builder/client (new) 0 → 1570182 B +1570182 B +5524797 B
@btst/plugin-ui-builder/client/components (new) 0 → 1568996 B +1568996 B +5516802 B
@btst/plugin-blog/client (new) 0 → 1567292 B +1567292 B +4978549 B
@btst/plugin-blog/client/components (new) 0 → 1563691 B +1563691 B +4964923 B
components/markdown (removed) 1342172 → 0 B -1342172 B (-100.0%) -4129801 B (-100.0%)
@btst/components/markdown (new) 0 → 1337326 B +1337326 B +4117048 B
plugins/newsletter/client (removed) 1310695 → 0 B -1310695 B (-100.0%) -4129377 B (-100.0%)
plugins/newsletter/client/components (removed) 1309554 → 0 B -1309554 B (-100.0%) -4124593 B (-100.0%)

Showing the 10 largest changes by absolute gzip bytes.

Unavailable: @btst/stack/ui/css (missing build outputs; comparison omitted).

2e176fe → c47b8f9. Standalone costs; rows overlap. Moved paths appear as new/removed entries, not application savings.

Measured 22 packed archives separately; full report includes their compressed bytes without installed dependencies.

Full report and measurements

This branch was successfully deployed

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