outlet-orm 9.0.2 → 11.1.0

package/skills/outlet-orm/QUERIES.md

@@ -211,6 +211,30 @@ if (hasAdmins) {
 }
 ```
 
+### Sum / Avg / Min / Max (v11.0.0)
+
+```javascript
+const totalBalance = await User.query().sum('balance');
+const averageAge = await User.query().avg('age');
+const youngest = await User.query().min('age');
+const oldest = await User.query().max('age');
+
+// With conditions
+const activeTotal = await User.where('status', 'active').sum('balance');
+```
+
+### Pluck / Value (v11.0.0)
+
+```javascript
+// pluck() — get an array of values from a single column
+const emails = await User.query().pluck('email');
+// ['john@example.com', 'jane@example.com', ...]
+
+// value() — get a single value from the first row
+const name = await User.where('id', 1).value('name');
+// 'John Doe'
+```
+
 ### Group By & Having
 
 ```javascript
@@ -280,6 +304,104 @@ await User.where('id', 1).decrement('credits', 50);
 
 ---
 
+## Batch Processing — chunk() (v11.0.0)
+
+Process large datasets in manageable batches:
+
+```javascript
+// Process 100 records at a time
+await User.query().chunk(100, async (users) => {
+  for (const user of users) {
+    await sendNewsletter(user);
+  }
+});
+
+// With conditions
+await User.where('status', 'active').chunk(50, async (batch) => {
+  console.log(`Processing ${batch.length} users`);
+});
+```
+
+---
+
+## Conditional Queries — when() / tap() (v11.0.0)
+
+### when()
+
+Conditionally apply query clauses:
+
+```javascript
+const status = req.query.status; // may be undefined
+
+const users = await User.query()
+  .when(status, (query, value) => query.where('status', value))
+  .when(req.query.role, (query, value) => query.where('role', value))
+  .get();
+```
+
+### tap()
+
+Execute a callback for debugging without modifying the query:
+
+```javascript
+const users = await User.query()
+  .where('status', 'active')
+  .tap((query) => console.log('Query so far:', query.toSQL()))
+  .orderBy('name')
+  .get();
+```
+
+---
+
+## Query Debugging — toSQL() / dd() (v11.0.0)
+
+```javascript
+// toSQL() — get the SQL string and bindings
+const { sql, bindings } = User.where('status', 'active').toSQL();
+console.log(sql);      // 'SELECT * FROM users WHERE status = ?'
+console.log(bindings); // ['active']
+
+// dd() — dump and die (logs to console and throws)
+User.where('status', 'active').dd();
+// Logs: { sql: '...', bindings: [...] } then throws
+```
+
+---
+
+## Fluent Local Scopes (v11.0.0)
+
+Define reusable query constraints as static methods on the model:
+
+```javascript
+class User extends Model {
+  static table = 'users';
+
+  // Define scope as static scopeXxx(query, ...params)
+  static scopeActive(query) {
+    return query.where('status', 'active');
+  }
+
+  static scopeRole(query, role) {
+    return query.where('role', role);
+  }
+
+  static scopeRecent(query, days = 7) {
+    const date = new Date(Date.now() - days * 86400000).toISOString();
+    return query.where('created_at', '>', date);
+  }
+}
+
+// Use fluently on the query builder
+const users = await User.query().active().role('admin').recent(30).get();
+
+// Combine with other query methods
+const count = await User.query().active().count();
+```
+
+> See [ADVANCED.md](ADVANCED.md) for more details on global and local scopes.
+
+---
+
 ## Raw Queries
 
 ```javascript
@@ -304,12 +426,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);
 
@@ -394,6 +516,17 @@ See [AI.md](AI.md) for full details.
 |`paginate(page, perPage)`| Pagination |
 |`count()`| Count results |
 |`exists()`| Check existence |
+|`sum(col)`| Sum of column (v11) |
+|`avg(col)`| Average of column (v11) |
+|`min(col)`| Minimum of column (v11) |
+|`max(col)`| Maximum of column (v11) |
+|`pluck(col)`| Array of column values (v11) |
+|`value(col)`| Single value from first row (v11) |
+|`chunk(size, callback)`| Batch processing (v11) |
+|`when(condition, callback)`| Conditional clause (v11) |
+|`tap(callback)`| Debug callback (v11) |
+|`toSQL()`| Get SQL + bindings (v11) |
+|`dd()`| Dump & die debug (v11) |
 |`insert(data)`| Insert record(s) |
 |`update(attrs)`| Update records |
 |`delete()`| Delete records |

package/skills/outlet-orm/RELATIONS.md

@@ -546,6 +546,50 @@ class Category extends Model {
 |`attach(ids)`| Attach (many-to-many) |
 |`detach(ids?)`| Detach (many-to-many) |
 |`sync(ids)`| Sync (many-to-many) |
+|`withDefault(attrs?)`| Default for empty HasOne/MorphOne (v11) |
+
+---
+
+## Relation Defaults — withDefault() (v11.0.0)
+
+Return a default model instead of `null` when a `hasOne`, `morphOne` or `hasOneThrough` relationship is empty:
+
+```javascript
+class User extends Model {
+  static table = 'users';
+
+  profile() {
+    // Returns empty Profile instance instead of null
+    return this.hasOne(Profile, 'user_id').withDefault();
+  }
+
+  avatar() {
+    // Returns a Profile with default values
+    return this.morphOne(Image, 'imageable').withDefault({
+      url: '/images/default-avatar.png'
+    });
+  }
+
+  settings() {
+    // Dynamic defaults via callback
+    return this.hasOne(Settings, 'user_id').withDefault((model) => {
+      model.setAttribute('theme', 'light');
+      model.setAttribute('locale', 'en');
+    });
+  }
+}
+
+// Usage
+const user = await User.with('profile').find(1);
+console.log(user.relationships.profile); // Profile instance (never null)
+```
+
+**Signatures:**
+- `withDefault()` — empty model instance
+- `withDefault({ key: value, ... })` — model with attributes
+- `withDefault((model) => { ... })` — dynamic defaults via callback
+
+**Supported on:** `hasOne`, `morphOne`, `hasOneThrough`
 
 ---
 

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,10 +1,10 @@
 ---
 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
-version: "9.0.0"
+version: "11.0.0"
 source: https://github.com/omgbwa-yasse/outlet-orm
 npm: https://www.npmjs.com/package/outlet-orm
 ---
@@ -13,9 +13,11 @@ 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).
+> 🆕 **v11.0.0**: Proxy property access (`user.name`), Eloquent-style model methods (`fresh`, `refresh`, `replicate`, `is`, `isNot`, `only`, `except`, `makeVisible`, `makeHidden`, `wasChanged`, `getChanges`), computed `appends`, QueryBuilder enhancements (`value`, `chunk`, `when`, `tap`, `toSQL`, `dd`), fluent local scopes (`static scopeActive(query)` → `User.query().active()`), relation `withDefault()`. See [MODELS.md](MODELS.md), [QUERIES.md](QUERIES.md), [ADVANCED.md](ADVANCED.md), [RELATIONS.md](RELATIONS.md).
 >
-> 🔖 **v8.0.0**: AiBridge multi-provider LLM abstraction (9 providers), AI Query Builder, AI Seeder, AI Query Optimizer, AI Prompt Enhancer.
+> 🔖 **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**: 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 +39,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 +58,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/skills/outlet-orm/TYPESCRIPT.md

@@ -384,6 +384,104 @@ table.foreign('user_id')
 
 ---
 
+## v11.0.0 Type Additions
+
+### Property-Style Attribute Access
+
+Model instances are wrapped in a `Proxy`, so attributes can be read and written as direct properties:
+
+```typescript
+const user = await User.find(1);
+
+// Property access (via Proxy)
+console.log(user.name);       // equivalent to user.getAttribute('name')
+user.email = 'new@mail.com';  // equivalent to user.setAttribute('email', ...)
+
+// Both styles coexist
+user.getAttribute('name');     // still works
+```
+
+The index signature `[K: string]: any` on `Model` enables this in TypeScript.
+
+### Computed Appends
+
+```typescript
+class User extends Model<UserAttributes> {
+  static table = 'users';
+  static appends = ['full_name'] as const;
+
+  getFullNameAttribute(): string {
+    return `${this.attributes.first_name} ${this.attributes.last_name}`;
+  }
+}
+
+// full_name is included in toJSON() output
+```
+
+### New Model Instance Methods
+
+```typescript
+// Reload from DB
+const freshUser: User | null = await user.fresh('posts');
+await user.refresh(); // mutates in place
+
+// Clone without primary key
+const clone: User = user.replicate('id', 'created_at');
+
+// Identity comparison
+user.is(otherUser);    // same table + same PK
+user.isNot(otherUser);
+
+// Attribute subsets
+const partial: Partial<UserAttributes> = user.only('name', 'email');
+const rest: Partial<UserAttributes> = user.except('password');
+
+// Instance-level visibility
+user.makeVisible('password');
+user.makeHidden('email');
+
+// Change tracking (after save)
+user.wasChanged('name'); // boolean
+user.getChanges();       // { name: 'new value' }
+```
+
+### New QueryBuilder Methods
+
+```typescript
+// Single column value
+const email: any = await User.where('id', 1).value('email');
+
+// Batch processing
+await User.where('active', true).chunk(100, (users, page) => {
+  console.log(`Page ${page}:`, users.length);
+  // return false to stop
+});
+
+// Conditional query building
+User.query()
+  .when(role, (qb, val) => qb.where('role', val))
+  .tap(qb => console.log(qb.toSQL()))
+  .get();
+
+// Debug
+const sql = User.where('active', true).toSQL();
+User.where('active', true).dd(); // dumps SQL + throws
+```
+
+### withDefault on Relations
+
+```typescript
+class User extends Model<UserAttributes> {
+  profile(): HasOneRelation<Profile> {
+    return this.hasOne(Profile, 'user_id').withDefault();
+    // or .withDefault({ bio: 'N/A' })
+    // or .withDefault(() => new Profile({ bio: 'N/A' }))
+  }
+}
+```
+
+---
+
 ## Common Patterns
 
 ### Repository Pattern

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
    */
@@ -90,66 +90,66 @@ class AiBridgeManager {
   /** @private */
   _buildProviderFromOptions(name, options) {
     switch (name) {
-      case 'openai': {
-        const api = options.api_key;
-        if (api) return new OpenAIProvider(api, options.chat_endpoint || 'https://api.openai.com/v1/chat/completions');
-        break;
-      }
-      case 'ollama': return new OllamaProvider(options.endpoint || 'http://localhost:11434');
-      case 'ollama_turbo': {
-        const api = options.api_key;
-        if (api) return new OllamaTurboProvider(api, options.endpoint || 'https://ollama.com');
-        break;
-      }
-      case 'onn': {
-        const api = options.api_key;
-        if (api) return new OnnProvider(api, options.endpoint || 'https://api.onn.ai/v1/chat');
-        break;
-      }
-      case 'gemini': {
-        const api = options.api_key;
-        if (api) return new GeminiProvider(api, options.endpoint);
-        break;
-      }
-      case 'grok': {
-        const api = options.api_key;
-        if (api) return new GrokProvider(api, options.endpoint);
-        break;
-      }
-      case 'claude': {
-        const api = options.api_key;
-        if (api) return new ClaudeProvider(api, options.endpoint);
-        break;
-      }
-      case 'mistral': {
-        const api = options.api_key;
-        if (api) return new MistralProvider(api, options.endpoint || 'https://api.mistral.ai/v1/chat/completions');
-        break;
-      }
-      case 'openai_custom': {
-        const api = options.api_key;
-        const base = options.base_url;
-        if (api && base) {
-          return new CustomOpenAIProvider(api, base, options.paths || {},
-            options.auth_header || 'Authorization', options.auth_prefix || BEARER_PREFIX,
-            options.extra_headers || {});
-        }
-        break;
+    case 'openai': {
+      const api = options.api_key;
+      if (api) return new OpenAIProvider(api, options.chat_endpoint || 'https://api.openai.com/v1/chat/completions');
+      break;
+    }
+    case 'ollama': return new OllamaProvider(options.endpoint || 'http://localhost:11434');
+    case 'ollama_turbo': {
+      const api = options.api_key;
+      if (api) return new OllamaTurboProvider(api, options.endpoint || 'https://ollama.com');
+      break;
+    }
+    case 'onn': {
+      const api = options.api_key;
+      if (api) return new OnnProvider(api, options.endpoint || 'https://api.onn.ai/v1/chat');
+      break;
+    }
+    case 'gemini': {
+      const api = options.api_key;
+      if (api) return new GeminiProvider(api, options.endpoint);
+      break;
+    }
+    case 'grok': {
+      const api = options.api_key;
+      if (api) return new GrokProvider(api, options.endpoint);
+      break;
+    }
+    case 'claude': {
+      const api = options.api_key;
+      if (api) return new ClaudeProvider(api, options.endpoint);
+      break;
+    }
+    case 'mistral': {
+      const api = options.api_key;
+      if (api) return new MistralProvider(api, options.endpoint || 'https://api.mistral.ai/v1/chat/completions');
+      break;
+    }
+    case 'openai_custom': {
+      const api = options.api_key;
+      const base = options.base_url;
+      if (api && base) {
+        return new CustomOpenAIProvider(api, base, options.paths || {},
+          options.auth_header || 'Authorization', options.auth_prefix || BEARER_PREFIX,
+          options.extra_headers || {});
       }
-      case 'openrouter': {
-        const api = options.api_key;
-        if (api) {
-          const base = options.base_url || 'https://openrouter.ai/api/v1';
-          const hdrs = {};
-          if (options.referer) hdrs['HTTP-Referer'] = options.referer;
-          if (options.title) hdrs['X-Title'] = options.title;
-          return new CustomOpenAIProvider(api, base,
-            { chat: '/chat/completions', embeddings: '/embeddings', image: '/images/generations', tts: '/audio/speech', stt: '/audio/transcriptions' },
-            'Authorization', BEARER_PREFIX, hdrs
-          );
-        }
-        break;
+      break;
+    }
+    case 'openrouter': {
+      const api = options.api_key;
+      if (api) {
+        const base = options.base_url || 'https://openrouter.ai/api/v1';
+        const hdrs = {};
+        if (options.referer) hdrs['HTTP-Referer'] = options.referer;
+        if (options.title) hdrs['X-Title'] = options.title;
+        return new CustomOpenAIProvider(api, base,
+          { chat: '/chat/completions', embeddings: '/embeddings', image: '/images/generations', tts: '/audio/speech', stt: '/audio/transcriptions' },
+          'Authorization', BEARER_PREFIX, hdrs
+        );
       }
+      break;
+    }
     }
     return null;
   }
@@ -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) {
@@ -153,12 +153,12 @@ class AIQueryBuilder {
       let tables = [];
       if (dialect === 'pg' || dialect === 'postgresql') {
         const res = await this._connection.raw(
-          "SELECT table_name FROM information_schema.tables WHERE table_schema = 'public' AND table_type = 'BASE TABLE'"
+          'SELECT table_name FROM information_schema.tables WHERE table_schema = \'public\' AND table_type = \'BASE TABLE\''
         );
         tables = (res.rows || res).map(r => r.table_name);
       } else if (dialect === 'sqlite' || dialect === 'sqlite3') {
         const res = await this._connection.raw(
-          "SELECT name FROM sqlite_master WHERE type='table' AND name NOT LIKE 'sqlite_%'"
+          'SELECT name FROM sqlite_master WHERE type=\'table\' AND name NOT LIKE \'sqlite_%\''
         );
         tables = (Array.isArray(res) ? res : (res.rows || [])).map(r => r.name);
       } else {

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) {
@@ -143,10 +143,10 @@ RULES:
       const dialect = this._connection.config?.client || 'mysql';
       let tables = [];
       if (dialect === 'pg' || dialect === 'postgresql') {
-        const res = await this._connection.raw("SELECT table_name FROM information_schema.tables WHERE table_schema = 'public'");
+        const res = await this._connection.raw('SELECT table_name FROM information_schema.tables WHERE table_schema = \'public\'');
         tables = (res.rows || res).map(r => r.table_name);
       } else if (dialect === 'sqlite' || dialect === 'sqlite3') {
-        const res = await this._connection.raw("SELECT name FROM sqlite_master WHERE type='table' AND name NOT LIKE 'sqlite_%'");
+        const res = await this._connection.raw('SELECT name FROM sqlite_master WHERE type=\'table\' AND name NOT LIKE \'sqlite_%\'');
         tables = (Array.isArray(res) ? res : []).map(r => r.name);
       } else {
         const res = await this._connection.raw('SHOW TABLES');

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/Contracts/AudioProviderContract.js

@@ -11,7 +11,7 @@ class AudioProviderContract {
    * @param {Object} [options={}]
    * @returns {Promise<{audio: string, mime: string}>} audio is base64-encoded
    */
-  async textToSpeech(text, options = {}) {
+  async textToSpeech(text, _options = {}) {
     throw new Error('Not implemented: textToSpeech()');
   }
 
@@ -21,7 +21,7 @@ class AudioProviderContract {
    * @param {Object} [options={}]
    * @returns {Promise<{text: string, raw?: Object}>}
    */
-  async speechToText(filePath, options = {}) {
+  async speechToText(filePath, _options = {}) {
     throw new Error('Not implemented: speechToText()');
   }
 }

package/src/AI/Contracts/ChatProviderContract.js

@@ -12,7 +12,7 @@ class ChatProviderContract {
    * @param {Object} [options={}]
    * @returns {Promise<Object>}
    */
-  async chat(messages, options = {}) {
+  async chat(messages, _options = {}) {
     throw new Error('Not implemented: chat()');
   }
 
@@ -22,7 +22,8 @@ class ChatProviderContract {
    * @param {Object} [options={}]
    * @yields {string|Object}
    */
-  async *stream(messages, options = {}) {
+  // eslint-disable-next-line require-yield
+  async *stream(messages, _options = {}) {
     throw new Error('Not implemented: stream()');
   }
 

package/src/AI/Contracts/EmbeddingsProviderContract.js

@@ -11,7 +11,7 @@ class EmbeddingsProviderContract {
    * @param {Object} [options={}]
    * @returns {Promise<{embeddings: number[][], usage?: Object, raw?: Object}>}
    */
-  async embeddings(inputs, options = {}) {
+  async embeddings(inputs, _options = {}) {
     throw new Error('Not implemented: embeddings()');
   }
 }