captify 0.1.17 → 0.1.18

package/README.md

@@ -1,759 +1,429 @@
-# @captify/captify-core
+# captify-core
 
-A comprehensive shared library providing reusable UI/UX components, utilities, hooks, and services for Captify applications. Built with Next.js 15, React 19, TypeScript, and Tailwind CSS using shadcn/ui components.
+A comprehensive shared library providing reusable UI/UX components, utilities, hooks, and services for Captify applications. Built with Next.js 16, React 19, TypeScript, and Tailwind CSS using shadcn/ui components.
 
 ## Features
 
-- 🎨 **Modern UI Components** - Built on shadcn/ui with Radix UI primitives
-- 🔐 **Authentication** - NextAuth.js integration with AWS Cognito
-- 📱 **Responsive Layouts** - ConsoleLayout with sidebar, toolbar, and navigation
-- 🎯 **Type-Safe** - Full TypeScript support
-- 🧩 **Modular Exports** - Import only what you need
-- 📚 **Storybook** - Interactive component documentation
-- ✅ **Testing** - Playwright for end-to-end testing
-- 🎭 **Dark Mode** - Theme support with next-themes
+- **Modern UI Components** - Built on shadcn/ui with Radix UI primitives
+- **Authentication** - NextAuth.js 5 integration with AWS Cognito
+- **AI/Chat Integration** - AI SDK with multi-provider support (Bedrock, Anthropic, OpenAI)
+- **Feature-Based Architecture** - Modular, domain-driven organization
+- **Type-Safe** - Full TypeScript support with Zod validation
+- **Real-time Collaboration** - Yjs integration for collaborative editing
+- **Dark Mode** - Theme support with next-themes
 
 ## Table of Contents
 
 - [Installation](#installation)
 - [Quick Start](#quick-start)
-- [Migration Guide](#migration-guide)
-- [Project Structure](#project-structure)
+- [Architecture](#architecture)
+- [Module Reference](#module-reference)
+- [Import Patterns](#import-patterns)
 - [Development](#development)
-- [Testing the Library](#testing-the-library)
-- [Available Components](#available-components)
-- [Module Exports](#module-exports)
-- [Usage Examples](#usage-examples)
 - [Scripts](#scripts)
-- [Changelog](#changelog)
 - [Contributing](#contributing)
 
 ## Installation
 
-Install from npm:
+This is a private package. Install via npm link or file reference:
 
 ```bash
-npm install @captify/captify-core
+npm install captify@file:../captify-core
 ```
 
-Or using pnpm:
-
-```bash
-pnpm add @captify/captify-core
-```
+### Peer Dependencies
 
-Or using yarn:
+Ensure your project has these peer dependencies:
 
 ```bash
-yarn add @captify/captify-core
+npm install next@^16.0.0 react@^19.0.0 react-dom@^19.0.0
 ```
 
-### For Local Development
+### Requirements
 
-If you're working on the library locally, you can link it:
+- Node.js >= 20.0.0
 
-```bash
-npm install @captify/captify-core@file:../captify-core
-```
+## Quick Start
 
-### Peer Dependencies
+### Importing from Feature Modules
 
-Ensure your project has these peer dependencies installed:
+The library uses a feature-based module structure. Import from specific module paths:
 
-```bash
-npm install next@^14.0.0 || ^15.0.0 react@^18.0.0 || ^19.0.0 react-dom@^18.0.0 || ^19.0.0
-```
+```typescript
+// Shell components (layouts, toolbars, sidebar)
+import { ConsoleLayout } from 'captify/shell/components';
+import { ThemeProvider } from 'captify/shell/theme-provider';
 
-## Quick Start
+// Authentication
+import { auth, signIn, signOut } from 'captify/auth';
+import { AuthSessionProvider } from 'captify/auth/components';
 
-### Importing Components
+// Chat components and services
+import { ChatInterface, ChatMessages } from 'captify/chat/components';
+import { useChatSession } from 'captify/chat/hooks';
+import { ChatService } from 'captify/chat/services';
 
-**Important:** As of v0.2.0, you must import from specific module paths to avoid naming conflicts. As of v0.3.0, granular exports are available for even more precise imports.
+// Shared utilities and components
+import { cn } from 'captify/shared/utilities/cn';
+import { Button, Card, Dialog } from 'captify/shared/components';
 
-```typescript
-// ✅ Import from category modules (REQUIRED as of v0.2.0)
-import { ConsoleLayout, Button } from "@captify/captify-core/components";
-import { useBookmarkContext } from "@captify/captify-core/hooks";
-import { cn } from "@captify/captify-core/utils";
-import { ServiceItem } from "@captify/captify-core/types";
-import { CognitoAdminService } from "@captify/captify-core/services";
-import { acceptTermsAndConditions } from "@captify/captify-core/actions";
-
-// ✅ Import from granular paths for tree-shaking (NEW in v0.3.0)
-import { AppLauncher } from "@captify/captify-core/components/app-launcher";
-import { useMobile } from "@captify/captify-core/hooks/use-mobile";
-import { cn } from "@captify/captify-core/utils/cn";
-import { CognitoAdminService } from "@captify/captify-core/services/cognito/services";
-
-// ❌ Main entry point no longer exports everything (v0.2.0+)
-// import { ConsoleLayout, Button } from "@captify/captify-core"; // This won't work
+// File management
+import { FileUploader } from 'captify/files/components';
+import { useFileUpload } from 'captify/files/hooks';
+
+// User management
+import { UserProfile } from 'captify/users/components';
 ```
 
-### Basic Setup
+### Basic Layout Setup
 
 ```tsx
-import { ConsoleLayout } from "@captify/captify-core/components";
-import { BookmarkProvider } from "@captify/captify-core/context";
+import { ConsoleLayout } from 'captify/shell/components';
+import { ThemeProvider } from 'captify/shell/theme-provider';
+import { AuthSessionProvider } from 'captify/auth/components';
 
-export default function App() {
+export default function RootLayout({ children }) {
   return (
-    <BookmarkProvider>
-      <ConsoleLayout appName="My Application">{/* Your app content */}</ConsoleLayout>
-    </BookmarkProvider>
+    <AuthSessionProvider>
+      <ThemeProvider attribute="class" defaultTheme="system" enableSystem>
+        <ConsoleLayout appName="My Application">
+          {children}
+        </ConsoleLayout>
+      </ThemeProvider>
+    </AuthSessionProvider>
   );
 }
 ```
 
-## Migration Guide
-
-### Migrating from v0.1.x to v0.2.0
+## Architecture
 
-**Breaking Change:** The main entry point (`@captify/captify-core`) no longer re-exports all modules. You must use specific import paths.
-
-#### Step 1: Update Your Imports
-
-Search your codebase for imports from `@captify/captify-core` and update them:
-
-```typescript
-// ❌ OLD (v0.1.x) - Will not work in v0.2.0+
-import {
-  Button,
-  ConsoleLayout,
-  useBookmarkContext,
-  cn
-} from "@captify/captify-core";
-
-// ✅ NEW (v0.2.0+) - Use specific module paths
-import { Button, ConsoleLayout } from "@captify/captify-core/components";
-import { useBookmarkContext } from "@captify/captify-core/hooks";
-import { cn } from "@captify/captify-core/utils";
-```
+### Feature-Based Module Structure
 
-#### Step 2: Update Import Statements by Category
+The `lib/` directory uses a domain-driven, feature-based organization. Each feature module contains:
 
-**Components:**
-```typescript
-// Before
-import { Button, TopToolbar } from "@captify/captify-core";
-// After
-import { Button, TopToolbar } from "@captify/captify-core/components";
 ```
-
-**Hooks:**
-```typescript
-// Before
-import { useBookmarkContext } from "@captify/captify-core";
-// After
-import { useBookmarkContext } from "@captify/captify-core/hooks";
+lib/<feature>/
+├── <feature>.interfaces.ts   # TypeScript interfaces
+├── <feature>.schemas.ts      # Zod validation schemas
+├── <feature>.constants.ts    # Constants and configuration
+├── <feature>.utilities.ts    # Helper functions
+├── <feature>.errors.ts       # Error classes
+├── api/                      # API client and route handlers
+├── components/               # React components
+├── context/                  # React context providers
+├── hooks/                    # Custom React hooks
+└── services/                 # Business logic and integrations
 ```
 
-**Services:**
-```typescript
-// Before
-import { CognitoAdminService } from "@captify/captify-core";
-// After
-import { CognitoAdminService } from "@captify/captify-core/services";
-```
+### Core Feature Modules
 
-**Utilities:**
-```typescript
-// Before
-import { cn } from "@captify/captify-core";
-// After
-import { cn } from "@captify/captify-core/utils";
-```
+| Module | Description |
+|--------|-------------|
+| `agents/` | AI agent components, interfaces, and chat functionality |
+| `auth/` | NextAuth.js 5 + AWS Cognito authentication |
+| `bookmarks/` | Bookmark management for services and resources |
+| `breadcrumb/` | Navigation breadcrumb components |
+| `chat/` | Chat interface, messaging, and AI conversation |
+| `feedback/` | User feedback collection and management |
+| `files/` | File management, upload, and S3 integration |
+| `groups/` | User group management |
+| `llm-providers/` | LLM provider configuration (Bedrock, Anthropic, OpenAI) |
+| `ontology/` | Ontology/knowledge graph support |
+| `shared/` | Shared utilities, UI components, providers |
+| `shell/` | Application shell (layouts, toolbar, sidebar, theme) |
+| `tables/` | Data table components and utilities |
+| `users/` | User management and profiles |
 
-#### Step 3: Verify Your Build
+## Module Reference
 
-After updating imports, run your build to ensure everything works:
+### Shell Module
 
-```bash
-npm run build
-# or
-pnpm build
-# or
-yarn build
-```
+Application shell components for layout and navigation:
 
-### Why This Change?
+```typescript
+// Components
+import {
+  ConsoleLayout,
+  AppLauncher,
+  AppSidebar,
+  TopToolbar
+} from 'captify/shell/components';
 
-This breaking change was introduced to:
-- ✅ Prevent naming conflicts between modules
-- ✅ Enable better tree-shaking and smaller bundle sizes
-- ✅ Make dependencies more explicit and easier to understand
-- ✅ Improve IDE autocomplete and IntelliSense
+// Theme
+import { ThemeProvider } from 'captify/shell/theme-provider';
 
-## Project Structure
+// Hooks
+import { useSidebar } from 'captify/shell/hooks';
 
+// Types
+import type { MenuItem, ServiceItem } from 'captify/shell/shell.interfaces';
 ```
-captify-core/
-├── app/                    # Next.js app directory (for testing only)
-│   ├── (authenticated)/    # Protected routes (dashboard, profile)
-│   └── (unauthenticated)/  # Public routes (terms, login)
-├── lib/                    # Library source code
-│   ├── components/         # UI components
-│   │   ├── ui/            # shadcn/ui components
-│   │   ├── layouts/       # Layout components
-│   │   ├── toolbars/      # Toolbar components
-│   │   └── ...
-│   ├── context/           # React Context providers
-│   ├── hooks/             # Custom React hooks
-│   ├── utils/             # Utility functions
-│   ├── types/             # TypeScript types
-│   ├── interfaces/        # TypeScript interfaces
-│   ├── constants/         # Constants
-│   ├── config/            # Configuration
-│   ├── services/          # Service modules
-│   ├── actions/           # Server actions
-│   └── auth/              # Authentication config
-├── stories/               # Storybook stories
-├── tests/                 # Playwright tests
-└── dist/                  # Build output (generated)
-```
-
-## Development
 
-### Prerequisites
-
-- Node.js 18+
-- npm/pnpm/yarn
-
-### Setup
+### Auth Module
 
-1. Clone the repository
-2. Install dependencies:
+Authentication with NextAuth.js 5 and AWS Cognito:
 
-   ```bash
-   npm install
-   ```
-
-3. Copy the environment template:
-
-   ```bash
-   cp .env.example .env
-   ```
-
-4. Configure your environment variables (see `.env.example`)
-
-### Available Scripts
+```typescript
+// Core auth
+import { auth, signIn, signOut } from 'captify/auth';
 
-```bash
-# Development
-npm run dev                # Start Next.js dev server with Turbopack
-npm run storybook          # Start Storybook on port 6006
+// Components
+import { AuthSessionProvider, LoginButton } from 'captify/auth/components';
 
-# Building
-npm run build              # Build library (TypeScript → dist/)
-npm run build:next         # Build Next.js app
-npm run type-check         # TypeScript check without emit
-npm run validate           # Run lint + type-check
+// Hooks
+import { useSession } from 'captify/auth/hooks';
 
-# Linting & Formatting
-npm run lint               # Run ESLint
-npm run lint:fix           # ESLint with auto-fix
-npm run prettify           # Check Prettier formatting
-npm run prettify:fix       # Auto-format with Prettier
+// Services
+import { CognitoService } from 'captify/auth/services';
 
-# Testing
-npm test                   # Run Playwright tests
-npm run test:ui            # Playwright UI mode
-npm run test:headed        # Playwright headed mode
-npm run test:debug         # Playwright debug mode
+// Actions
+import { signOutAction } from 'captify/auth/actions';
 ```
 
-## Testing the Library
-
-The `app/` directory contains a test application to demonstrate and test library components:
-
-### Running the Test App
-
-1. Set up your environment variables in `.env` (see `.env.example`)
-2. Start the development server:
-   ```bash
-   npm run dev
-   ```
-3. Open [http://localhost:3000](http://localhost:3000)
-
-### Test Pages
+### Chat Module
 
-- **Terms & Conditions** (`/`) - Landing page with terms acceptance modal
-- **Profile** (`/profile`) - User profile page (requires auth)
+AI-powered chat interface with multi-provider support:
 
-These pages demonstrate:
+```typescript
+// Components
+import {
+  ChatInterface,
+  ChatMessages,
+  ChatInput,
+  ChatHistory,
+  ChatModelSelector
+} from 'captify/chat/components';
 
-- Authentication flow with AWS Cognito
-- Terms and conditions acceptance
-- Protected routes with middleware
-- Layout components (ConsoleLayout, AppSidebar, TopToolbar)
-- Theme switching
+// Hooks
+import { useChatSession, useChat } from 'captify/chat/hooks';
 
-### Using Storybook
+// Context
+import { ChatProvider, useChatContext } from 'captify/chat/context';
 
-Storybook provides interactive documentation for all components:
+// Services
+import { ChatService } from 'captify/chat/services';
 
-```bash
-npm run storybook
+// Types
+import type { ChatMessage, ChatSession } from 'captify/chat/chat.interfaces';
+import { chatMessageSchema } from 'captify/chat/chat.schemas';
 ```
 
-Open [http://localhost:6006](http://localhost:6006) to explore components.
-
-## Available Components
-
-### Layout Components
-
-- **ConsoleLayout** - Main application layout wrapper
-- **AppHeader** - Application header
-- **AppSidebar** - Collapsible sidebar with navigation
-- **AppServicesBar** - Quick access services bar
-- **TopToolbar** - Top toolbar with search, notifications, profile
-
-### UI Components (shadcn/ui)
-
-- **Avatar** - User avatar display
-- **Badge** - Status and notification badges
-- **Button** - Various button variants
-- **Card** - Content cards
-- **Checkbox** - Form checkbox input
-- **Dialog** - Modal dialogs
-- **Dropdown Menu** - Context menus
-- **Input** - Text input fields
-- **Separator** - Visual dividers
-- **Sheet** - Slide-out panels
-- **Skeleton** - Loading placeholders
-- **Table** - Data tables
-- **Tooltip** - Hover tooltips
+### Files Module
 
-### Feature Components
+File management with S3 integration:
 
-- **Breadcrumb** - Navigation breadcrumbs
-- **Notifications** - Notification center
-- **AppLauncher** - Application launcher grid
-- **TermsAndConditionsModal** - Terms acceptance modal
-- **GenericNotFoundUI** - 404 error page
-
-### Context Providers
-
-- **BookmarkProvider** - Bookmark management
-- **ThemeProvider** - Dark/light theme switching
-
-### Hooks
-
-- **useBookmarkContext** - Access bookmark state
-- **useIsMobile** - Responsive breakpoint detection
-
-### Services
+```typescript
+// Components
+import { FileUploader, FileList, FileViewer } from 'captify/files/components';
 
-- **AWS Services** - S3, DynamoDB, Cognito integrations
+// Hooks
+import { useFileUpload, useFiles } from 'captify/files/hooks';
 
-## Usage Examples
+// Services
+import { FileService, S3Service } from 'captify/files/services';
 
-### Using ConsoleLayout
+// Types
+import type { FileMetadata } from 'captify/files/files.interfaces';
+```
 
-```tsx
-import { ConsoleLayout } from "@captify/captify-core/components";
-import { MenuItem } from "@captify/captify-core/types";
+### Shared Module
 
-const menuItems: MenuItem[] = [
-  { title: "Dashboard", url: "/dashboard", icon: "Home" },
-  { title: "Settings", url: "/settings", icon: "Settings" },
-];
+Common utilities, UI components, and providers:
 
-export default function MyApp() {
-  return (
-    <ConsoleLayout appName="My Application" menuItems={menuItems}>
-      <main>{/* Your content */}</main>
-    </ConsoleLayout>
-  );
-}
+```typescript
+// UI Components (shadcn/ui)
+import {
+  Button,
+  Card,
+  Dialog,
+  Input,
+  Select,
+  Tabs,
+  Toast,
+  Tooltip
+} from 'captify/shared/components';
+
+// Utilities
+import { cn } from 'captify/shared/utilities/cn';
+import { formatDate } from 'captify/shared/utilities/date-utilities';
+import { invariant } from 'captify/shared/utilities/invariant';
+
+// Providers
+import { QueryProvider } from 'captify/shared/providers';
+
+// Hooks
+import { useMobile, useDebounce } from 'captify/shared/hooks';
 ```
 
-### Using Bookmark Context
+### LLM Providers Module
 
-```tsx
-import { useBookmarkContext } from '@captify/captify-core/hooks';
-
-function MyComponent() {
-  const {
-    bookmarkedServices,
-    addBookmark,
-    removeBookmark
-  } = useBookmarkContext();
-
-  const handleBookmark = (service: ServiceItem) => {
-    if (bookmarkedServices.find(s => s.id === service.id)) {
-      removeBookmark(service.id);
-    } else {
-      addBookmark(service);
-    }
-  };
+Multi-provider LLM configuration:
 
-  return (
-    // Your component JSX
-  );
-}
-```
+```typescript
+// Components
+import { ModelSelector, ProviderConfig } from 'captify/llm-providers/components';
 
-### Using Utility Functions
+// Hooks
+import { useModelSelection } from 'captify/llm-providers/hooks';
 
-```tsx
-import { cn } from "@captify/captify-core/utils";
+// Services
+import { LLMProviderService } from 'captify/llm-providers/services';
 
-function MyComponent() {
-  return (
-    <div className={cn("base-styles", condition && "conditional-styles", className)}>Content</div>
-  );
-}
+// Types
+import type { LLMProvider, ModelConfig } from 'captify/llm-providers/llm-providers.interfaces';
 ```
 
-## Module Exports
+## Import Patterns
 
-**v0.2.0+**: The library uses granular exports to prevent naming conflicts and enable better tree-shaking. You **must** import from specific module paths.
+### Module-Level Imports (Recommended)
 
-**v0.3.0+**: Enhanced with even more granular exports for maximum flexibility and optimal tree-shaking.
-
-### Available Module Paths
-
-#### Category-Level Exports (v0.2.0+)
+Import from the module's category exports:
 
 ```typescript
-// Components - All UI/UX components
-import { Button, ConsoleLayout, AppSidebar, TopToolbar } from '@captify/captify-core/components';
+import { ChatInterface } from 'captify/chat/components';
+import { useChat } from 'captify/chat/hooks';
+import { ChatService } from 'captify/chat/services';
+```
 
-// Hooks - Custom React hooks
-import { useBookmarkContext, useMobile } from '@captify/captify-core/hooks';
+### Granular Imports
 
-// Utils - Utility functions
-import { cn, formatDate } from '@captify/captify-core/utils';
+For maximum tree-shaking, import from specific files:
 
-// Types - TypeScript type definitions
-import { ServiceItem, MenuItem } from '@captify/captify-core/types';
+```typescript
+import { cn } from 'captify/shared/utilities/cn';
+import { formatDate } from 'captify/shared/utilities/date-utilities';
+import { invariant } from 'captify/shared/utilities/invariant';
+```
 
-// Interfaces - TypeScript interfaces
-import { NotificationProps, LayoutProps } from '@captify/captify-core/interfaces';
+### Type Imports
 
-// Services - AWS service integrations
-import { CognitoAdminService, DynamoDBService, S3Service } from '@captify/captify-core/services';
+Import interfaces and schemas directly:
 
-// Actions - Server actions
-import { acceptTermsAndConditions, cognitoSignOut } from '@captify/captify-core/actions';
+```typescript
+import type { ChatMessage } from 'captify/chat/chat.interfaces';
+import { chatMessageSchema } from 'captify/chat/chat.schemas';
+import { CHAT_CONSTANTS } from 'captify/chat/chat.constants';
+```
 
-// Auth - NextAuth configuration
-import { auth, signIn, signOut } from '@captify/captify-core/auth';
+## Development
 
-// Context - React Context providers
-import { BookmarkProvider, ThemeProvider } from '@captify/captify-core/context';
+### Prerequisites
 
-// Providers - React providers
-import { AuthSessionProvider } from '@captify/captify-core/providers';
+- Node.js >= 20.0.0
+- npm/pnpm/yarn
 
-// Config - Configuration files
-import { routeConfig } from '@captify/captify-core/config';
+### Setup
 
-// Constants - Application constants
-import { APP_LAUNCHER_CONSTANTS } from '@captify/captify-core/constants';
-```
+1. Clone the repository
+2. Install dependencies:
+   ```bash
+   npm install
+   ```
+3. Copy the environment template:
+   ```bash
+   cp .env.example .env
+   ```
+4. Configure your environment variables
 
-#### Granular Exports (v0.3.0+)
+### Running the Test Application
 
-For even better tree-shaking and more precise imports:
+The `app/` directory contains a test application for developing and testing library components:
 
-```typescript
-// ===== COMPONENTS =====
-// Specific component groups
-import { AppLauncher } from '@captify/captify-core/components/app-launcher';
-import { BreadcrumbComponent } from '@captify/captify-core/components/breadcrumb';
-import { ConsoleLayout } from '@captify/captify-core/components/console-layout';
-import { ErrorBoundary } from '@captify/captify-core/components/error-boundary';
-import { AppLayout, AppHeader, AppSidebar } from '@captify/captify-core/components/layouts';
-import { LoadingSkeleton } from '@captify/captify-core/components/loading-skeleton';
-import { GenericNotFoundUI } from '@captify/captify-core/components/not-found';
-import { Notifications } from '@captify/captify-core/components/notifications';
-import { FeaturedServiceNavItem } from '@captify/captify-core/components/services';
-import { TermsAndConditionsModal } from '@captify/captify-core/components/terms-and-agreements';
-import { TopToolbar, TopRightToolbar } from '@captify/captify-core/components/toolbars';
-import { Button, Card, Dialog, Input } from '@captify/captify-core/components/ui';
-
-// ===== HOOKS =====
-import { useMobile } from '@captify/captify-core/hooks/use-mobile';
-import { useNotifications } from '@captify/captify-core/hooks/use-notifications';
-
-// ===== UTILS =====
-import { cn } from '@captify/captify-core/utils/cn';
-import { formatDate } from '@captify/captify-core/utils/date';
-import { invariant } from '@captify/captify-core/utils/invariant';
-import { capitalize } from '@captify/captify-core/utils/string';
-
-// ===== CONTEXT =====
-import { BookmarkProvider } from '@captify/captify-core/context/bookmark';
-import { ThemeProvider } from '@captify/captify-core/context/theme';
-
-// ===== ACTIONS =====
-import { cognitoSignOut } from '@captify/captify-core/actions/auth';
-import { acceptTermsAndConditions } from '@captify/captify-core/actions/terms-and-conditions';
-
-// ===== AUTH =====
-import { refreshCognitoTokens } from '@captify/captify-core/auth/refresh-token';
-
-// ===== CONFIG =====
-import { routeConfig } from '@captify/captify-core/config/route-config';
-
-// ===== CONSTANTS =====
-import { APP_LAUNCHER_CONSTANTS } from '@captify/captify-core/constants/app-launcher';
-import { PROFILE_DROPDOWN_ITEMS } from '@captify/captify-core/constants/profile-dropdown';
-import { TABLES } from '@captify/captify-core/constants/tables';
-
-// ===== INTERFACES =====
-import { AppLauncherProps } from '@captify/captify-core/interfaces/app-launcher';
-import { BreadcrumbProps } from '@captify/captify-core/interfaces/breadcrumb';
-import { LayoutProps } from '@captify/captify-core/interfaces/layout-props';
-import { NavConfigProps } from '@captify/captify-core/interfaces/nav-config-props';
-import { NotificationProps } from '@captify/captify-core/interfaces/notification-props';
-import { RouteItem } from '@captify/captify-core/interfaces/route-item';
-import { SearchProps } from '@captify/captify-core/interfaces/search';
-import { ServiceItem } from '@captify/captify-core/interfaces/service';
-import { SidebarProps } from '@captify/captify-core/interfaces/sidebar-props';
-import { ToolbarProps } from '@captify/captify-core/interfaces/toolbar-props';
-
-// ===== PROVIDERS =====
-import { AuthSessionProvider } from '@captify/captify-core/providers/auth-session';
-
-// ===== SERVICES =====
-// Chat Service
-import { ChatService } from '@captify/captify-core/services/chat';
-import { CHAT_CONSTANTS } from '@captify/captify-core/services/chat/constants';
-import { ChatError } from '@captify/captify-core/services/chat/errors';
-import { ChatMessage } from '@captify/captify-core/services/chat/interfaces';
-import { ChatService as ChatServiceClass } from '@captify/captify-core/services/chat/services';
-import { validateChatMessage } from '@captify/captify-core/services/chat/utilities';
-
-// Cognito Service
-import { CognitoAdminService } from '@captify/captify-core/services/cognito';
-import { COGNITO_CONSTANTS } from '@captify/captify-core/services/cognito/constants';
-import { CognitoError } from '@captify/captify-core/services/cognito/errors';
-import { CognitoUser } from '@captify/captify-core/services/cognito/interfaces';
-import { CognitoAdminService as CognitoAdmin } from '@captify/captify-core/services/cognito/services';
-
-// DynamoDB Service
-import { DynamoDBService } from '@captify/captify-core/services/dynamodb';
-import { DYNAMODB_CONSTANTS } from '@captify/captify-core/services/dynamodb/constants';
-import { DynamoDBError } from '@captify/captify-core/services/dynamodb/errors';
-import { DynamoDBConfig } from '@captify/captify-core/services/dynamodb/interfaces';
-import { DynamoDBService as DynamoDBClient } from '@captify/captify-core/services/dynamodb/services';
-
-// S3 Service
-import { S3Service } from '@captify/captify-core/services/s3';
-import { S3_CONSTANTS } from '@captify/captify-core/services/s3/constants';
-import { S3Error } from '@captify/captify-core/services/s3/errors';
-import { S3Config } from '@captify/captify-core/services/s3/interfaces';
-import { S3Service as S3Client } from '@captify/captify-core/services/s3/services';
-
-// Shared Service Utilities
-import { BaseAwsService } from '@captify/captify-core/services/shared';
-import { AWS_ERROR_KIND } from '@captify/captify-core/services/shared/constants';
-import { BaseAwsError } from '@captify/captify-core/services/shared/errors';
-import { Logger, ConsoleLogger } from '@captify/captify-core/services/logger';
-import { BaseAwsService as AwsService } from '@captify/captify-core/services/shared/services';
+```bash
+npm run dev
 ```
 
-### Why Granular Exports?
+Open [http://localhost:3000](http://localhost:3000)
 
-✅ **No naming conflicts** - Isolated modules prevent name collisions
-✅ **Better tree-shaking** - Only bundle what you actually use
-✅ **Clearer dependencies** - Explicit about what you're importing
-✅ **Improved IDE autocomplete** - More precise suggestions
-✅ **Optimal bundle size** - Import exactly what you need (v0.3.0)
-✅ **Flexible imports** - Choose between category or granular imports (v0.3.0)
+### Storybook
 
-## Authentication
+Interactive component documentation:
 
-The library includes NextAuth.js integration with AWS Cognito:
+```bash
+npm run storybook
+```
 
-### Setup
+Open [http://localhost:6006](http://localhost:6006)
 
-1. Configure environment variables (see `.env.example`)
-2. The auth config is in `lib/auth/index.ts`
-3. Middleware protects routes automatically
+## Scripts
 
-### Usage in Your App
+```bash
+# Development
+npm run dev              # Start Next.js dev server with Turbopack (port 3000)
+npm run storybook        # Start Storybook on port 6006
 
-```tsx
-import { auth } from "@captify/captify-core/auth";
+# Building
+npm run build            # Build library (TypeScript to dist/)
+npm run build:next       # Build Next.js app
 
-// Server component
-export default async function Page() {
-  const session = await auth();
+# Validation
+npm run validate         # Run lint + type-check
+npm run lint             # Run ESLint
+npm run lint:fix         # ESLint with auto-fix
+npm run type-check       # TypeScript check without emit
 
-  if (!session) {
-    return <div>Not authenticated</div>;
-  }
+# Formatting
+npm run prettify         # Check Prettier formatting
+npm run prettify:fix     # Auto-format with Prettier
 
-  return <div>Hello {session.user.name}</div>;
-}
+# Testing
+npm test                 # Run Playwright e2e tests
+npm run test:ui          # Playwright UI mode
+npm run test:headed      # Playwright headed mode
+npm run test:debug       # Playwright debug mode
+npm run test:unit        # Run Vitest unit tests
 ```
 
-## Adding New Components
+## TypeScript Configuration
 
-1. Create component in appropriate `lib/` subdirectory:
+- `tsconfig.json` - Development config for Next.js
+- `tsconfig.build.json` - Library build config (compiles `lib/` to `dist/`)
 
-   ```bash
-   lib/components/my-component/
-   ├── my-component.tsx
-   └── index.ts
-   ```
+### Path Aliases
 
-2. Export from directory's `index.ts`:
+- `@/*` maps to project root
+- `captify/*` maps to `lib/*`
 
-   ```typescript
-   export * from "./my-component";
-   ```
+## Code Quality
 
-3. Export from parent module:
+### ESLint Rules
 
-   ```typescript
-   // lib/components/index.ts
-   export * from "./my-component";
-   ```
+- `no-console: error` - Use `// eslint-disable-next-line no-console` for intentional logs
+- `no-undef: error` - All variables must be defined
+- Unused variables with `_` prefix are allowed
+- `lib/shared/components/ui/**` is ignored (shadcn/ui components)
 
-4. Create Storybook story (optional):
-   ```bash
-   stories/components/MyComponent.stories.tsx
-   ```
+### Pre-commit Hooks
 
-## Code Quality
+Husky runs lint-staged on commit for:
+- ESLint fixes
+- Prettier formatting
 
-### ESLint Rules
+## AWS Services Integration
 
-- Strict mode enabled
-- `no-console: error` (use `// eslint-disable-next-line no-console` for intentional logs)
-- `no-undef: error`
-- Unused vars allowed with `_` prefix
-- `lib/components/ui/**` ignored (external shadcn components)
+The library integrates with multiple AWS services:
 
-### Pre-commit Hooks
+- **Cognito** - User authentication and management
+- **S3** - File storage and presigned URLs
+- **DynamoDB** - Database operations
+- **Bedrock** - AI/LLM inference
 
-Husky runs lint-staged on commit to auto-fix:
+## AI SDK Integration
 
-- ESLint issues
-- Prettier formatting
+Multi-provider AI support via Vercel AI SDK:
 
-## TypeScript
-
-Two TypeScript configurations:
-
-- `tsconfig.json` - Next.js development
-- `tsconfig.build.json` - Library build (targets `lib/`, outputs `dist/`)
-
-Path aliases:
-
-- `@/*` → project root
-- `@captify/captify-core` → `lib/`
-
-## Styling
-
-- **Tailwind CSS** with custom configuration
-- **CSS Variables** for theming
-- **Dark Mode** support via next-themes
-- **shadcn/ui** style: "new-york", base color: "neutral"
-
-## Browser Support
-
-- Modern browsers (Chrome, Firefox, Safari, Edge)
-- ES2020+ features
-
-## Changelog
-
-### v0.3.0 (2025-01-26)
-
-**New Features:**
-- ✨ **100+ Granular Export Paths** - Ultra-precise imports for optimal tree-shaking
-- ✨ **Component-Level Exports** - Import specific components directly
-  - `@captify/captify-core/components/app-launcher`
-  - `@captify/captify-core/components/console-layout`
-  - `@captify/captify-core/components/breadcrumb`
-  - And many more!
-- ✨ **Hook-Level Exports** - Direct hook imports
-  - `@captify/captify-core/hooks/use-mobile`
-  - `@captify/captify-core/hooks/use-notifications`
-- ✨ **Utility-Level Exports** - Import individual utilities
-  - `@captify/captify-core/utils/cn`
-  - `@captify/captify-core/utils/date`
-  - `@captify/captify-core/utils/string`
-- ✨ **Service Submodule Exports** - Granular service imports
-  - `@captify/captify-core/services/cognito/services`
-  - `@captify/captify-core/services/cognito/constants`
-  - `@captify/captify-core/services/cognito/errors`
-  - Similar structure for S3, DynamoDB, and Chat services
-- ✨ **Interface-Level Exports** - Import specific interfaces
-  - `@captify/captify-core/interfaces/app-launcher`
-  - `@captify/captify-core/interfaces/breadcrumb`
-  - And all other interfaces
-- ✨ **Constant-Level Exports** - Direct constant imports
-  - `@captify/captify-core/constants/app-launcher`
-  - `@captify/captify-core/constants/profile-dropdown`
-  - `@captify/captify-core/constants/tables`
-
-**Improvements:**
-- 🎯 **Maximum Tree-Shaking** - Import exactly what you need, nothing more
-- 🎯 **Smaller Bundle Sizes** - Granular imports reduce final bundle size
-- 🎯 **Better Developer Experience** - More intuitive import paths
-- 🎯 **Flexible Import Strategy** - Choose between category or granular imports
-- 📝 **Comprehensive Documentation** - Full list of all 100+ export paths
-- 🔧 **UI Components Index** - Added index.ts for all shadcn/ui components
-- 🔧 **Constants Export** - Added missing tables constants export
-
-**Technical:**
-- 📦 Published to npm registry as public package
-- ✅ All validation and build checks pass
-- ✅ Path aliases properly converted to relative imports
-
-### v0.2.0 (2025-01-26)
-
-**Breaking Changes:**
-- 🚨 Main entry point (`@captify/captify-core`) no longer re-exports all modules
-- All imports must now use specific module paths (e.g., `@captify/captify-core/components`)
-- See [Migration Guide](#migration-guide) for upgrade instructions
-
-**New Features:**
-- ✨ Granular exports to prevent naming conflicts
-- ✨ Added complete exports for all services (Cognito, DynamoDB, S3, Chat)
-- ✨ Added terms-and-conditions actions export
-- ✨ Added utilities exports for all service modules
-
-**Improvements:**
-- 🎯 Better tree-shaking support - only bundle what you use
-- 🎯 Clearer dependency management
-- 🎯 Improved IDE autocomplete and IntelliSense
-- 📝 Updated documentation with comprehensive import examples
-
-**Bug Fixes:**
-- 🐛 Fixed missing exports in lib/actions/index.ts
-- 🐛 Fixed missing exports in lib/services/cognito/index.ts
-- 🐛 Fixed missing exports in lib/services/dynamodb/index.ts
-
-### v0.1.20 (Previous)
-
-- Initial stable release with all core components and services
+- **Amazon Bedrock** - Claude, Titan models
+- **Anthropic** - Direct Claude API
+- **OpenAI** - GPT models
 
 ## Contributing
 
-1. Create a feature branch
-2. Make your changes
+1. Create a feature branch from `dev`
+2. Make your changes following the feature-based module structure
 3. Run `npm run validate` to ensure quality
 4. Commit your changes (pre-commit hooks will run)
-5. Submit a pull request
+5. Submit a pull request to `dev`
 
 ## License
 
-MIT
-
-## Support
-
-For issues and questions, please use the GitHub issue tracker.
-
-## Related Projects
-
-- [Next.js](https://nextjs.org/)
-- [React](https://react.dev/)
-- [shadcn/ui](https://ui.shadcn.com/)
-- [Tailwind CSS](https://tailwindcss.com/)
-- [NextAuth.js](https://next-auth.js.org/)
+Anautics Inc. All rights reserved.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "captify",
-  "version": "0.1.17",
+  "version": "0.1.18",
   "description": "Core shared library for Captify applications",
   "license": "Anautics Inc. All rights reserved.",
   "engines": {
@@ -460,7 +460,6 @@
   },
   "peerDependencies": {
     "next": "^16.0.0",
-    "next-auth": "5.0.0-beta.30",
     "react": "^19.0.0",
     "react-dom": "^19.0.0"
   },
@@ -617,6 +616,7 @@
     "motion": "^12.23.24",
     "nanoid": "^5.1.6",
     "next": "^16.0.0",
+    "next-auth": "5.0.0-beta.30",
     "next-themes": "^0.4.6",
     "pdf2json": "^4.0.0",
     "prosemirror-commands": "^1.7.1",