@btst/stack 1.12.0 → 2.0.0

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";
@@ -501,7 +501,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:

package/src/plugins/client/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:

package/src/plugins/cms/client/localization/cms-common.ts

@@ -25,5 +25,5 @@ export const CMS_COMMON = {
 	CMS_ERROR_VALIDATION: "Please fix the errors above",
 
 	// Attribution
-	CMS_ATTRIBUTION: "Powered by Better Stack",
+	CMS_ATTRIBUTION: "Powered by BTST",
 };

package/src/plugins/form-builder/client/localization/form-builder-common.ts

@@ -32,5 +32,5 @@ export const FORM_BUILDER_COMMON = {
 	FORM_BUILDER_ERROR_VALIDATION: "Please fix the errors above",
 
 	// Attribution
-	FORM_BUILDER_ATTRIBUTION: "Powered by Better Stack",
+	FORM_BUILDER_ATTRIBUTION: "Powered by BTST",
 };

package/src/plugins/open-api/api/generator.ts

@@ -1,5 +1,5 @@
 import type { Endpoint } from "better-call";
-import type { BetterStackContext } from "../../../types";
+import type { StackContext } from "../../../types";
 import * as z from "zod";
 
 /**
@@ -321,10 +321,10 @@ function getErrorResponses(): Record<string, any> {
 }
 
 /**
- * Generate OpenAPI 3.1 schema from Better Stack context
+ * Generate OpenAPI 3.1 schema from BTST context
  */
 export function generateOpenAPISchema(
-	context: BetterStackContext,
+	context: StackContext,
 	options?: { title?: string; description?: string; version?: string },
 ): Record<string, any> {
 	const paths: Record<string, Record<string, PathOperation>> = {};
@@ -400,10 +400,9 @@ export function generateOpenAPISchema(
 	return {
 		openapi: "3.1.0",
 		info: {
-			title: options?.title || "Better Stack API",
+			title: options?.title || "BTST API",
 			description:
-				options?.description ||
-				"API Reference for your Better Stack application",
+				options?.description || "API Reference for your BTST application",
 			version: options?.version || "1.0.0",
 		},
 		servers: [

package/src/plugins/open-api/api/plugin.ts

@@ -3,7 +3,7 @@ import { createEndpoint } from "@btst/stack/plugins/api";
 import { openApiSchema } from "../db";
 import { generateOpenAPISchema } from "./generator";
 import { logo } from "../logo";
-import type { BetterStackContext } from "../../../types";
+import type { StackContext } from "../../../types";
 
 /**
  * Scalar API Reference themes
@@ -54,7 +54,7 @@ export interface OpenAPIOptions {
 
 	/**
 	 * Custom title for the API documentation
-	 * @default "Better Stack API"
+	 * @default "BTST API"
 	 */
 	title?: string;
 
@@ -137,14 +137,14 @@ function getScalarHTML(
 }
 
 /**
- * OpenAPI plugin for Better Stack
+ * OpenAPI plugin for BTST
  *
  * Automatically generates OpenAPI 3.1 documentation for all registered plugins.
  * Provides both a JSON schema endpoint and an interactive Scalar UI reference page.
  *
  * @example
  * ```ts
- * const { handler } = betterStack({
+ * const { handler } = stack({
  *   basePath: "/api/data",
  *   plugins: {
  *     blog: blogBackendPlugin(),
@@ -163,7 +163,7 @@ export const openApiBackendPlugin = (options?: OpenAPIOptions) => {
 	const referencePath = options?.path ?? "/reference";
 
 	// Store context for use in endpoint handlers
-	let storedContext: BetterStackContext | null = null;
+	let storedContext: StackContext | null = null;
 
 	return defineBackendPlugin({
 		name: "open-api",

package/src/plugins/open-api/logo.ts

@@ -1,5 +1,5 @@
 /**
- * Better Stack logo SVG for use in Scalar API Reference
+ * BTST logo SVG for use in Scalar API Reference
  */
 export const logo = `<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 100 100" fill="none">
   <rect width="100" height="100" rx="20" fill="#0ea5e9"/>

package/src/types.ts

@@ -6,7 +6,7 @@ import type { 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)
  */
-export interface BetterStackContext {
+export interface StackContext {
 	/** All registered backend plugins */
 	plugins: Record<string, BackendPlugin<any>>;
 	/** The API base path (e.g., "/api/data") */
@@ -36,7 +36,7 @@ export interface ClientStackContext<
  * 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)
@@ -54,7 +54,7 @@ export interface BackendPlugin<
 	 *   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;
 }
 
@@ -129,7 +129,7 @@ export type InferPluginOverrides<
 };
 
 /**
- * Type for the pluginOverrides prop in BetterStackContext
+ * Type for the pluginOverrides prop in StackContext
  * Allows partial overrides per plugin
  */
 export type PluginOverrides<