@nextsparkjs/theme-default 0.1.0-beta.29 → 0.1.0-beta.31

package/docs/public/01-overview/01-introduction.md

@@ -1,3 +1,8 @@
+---
+title: Introduction
+description: Overview of the Default Theme and its key features for NextSpark applications.
+---
+
 # Default Theme Introduction
 
 ## Overview

package/docs/public/01-overview/02-customization.md

@@ -1,3 +1,8 @@
+---
+title: Customization
+description: Learn how to customize colors, typography, components, and functionality in the default theme.
+---
+
 # Theme Customization
 
 ## Introduction

package/docs/public/02-features/03-tasks-entity.md

@@ -1,3 +1,8 @@
+---
+title: Tasks Entity
+description: Complete guide to the Tasks entity implementation with CRUD operations, metadata, and API access.
+---
+
 # Tasks Entity
 
 ## Introduction

package/docs/public/03-ai/01-overview.md

@@ -1,3 +1,8 @@
+---
+title: AI Assistant Overview
+description: Learn about the AI-powered assistant features and multi-agent architecture.
+---
+
 # AI Assistant - Overview
 
 This theme includes an AI-powered assistant that helps users manage tasks, customers, and pages through natural language.

package/docs/public/03-ai/02-customization.md

@@ -1,3 +1,8 @@
+---
+title: AI Customization
+description: Guide to customizing and extending the AI assistant with custom tools and handlers.
+---
+
 # AI Assistant - Customization
 
 This guide covers how to customize and extend the AI assistant for your specific needs.

package/docs/superadmin/01-setup/01-configuration.md

@@ -1,3 +1,8 @@
+---
+title: Configuration
+description: Environment variables and configuration options for NextSpark applications.
+---
+
 # Configuration Guide
 
 This guide covers the configuration options available to administrators for setting up and customizing your NextSpark application.

package/docs/superadmin/01-setup/02-deployment.md

@@ -1,3 +1,8 @@
+---
+title: Deployment
+description: Guide to deploying NextSpark applications to Vercel, Docker, and other platforms.
+---
+
 # Deployment Guide
 
 This guide covers deploying your NextSpark application to production environments.

package/docs/superadmin/02-management/01-users.md

@@ -1,3 +1,8 @@
+---
+title: User Management
+description: Managing users, teams, and roles in your NextSpark application.
+---
+
 # User Management
 
 This guide covers managing users and teams in your NextSpark application.

package/docs/superadmin/03-integrations/01-langchain.md

@@ -0,0 +1,139 @@
+---
+title: Langchain Integration
+description: Configure and manage the AI-powered Langchain plugin for your application.
+---
+
+# Langchain Integration
+
+The Langchain plugin provides AI-powered capabilities to your application, including conversational agents, document processing, and intelligent automation.
+
+## Overview
+
+Langchain is integrated as a plugin that can be enabled per-theme. It provides:
+
+- **Conversational AI**: Build chat interfaces with context-aware responses
+- **Memory Management**: Persistent conversation history with PostgreSQL storage
+- **Tool Integration**: Connect AI to your application's data and actions
+- **Streaming Responses**: Real-time AI responses for better UX
+
+## Configuration
+
+### Environment Variables
+
+Add the following to your `.env` file:
+
+```bash
+# OpenAI API Key (required)
+OPENAI_API_KEY=sk-your-api-key-here
+
+# Optional: Model configuration
+LANGCHAIN_MODEL=gpt-4o-mini
+LANGCHAIN_TEMPERATURE=0.7
+LANGCHAIN_MAX_TOKENS=2000
+```
+
+### Plugin Activation
+
+Enable the plugin in your theme configuration:
+
+```typescript
+// themes/{theme}/config/theme.config.ts
+export const themeConfig = {
+  plugins: ['langchain'],
+  // ...
+}
+```
+
+## Database Setup
+
+The plugin requires a memory table for conversation persistence. Run the migration:
+
+```bash
+pnpm db:migrate
+```
+
+This creates the `langchain_memory` table with the following schema:
+
+| Column | Type | Description |
+|--------|------|-------------|
+| id | uuid | Primary key |
+| sessionId | varchar | Conversation session identifier |
+| messages | jsonb | Array of message objects |
+| metadata | jsonb | Additional context data |
+| createdAt | timestamp | Creation timestamp |
+| updatedAt | timestamp | Last update timestamp |
+
+## Usage
+
+### Basic Chat Endpoint
+
+The plugin exposes an API endpoint for chat interactions:
+
+```typescript
+// POST /api/v1/ai/chat
+{
+  "message": "Hello, how can you help me?",
+  "sessionId": "user-123-session-456"
+}
+```
+
+Response:
+
+```typescript
+{
+  "success": true,
+  "data": {
+    "response": "Hello! I'm here to help you with...",
+    "sessionId": "user-123-session-456"
+  }
+}
+```
+
+### Streaming Responses
+
+For real-time streaming:
+
+```typescript
+// POST /api/v1/ai/chat/stream
+{
+  "message": "Explain quantum computing",
+  "sessionId": "user-123-session-456",
+  "stream": true
+}
+```
+
+## Security Considerations
+
+- **API Key Protection**: Never expose your OpenAI API key in client-side code
+- **Rate Limiting**: Consider implementing rate limits per user/team
+- **Content Filtering**: The plugin includes basic content moderation
+- **Session Isolation**: Conversations are isolated by sessionId
+
+## Monitoring
+
+View AI usage statistics in the Superadmin dashboard:
+
+1. Navigate to **Superadmin > Analytics** (coming soon)
+2. Select the **AI Usage** tab
+3. Monitor token usage, response times, and error rates
+
+## Troubleshooting
+
+### Common Issues
+
+**"OPENAI_API_KEY not configured"**
+- Ensure the environment variable is set
+- Restart the development server after adding the key
+
+**"Rate limit exceeded"**
+- OpenAI has per-minute and per-day limits
+- Consider implementing request queuing
+
+**"Memory not persisting"**
+- Verify the database migration ran successfully
+- Check that `sessionId` is being passed consistently
+
+## Related Documentation
+
+- [Plugin System](/docs/plugins/overview)
+- [API Authentication](/docs/api/authentication)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nextsparkjs/theme-default",
-  "version": "0.1.0-beta.29",
+  "version": "0.1.0-beta.31",
   "private": false,
   "type": "module",
   "main": "./config/theme.config.ts",
@@ -9,7 +9,6 @@
   ],
   "dependencies": {},
   "peerDependencies": {
-    "@nextsparkjs/core": "0.1.0-beta.24",
     "@tanstack/react-query": "^5.0.0",
     "lucide-react": "^0.539.0",
     "next": "^15.0.0",
@@ -17,7 +16,8 @@
     "react": "^19.0.0",
     "react-dom": "^19.0.0",
     "react-markdown": "^10.1.0",
-    "zod": "^4.0.0"
+    "zod": "^4.0.0",
+    "@nextsparkjs/core": "0.1.0-beta.31"
   },
   "nextspark": {
     "type": "theme",