outlet-orm 9.0.2 → 10.0.0

package/README.md

@@ -7,6 +7,72 @@ A JavaScript ORM inspired by Laravel Eloquent for Node.js with support for MySQL
 
 📚 **[Complete documentation available in `/docs`](./docs/INDEX.md)**
 
+## Table of Contents
+
+- [✅ Prerequisites and compatibility](#prerequisites-and-compatibility)
+- [🚀 Installation](#installation)
+  - [Install the database driver](#install-the-database-driver)
+- [📁 Recommended Project Structure](#recommended-project-structure)
+  - [🏗️ Architecture Flow](#architecture-flow)
+  - [📋 Role of each layer](#role-of-each-layer)
+  - [✅ Benefits of this architecture](#benefits-of-this-architecture)
+  - [📝 Example workflow](#example-workflow)
+- [✨ Key features](#key-features)
+- [⚡ Quick Start](#quick-start)
+  - [Project Initialisation](#project-initialisation)
+  - [🌱 Quick Seeding](#quick-seeding)
+- [📖 Usage](#usage)
+  - [Connection configuration](#connection-configuration)
+  - [Importation](#importation)
+  - [Define a model](#define-a-model)
+  - [CRUD operations](#crud-operations)
+  - [Query Builder](#query-builder)
+  - [Relationship filters](#relationship-filters)
+- [🔗 Relations](#relations)
+  - [One to One (hasOne)](#one-to-one-hasone)
+  - [One to Many (hasMany)](#one-to-many-hasmany)
+  - [Belongs To (belongsTo)](#belongs-to-belongsto)
+  - [Many to Many (belongsToMany)](#many-to-many-belongstomany)
+  - [Has Many Through (hasManyThrough)](#has-many-through-hasmanythrough)
+  - [Has One Through (hasOneThrough)](#has-one-through-hasonethrough)
+  - [Polymorphic relationships](#polymorphic-relationships)
+  - [Eager Loading](#eager-loading)
+- [🎭 Attributs](#attributs)
+  - [Casts](#casts)
+  - [Hidden attributes](#hidden-attributes)
+  - [Timestamps](#timestamps)
+- [🔄 Transactions](#transactions)
+- [🗑️ Soft Deletes](#soft-deletes)
+- [🔬 Scopes](#scopes)
+  - [Scopes Globaux](#scopes-globaux)
+- [📣 Events / Hooks](#events-hooks)
+- [✅ Validation](#validation)
+  - [Available rules](#available-rules)
+- [📊 Query Logging](#query-logging)
+- [📝 API Reference](#api-reference)
+  - [DatabaseConnection](#databaseconnection)
+  - [Model (static methods)](#model-static-methods)
+  - [Model (instance methods)](#model-instance-methods)
+  - [QueryBuilder](#querybuilder)
+- [🛠️ CLI tools](#cli-tools)
+  - [outlet-init](#outlet-init)
+  - [outlet-migrate](#outlet-migrate)
+  - [outlet-convert](#outlet-convert)
+- [🤖 AI Integration](#ai-integration)
+  - [AI — Multi-Provider LLM Abstraction](#ai-multi-provider-llm-abstraction)
+  - [AI Query Builder — Natural Language → SQL](#ai-query-builder-natural-language-sql)
+  - [AI Seeder — Realistic Data Generation](#ai-seeder-realistic-data-generation)
+  - [AI Query Optimizer](#ai-query-optimizer)
+  - [MCP Server — AI Agent Integration](#mcp-server-ai-agent-integration)
+- [📚 Documentation](#documentation)
+- [📘 TypeScript Support](#typescript-support)
+  - [Typed models](#typed-models)
+  - [Migrations typedes](#migrations-typedes)
+- [🤝 Contributions](#contributions)
+- [📄 Licence](#licence)
+
+---
+
 ## ✅ Prerequisites and compatibility
 
 - Node.js >= 18 (recommended/required)
@@ -197,7 +263,7 @@ async store(req, res) {
 - **Raw queries**: `executeRawQuery()` and `execute()` (native driver results)
 - **Complete Migrations** (create/alter/drop, index, foreign keys, batch tracking)
 - **Database Backup** (v6.0.0): full/partial/journal backups, recurring scheduler, AES-256-GCM encryption, TCP daemon + remote client, automatic restore
-- **🤖 AiBridge** (v8.0.0): Multi-provider LLM abstraction — chat, stream, embeddings, images, TTS, STT with 9+ providers
+- **🤖 AI** (v8.0.0): Multi-provider LLM abstraction — chat, stream, embeddings, images, TTS, STT with 9+ providers
 - **🤖 AI Query Builder** (v8.0.0): Natural language → SQL with schema introspection
 - **🤖 AI Seeder** (v8.0.0): LLM-powered realistic, domain-specific data generation
 - **🤖 AI Query Optimizer** (v8.0.0): SQL analysis, optimization, and index recommendations
@@ -1233,12 +1299,12 @@ Outlet ORM includes a complete AI subsystem with multi-provider LLM support and
 
 📚 **[Complete AI documentation available in `/docs`](./docs/AI_BRIDGE.md)**
 
-### AiBridge — Multi-Provider LLM Abstraction
+### AI — Multi-Provider LLM Abstraction
 
 ```javascript
-const { AiBridgeManager } = require('outlet-orm');
+const { AIManager } = require('outlet-orm');
 
-const ai = new AiBridgeManager({
+const ai = new AIManager({
   providers: {
     openai: { api_key: process.env.OPENAI_API_KEY, model: 'gpt-4o' },
     claude: { api_key: process.env.ANTHROPIC_API_KEY, model: 'claude-sonnet-4-20250514' },
@@ -1339,7 +1405,7 @@ Configure your AI editor:
 **13 MCP tools**: migrations, schema introspection, queries, seeds, backups, AI query, query optimization
 
 📖 Full documentation:
-- [AiBridge Manager](docs/AI_BRIDGE.md) — Multi-provider LLM abstraction
+- [AI Manager](docs/AI_BRIDGE.md) — Multi-provider LLM abstraction
 - [AI Query Builder](docs/AI_QUERY.md) — Natural language to SQL
 - [AI Seeder](docs/AI_SEEDER.md) — Realistic data generation
 - [AI Query Optimizer](docs/AI_OPTIMIZER.md) — SQL optimization

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "outlet-orm",
-  "version": "9.0.2",
+  "version": "10.0.0",
   "description": "A Laravel Eloquent-inspired ORM for Node.js with support for MySQL, PostgreSQL, and SQLite",
   "main": "src/index.js",
   "types": "types/index.d.ts",

package/skills/outlet-orm/AI.md

@@ -1,6 +1,6 @@
 ---
 name: outlet-orm-ai-integration
-description: Guide for AI agents to use Outlet ORM's AiBridge multi-provider LLM, AI Query Builder, AI Seeder, AI Optimizer, AI Prompt Enhancer, MCP Server, and AI Safety Guardrails. Use this skill when an AI agent needs to interact with LLMs, databases, run migrations, generate data, optimize queries, or create projects safely.
+description: Guide for AI agents to use Outlet ORM's AI multi-provider LLM, AI Query Builder, AI Seeder, AI Optimizer, AI Prompt Enhancer, MCP Server, and AI Safety Guardrails. Use this skill when an AI agent needs to interact with LLMs, databases, run migrations, generate data, optimize queries, or create projects safely.
 license: MIT
 metadata:
   author: omgbwa-yasse
@@ -13,7 +13,7 @@ metadata:
 
 This skill covers Outlet ORM's complete AI feature set (v7.0.0 – v9.0.0):
 
-- **AiBridge** — Multi-provider LLM abstraction (9 providers, chat, stream, embeddings, images, TTS, STT, tool calling)
+- **AI** — Multi-provider LLM abstraction (9 providers, chat, stream, embeddings, images, TTS, STT, tool calling)
 - **AI Query Builder** — Natural language to SQL
 - **AI Seeder** — LLM-powered realistic data generation
 - **AI Query Optimizer** — SQL optimization and EXPLAIN analysis
@@ -23,16 +23,16 @@ This skill covers Outlet ORM's complete AI feature set (v7.0.0 – v9.0.0):
 
 ---
 
-## AiBridge — Multi-Provider LLM Abstraction
+## AI — Multi-Provider LLM Abstraction
 
 > Since v8.0.0
 
-AiBridge provides a unified API to interact with 9+ LLM providers. Zero production dependencies (Node 18+ native `fetch`).
+AI provides a unified API to interact with 9+ LLM providers. Zero production dependencies (Node 18+ native `fetch`).
 
 ### Configuration
 
 ```javascript
-// config/aibridge.js
+// config/ai.js
 module.exports = {
   default: process.env.AI_DEFAULT_PROVIDER || 'openai',
   providers: {
@@ -84,9 +84,9 @@ module.exports = {
 ### Chat
 
 ```javascript
-const { AiBridgeManager } = require('outlet-orm');
+const { AIManager } = require('outlet-orm');
 
-const ai = new AiBridgeManager(config);
+const ai = new AIManager(config);
 
 const response = await ai.chat('openai', [
   { role: 'system', content: 'You are a helpful assistant.' },
@@ -179,14 +179,14 @@ const response = await ai.chatWithTools('openai', [
 ]);
 ```
 
-### AiBridge Facade
+### AI Facade
 
 ```javascript
-const { AiBridge, AiBridgeManager } = require('outlet-orm');
+const { AI, AIManager } = require('outlet-orm');
 
-AiBridge.setManager(new AiBridgeManager(config));
+AI.setManager(new AIManager(config));
 
-const { text } = await AiBridge.text()
+const { text } = await AI.text()
   .using('openai', 'gpt-4o')
   .withPrompt('Hello!')
   .asText();
@@ -226,9 +226,9 @@ const { text } = await AiBridge.text()
 Convert natural language questions into SQL queries using any LLM.
 
 ```javascript
-const { AiBridgeManager, AIQueryBuilder, DatabaseConnection } = require('outlet-orm');
+const { AIManager, AIQueryBuilder, DatabaseConnection } = require('outlet-orm');
 
-const ai = new AiBridgeManager(config);
+const ai = new AIManager(config);
 const db = new DatabaseConnection();
 const qb = new AIQueryBuilder(ai, db);
 
@@ -267,9 +267,9 @@ const { sql } = await qb.toSql('Find duplicate emails');
 Generate realistic, domain-specific seed data using AI.
 
 ```javascript
-const { AiBridgeManager, AISeeder, DatabaseConnection } = require('outlet-orm');
+const { AIManager, AISeeder, DatabaseConnection } = require('outlet-orm');
 
-const seeder = new AISeeder(new AiBridgeManager(config), new DatabaseConnection());
+const seeder = new AISeeder(new AIManager(config), new DatabaseConnection());
 
 // Generate and insert
 const { records, inserted } = await seeder.seed('users', 10, {
@@ -309,9 +309,9 @@ const records = await seeder.generate('products', 20, {
 Analyze and optimize SQL queries using AI with index recommendations.
 
 ```javascript
-const { AiBridgeManager, AIQueryOptimizer, DatabaseConnection } = require('outlet-orm');
+const { AIManager, AIQueryOptimizer, DatabaseConnection } = require('outlet-orm');
 
-const optimizer = new AIQueryOptimizer(new AiBridgeManager(config), new DatabaseConnection());
+const optimizer = new AIQueryOptimizer(new AIManager(config), new DatabaseConnection());
 
 // Optimize
 const result = await optimizer.optimize(
@@ -352,9 +352,9 @@ const { plan, analysis } = await optimizer.explain('SELECT ...');
 Generate complete schemas, models, and migrations from natural language.
 
 ```javascript
-const { AiBridgeManager, AIPromptEnhancer } = require('outlet-orm');
+const { AIManager, AIPromptEnhancer } = require('outlet-orm');
 
-const enhancer = new AIPromptEnhancer(new AiBridgeManager(config));
+const enhancer = new AIPromptEnhancer(new AIManager(config));
 
 // Generate full schema
 const schema = await enhancer.generateSchema(
@@ -546,10 +546,10 @@ console.log(result.allowed); // true
 
 ```javascript
 const {
-  // AiBridge — Multi-Provider LLM
-  AiBridgeManager,       // Main manager (chat, stream, embeddings, images, TTS, STT, tools)
-  AiBridge,              // Static facade
-  // AiBridge Support
+  // AI — Multi-Provider LLM
+  AIManager,       // Main manager (chat, stream, embeddings, images, TTS, STT, tools)
+  AI,              // Static facade
+  // AI Support
   Message,               // Chat message value object
   Document,              // File/URL/base64 attachment
   StreamChunk,           // Streaming DTO

package/skills/outlet-orm/API.md

@@ -515,15 +515,15 @@ const db = new DatabaseConnection({
 
 ---
 
-## AiBridgeManager
+## AIManager
 
 > Since v8.0.0
 
 ### Constructor
 
 ```javascript
-const { AiBridgeManager } = require('outlet-orm');
-const ai = new AiBridgeManager(config); // From config/aibridge.js or inline
+const { AIManager } = require('outlet-orm');
+const ai = new AIManager(config); // From config/ai.js or inline
 ```
 
 ### Methods

package/skills/outlet-orm/QUERIES.md

@@ -304,12 +304,12 @@ const native = await db.execute(
 
 > Since v8.0.0
 
-Convert natural language into SQL queries using any LLM provider via AiBridge.
+Convert natural language into SQL queries using any LLM provider via AI.
 
 ```javascript
-const { AiBridgeManager, AIQueryBuilder, DatabaseConnection } = require('outlet-orm');
+const { AIManager, AIQueryBuilder, DatabaseConnection } = require('outlet-orm');
 
-const ai = new AiBridgeManager({ providers: { openai: { api_key: process.env.OPENAI_API_KEY, model: 'gpt-4o-mini' } } });
+const ai = new AIManager({ providers: { openai: { api_key: process.env.OPENAI_API_KEY, model: 'gpt-4o-mini' } } });
 const db = new DatabaseConnection();
 const qb = new AIQueryBuilder(ai, db);
 

package/skills/outlet-orm/SEEDS.md

@@ -106,9 +106,9 @@ outlet-migrate seed
 Generate realistic domain-specific seed data using AI instead of generic lorem ipsum.
 
 ```javascript
-const { AiBridgeManager, AISeeder, DatabaseConnection } = require('outlet-orm');
+const { AIManager, AISeeder, DatabaseConnection } = require('outlet-orm');
 
-const ai = new AiBridgeManager({
+const ai = new AIManager({
   providers: { openai: { api_key: process.env.OPENAI_API_KEY, model: 'gpt-4o-mini' } }
 });
 const seeder = new AISeeder(ai, new DatabaseConnection());

package/skills/outlet-orm/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: outlet-orm-best-practices
-description: Outlet ORM is a Laravel Eloquent-inspired ORM for Node.js with MySQL, PostgreSQL, and SQLite support. Use this skill when working with Outlet ORM models, queries, relationships, migrations, backup, AI integration (AiBridge multi-provider LLM, AI Query Builder, AI Seeder, AI Optimizer, MCP Server) and database operations.
+description: Outlet ORM is a Laravel Eloquent-inspired ORM for Node.js with MySQL, PostgreSQL, and SQLite support. Use this skill when working with Outlet ORM models, queries, relationships, migrations, backup, AI integration (AI multi-provider LLM, AI Query Builder, AI Seeder, AI Optimizer, MCP Server) and database operations.
 license: MIT
 metadata:
 author: omgbwa-yasse
@@ -13,9 +13,9 @@ npm: https://www.npmjs.com/package/outlet-orm
 
 Comprehensive guide for using Outlet ORM - a Laravel Eloquent-inspired ORM for Node.js/TypeScript with support for MySQL, PostgreSQL, and SQLite.
 
-> 🆕 **v9.0.0**: Complete AI documentation — AiBridge multi-provider LLM, AI Query Builder, AI Seeder, AI Optimizer, AI Prompt Enhancer, AI Safety Guardrails. See [AI.md](AI.md).
+> 🆕 **v9.0.0**: Complete AI documentation — AI multi-provider LLM, AI Query Builder, AI Seeder, AI Optimizer, AI Prompt Enhancer, AI Safety Guardrails. See [AI.md](AI.md).
 >
-> 🔖 **v8.0.0**: AiBridge multi-provider LLM abstraction (9 providers), AI Query Builder, AI Seeder, AI Query Optimizer, AI Prompt Enhancer.
+> 🔖 **v8.0.0**: AI multi-provider LLM abstraction (9 providers), AI Query Builder, AI Seeder, AI Query Optimizer, AI Prompt Enhancer.
 >
 > 🔖 **v7.0.0**: AI Integration — MCP Server (Model Context Protocol), AI Safety Guardrails, Prompt-based project initialization.
 >
@@ -37,7 +37,7 @@ Comprehensive guide for using Outlet ORM - a Laravel Eloquent-inspired ORM for N
 | **[TYPESCRIPT.md](TYPESCRIPT.md)** | TypeScript types, generics, typed models, migrations |
 | **[SECURITY.md](SECURITY.md)** | 🔐 Security best practices, authentication, authorisation |
 | **[BACKUP.md](BACKUP.md)** | 🗄️ Backups, scheduling, AES-256-GCM encryption, TCP daemon, restore |
-| **[AI.md](AI.md)** | 🤖 AiBridge (9 LLM providers), AI Query Builder, AI Seeder, AI Optimizer, AI Prompt Enhancer, MCP Server, AI Safety Guardrails |
+| **[AI.md](AI.md)** | 🤖 AI (9 LLM providers), AI Query Builder, AI Seeder, AI Optimizer, AI Prompt Enhancer, MCP Server, AI Safety Guardrails |
 | **[API.md](API.md)** | Complete API Reference |
 
 ---
@@ -56,7 +56,7 @@ Reference these guidelines when:
 - Scheduling or encrypting database backups  [BACKUP.md](BACKUP.md)
 - Restoring a database from a backup file  [BACKUP.md](BACKUP.md)
 - Running a long-lived backup daemon over TCP  [BACKUP.md](BACKUP.md)
-- Configuring LLM providers (AiBridge)  [AI.md](AI.md)
+- Configuring LLM providers (AI)  [AI.md](AI.md)
 - Converting natural language to SQL (AI Query Builder)  [AI.md](AI.md)
 - Generating realistic seed data with AI  [AI.md](AI.md)
 - Optimizing SQL queries with AI  [AI.md](AI.md)

package/src/AI/{AiBridgeManager.js → AIManager.js}

@@ -16,12 +16,12 @@ const ToolChatRunner = require('./Support/ToolChatRunner');
 const BEARER_PREFIX = 'Bearer ';
 
 /**
- * AiBridgeManager
+ * AIManager
  * Central orchestrator for all AI providers. Supports provider registration,
  * per-call overrides, capability delegation (chat, stream, embeddings, images,
  * audio, models), tool registration, and chatWithTools loop.
  */
-class AiBridgeManager {
+class AIManager {
   /**
    * @param {Object} config
    */
@@ -284,4 +284,4 @@ class AiBridgeManager {
   }
 }
 
-module.exports = AiBridgeManager;
+module.exports = AIManager;

package/src/AI/AIPromptEnhancer.js

@@ -10,7 +10,7 @@
  */
 class AIPromptEnhancer {
   /**
-   * @param {import('./AiBridgeManager')} manager
+   * @param {import('./AIManager')} manager
    */
   constructor(manager) {
     this._manager = manager;

package/src/AI/AIQueryBuilder.js

@@ -2,7 +2,7 @@
 
 /**
  * AIQueryBuilder
- * Natural Language → SQL conversion using any AiBridge provider.
+ * Natural Language → SQL conversion using any AI provider.
  * Introspects the database schema, sends it with the NL prompt to an LLM,
  * and returns a safe, parameterized SQL query.
  *
@@ -10,7 +10,7 @@
  */
 class AIQueryBuilder {
   /**
-   * @param {import('./AiBridgeManager')} manager - AiBridge manager instance
+   * @param {import('./AIManager')} manager - AI manager instance
    * @param {Object} connection - DatabaseConnection instance (outlet-orm)
    */
   constructor(manager, connection) {

package/src/AI/AIQueryOptimizer.js

@@ -9,7 +9,7 @@
  */
 class AIQueryOptimizer {
   /**
-   * @param {import('./AiBridgeManager')} manager
+   * @param {import('./AIManager')} manager
    * @param {Object} [connection] - DatabaseConnection instance (optional, for schema introspection)
    */
   constructor(manager, connection = null) {

package/src/AI/AISeeder.js

@@ -9,7 +9,7 @@
  */
 class AISeeder {
   /**
-   * @param {import('./AiBridgeManager')} manager
+   * @param {import('./AIManager')} manager
    * @param {Object} connection - DatabaseConnection instance
    */
   constructor(manager, connection) {

package/src/AI/Builders/TextBuilder.js

@@ -5,7 +5,7 @@ const StreamChunk = require('../Support/StreamChunk');
 
 /**
  * TextBuilder
- * Fluent builder for text generation over AiBridge providers.
+ * Fluent builder for text generation over AI providers.
  * Keeps method names short and explicit, reducing array option errors.
  *
  * @example
@@ -19,7 +19,7 @@ class TextBuilder {
   static ERR_MISSING_USING = 'Provider and model must be set via using().';
 
   /**
-   * @param {import('../AiBridgeManager')} manager
+   * @param {import('../AIManager')} manager
    */
   constructor(manager) {
     this._manager = manager;

package/src/AI/Facades/{AiBridge.js → AI.js}

@@ -1,10 +1,10 @@
 'use strict';
 
 /**
- * AiBridge Facade
+ * AI Facade
  *
- * Convenience entry-point mirroring AiBridge\Facades\AiBridge in PHP.
- * Provides static-like helpers that delegate to an AiBridgeManager instance.
+ * Convenience entry-point for AI operations.
+ * Provides static-like helpers that delegate to an AIManager instance.
  */
 
 const ImageNormalizer      = require('../Support/ImageNormalizer');
@@ -13,10 +13,10 @@ const EmbeddingsNormalizer = require('../Support/EmbeddingsNormalizer');
 
 let _manager = null;
 
-const AiBridge = {
+const AI = {
   /**
-   * Bind an AiBridgeManager instance so all helpers delegate to it.
-   * @param {import('../AiBridgeManager')} manager
+   * Bind an AIManager instance so all helpers delegate to it.
+   * @param {import('../AIManager')} manager
    */
   setManager(manager) {
     _manager = manager;
@@ -24,7 +24,7 @@ const AiBridge = {
 
   /**
    * Return the bound manager (or null).
-   * @returns {import('../AiBridgeManager')|null}
+   * @returns {import('../AIManager')|null}
    */
   getManager() {
     return _manager;
@@ -55,7 +55,7 @@ const AiBridge = {
    * @returns {import('../Builders/TextBuilder')}
    */
   text() {
-    if (!_manager) throw new Error('AiBridge facade: no manager bound. Call AiBridge.setManager(manager) first.');
+    if (!_manager) throw new Error('AI facade: no manager bound. Call AI.setManager(manager) first.');
     return _manager.text();
   },
 
@@ -63,7 +63,7 @@ const AiBridge = {
    * Shorthand for manager.chat()
    */
   async chat(messages, opts) {
-    if (!_manager) throw new Error('AiBridge facade: no manager bound.');
+    if (!_manager) throw new Error('AI facade: no manager bound.');
     return _manager.chat(messages, opts);
   },
 
@@ -71,9 +71,9 @@ const AiBridge = {
    * Shorthand for manager.provider()
    */
   provider(name) {
-    if (!_manager) throw new Error('AiBridge facade: no manager bound.');
+    if (!_manager) throw new Error('AI facade: no manager bound.');
     return _manager.provider(name);
   },
 };
 
-module.exports = AiBridge;
+module.exports = AI;

package/src/AI/MCPServer.js

@@ -115,7 +115,7 @@ const TOOL_DEFINITIONS = [
   },
   {
     name: 'ai_query',
-    description: 'Convert a natural language question into SQL and execute it. Requires an AI provider (AiBridge).',
+    description: 'Convert a natural language question into SQL and execute it. Requires an AI provider.',
     inputSchema: {
       type: 'object',
       properties: {
@@ -644,8 +644,8 @@ class MCPServer extends EventEmitter {
   async _toolAiQuery(args) {
     if (!args.question) throw new Error('A natural language question is required.');
     const conn = await this._getConnection();
-    const manager = this._getAiBridgeManager();
-    if (!manager) throw new Error('AiBridge is not configured. Set OPENAI_API_KEY or configure a provider.');
+    const manager = this._getAIManager();
+    if (!manager) throw new Error('AI is not configured. Set OPENAI_API_KEY or configure a provider.');
 
     const AIQueryBuilder = require('./AIQueryBuilder');
     const builder = new AIQueryBuilder(manager, conn);
@@ -672,8 +672,8 @@ class MCPServer extends EventEmitter {
   async _toolQueryOptimize(args) {
     if (!args.sql) throw new Error('SQL query is required.');
     const conn = await this._getConnection();
-    const manager = this._getAiBridgeManager();
-    if (!manager) throw new Error('AiBridge is not configured. Set OPENAI_API_KEY or configure a provider.');
+    const manager = this._getAIManager();
+    if (!manager) throw new Error('AI is not configured. Set OPENAI_API_KEY or configure a provider.');
 
     const AIQueryOptimizer = require('./AIQueryOptimizer');
     const optimizer = new AIQueryOptimizer(manager, conn);
@@ -692,17 +692,17 @@ class MCPServer extends EventEmitter {
     };
   }
 
-  // ── AiBridge manager helper ────────────────────────────────────
+  // ── AI manager helper ────────────────────────────────────
 
   /**
-   * Lazily creates an AiBridge manager from environment variables.
-   * @returns {import('./Bridge/AiBridgeManager')|null}
+   * Lazily creates an AI manager from environment variables.
+   * @returns {import('./AIManager')|null}
    */
-  _getAiBridgeManager() {
-    if (this._aiBridgeManager) return this._aiBridgeManager;
+  _getAIManager() {
+    if (this._aiManager) return this._aiManager;
 
     try {
-      const AiBridgeManager = require('./AiBridgeManager');
+      const AIManager = require('./AIManager');
       const config = {};
 
       // Auto-detect providers from env
@@ -716,8 +716,8 @@ class MCPServer extends EventEmitter {
 
       if (Object.keys(config).length === 0) return null;
 
-      this._aiBridgeManager = new AiBridgeManager(config);
-      return this._aiBridgeManager;
+      this._aiManager = new AIManager(config);
+      return this._aiManager;
     } catch {
       return null;
     }

package/src/AI/Support/ToolChatRunner.js

@@ -8,7 +8,7 @@
  */
 class ToolChatRunner {
   /**
-   * @param {import('../AiBridgeManager')} manager
+   * @param {import('../AIManager')} manager
    */
   constructor(manager) {
     this.manager = manager;

package/src/index.js

@@ -33,9 +33,9 @@ const MCPServer          = require('./AI/MCPServer');
 const AISafetyGuardrails = require('./AI/AISafetyGuardrails');
 const PromptGenerator    = require('./AI/PromptGenerator');
 
-// AI Bridge (v8.0.0) — Multi-provider LLM abstraction
-const AiBridgeManager       = require('./AI/AiBridgeManager');
-const AiBridgeFacade        = require('./AI/Facades/AiBridge');
+// AI (v8.0.0) — Multi-provider LLM abstraction
+const AIManager             = require('./AI/AIManager');
+const AIFacade              = require('./AI/Facades/AI');
 const TextBuilder           = require('./AI/Builders/TextBuilder');
 const ChatProviderContract  = require('./AI/Contracts/ChatProviderContract');
 const EmbeddingsProviderContract = require('./AI/Contracts/EmbeddingsProviderContract');
@@ -110,9 +110,9 @@ module.exports = {
   AISafetyGuardrails,
   PromptGenerator,
 
-  // AI Bridge (v8.0.0)
-  AiBridgeManager,
-  AiBridgeFacade,
+  // AI (v8.0.0)
+  AIManager,
+  AIFacade,
   TextBuilder,
   ChatProviderContract,
   EmbeddingsProviderContract,

package/types/index.d.ts

@@ -1154,7 +1154,7 @@ declare module 'outlet-orm' {
 
   /** Tool chat runner — executes tool loops */
   export class ToolChatRunner {
-    constructor(manager: AiBridgeManager, registry: ToolRegistry);
+    constructor(manager: AIManager, registry: ToolRegistry);
     run(provider: string, messages: Array<{ role: string; content: string }>, options?: { maxToolIterations?: number; model?: string }): Promise<ChatResponse>;
   }
 
@@ -1243,8 +1243,8 @@ declare module 'outlet-orm' {
     listModels(): Promise<any[]>;
   }
 
-  /** AiBridge manager configuration */
-  export interface AiBridgeConfig {
+  /** AI manager configuration */
+  export interface AIConfig {
     default?: string;
     openai?: OpenAIProviderConfig;
     ollama?: { endpoint?: string; model?: string };
@@ -1261,7 +1261,7 @@ declare module 'outlet-orm' {
 
   /** TextBuilder — fluent API for building AI requests */
   export class TextBuilder {
-    constructor(manager: AiBridgeManager);
+    constructor(manager: AIManager);
     using(provider: string, model?: string): this;
     withPrompt(text: string, attachments?: Document[]): this;
     withSystemPrompt(text: string): this;
@@ -1280,9 +1280,9 @@ declare module 'outlet-orm' {
     asStream(): AsyncGenerator<StreamChunk>;
   }
 
-  /** AiBridge Manager — central orchestrator for multi-provider AI */
-  export class AiBridgeManager {
-    constructor(config?: AiBridgeConfig);
+  /** AIManager — central orchestrator for multi-provider AI */
+  export class AIManager {
+    constructor(config?: AIConfig);
     provider(name: string): ChatProviderContract;
     registerProvider(name: string, provider: ChatProviderContract): void;
     chat(provider: string, messages: Array<{ role: string; content: string }>, options?: Record<string, any>): Promise<ChatResponse>;
@@ -1315,7 +1315,7 @@ declare module 'outlet-orm' {
 
   /** AIQueryBuilder — natural language to SQL conversion */
   export class AIQueryBuilder {
-    constructor(manager: AiBridgeManager, connection: DatabaseConnection);
+    constructor(manager: AIManager, connection: DatabaseConnection);
     using(provider: string, model: string): this;
     safeMode(safe: boolean): this;
     query(question: string, options?: { model?: string; max_tokens?: number; temperature?: number }): Promise<AIQueryResult>;
@@ -1330,7 +1330,7 @@ declare module 'outlet-orm' {
 
   /** AISeeder — AI-powered data seeding */
   export class AISeeder {
-    constructor(manager: AiBridgeManager, connection: DatabaseConnection);
+    constructor(manager: AIManager, connection: DatabaseConnection);
     using(provider: string, model: string): this;
     seed(table: string, count?: number, context?: { description?: string; locale?: string; domain?: string }): Promise<AISeedResult>;
     generate(table: string, count?: number, context?: { description?: string; locale?: string; domain?: string }): Promise<Record<string, any>[]>;
@@ -1348,7 +1348,7 @@ declare module 'outlet-orm' {
 
   /** AIQueryOptimizer — AI-powered SQL query optimization */
   export class AIQueryOptimizer {
-    constructor(manager: AiBridgeManager, connection?: DatabaseConnection);
+    constructor(manager: AIManager, connection?: DatabaseConnection);
     using(provider: string, model: string): this;
     optimize(sql: string, options?: { schema?: string; dialect?: string; model?: string }): Promise<OptimizationResult>;
     explain(sql: string): Promise<{ plan: any[]; analysis: string }>;
@@ -1363,7 +1363,7 @@ declare module 'outlet-orm' {
 
   /** AIPromptEnhancer — LLM-powered schema/code generation */
   export class AIPromptEnhancer {
-    constructor(manager: AiBridgeManager);
+    constructor(manager: AIManager);
     using(provider: string, model: string): this;
     generateSchema(description: string, options?: { model?: string }): Promise<AISchema>;
     generateModelCode(tableName: string, tableSchema: { columns: string[] }, relations?: any[]): Promise<string>;