@btst/stack 1.3.1 → 1.4.1

package/dist/plugins/ai-chat/client/components/index.d.cts

@@ -0,0 +1,30 @@
+export { i as ChatInput, C as ChatInterface, e as ChatLayout, f as ChatLayoutProps, h as ChatMessage, g as ChatSidebar, j as ToolCallDisplay } from '../../../../shared/stack.DaOcgmrM.cjs';
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { FallbackProps } from 'react-error-boundary';
+import 'ai';
+import 'react';
+
+interface ChatPageComponentProps {
+    conversationId?: string;
+}
+declare function ChatPageComponent({ conversationId }: ChatPageComponentProps): react_jsx_runtime.JSX.Element;
+
+/**
+ * Skeleton loading state for the chat page
+ */
+declare function ChatPageSkeleton(): react_jsx_runtime.JSX.Element;
+
+declare function ChatLoading(): react_jsx_runtime.JSX.Element;
+
+declare function DefaultError({ error }: FallbackProps): react_jsx_runtime.JSX.Element;
+
+declare function ErrorPlaceholder({ title, message, }: {
+    title: string;
+    message: string;
+}): react_jsx_runtime.JSX.Element;
+
+declare function NotFoundPage({ message }: {
+    message?: string;
+}): react_jsx_runtime.JSX.Element;
+
+export { ChatLoading, ChatPageComponent, ChatPageSkeleton, DefaultError, ErrorPlaceholder, NotFoundPage };

package/dist/plugins/ai-chat/client/components/index.d.mts

@@ -0,0 +1,30 @@
+export { i as ChatInput, C as ChatInterface, e as ChatLayout, f as ChatLayoutProps, h as ChatMessage, g as ChatSidebar, j as ToolCallDisplay } from '../../../../shared/stack.DaOcgmrM.mjs';
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { FallbackProps } from 'react-error-boundary';
+import 'ai';
+import 'react';
+
+interface ChatPageComponentProps {
+    conversationId?: string;
+}
+declare function ChatPageComponent({ conversationId }: ChatPageComponentProps): react_jsx_runtime.JSX.Element;
+
+/**
+ * Skeleton loading state for the chat page
+ */
+declare function ChatPageSkeleton(): react_jsx_runtime.JSX.Element;
+
+declare function ChatLoading(): react_jsx_runtime.JSX.Element;
+
+declare function DefaultError({ error }: FallbackProps): react_jsx_runtime.JSX.Element;
+
+declare function ErrorPlaceholder({ title, message, }: {
+    title: string;
+    message: string;
+}): react_jsx_runtime.JSX.Element;
+
+declare function NotFoundPage({ message }: {
+    message?: string;
+}): react_jsx_runtime.JSX.Element;
+
+export { ChatLoading, ChatPageComponent, ChatPageSkeleton, DefaultError, ErrorPlaceholder, NotFoundPage };

package/dist/plugins/ai-chat/client/components/index.d.ts

@@ -0,0 +1,30 @@
+export { i as ChatInput, C as ChatInterface, e as ChatLayout, f as ChatLayoutProps, h as ChatMessage, g as ChatSidebar, j as ToolCallDisplay } from '../../../../shared/stack.DaOcgmrM.js';
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { FallbackProps } from 'react-error-boundary';
+import 'ai';
+import 'react';
+
+interface ChatPageComponentProps {
+    conversationId?: string;
+}
+declare function ChatPageComponent({ conversationId }: ChatPageComponentProps): react_jsx_runtime.JSX.Element;
+
+/**
+ * Skeleton loading state for the chat page
+ */
+declare function ChatPageSkeleton(): react_jsx_runtime.JSX.Element;
+
+declare function ChatLoading(): react_jsx_runtime.JSX.Element;
+
+declare function DefaultError({ error }: FallbackProps): react_jsx_runtime.JSX.Element;
+
+declare function ErrorPlaceholder({ title, message, }: {
+    title: string;
+    message: string;
+}): react_jsx_runtime.JSX.Element;
+
+declare function NotFoundPage({ message }: {
+    message?: string;
+}): react_jsx_runtime.JSX.Element;
+
+export { ChatLoading, ChatPageComponent, ChatPageSkeleton, DefaultError, ErrorPlaceholder, NotFoundPage };

package/dist/plugins/ai-chat/client/components/index.mjs

@@ -0,0 +1,12 @@
+export { ChatInterface } from '../../../../packages/better-stack/src/plugins/ai-chat/client/components/chat-interface.mjs';
+export { ChatLayout } from '../../../../packages/better-stack/src/plugins/ai-chat/client/components/chat-layout.mjs';
+export { ChatSidebar } from '../../../../packages/better-stack/src/plugins/ai-chat/client/components/chat-sidebar.mjs';
+export { ChatMessage } from '../../../../packages/better-stack/src/plugins/ai-chat/client/components/chat-message.mjs';
+export { ChatInput } from '../../../../packages/better-stack/src/plugins/ai-chat/client/components/chat-input.mjs';
+export { ToolCallDisplay } from '../../../../packages/better-stack/src/plugins/ai-chat/client/components/tool-call-display.mjs';
+export { ChatPageComponent } from '../../../../packages/better-stack/src/plugins/ai-chat/client/components/pages/chat-page.mjs';
+export { ChatLoading } from '../../../../packages/better-stack/src/plugins/ai-chat/client/components/loading/index.mjs';
+export { DefaultError } from '../../../../packages/better-stack/src/plugins/ai-chat/client/components/shared/default-error.mjs';
+export { ErrorPlaceholder } from '../../../../packages/better-stack/src/plugins/ai-chat/client/components/shared/error-placeholder.mjs';
+export { NotFoundPage } from '../../../../packages/better-stack/src/plugins/ai-chat/client/components/pages/404-page.mjs';
+export { ChatPageSkeleton } from '../../../../packages/better-stack/src/plugins/ai-chat/client/components/loading/chat-page-skeleton.mjs';

package/dist/plugins/ai-chat/client/hooks/index.cjs

@@ -0,0 +1,13 @@
+'use strict';
+
+const chatHooks = require('../../../../packages/better-stack/src/plugins/ai-chat/client/hooks/chat-hooks.cjs');
+
+
+
+exports.useConversation = chatHooks.useConversation;
+exports.useConversations = chatHooks.useConversations;
+exports.useCreateConversation = chatHooks.useCreateConversation;
+exports.useDeleteConversation = chatHooks.useDeleteConversation;
+exports.useRenameConversation = chatHooks.useRenameConversation;
+exports.useSuspenseConversation = chatHooks.useSuspenseConversation;
+exports.useSuspenseConversations = chatHooks.useSuspenseConversations;

package/dist/plugins/ai-chat/client/hooks/index.d.cts

@@ -0,0 +1,98 @@
+import * as _tanstack_react_query from '@tanstack/react-query';
+import { ConversationWithMessages } from '../../query-keys.cjs';
+import { S as SerializedConversation } from '../../../../shared/stack.Be1QIHEn.cjs';
+export { a as SerializedMessage } from '../../../../shared/stack.Be1QIHEn.cjs';
+import '@btst/stack/plugins/api';
+import 'zod/v4/core';
+import 'zod';
+import 'better-call';
+import 'ai';
+import '@btst/stack/plugins/client';
+
+/**
+ * Options for the useConversations hook
+ */
+interface UseConversationsOptions {
+    /** Whether to enable the query (default: true) */
+    enabled?: boolean;
+}
+/**
+ * Result from the useConversations hook
+ */
+interface UseConversationsResult {
+    /** Array of conversations */
+    conversations: SerializedConversation[];
+    /** Whether the initial load is in progress */
+    isLoading: boolean;
+    /** Error if the query failed */
+    error: Error | null;
+    /** Function to refetch the conversations */
+    refetch: () => void;
+}
+/**
+ * Hook for fetching all conversations
+ */
+declare function useConversations(options?: UseConversationsOptions): UseConversationsResult;
+/**
+ * Suspense variant of useConversations
+ */
+declare function useSuspenseConversations(): {
+    conversations: SerializedConversation[];
+    refetch: () => Promise<unknown>;
+};
+/**
+ * Options for the useConversation hook
+ */
+interface UseConversationOptions {
+    /** Whether to enable the query (default: true) */
+    enabled?: boolean;
+}
+/**
+ * Result from the useConversation hook
+ */
+interface UseConversationResult {
+    /** The conversation with messages, or null if not found */
+    conversation: ConversationWithMessages | null;
+    /** Whether the conversation is being loaded */
+    isLoading: boolean;
+    /** Error if the query failed */
+    error: Error | null;
+    /** Function to refetch the conversation */
+    refetch: () => void;
+}
+/**
+ * Hook for fetching a single conversation with messages
+ */
+declare function useConversation(id?: string, options?: UseConversationOptions): UseConversationResult;
+/**
+ * Suspense variant of useConversation
+ */
+declare function useSuspenseConversation(id: string): {
+    conversation: ConversationWithMessages | null;
+    refetch: () => Promise<unknown>;
+};
+/**
+ * Hook for creating a new conversation
+ */
+declare function useCreateConversation(): _tanstack_react_query.UseMutationResult<SerializedConversation | null, Error, {
+    id?: string;
+    title?: string;
+}, unknown>;
+/**
+ * Hook for renaming a conversation
+ */
+declare function useRenameConversation(): _tanstack_react_query.UseMutationResult<SerializedConversation | null, Error, {
+    id: string;
+    title: string;
+}, unknown>;
+/**
+ * Hook for deleting a conversation
+ */
+declare function useDeleteConversation(): _tanstack_react_query.UseMutationResult<{
+    success: boolean;
+}, Error, {
+    id: string;
+}, unknown>;
+
+export { ConversationWithMessages, SerializedConversation, useConversation, useConversations, useCreateConversation, useDeleteConversation, useRenameConversation, useSuspenseConversation, useSuspenseConversations };
+export type { UseConversationOptions, UseConversationResult, UseConversationsOptions, UseConversationsResult };

package/dist/plugins/ai-chat/client/hooks/index.d.mts

@@ -0,0 +1,98 @@
+import * as _tanstack_react_query from '@tanstack/react-query';
+import { ConversationWithMessages } from '../../query-keys.mjs';
+import { S as SerializedConversation } from '../../../../shared/stack.Be1QIHEn.mjs';
+export { a as SerializedMessage } from '../../../../shared/stack.Be1QIHEn.mjs';
+import '@btst/stack/plugins/api';
+import 'zod/v4/core';
+import 'zod';
+import 'better-call';
+import 'ai';
+import '@btst/stack/plugins/client';
+
+/**
+ * Options for the useConversations hook
+ */
+interface UseConversationsOptions {
+    /** Whether to enable the query (default: true) */
+    enabled?: boolean;
+}
+/**
+ * Result from the useConversations hook
+ */
+interface UseConversationsResult {
+    /** Array of conversations */
+    conversations: SerializedConversation[];
+    /** Whether the initial load is in progress */
+    isLoading: boolean;
+    /** Error if the query failed */
+    error: Error | null;
+    /** Function to refetch the conversations */
+    refetch: () => void;
+}
+/**
+ * Hook for fetching all conversations
+ */
+declare function useConversations(options?: UseConversationsOptions): UseConversationsResult;
+/**
+ * Suspense variant of useConversations
+ */
+declare function useSuspenseConversations(): {
+    conversations: SerializedConversation[];
+    refetch: () => Promise<unknown>;
+};
+/**
+ * Options for the useConversation hook
+ */
+interface UseConversationOptions {
+    /** Whether to enable the query (default: true) */
+    enabled?: boolean;
+}
+/**
+ * Result from the useConversation hook
+ */
+interface UseConversationResult {
+    /** The conversation with messages, or null if not found */
+    conversation: ConversationWithMessages | null;
+    /** Whether the conversation is being loaded */
+    isLoading: boolean;
+    /** Error if the query failed */
+    error: Error | null;
+    /** Function to refetch the conversation */
+    refetch: () => void;
+}
+/**
+ * Hook for fetching a single conversation with messages
+ */
+declare function useConversation(id?: string, options?: UseConversationOptions): UseConversationResult;
+/**
+ * Suspense variant of useConversation
+ */
+declare function useSuspenseConversation(id: string): {
+    conversation: ConversationWithMessages | null;
+    refetch: () => Promise<unknown>;
+};
+/**
+ * Hook for creating a new conversation
+ */
+declare function useCreateConversation(): _tanstack_react_query.UseMutationResult<SerializedConversation | null, Error, {
+    id?: string;
+    title?: string;
+}, unknown>;
+/**
+ * Hook for renaming a conversation
+ */
+declare function useRenameConversation(): _tanstack_react_query.UseMutationResult<SerializedConversation | null, Error, {
+    id: string;
+    title: string;
+}, unknown>;
+/**
+ * Hook for deleting a conversation
+ */
+declare function useDeleteConversation(): _tanstack_react_query.UseMutationResult<{
+    success: boolean;
+}, Error, {
+    id: string;
+}, unknown>;
+
+export { ConversationWithMessages, SerializedConversation, useConversation, useConversations, useCreateConversation, useDeleteConversation, useRenameConversation, useSuspenseConversation, useSuspenseConversations };
+export type { UseConversationOptions, UseConversationResult, UseConversationsOptions, UseConversationsResult };

package/dist/plugins/ai-chat/client/hooks/index.d.ts

@@ -0,0 +1,98 @@
+import * as _tanstack_react_query from '@tanstack/react-query';
+import { ConversationWithMessages } from '../../query-keys.js';
+import { S as SerializedConversation } from '../../../../shared/stack.Be1QIHEn.js';
+export { a as SerializedMessage } from '../../../../shared/stack.Be1QIHEn.js';
+import '@btst/stack/plugins/api';
+import 'zod/v4/core';
+import 'zod';
+import 'better-call';
+import 'ai';
+import '@btst/stack/plugins/client';
+
+/**
+ * Options for the useConversations hook
+ */
+interface UseConversationsOptions {
+    /** Whether to enable the query (default: true) */
+    enabled?: boolean;
+}
+/**
+ * Result from the useConversations hook
+ */
+interface UseConversationsResult {
+    /** Array of conversations */
+    conversations: SerializedConversation[];
+    /** Whether the initial load is in progress */
+    isLoading: boolean;
+    /** Error if the query failed */
+    error: Error | null;
+    /** Function to refetch the conversations */
+    refetch: () => void;
+}
+/**
+ * Hook for fetching all conversations
+ */
+declare function useConversations(options?: UseConversationsOptions): UseConversationsResult;
+/**
+ * Suspense variant of useConversations
+ */
+declare function useSuspenseConversations(): {
+    conversations: SerializedConversation[];
+    refetch: () => Promise<unknown>;
+};
+/**
+ * Options for the useConversation hook
+ */
+interface UseConversationOptions {
+    /** Whether to enable the query (default: true) */
+    enabled?: boolean;
+}
+/**
+ * Result from the useConversation hook
+ */
+interface UseConversationResult {
+    /** The conversation with messages, or null if not found */
+    conversation: ConversationWithMessages | null;
+    /** Whether the conversation is being loaded */
+    isLoading: boolean;
+    /** Error if the query failed */
+    error: Error | null;
+    /** Function to refetch the conversation */
+    refetch: () => void;
+}
+/**
+ * Hook for fetching a single conversation with messages
+ */
+declare function useConversation(id?: string, options?: UseConversationOptions): UseConversationResult;
+/**
+ * Suspense variant of useConversation
+ */
+declare function useSuspenseConversation(id: string): {
+    conversation: ConversationWithMessages | null;
+    refetch: () => Promise<unknown>;
+};
+/**
+ * Hook for creating a new conversation
+ */
+declare function useCreateConversation(): _tanstack_react_query.UseMutationResult<SerializedConversation | null, Error, {
+    id?: string;
+    title?: string;
+}, unknown>;
+/**
+ * Hook for renaming a conversation
+ */
+declare function useRenameConversation(): _tanstack_react_query.UseMutationResult<SerializedConversation | null, Error, {
+    id: string;
+    title: string;
+}, unknown>;
+/**
+ * Hook for deleting a conversation
+ */
+declare function useDeleteConversation(): _tanstack_react_query.UseMutationResult<{
+    success: boolean;
+}, Error, {
+    id: string;
+}, unknown>;
+
+export { ConversationWithMessages, SerializedConversation, useConversation, useConversations, useCreateConversation, useDeleteConversation, useRenameConversation, useSuspenseConversation, useSuspenseConversations };
+export type { UseConversationOptions, UseConversationResult, UseConversationsOptions, UseConversationsResult };

package/dist/plugins/ai-chat/client/hooks/index.mjs

@@ -0,0 +1 @@
+export { useConversation, useConversations, useCreateConversation, useDeleteConversation, useRenameConversation, useSuspenseConversation, useSuspenseConversations } from '../../../../packages/better-stack/src/plugins/ai-chat/client/hooks/chat-hooks.mjs';

package/dist/plugins/ai-chat/client/index.cjs

@@ -0,0 +1,21 @@
+'use strict';
+
+const plugin = require('../../../packages/better-stack/src/plugins/ai-chat/client/plugin.cjs');
+const overrides = require('../../../packages/better-stack/src/plugins/ai-chat/client/overrides.cjs');
+const chatInterface = require('../../../packages/better-stack/src/plugins/ai-chat/client/components/chat-interface.cjs');
+const chatLayout = require('../../../packages/better-stack/src/plugins/ai-chat/client/components/chat-layout.cjs');
+const chatSidebar = require('../../../packages/better-stack/src/plugins/ai-chat/client/components/chat-sidebar.cjs');
+const chatMessage = require('../../../packages/better-stack/src/plugins/ai-chat/client/components/chat-message.cjs');
+const chatInput = require('../../../packages/better-stack/src/plugins/ai-chat/client/components/chat-input.cjs');
+const toolCallDisplay = require('../../../packages/better-stack/src/plugins/ai-chat/client/components/tool-call-display.cjs');
+
+
+
+exports.aiChatClientPlugin = plugin.aiChatClientPlugin;
+exports.DEFAULT_ALLOWED_FILE_TYPES = overrides.DEFAULT_ALLOWED_FILE_TYPES;
+exports.ChatInterface = chatInterface.ChatInterface;
+exports.ChatLayout = chatLayout.ChatLayout;
+exports.ChatSidebar = chatSidebar.ChatSidebar;
+exports.ChatMessage = chatMessage.ChatMessage;
+exports.ChatInput = chatInput.ChatInput;
+exports.ToolCallDisplay = toolCallDisplay.ToolCallDisplay;

package/dist/plugins/ai-chat/client/index.d.cts

@@ -0,0 +1,156 @@
+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 SerializedConversation, a as SerializedMessage } from '../../../shared/stack.Be1QIHEn.cjs';
+import { A as AiChatMode } from '../../../shared/stack.DaOcgmrM.cjs';
+export { a as AiChatPluginOverrides, b as AllowedFileType, i as ChatInput, C as ChatInterface, e as ChatLayout, f as ChatLayoutProps, h as ChatMessage, g as ChatSidebar, D as DEFAULT_ALLOWED_FILE_TYPES, j as ToolCallDisplay, T as ToolCallProps, d as ToolCallRenderer, c as ToolCallState } from '../../../shared/stack.DaOcgmrM.cjs';
+export { UIMessage } from 'ai';
+import 'react/jsx-runtime';
+
+/**
+ * Context passed to route hooks
+ */
+interface RouteContext {
+    /** Current route path */
+    path: string;
+    /** Route parameters (e.g., { id: "abc123" }) */
+    params?: Record<string, string>;
+    /** Whether rendering on server (true) or client (false) */
+    isSSR: boolean;
+    /** Additional context properties */
+    [key: string]: any;
+}
+/**
+ * Context passed to loader hooks
+ */
+interface LoaderContext {
+    /** Current route path */
+    path: string;
+    /** Route parameters (e.g., { id: "abc123" }) */
+    params?: Record<string, string>;
+    /** Whether rendering on server (true) or client (false) */
+    isSSR: boolean;
+    /** Base URL for API calls */
+    apiBaseURL: string;
+    /** Path where the API is mounted */
+    apiBasePath: string;
+    /** Optional headers for the request */
+    headers?: Headers;
+    /** Additional context properties */
+    [key: string]: any;
+}
+/**
+ * Configuration for AI Chat client plugin
+ */
+interface AiChatClientConfig {
+    /** Base URL for API calls (e.g., "http://localhost:3000") */
+    apiBaseURL: string;
+    /** Path where the API is mounted (e.g., "/api/data") */
+    apiBasePath: string;
+    /** Base URL of your site for SEO meta tags */
+    siteBaseURL: string;
+    /** Path where pages are mounted (e.g., "/pages") */
+    siteBasePath: string;
+    /** React Query client instance for caching */
+    queryClient: QueryClient;
+    /**
+     * Plugin mode - should match backend config
+     * - 'authenticated': Full chat with conversation history (default)
+     * - 'public': Simple widget mode, no persistence, no sidebar
+     * @default 'authenticated'
+     */
+    mode?: AiChatMode;
+    /** Optional SEO configuration for meta tags */
+    seo?: {
+        /** Site name for Open Graph tags */
+        siteName?: string;
+        /** Default description */
+        description?: string;
+        /** Locale for Open Graph (e.g., "en_US") */
+        locale?: string;
+        /** Default image URL for social sharing */
+        defaultImage?: string;
+    };
+    /** Optional hooks for customizing behavior */
+    hooks?: AiChatClientHooks;
+    /** Optional headers for SSR (e.g., forwarding cookies) */
+    headers?: Headers;
+}
+/**
+ * Hooks for AI Chat client plugin
+ * All hooks are optional and allow consumers to customize behavior
+ */
+interface AiChatClientHooks {
+    /**
+     * Called before loading conversations list. Return false to cancel loading.
+     * @param context - Loader context with path, params, etc.
+     */
+    beforeLoadConversations?: (context: LoaderContext) => Promise<boolean> | boolean;
+    /**
+     * Called after conversations are loaded. Return false to cancel further processing.
+     * @param conversations - Array of loaded conversations or null
+     * @param context - Loader context
+     */
+    afterLoadConversations?: (conversations: SerializedConversation[] | null, context: LoaderContext) => Promise<boolean> | boolean;
+    /**
+     * Called before loading a single conversation. Return false to cancel loading.
+     * @param id - Conversation ID being loaded
+     * @param context - Loader context
+     */
+    beforeLoadConversation?: (id: string, context: LoaderContext) => Promise<boolean> | boolean;
+    /**
+     * Called after a conversation is loaded. Return false to cancel further processing.
+     * @param conversation - Loaded conversation or null if not found
+     * @param id - Conversation ID that was requested
+     * @param context - Loader context
+     */
+    afterLoadConversation?: (conversation: (SerializedConversation & {
+        messages: SerializedMessage[];
+    }) | null, id: string, context: LoaderContext) => Promise<boolean> | boolean;
+    /**
+     * Called when a loading error occurs
+     * @param error - The error that occurred
+     * @param context - Loader context
+     */
+    onLoadError?: (error: Error, context: LoaderContext) => Promise<void> | void;
+}
+/**
+ * AI Chat client plugin
+ * Provides routes, components, and React Query hooks for AI chat
+ *
+ * @param config - Configuration including queryClient, baseURL, and optional hooks
+ */
+declare const aiChatClientPlugin: (config: AiChatClientConfig) => _btst_stack_plugins_client.ClientPlugin<Record<string, never>, {
+    chat: {
+        (inputCtx_0?: _btst_yar.InputContext<"/chat", _btst_yar.RouteOptions> | undefined): {
+            PageComponent?: react.ComponentType<unknown> | undefined;
+            LoadingComponent?: react.ComponentType<unknown> | undefined;
+            ErrorComponent?: react.ComponentType<unknown> | undefined;
+            loader?: (() => Promise<void>) | undefined;
+            meta?: (() => ({
+                title: string;
+                name?: undefined;
+                content?: undefined;
+                property?: undefined;
+            } | {
+                name: string;
+                content: string;
+                title?: undefined;
+                property?: undefined;
+            } | {
+                property: string;
+                content: string;
+                title?: undefined;
+                name?: undefined;
+            })[]) | undefined;
+            extra?: (() => any) | undefined;
+        };
+        options: _btst_yar.RouteOptions | undefined;
+        path: "/chat";
+        meta: _btst_yar.RouteMeta | undefined;
+    };
+}>;
+
+export { aiChatClientPlugin };
+export type { AiChatClientConfig, AiChatClientHooks, LoaderContext, RouteContext };