@btst/stack 1.12.0 → 2.0.1

package/dist/plugins/open-api/api/index.mjs

@@ -1,2 +1,2 @@
-export { openApiBackendPlugin } from '../../../packages/better-stack/src/plugins/open-api/api/plugin.mjs';
-export { generateOpenAPISchema } from '../../../packages/better-stack/src/plugins/open-api/api/generator.mjs';
+export { openApiBackendPlugin } from '../../../packages/stack/src/plugins/open-api/api/plugin.mjs';
+export { generateOpenAPISchema } from '../../../packages/stack/src/plugins/open-api/api/generator.mjs';

package/dist/plugins/route-docs/client/index.cjs

@@ -1,6 +1,6 @@
 'use strict';
 
-const plugin = require('../../../packages/better-stack/src/plugins/route-docs/client/plugin.cjs');
+const plugin = require('../../../packages/stack/src/plugins/route-docs/client/plugin.cjs');
 
 
 

package/dist/plugins/route-docs/client/index.d.cts

@@ -2,7 +2,7 @@ import * as _btst_stack_plugins_client from '@btst/stack/plugins/client';
 import * as react from 'react';
 import * as _btst_yar from '@btst/yar';
 import { QueryClient } from '@tanstack/react-query';
-import { S as SitemapEntry, b as ClientStackContext } from '../../../shared/stack.u9iYV6vt.cjs';
+import { a as SitemapEntry, b as ClientStackContext } from '../../../shared/stack.BoA0xkJv.cjs';
 import '@btst/db';
 import 'better-call';
 

package/dist/plugins/route-docs/client/index.d.mts

@@ -2,7 +2,7 @@ import * as _btst_stack_plugins_client from '@btst/stack/plugins/client';
 import * as react from 'react';
 import * as _btst_yar from '@btst/yar';
 import { QueryClient } from '@tanstack/react-query';
-import { S as SitemapEntry, b as ClientStackContext } from '../../../shared/stack.u9iYV6vt.mjs';
+import { a as SitemapEntry, b as ClientStackContext } from '../../../shared/stack.BoA0xkJv.mjs';
 import '@btst/db';
 import 'better-call';
 

package/dist/plugins/route-docs/client/index.d.ts

@@ -2,7 +2,7 @@ import * as _btst_stack_plugins_client from '@btst/stack/plugins/client';
 import * as react from 'react';
 import * as _btst_yar from '@btst/yar';
 import { QueryClient } from '@tanstack/react-query';
-import { S as SitemapEntry, b as ClientStackContext } from '../../../shared/stack.u9iYV6vt.js';
+import { a as SitemapEntry, b as ClientStackContext } from '../../../shared/stack.BoA0xkJv.js';
 import '@btst/db';
 import 'better-call';
 

package/dist/plugins/route-docs/client/index.mjs

@@ -1 +1 @@
-export { ROUTE_DOCS_QUERY_KEY, generateSchema, getStoredContext, routeDocsClientPlugin } from '../../../packages/better-stack/src/plugins/route-docs/client/plugin.mjs';
+export { ROUTE_DOCS_QUERY_KEY, generateSchema, getStoredContext, routeDocsClientPlugin } from '../../../packages/stack/src/plugins/route-docs/client/plugin.mjs';

package/dist/plugins/ui-builder/client/components/index.cjs

@@ -1,8 +1,8 @@
 'use strict';
 
-const pageRenderer = require('../../../../packages/better-stack/src/plugins/ui-builder/client/components/page-renderer.cjs');
-const pageListPage = require('../../../../packages/better-stack/src/plugins/ui-builder/client/components/pages/page-list-page.cjs');
-const pageBuilderPage = require('../../../../packages/better-stack/src/plugins/ui-builder/client/components/pages/page-builder-page.cjs');
+const pageRenderer = require('../../../../packages/stack/src/plugins/ui-builder/client/components/page-renderer.cjs');
+const pageListPage = require('../../../../packages/stack/src/plugins/ui-builder/client/components/pages/page-list-page.cjs');
+const pageBuilderPage = require('../../../../packages/stack/src/plugins/ui-builder/client/components/pages/page-builder-page.cjs');
 
 
 

package/dist/plugins/ui-builder/client/components/index.mjs

@@ -1,3 +1,3 @@
-export { PageRenderer, SuspensePageRenderer } from '../../../../packages/better-stack/src/plugins/ui-builder/client/components/page-renderer.mjs';
-export { PageListPage } from '../../../../packages/better-stack/src/plugins/ui-builder/client/components/pages/page-list-page.mjs';
-export { PageBuilderPage } from '../../../../packages/better-stack/src/plugins/ui-builder/client/components/pages/page-builder-page.mjs';
+export { PageRenderer, SuspensePageRenderer } from '../../../../packages/stack/src/plugins/ui-builder/client/components/page-renderer.mjs';
+export { PageListPage } from '../../../../packages/stack/src/plugins/ui-builder/client/components/pages/page-list-page.mjs';
+export { PageBuilderPage } from '../../../../packages/stack/src/plugins/ui-builder/client/components/pages/page-builder-page.mjs';

package/dist/plugins/ui-builder/client/hooks/index.cjs

@@ -1,6 +1,6 @@
 'use strict';
 
-const uiBuilderHooks = require('../../../../packages/better-stack/src/plugins/ui-builder/client/hooks/ui-builder-hooks.cjs');
+const uiBuilderHooks = require('../../../../packages/stack/src/plugins/ui-builder/client/hooks/ui-builder-hooks.cjs');
 
 
 

package/dist/plugins/ui-builder/client/hooks/index.mjs

@@ -1 +1 @@
-export { useCreateUIBuilderPage, useDeleteUIBuilderPage, useSuspenseUIBuilderPage, useSuspenseUIBuilderPageBySlug, useSuspenseUIBuilderPages, useUIBuilderPage, useUIBuilderPageBySlug, useUIBuilderPages, useUpdateUIBuilderPage } from '../../../../packages/better-stack/src/plugins/ui-builder/client/hooks/ui-builder-hooks.mjs';
+export { useCreateUIBuilderPage, useDeleteUIBuilderPage, useSuspenseUIBuilderPage, useSuspenseUIBuilderPageBySlug, useSuspenseUIBuilderPages, useUIBuilderPage, useUIBuilderPageBySlug, useUIBuilderPages, useUpdateUIBuilderPage } from '../../../../packages/stack/src/plugins/ui-builder/client/hooks/ui-builder-hooks.mjs';

package/dist/plugins/ui-builder/client/index.cjs

@@ -1,13 +1,13 @@
 'use strict';
 
-const plugin = require('../../../packages/better-stack/src/plugins/ui-builder/client/plugin.cjs');
-const registry = require('../../../packages/better-stack/src/plugins/ui-builder/client/registry.cjs');
+const plugin = require('../../../packages/stack/src/plugins/ui-builder/client/plugin.cjs');
+const registry = require('../../../packages/stack/src/plugins/ui-builder/client/registry.cjs');
 const formFieldOverrides = require('../../../packages/ui/src/lib/ui-builder/registry/form-field-overrides.cjs');
-const pageRenderer = require('../../../packages/better-stack/src/plugins/ui-builder/client/components/page-renderer.cjs');
-const pageListPage = require('../../../packages/better-stack/src/plugins/ui-builder/client/components/pages/page-list-page.cjs');
-const pageBuilderPage = require('../../../packages/better-stack/src/plugins/ui-builder/client/components/pages/page-builder-page.cjs');
-const uiBuilderHooks = require('../../../packages/better-stack/src/plugins/ui-builder/client/hooks/ui-builder-hooks.cjs');
-const index = require('../../../packages/better-stack/src/plugins/ui-builder/client/localization/index.cjs');
+const pageRenderer = require('../../../packages/stack/src/plugins/ui-builder/client/components/page-renderer.cjs');
+const pageListPage = require('../../../packages/stack/src/plugins/ui-builder/client/components/pages/page-list-page.cjs');
+const pageBuilderPage = require('../../../packages/stack/src/plugins/ui-builder/client/components/pages/page-builder-page.cjs');
+const uiBuilderHooks = require('../../../packages/stack/src/plugins/ui-builder/client/hooks/ui-builder-hooks.cjs');
+const index = require('../../../packages/stack/src/plugins/ui-builder/client/localization/index.cjs');
 
 
 

package/dist/plugins/ui-builder/client/index.mjs

@@ -1,8 +1,8 @@
-export { uiBuilderClientPlugin } from '../../../packages/better-stack/src/plugins/ui-builder/client/plugin.mjs';
-export { complexComponentDefinitions, createComponentRegistry, defaultComponentRegistry, primitiveComponentDefinitions } from '../../../packages/better-stack/src/plugins/ui-builder/client/registry.mjs';
+export { uiBuilderClientPlugin } from '../../../packages/stack/src/plugins/ui-builder/client/plugin.mjs';
+export { complexComponentDefinitions, createComponentRegistry, defaultComponentRegistry, primitiveComponentDefinitions } from '../../../packages/stack/src/plugins/ui-builder/client/registry.mjs';
 export { childrenAsTextareaFieldOverrides, childrenAsTipTapFieldOverrides, childrenFieldOverrides, classNameFieldOverrides, commonFieldOverrides, iconNameFieldOverrides } from '../../../packages/ui/src/lib/ui-builder/registry/form-field-overrides.mjs';
-export { PageRenderer, SuspensePageRenderer } from '../../../packages/better-stack/src/plugins/ui-builder/client/components/page-renderer.mjs';
-export { PageListPage } from '../../../packages/better-stack/src/plugins/ui-builder/client/components/pages/page-list-page.mjs';
-export { PageBuilderPage } from '../../../packages/better-stack/src/plugins/ui-builder/client/components/pages/page-builder-page.mjs';
-export { useCreateUIBuilderPage, useDeleteUIBuilderPage, useSuspenseUIBuilderPage, useSuspenseUIBuilderPageBySlug, useSuspenseUIBuilderPages, useUIBuilderPage, useUIBuilderPageBySlug, useUIBuilderPages, useUpdateUIBuilderPage } from '../../../packages/better-stack/src/plugins/ui-builder/client/hooks/ui-builder-hooks.mjs';
-export { uiBuilderLocalization } from '../../../packages/better-stack/src/plugins/ui-builder/client/localization/index.mjs';
+export { PageRenderer, SuspensePageRenderer } from '../../../packages/stack/src/plugins/ui-builder/client/components/page-renderer.mjs';
+export { PageListPage } from '../../../packages/stack/src/plugins/ui-builder/client/components/pages/page-list-page.mjs';
+export { PageBuilderPage } from '../../../packages/stack/src/plugins/ui-builder/client/components/pages/page-builder-page.mjs';
+export { useCreateUIBuilderPage, useDeleteUIBuilderPage, useSuspenseUIBuilderPage, useSuspenseUIBuilderPageBySlug, useSuspenseUIBuilderPages, useUIBuilderPage, useUIBuilderPageBySlug, useUIBuilderPages, useUpdateUIBuilderPage } from '../../../packages/stack/src/plugins/ui-builder/client/hooks/ui-builder-hooks.mjs';
+export { uiBuilderLocalization } from '../../../packages/stack/src/plugins/ui-builder/client/localization/index.mjs';

package/dist/plugins/ui-builder/index.cjs

@@ -1,6 +1,6 @@
 'use strict';
 
-const schemas = require('../../packages/better-stack/src/plugins/ui-builder/schemas.cjs');
+const schemas = require('../../packages/stack/src/plugins/ui-builder/schemas.cjs');
 
 
 

package/dist/plugins/ui-builder/index.mjs

@@ -1 +1 @@
-export { UI_BUILDER_CONTENT_TYPE, UI_BUILDER_TYPE_SLUG, uiBuilderPageSchema } from '../../packages/better-stack/src/plugins/ui-builder/schemas.mjs';
+export { UI_BUILDER_CONTENT_TYPE, UI_BUILDER_TYPE_SLUG, uiBuilderPageSchema } from '../../packages/stack/src/plugins/ui-builder/schemas.mjs';

package/dist/shared/{stack.u9iYV6vt.d.mts → stack.BoA0xkJv.d.cts}

@@ -6,7 +6,7 @@ import { Endpoint, Router } from 'better-call';
  * Context passed to backend plugins during route creation
  * Provides access to all registered plugins for introspection (used by openAPI plugin)
  */
-interface BetterStackContext {
+interface StackContext {
     /** All registered backend plugins */
     plugins: Record<string, BackendPlugin<any>>;
     /** The API base path (e.g., "/api/data") */
@@ -29,7 +29,7 @@ interface ClientStackContext<TPlugins extends Record<string, ClientPlugin<any, a
  * Defines API routes and data access for a feature
  *
  * Note: Each plugin defines its own schema using createDbPlugin().
- * Better Stack composes all plugin schemas together at runtime using Better DB's .use() method.
+ * BTST composes all plugin schemas together at runtime using Better DB's .use() method.
  * You can optionally provide a base schema via the dbSchema config option.
  *
  * @template TRoutes - The exact shape of routes this plugin provides (preserves keys and endpoint types)
@@ -44,7 +44,7 @@ interface BackendPlugin<TRoutes extends Record<string, Endpoint> = Record<string
      *   create, update, updateMany, delete, deleteMany, findOne, findMany, count
      * @param context - Optional context with access to all plugins (for introspection)
      */
-    routes: (adapter: Adapter, context?: BetterStackContext) => TRoutes;
+    routes: (adapter: Adapter, context?: StackContext) => TRoutes;
     dbPlugin: DbPlugin;
 }
 /**
@@ -95,7 +95,7 @@ type InferPluginOverrides<TPlugins extends Record<string, ClientPlugin<any, any>
     [K in keyof TPlugins]: TPlugins[K] extends ClientPlugin<infer TOverrides, any> ? TOverrides : never;
 };
 /**
- * Type for the pluginOverrides prop in BetterStackContext
+ * Type for the pluginOverrides prop in StackContext
  * Allows partial overrides per plugin
  */
 type PluginOverrides<TPlugins extends Record<string, ClientPlugin<any, any>>> = {
@@ -154,4 +154,4 @@ type SitemapEntry = {
 };
 type Sitemap = Array<SitemapEntry>;
 
-export type { BackendPlugin as B, ClientPlugin as C, PluginOverrides as P, SitemapEntry as S, BetterStackContext as a, ClientStackContext as b, Sitemap as c, PluginRoutes as d, ClientLibConfig as e, ClientLib as f, PrefixedPluginRoutes as g, BackendLibConfig as h, BackendLib as i };
+export type { BackendPlugin as B, ClientPlugin as C, PluginOverrides as P, StackContext as S, SitemapEntry as a, ClientStackContext as b, Sitemap as c, PluginRoutes as d, ClientLibConfig as e, ClientLib as f, PrefixedPluginRoutes as g, BackendLibConfig as h, BackendLib as i };

package/dist/shared/{stack.u9iYV6vt.d.cts → stack.BoA0xkJv.d.mts}

@@ -6,7 +6,7 @@ import { Endpoint, Router } from 'better-call';
  * Context passed to backend plugins during route creation
  * Provides access to all registered plugins for introspection (used by openAPI plugin)
  */
-interface BetterStackContext {
+interface StackContext {
     /** All registered backend plugins */
     plugins: Record<string, BackendPlugin<any>>;
     /** The API base path (e.g., "/api/data") */
@@ -29,7 +29,7 @@ interface ClientStackContext<TPlugins extends Record<string, ClientPlugin<any, a
  * Defines API routes and data access for a feature
  *
  * Note: Each plugin defines its own schema using createDbPlugin().
- * Better Stack composes all plugin schemas together at runtime using Better DB's .use() method.
+ * BTST composes all plugin schemas together at runtime using Better DB's .use() method.
  * You can optionally provide a base schema via the dbSchema config option.
  *
  * @template TRoutes - The exact shape of routes this plugin provides (preserves keys and endpoint types)
@@ -44,7 +44,7 @@ interface BackendPlugin<TRoutes extends Record<string, Endpoint> = Record<string
      *   create, update, updateMany, delete, deleteMany, findOne, findMany, count
      * @param context - Optional context with access to all plugins (for introspection)
      */
-    routes: (adapter: Adapter, context?: BetterStackContext) => TRoutes;
+    routes: (adapter: Adapter, context?: StackContext) => TRoutes;
     dbPlugin: DbPlugin;
 }
 /**
@@ -95,7 +95,7 @@ type InferPluginOverrides<TPlugins extends Record<string, ClientPlugin<any, any>
     [K in keyof TPlugins]: TPlugins[K] extends ClientPlugin<infer TOverrides, any> ? TOverrides : never;
 };
 /**
- * Type for the pluginOverrides prop in BetterStackContext
+ * Type for the pluginOverrides prop in StackContext
  * Allows partial overrides per plugin
  */
 type PluginOverrides<TPlugins extends Record<string, ClientPlugin<any, any>>> = {
@@ -154,4 +154,4 @@ type SitemapEntry = {
 };
 type Sitemap = Array<SitemapEntry>;
 
-export type { BackendPlugin as B, ClientPlugin as C, PluginOverrides as P, SitemapEntry as S, BetterStackContext as a, ClientStackContext as b, Sitemap as c, PluginRoutes as d, ClientLibConfig as e, ClientLib as f, PrefixedPluginRoutes as g, BackendLibConfig as h, BackendLib as i };
+export type { BackendPlugin as B, ClientPlugin as C, PluginOverrides as P, StackContext as S, SitemapEntry as a, ClientStackContext as b, Sitemap as c, PluginRoutes as d, ClientLibConfig as e, ClientLib as f, PrefixedPluginRoutes as g, BackendLibConfig as h, BackendLib as i };

package/dist/shared/{stack.u9iYV6vt.d.ts → stack.BoA0xkJv.d.ts}

@@ -6,7 +6,7 @@ import { Endpoint, Router } from 'better-call';
  * Context passed to backend plugins during route creation
  * Provides access to all registered plugins for introspection (used by openAPI plugin)
  */
-interface BetterStackContext {
+interface StackContext {
     /** All registered backend plugins */
     plugins: Record<string, BackendPlugin<any>>;
     /** The API base path (e.g., "/api/data") */
@@ -29,7 +29,7 @@ interface ClientStackContext<TPlugins extends Record<string, ClientPlugin<any, a
  * Defines API routes and data access for a feature
  *
  * Note: Each plugin defines its own schema using createDbPlugin().
- * Better Stack composes all plugin schemas together at runtime using Better DB's .use() method.
+ * BTST composes all plugin schemas together at runtime using Better DB's .use() method.
  * You can optionally provide a base schema via the dbSchema config option.
  *
  * @template TRoutes - The exact shape of routes this plugin provides (preserves keys and endpoint types)
@@ -44,7 +44,7 @@ interface BackendPlugin<TRoutes extends Record<string, Endpoint> = Record<string
      *   create, update, updateMany, delete, deleteMany, findOne, findMany, count
      * @param context - Optional context with access to all plugins (for introspection)
      */
-    routes: (adapter: Adapter, context?: BetterStackContext) => TRoutes;
+    routes: (adapter: Adapter, context?: StackContext) => TRoutes;
     dbPlugin: DbPlugin;
 }
 /**
@@ -95,7 +95,7 @@ type InferPluginOverrides<TPlugins extends Record<string, ClientPlugin<any, any>
     [K in keyof TPlugins]: TPlugins[K] extends ClientPlugin<infer TOverrides, any> ? TOverrides : never;
 };
 /**
- * Type for the pluginOverrides prop in BetterStackContext
+ * Type for the pluginOverrides prop in StackContext
  * Allows partial overrides per plugin
  */
 type PluginOverrides<TPlugins extends Record<string, ClientPlugin<any, any>>> = {
@@ -154,4 +154,4 @@ type SitemapEntry = {
 };
 type Sitemap = Array<SitemapEntry>;
 
-export type { BackendPlugin as B, ClientPlugin as C, PluginOverrides as P, SitemapEntry as S, BetterStackContext as a, ClientStackContext as b, Sitemap as c, PluginRoutes as d, ClientLibConfig as e, ClientLib as f, PrefixedPluginRoutes as g, BackendLibConfig as h, BackendLib as i };
+export type { BackendPlugin as B, ClientPlugin as C, PluginOverrides as P, StackContext as S, SitemapEntry as a, ClientStackContext as b, Sitemap as c, PluginRoutes as d, ClientLibConfig as e, ClientLib as f, PrefixedPluginRoutes as g, BackendLibConfig as h, BackendLib as i };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@btst/stack",
-  "version": "1.12.0",
+  "version": "2.0.1",
   "description": "A composable, plugin-based library for building full-stack applications.",
   "repository": {
     "type": "git",

package/src/__tests__/plugins.test.tsx

@@ -1,5 +1,5 @@
 import { describe, it, expect } from "vitest";
-import { betterStack } from "../api";
+import { stack } from "../api";
 import { createStackClient } from "../client";
 import { defineBackendPlugin } from "../plugins/api";
 import { defineClientPlugin } from "../plugins/client";
@@ -50,7 +50,7 @@ const messagesSchema: BetterAuthDBSchema = {
 
 /**
  * Test backend plugin - Messages
- * Demonstrates how to build a 3rd party plugin using Better Stack
+ * Demonstrates how to build a 3rd party plugin using BTST
  * Now using defineBackendPlugin for full type inference - no casts needed!
  */
 const messagesBackendPlugin = defineBackendPlugin({
@@ -164,7 +164,7 @@ const messagesClientPlugin = defineClientPlugin({
 describe("3rd Party Plugin Support", () => {
 	describe("Backend Plugin", () => {
 		it("should create backend with custom plugin", () => {
-			const backend = betterStack({
+			const backend = stack({
 				basePath: "/api",
 				plugins: {
 					messages: messagesBackendPlugin,
@@ -219,7 +219,7 @@ describe("3rd Party Plugin Support", () => {
 				}),
 			});
 
-			const backend = betterStack({
+			const backend = stack({
 				basePath: "/api",
 				plugins: {
 					messages: messagesBackendPlugin,
@@ -233,7 +233,7 @@ describe("3rd Party Plugin Support", () => {
 		});
 
 		it("should generate routes for custom plugin", () => {
-			const backend = betterStack({
+			const backend = stack({
 				basePath: "/api",
 				plugins: {
 					messages: messagesBackendPlugin,
@@ -248,7 +248,7 @@ describe("3rd Party Plugin Support", () => {
 		});
 
 		it("should include plugin schema in database", () => {
-			const backend = betterStack({
+			const backend = stack({
 				basePath: "/api",
 				plugins: {
 					messages: messagesBackendPlugin,
@@ -421,7 +421,7 @@ describe("3rd Party Plugin Support", () => {
 		it("should use backend and client plugins independently", () => {
 			// Backend and client plugins are completely separate
 			// This prevents SSR issues and enables better code splitting
-			const backend = betterStack({
+			const backend = stack({
 				basePath: "/api",
 				plugins: {
 					messages: messagesBackendPlugin,

package/src/api/index.ts

@@ -3,7 +3,7 @@ import type {
 	BackendLibConfig,
 	BackendLib,
 	PrefixedPluginRoutes,
-	BetterStackContext,
+	StackContext,
 } from "../types";
 import { defineDb } from "@btst/db";
 
@@ -14,7 +14,7 @@ export { toNodeHandler } from "better-call/node";
  *
  * @example
  * ```ts
- * const api = betterStack({
+ * const api = stack({
  *   plugins: {
  *     messages: messagesPlugin.backend
  *   },
@@ -29,7 +29,7 @@ export { toNodeHandler } from "better-call/node";
  * @template TPlugins - The exact plugins map (inferred from config)
  * @template TRoutes - All routes with prefixed keys like "pluginName_routeName" (computed automatically)
  */
-export function betterStack<
+export function stack<
 	TPlugins extends Record<string, any>,
 	TRoutes extends
 		PrefixedPluginRoutes<TPlugins> = PrefixedPluginRoutes<TPlugins>,
@@ -50,7 +50,7 @@ export function betterStack<
 	const adapterInstance = adapter(betterDbSchema);
 
 	// Create context for plugins that need access to all plugins (e.g., openAPI)
-	const context: BetterStackContext = {
+	const context: StackContext = {
 		plugins,
 		basePath,
 		adapter: adapterInstance,
@@ -83,5 +83,5 @@ export type {
 	BackendPlugin,
 	BackendLibConfig,
 	BackendLib,
-	BetterStackContext,
+	StackContext,
 } from "../types";

package/src/context/provider.tsx

@@ -5,9 +5,7 @@ import { createContext, useContext, type ReactNode } from "react";
  * Context value that provides plugin-specific overrides
  * Generic over the shape of all plugin overrides
  */
-interface BetterStackContextValue<
-	TPluginOverrides extends Record<string, any>,
-> {
+interface StackContextValue<TPluginOverrides extends Record<string, any>> {
 	/**
 	 * The overrides for the plugin.
 	 */
@@ -18,12 +16,10 @@ interface BetterStackContextValue<
 	basePath: string;
 }
 
-const BetterStackContext = createContext<BetterStackContextValue<any> | null>(
-	null,
-);
+const StackContext = createContext<StackContextValue<any> | null>(null);
 
 /**
- * Provider component for BetterStack context
+ * Provider component for BTST context
  * Provides type-safe access to plugin-specific overrides
  *
  * Only requires override values, not plugin objects - keeps bundle size minimal!
@@ -36,7 +32,7 @@ const BetterStackContext = createContext<BetterStackContextValue<any> | null>(
  *   messages: MessagesPluginOverrides;
  * };
  *
- * <BetterStackProvider<MyPluginOverrides>
+ * <StackProvider<MyPluginOverrides>
  *   overrides={{
  *     todos: {
  *       Link: (props) => <NextLink {...props} />,
@@ -48,10 +44,10 @@ const BetterStackContext = createContext<BetterStackContextValue<any> | null>(
  *   }}
  * >
  *   {children}
- * </BetterStackProvider>
+ * </StackProvider>
  * ```
  */
-export function BetterStackProvider<
+export function StackProvider<
 	TPluginOverrides extends Record<string, any> = Record<string, any>,
 >({
 	children,
@@ -62,41 +58,39 @@ export function BetterStackProvider<
 	overrides: TPluginOverrides;
 	basePath: string;
 }) {
-	const value: BetterStackContextValue<TPluginOverrides> = {
+	const value: StackContextValue<TPluginOverrides> = {
 		overrides,
 		basePath,
 	};
 
 	return (
-		<BetterStackContext.Provider value={value}>
-			{children}
-		</BetterStackContext.Provider>
+		<StackContext.Provider value={value}>{children}</StackContext.Provider>
 	);
 }
 
 /**
- * Hook to access the entire BetterStack context
+ * Hook to access the entire BTST context
  * Useful if you need access to multiple plugins or the full context
  *
  * @returns The full context value including overrides and basePath
- * @throws Error if used outside of BetterStackProvider
+ * @throws Error if used outside of StackProvider
  *
  * @example
  * ```tsx
- * const { overrides, basePath } = useBetterStack<MyPluginOverrides>();
+ * const { overrides, basePath } = useStack<MyPluginOverrides>();
  * ```
  */
-export function useBetterStack<
+export function useStack<
 	TPluginOverrides extends Record<string, any> = Record<string, any>,
 >() {
 	const context = useContext(
-		BetterStackContext,
-	) as BetterStackContextValue<TPluginOverrides> | null;
+		StackContext,
+	) as StackContextValue<TPluginOverrides> | null;
 
 	if (!context) {
 		throw new Error(
-			"useBetterStack must be used within BetterStackProvider. " +
-				"Wrap your app with <BetterStackProvider> in your layout file.",
+			"useStack must be used within StackProvider. " +
+				"Wrap your app with <StackProvider> in your layout file.",
 		);
 	}
 
@@ -140,7 +134,7 @@ export function usePluginOverrides<
 	pluginName: string,
 	defaultValues?: TDefaults,
 ): OverridesResult<TOverrides, TDefaults> {
-	const context = useBetterStack();
+	const context = useStack();
 
 	const pluginOverrides = context.overrides[pluginName];
 
@@ -157,7 +151,7 @@ export function usePluginOverrides<
  * Hook to access the base path where the client router is mounted
  *
  * @returns The base path string (e.g., "/pages")
- * @throws Error if used outside of BetterStackProvider
+ * @throws Error if used outside of StackProvider
  *
  * @example
  * ```tsx
@@ -166,11 +160,11 @@ export function usePluginOverrides<
  * ```
  */
 export function useBasePath() {
-	const context = useBetterStack();
+	const context = useStack();
 	if (!context) {
 		throw new Error(
-			"useBasePath must be used within BetterStackProvider. " +
-				"Wrap your app with <BetterStackProvider> in your layout file.",
+			"useBasePath must be used within StackProvider. " +
+				"Wrap your app with <StackProvider> in your layout file.",
 		);
 	}
 	return context.basePath;

package/src/plugins/ai-chat/client/components/chat-interface.tsx

@@ -5,7 +5,7 @@ import { useEffect, useRef, useState, useMemo, useCallback } from "react";
 import { useQueryClient } from "@tanstack/react-query";
 import { ChatMessage } from "./chat-message";
 import { ChatInput, type AttachedFile } from "./chat-input";
-import { BetterStackAttribution } from "@workspace/ui/components/better-stack-attribution";
+import { StackAttribution } from "@workspace/ui/components/stack-attribution";
 import { ScrollArea } from "@workspace/ui/components/scroll-area";
 import { DefaultChatTransport, type UIMessage } from "ai";
 import { cn } from "@workspace/ui/lib/utils";
@@ -170,6 +170,12 @@ export function ChatInterface({
 			transport,
 			onError: (err) => {
 				console.error("useChat onError:", err);
+				// Reset first-message tracking if the send failed before a conversation was created.
+				// Without this, isFirstMessageSentRef stays true and the next successful send
+				// skips the "first message" navigation logic, corrupting the conversation flow.
+				if (!id && !hasNavigatedRef.current) {
+					isFirstMessageSentRef.current = false;
+				}
 			},
 			onFinish: async () => {
 				// In public mode, skip all persistence-related operations
@@ -271,8 +277,43 @@ export function ChatInterface({
 	const [attachedFiles, setAttachedFiles] = useState<AttachedFile[]>([]);
 	const scrollRef = useRef<HTMLDivElement>(null);
 
-	// Auto-scroll to bottom when messages change
+	// Track whether the user has manually scrolled away from the bottom.
+	// When true, auto-scroll is paused so the user can read earlier context.
+	const userHasScrolledRef = useRef(false);
+	const prevStatusRef = useRef(status);
+
+	// Reset the scroll lock when a new generation starts so auto-scroll
+	// resumes for the next assistant response.
 	useEffect(() => {
+		if (
+			status !== prevStatusRef.current &&
+			(status === "streaming" || status === "submitted")
+		) {
+			userHasScrolledRef.current = false;
+		}
+		prevStatusRef.current = status;
+	}, [status]);
+
+	// Attach a scroll listener to detect when the user scrolls away from the bottom.
+	useEffect(() => {
+		const viewport = scrollRef.current?.querySelector(
+			"[data-radix-scroll-area-viewport]",
+		);
+		if (!viewport) return;
+
+		const handleScroll = () => {
+			const { scrollTop, scrollHeight, clientHeight } = viewport;
+			const isNearBottom = scrollHeight - scrollTop - clientHeight < 50;
+			userHasScrolledRef.current = !isNearBottom;
+		};
+
+		viewport.addEventListener("scroll", handleScroll);
+		return () => viewport.removeEventListener("scroll", handleScroll);
+	}, []);
+
+	// Auto-scroll to bottom when messages change, unless the user has scrolled away
+	useEffect(() => {
+		if (userHasScrolledRef.current) return;
 		if (scrollRef.current) {
 			const scrollElement = scrollRef.current.querySelector(
 				"[data-radix-scroll-area-viewport]",
@@ -309,10 +350,24 @@ export function ChatInterface({
 			isFirstMessageSentRef.current = true;
 		}
 
+		// Re-enable auto-scroll so the user's own message (and any subsequent
+		// error indicator or assistant reply) is scrolled into view.  Without
+		// this, if the user had scrolled up earlier, userHasScrolledRef stays
+		// true and none of the new content would be auto-scrolled to — and if
+		// the request fails before reaching "streaming" status the ref would
+		// remain stuck permanently.
+		userHasScrolledRef.current = false;
+
 		// Save current values before clearing - we'll restore them if send fails
 		const savedInput = input;
 		const savedFiles = files ? [...files] : [];
 
+		// Capture the message count before sending so we can restore to this
+		// exact point on failure. The SDK may append both a user message and a
+		// partial assistant message during streaming — using a fixed snapshot
+		// length removes all of them instead of just the last one.
+		const messageCountBeforeSend = messages.length;
+
 		// Clear input immediately (optimistically) - the AI SDK renders messages optimistically,
 		// so we need to clear the input before the message appears to avoid duplicate text
 		setInput("");
@@ -341,6 +396,13 @@ export function ChatInterface({
 			// Restore input on failure so user can retry
 			setInput(savedInput);
 			setAttachedFiles(savedFiles);
+			// Reset first-message tracking so the next attempt still triggers navigation
+			if (isFirstMessageSentRef.current && !hasNavigatedRef.current) {
+				isFirstMessageSentRef.current = false;
+			}
+			// Remove all messages the SDK added after our send attempt (optimistic
+			// user message AND any partial assistant message from a mid-stream failure).
+			setMessages((prev) => prev.slice(0, messageCountBeforeSend));
 			console.error("Error sending message:", error);
 		}
 	};
@@ -410,6 +472,7 @@ export function ChatInterface({
 						className,
 					)}
 					data-testid="chat-interface"
+					data-chat-status={status}
 				>
 					{/* Messages Area */}
 					<ScrollArea ref={scrollRef} className="flex-1 h-full">
@@ -501,7 +564,7 @@ export function ChatInterface({
 						onFilesAttached={setAttachedFiles}
 						attachedFiles={attachedFiles}
 					/>
-					{showAttribution && <BetterStackAttribution />}
+					{showAttribution && <StackAttribution />}
 				</div>
 			</div>
 		</>

package/src/plugins/api/index.ts

@@ -2,7 +2,7 @@
  * Plugin utilities and types for building standalone plugins
  *
  * This module exports everything needed to create custom plugins
- * for Better Stack outside of this package.
+ * for BTST outside of this package.
  *
  * Note: Backend and Client plugins are separate to prevent SSR issues
  * and enable better code splitting. Import them separately: