@foisit/angular-wrapper 2.1.1 → 2.4.2

package/README.md

@@ -7,39 +7,38 @@
 
 Transform your Angular app into an intelligent, voice-ready platform. Foisit provides a drop-in AI layer that understands natural language, manages multi-step workflows, and executes actions—all with zero backend required.
 
-> [!NOTE]
-> 🎙️ **Voice Support Status**: Voice recognition and responses are currently in development and will be released in a future update. The current version focuses on high-performance text-based interactions and AI intent matching.
+> [!NOTE] > **Voice Support Status**: Voice recognition and responses are currently in development and will be released in a future update. The current version focuses on high-performance text-based interactions and AI intent matching.
 
 ---
 
-## 📋 Table of Contents
+## Table of Contents
 
-- [Features](#-features)
-- [Installation](#-installation)
-- [Quick Start](#-quick-start)
-- [Core Concepts](#-core-concepts)
-- [API Reference](#-api-reference)
-- [Advanced Usage](#-advanced-usage)
-- [Examples](#-examples)
-- [TypeScript Support](#-typescript-support)
-- [Best Practices](#-best-practices)
+- [Features](#features)
+- [Installation](#installation)
+- [Quick Start](#quick-start)
+- [Core Concepts](#core-concepts)
+- [API Reference](#api-reference)
+- [Advanced Usage](#advanced-usage)
+- [Examples](#examples)
+- [TypeScript Support](#typescript-support)
+- [Best Practices](#best-practices)
 
 ---
 
-## ✨ Features
+## Features
 
-- **🧠 Natural Language Understanding** - AI-powered intent matching using GPT-4o mini (proxied securely)
-- **📝 Smart Slot Filling** - Auto-generates forms for missing parameters
-- **⚠️ Critical Action Protection** - Built-in confirmation dialogs for dangerous operations
-- **🎨 Premium UI** - Glassmorphic overlay with dark/light mode support
-- **🔒 Zero Backend Required** - Secure proxy architecture keeps API keys server-side
-- **⚡ Angular Native** - Uses Dependency Injection, Signals, and RxJS
-- **🎯 Type-Safe** - Full TypeScript support with comprehensive types
-- **📱 Responsive** - Works flawlessly on desktop and mobile
+- **Natural Language Understanding** - AI-powered intent matching using GPT-4o mini (proxied securely)
+- **Smart Slot Filling** - Auto-generates forms for missing parameters
+- **Critical Action Protection** - Built-in confirmation dialogs for dangerous operations
+- **Premium UI** - Glassmorphic overlay with dark/light mode support
+- **Zero Backend Required** - Secure proxy architecture keeps API keys server-side
+- **Angular Native** - Uses Dependency Injection, Signals, and RxJS
+- **Type-Safe** - Full TypeScript support with comprehensive types
+- **Responsive** - Works flawlessly on desktop and mobile
 
 ---
 
-## 🚀 Installation
+## Installation
 
 ```bash
 npm install @foisit/angular-wrapper
@@ -56,7 +55,7 @@ npm install @foisit/angular-wrapper
 
 ---
 
-## 🏁 Quick Start
+## Quick Start
 
 ### Step 1: Import the Module
 
@@ -127,7 +126,7 @@ export class MyComponent {
 
 ---
 
-## 🎯 Core Concepts
+## Core Concepts
 
 ### 1. Commands
 
@@ -158,30 +157,85 @@ Define parameters and Foisit will automatically generate forms to collect them:
 }
 ```
 
+**Enterprise-safe param collection controls**
+
+- `collectRequiredViaForm` (default: true): when enabled, any missing/invalid required params are collected via a form—no conversational guessing.
+- `allowAiParamExtraction` (default: true): when false, AI-extracted params are ignored; the assistant will always prompt the user for required fields.
+
+Example:
+
+```typescript
+{
+  command: 'secure create user',
+  description: 'No AI guessing, form-only',
+  collectRequiredViaForm: true,
+  allowAiParamExtraction: false,
+  parameters: [
+    { name: 'fullName', type: 'string', required: true },
+    { name: 'email', type: 'string', required: true },
+    { name: 'age', type: 'number', required: true, min: 18 },
+  ],
+  action: (params) => this.userService.create(params),
+}
+```
+
 **Supported Parameter Types:**
 
 - `string` - Text input
 - `number` - Numeric input
 - `date` - Date picker
 - `select` - Dropdown (static or async options)
+- `file` - File upload input
 
-### 3. Critical Actions
+### 3. File Parameters
+
+Collect files via the built-in form UI and receive them in your command `action`.
+
+```typescript
+{
+  command: 'upload file',
+  description: 'Pick a file and return it to the action',
+  parameters: [
+    {
+      name: 'attachment',
+      type: 'file',
+      required: true,
+      accept: ['image/*', 'audio/*', 'video/*'],
+      multiple: false,
+      // delivery: 'file' | 'base64' (default: 'file')
+      delivery: 'file',
+    },
+  ],
+  action: async (params) => {
+    const file = params?.attachment as File | undefined;
+    if (!file) return { type: 'error', message: 'No file provided.' };
+    return {
+      type: 'success',
+      message: `File received. Name: ${file.name}, Type: ${file.type || 'unknown'}, Size: ${file.size} bytes`,
+    };
+  },
+}
+```
+
+`FileParameter` supports validations like `maxFiles`, `maxSizeBytes`, `maxTotalBytes`, and media/image constraints like `maxDurationSec`, `maxWidth`, and `maxHeight`.
+
+### 4. Critical Actions
 
 Protect dangerous operations with automatic confirmation dialogs:
 
 ```typescript
 {
   command: 'delete all data',
-  critical: true, // 🔒 Requires confirmation
+  critical: true, // Requires confirmation
   description: 'Permanently delete all application data',
   action: async () => {
     await this.dataService.deleteAll();
-    return '✅ All data deleted successfully.';
+    return 'All data deleted successfully.';
   }
 }
 ```
 
-### 4. Select Parameters (Static)
+### 5. Select Parameters (Static)
 
 Provide predefined options:
 
@@ -201,7 +255,7 @@ Provide predefined options:
 }
 ```
 
-### 5. Dynamic Select Parameters
+### 6. Dynamic Select Parameters
 
 Load options from APIs:
 
@@ -225,7 +279,7 @@ Load options from APIs:
 
 ---
 
-## 📘 API Reference
+## API Reference
 
 ### `AssistantService`
 
@@ -250,7 +304,7 @@ this.assistant.toggle(
 
 ##### `addCommand(command, action?)`
 
-Dynamically add a command at runtime.
+Dynamically add or update a command at runtime. Commands added via `addCommand` take effect immediately in the running application; they are stored in memory for the current session (they are not persisted after a page reload unless you re-register them during app startup).
 
 ```typescript
 // Add a simple command
@@ -280,6 +334,35 @@ this.assistant.addCommand({
 });
 ```
 
+### Dynamic Updates (Add / Remove / Update commands at runtime) ✅
+
+- Use `addCommand` to register a new command or to replace an existing command's behavior (remove first if you want a clean replacement).
+- Use `removeCommand(commandPhrase)` to unregister a command. This is useful for temporary or context-specific commands.
+- Commands are in-memory only; to persist them across reloads, re-register on app startup (e.g., in an initialization hook).
+
+Example — register a temporary command and clean it up in `ngOnDestroy`:
+
+```typescript
+// component.ts
+import { OnDestroy } from '@angular/core';
+
+export class MyComponent implements OnDestroy {
+  constructor(private assistant: AssistantService) {
+    this.assistant.addCommand('temp action', () => 'Temporary action executed');
+  }
+
+  ngOnDestroy() {
+    // Remove the temporary command when component unmounts
+    this.assistant.removeCommand('temp action');
+  }
+}
+```
+
+Notes:
+
+- If a command has only optional params, consider returning a `form` InteractiveResponse to prompt the user when no params are provided.
+- Always remove transient commands in your cleanup lifecycle to avoid leaks and confusing UX.
+
 ##### `removeCommand(commandPhrase)`
 
 Remove a registered command.
@@ -299,7 +382,7 @@ console.log('Available commands:', commands);
 
 ---
 
-## 🔧 Configuration Options
+## Configuration Options
 
 ### `AssistantConfig`
 
@@ -335,7 +418,7 @@ interface AssistantConfig {
 
 ---
 
-## 🎨 Advanced Usage
+## Advanced Usage
 
 ### Example 1: Multi-Step Booking System
 
@@ -471,7 +554,7 @@ this.assistant.addCommand({
 
 ---
 
-## 📝 TypeScript Support
+## TypeScript Support
 
 ### Full Type Definitions
 
@@ -505,7 +588,7 @@ const myCommand: AssistantCommand = {
 
 ---
 
-## 🎯 Best Practices
+## Best Practices
 
 ### 1. Command Naming
 
@@ -571,7 +654,7 @@ export class MyComponent {
 
 ---
 
-## 🧪 Testing
+## Testing
 
 ### Unit Testing Commands
 
@@ -606,7 +689,7 @@ describe('AssistantService', () => {
 
 ---
 
-## � Related Packages
+## Related Packages
 
 - **[@foisit/core](../core)** - Core engine (auto-installed)
 - **[@foisit/react-wrapper](../react-wrapper)** - React integration
@@ -614,7 +697,7 @@ describe('AssistantService', () => {
 
 ---
 
-## 🐛 Troubleshooting
+## Troubleshooting
 
 ### Assistant not appearing
 
@@ -630,24 +713,24 @@ Make sure you're using Angular 17+ and have `@angular/core` installed.
 
 ---
 
-## 📄 License
+## License
 
 MIT © [Foisit](https://github.com/boluwatifee4/foisit)
 
 ---
 
-## 🤝 Contributing
+## Contributing
 
 Contributions are welcome! Please read our [Contributing Guide](../../CONTRIBUTING.md) first.
 
 ---
 
-## 📬 Support
+## Support
 
-- 📧 Email: support@foisit.com
-- 💬 Discord: [Join our community](https://discord.gg/foisit)
-- 🐛 Issues: [GitHub Issues](https://github.com/boluwatifee4/foisit/issues)
+- Email: support@foisit.com
+- Discord: [Join our community](https://discord.gg/foisit)
+- Issues: [GitHub Issues](https://github.com/boluwatifee4/foisit/issues)
 
 ---
 
-**Made with ❤️ by the Foisit Team**
+**Made by the Foisit Team**

package/fesm2022/foisit-angular-wrapper.mjs

@@ -0,0 +1,288 @@
+import * as i0 from '@angular/core';
+import { Component, Inject, Injectable, NgModule } from '@angular/core';
+import { CommonModule } from '@angular/common';
+import { CommandHandler, FallbackHandler, VoiceProcessor, TextToSpeech, StateManager, GestureHandler, OverlayManager } from '@foisit/core';
+
+class AngularWrapperComponent {
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "19.0.7", ngImport: i0, type: AngularWrapperComponent, deps: [], target: i0.ɵɵFactoryTarget.Component });
+    static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "14.0.0", version: "19.0.7", type: AngularWrapperComponent, isStandalone: true, selector: "lib-angular-wrapper", ngImport: i0, template: "<p>AngularWrapper works!</p>\n", styles: [""], dependencies: [{ kind: "ngmodule", type: CommonModule }] });
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "19.0.7", ngImport: i0, type: AngularWrapperComponent, decorators: [{
+            type: Component,
+            args: [{ selector: 'lib-angular-wrapper', imports: [CommonModule], template: "<p>AngularWrapper works!</p>\n" }]
+        }] });
+
+class AssistantService {
+    config;
+    commandHandler;
+    fallbackHandler;
+    voiceProcessor;
+    textToSpeech;
+    stateManager;
+    lastProcessedInput = '';
+    processingLock = false;
+    isActivated = false; // Tracks activation status
+    gestureHandler;
+    overlayManager;
+    defaultIntroMessage = 'How can I help you?';
+    constructor(config) {
+        this.config = config;
+        // Pass enableSmartIntent (default true) and potential apiKey (if we add it to config later)
+        this.commandHandler = new CommandHandler({
+            enableSmartIntent: this.config.enableSmartIntent !== false,
+            intentEndpoint: this.config.intentEndpoint,
+        });
+        this.fallbackHandler = new FallbackHandler();
+        this.voiceProcessor = new VoiceProcessor();
+        this.textToSpeech = new TextToSpeech();
+        this.stateManager = new StateManager();
+        this.gestureHandler = new GestureHandler();
+        this.overlayManager = new OverlayManager({
+            floatingButton: this.config.floatingButton,
+            inputPlaceholder: this.config.inputPlaceholder,
+        });
+        // Setup commands from config
+        this.config.commands.forEach((cmd) => this.commandHandler.addCommand(cmd));
+        // Setup fallback response
+        if (this.config.fallbackResponse) {
+            this.fallbackHandler.setFallbackMessage(this.config.fallbackResponse);
+        }
+        // Voice disabled for text-first pivot
+        // this.startListening();
+        // Setup double-tap/double-click listener
+        this.gestureHandler.setupDoubleTapListener(() => this.toggle());
+        // Register global callbacks for floating button
+        this.overlayManager.registerCallbacks(async (input) => {
+            if (typeof input === 'string') {
+                this.overlayManager.addMessage(input, 'user');
+            }
+            else if (input && typeof input === 'object') {
+                const label = this.extractUserLabel(input);
+                if (label) {
+                    this.overlayManager.addMessage(label, 'user');
+                }
+            }
+            await this.handleCommand(input);
+        }, () => console.log('AssistantService: Overlay closed.'));
+    }
+    /** Start listening for activation and commands */
+    startListening() {
+        // Voice is currently disabled (text-only mode)
+        console.log('AssistantService: Voice is disabled; startListening() is a no-op.');
+        return;
+        /*
+        this.voiceProcessor.startListening(async (transcript: string) => {
+          if (this.processingLock) return;
+    
+          const normalizedTranscript = transcript.toLowerCase().trim();
+    
+          // Skip repeated or irrelevant inputs
+          if (
+            !normalizedTranscript ||
+            normalizedTranscript.length < 3 ||
+            normalizedTranscript === this.lastProcessedInput
+          ) {
+            console.log('AssistantService: Ignoring irrelevant input.');
+            return;
+          }
+    
+          this.lastProcessedInput = normalizedTranscript;
+    
+          if (!this.isActivated) {
+            await this.processActivation(normalizedTranscript);
+            return;
+          }
+    
+          const isFallbackOrIntroMessage =
+            normalizedTranscript === this.config.fallbackResponse?.toLowerCase() ||
+            normalizedTranscript === this.config.introMessage?.toLowerCase() ||
+            normalizedTranscript === this.defaultIntroMessage.toLowerCase();
+    
+          if (!isFallbackOrIntroMessage) {
+            await this.handleCommand(normalizedTranscript);
+          } else {
+            console.log('AssistantService: Ignoring fallback or intro message.');
+          }
+    
+          // Throttle input processing to prevent rapid feedback
+          this.processingLock = true;
+          setTimeout(() => (this.processingLock = false), 1000);
+        });
+        */
+    }
+    /** Stop listening for voice input */
+    stopListening() {
+        // Voice is currently disabled (text-only mode)
+        console.log('AssistantService: Voice is disabled; stopListening() is a no-op.');
+        this.isActivated = false;
+    }
+    /** Reset activation state so the next activation flow can occur. */
+    reactivate() {
+        console.log('AssistantService: Reactivating assistant...');
+        this.isActivated = false;
+        try {
+            this.startListening();
+        }
+        catch {
+            // no-op
+        }
+    }
+    /** Process activation command */
+    async processActivation(transcript) {
+        const activationCmd = this.config.activationCommand?.toLowerCase();
+        // If no activation command is set, we can't activate via voice
+        if (!activationCmd)
+            return;
+        if (transcript === activationCmd) {
+            console.log('AssistantService: Activation matched.');
+            this.isActivated = true;
+            this.textToSpeech.speak(this.config.introMessage || this.defaultIntroMessage);
+            // this.stateManager.setState('listening'); // DISABLED - no gradient animation
+        }
+        else {
+            console.log('AssistantService: Activation command not recognized.');
+        }
+    }
+    /** Handle recognized commands */
+    async handleCommand(input) {
+        this.overlayManager.showLoading();
+        let response;
+        try {
+            response = await this.commandHandler.executeCommand(input);
+        }
+        finally {
+            this.overlayManager.hideLoading();
+        }
+        const originalText = typeof input === 'string' ? input : undefined;
+        this.processResponse(response, originalText);
+    }
+    /**
+     * Cleanup resources
+     */
+    destroy() {
+        this.voiceProcessor.stopListening();
+        this.gestureHandler.destroy();
+        this.overlayManager.destroy();
+    }
+    /** Unified response processing */
+    processResponse(response, originalText) {
+        if (response.type === 'error' && originalText) {
+            this.fallbackHandler.handleFallback(originalText);
+            this.overlayManager.addMessage(this.fallbackHandler.getFallbackMessage(), 'system');
+            return;
+        }
+        if (response.type === 'form' && response.fields) {
+            this.overlayManager.addForm(response.message, response.fields, async (data) => {
+                this.overlayManager.showLoading();
+                let nextReponse;
+                try {
+                    nextReponse = await this.commandHandler.executeCommand(data);
+                }
+                finally {
+                    this.overlayManager.hideLoading();
+                }
+                this.processResponse(nextReponse);
+            });
+            return;
+        }
+        if ((response.type === 'ambiguous' || response.type === 'confirm') && response.options) {
+            if (response.message) {
+                this.overlayManager.addMessage(response.message, 'system');
+            }
+            this.overlayManager.addOptions(response.options);
+            return;
+        }
+        if (response.message) {
+            this.overlayManager.addMessage(response.message, 'system');
+        }
+    }
+    /** Add a command dynamically (supports string or rich object) */
+    addCommand(commandOrObj, action) {
+        if (typeof commandOrObj === 'string') {
+            console.log(`AssistantService: Adding command "${commandOrObj}".`);
+        }
+        else {
+            console.log(`AssistantService: Adding rich command "${commandOrObj.command}".`);
+        }
+        this.commandHandler.addCommand(commandOrObj, action);
+    }
+    /** Remove a command dynamically */
+    removeCommand(command) {
+        console.log(`AssistantService: Removing command "${command}".`);
+        this.commandHandler.removeCommand(command);
+    }
+    /** Get all registered commands */
+    getCommands() {
+        return this.commandHandler.getCommands();
+    }
+    /** Toggle the assistant overlay */
+    toggle(onSubmit, onClose) {
+        console.log('AssistantService: Toggling overlay...');
+        this.overlayManager.toggle(async (input) => {
+            if (typeof input === 'string') {
+                this.overlayManager.addMessage(input, 'user');
+            }
+            else if (input && typeof input === 'object') {
+                const label = this.extractUserLabel(input);
+                if (label) {
+                    this.overlayManager.addMessage(label, 'user');
+                }
+            }
+            if (onSubmit)
+                onSubmit(input);
+            await this.handleCommand(input);
+        }, () => {
+            console.log('AssistantService: Overlay closed.');
+            if (onClose)
+                onClose();
+        });
+    }
+    extractUserLabel(payload) {
+        const label = payload['label'];
+        if (typeof label === 'string' && label.trim()) {
+            return label.trim();
+        }
+        const commandId = payload['commandId'];
+        if (typeof commandId === 'string' && commandId.trim()) {
+            return commandId.trim();
+        }
+        return null;
+    }
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "19.0.7", ngImport: i0, type: AssistantService, deps: [{ token: 'ASSISTANT_CONFIG' }], target: i0.ɵɵFactoryTarget.Injectable });
+    static ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "19.0.7", ngImport: i0, type: AssistantService, providedIn: 'root' });
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "19.0.7", ngImport: i0, type: AssistantService, decorators: [{
+            type: Injectable,
+            args: [{
+                    providedIn: 'root',
+                }]
+        }], ctorParameters: () => [{ type: undefined, decorators: [{
+                    type: Inject,
+                    args: ['ASSISTANT_CONFIG']
+                }] }] });
+
+class AssistantModule {
+    static forRoot(config) {
+        return {
+            ngModule: AssistantModule,
+            providers: [
+                { provide: 'ASSISTANT_CONFIG', useValue: config },
+                AssistantService,
+            ],
+        };
+    }
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "19.0.7", ngImport: i0, type: AssistantModule, deps: [], target: i0.ɵɵFactoryTarget.NgModule });
+    static ɵmod = i0.ɵɵngDeclareNgModule({ minVersion: "14.0.0", version: "19.0.7", ngImport: i0, type: AssistantModule });
+    static ɵinj = i0.ɵɵngDeclareInjector({ minVersion: "12.0.0", version: "19.0.7", ngImport: i0, type: AssistantModule });
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "19.0.7", ngImport: i0, type: AssistantModule, decorators: [{
+            type: NgModule,
+            args: [{}]
+        }] });
+
+/**
+ * Generated bundle index. Do not edit.
+ */
+
+export { AngularWrapperComponent, AssistantModule, AssistantService };
+//# sourceMappingURL=foisit-angular-wrapper.mjs.map

package/fesm2022/foisit-angular-wrapper.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"foisit-angular-wrapper.mjs","sources":["../../../../libs/angular-wrapper/src/lib/angular-wrapper/angular-wrapper.component.ts","../../../../libs/angular-wrapper/src/lib/angular-wrapper/angular-wrapper.component.html","../../../../libs/angular-wrapper/src/lib/service/assistant.service.ts","../../../../libs/angular-wrapper/src/lib/assistant.module.ts","../../../../libs/angular-wrapper/src/foisit-angular-wrapper.ts"],"sourcesContent":["import { Component } from '@angular/core';\nimport { CommonModule } from '@angular/common';\n\n@Component({\n  selector: 'lib-angular-wrapper',\n  imports: [CommonModule],\n  templateUrl: './angular-wrapper.component.html',\n  styleUrl: './angular-wrapper.component.css',\n})\nexport class AngularWrapperComponent {}\n","<p>AngularWrapper works!</p>\n","import { Injectable, Inject } from '@angular/core';\nimport {\n  CommandHandler,\n  FallbackHandler,\n  VoiceProcessor,\n  StateManager,\n  AssistantConfig,\n  TextToSpeech,\n  GestureHandler,\n  OverlayManager,\n  AssistantCommand,\n  AssistantCommandParams,\n  InteractiveResponse,\n} from '@foisit/core';\n\n@Injectable({\n  providedIn: 'root',\n})\nexport class AssistantService {\n  private commandHandler: CommandHandler;\n  private fallbackHandler: FallbackHandler;\n  private voiceProcessor: VoiceProcessor;\n  private textToSpeech: TextToSpeech;\n  private stateManager: StateManager;\n  private lastProcessedInput = '';\n  private processingLock = false;\n  private isActivated = false; // Tracks activation status\n  private gestureHandler: GestureHandler;\n  private overlayManager: OverlayManager;\n  private defaultIntroMessage = 'How can I help you?';\n\n  constructor(@Inject('ASSISTANT_CONFIG') private config: AssistantConfig) {\n    // Pass enableSmartIntent (default true) and potential apiKey (if we add it to config later)\n    this.commandHandler = new CommandHandler({\n      enableSmartIntent: this.config.enableSmartIntent !== false,\n      intentEndpoint: this.config.intentEndpoint,\n    });\n    this.fallbackHandler = new FallbackHandler();\n    this.voiceProcessor = new VoiceProcessor();\n    this.textToSpeech = new TextToSpeech();\n    this.stateManager = new StateManager();\n    this.gestureHandler = new GestureHandler();\n    this.overlayManager = new OverlayManager({\n      floatingButton: this.config.floatingButton,\n      inputPlaceholder: this.config.inputPlaceholder,\n    });\n\n    // Setup commands from config\n    this.config.commands.forEach((cmd) => this.commandHandler.addCommand(cmd));\n\n    // Setup fallback response\n    if (this.config.fallbackResponse) {\n      this.fallbackHandler.setFallbackMessage(this.config.fallbackResponse);\n    }\n\n    // Voice disabled for text-first pivot\n    // this.startListening();\n\n    // Setup double-tap/double-click listener\n    this.gestureHandler.setupDoubleTapListener(() => this.toggle());\n\n    // Register global callbacks for floating button\n    this.overlayManager.registerCallbacks(\n      async (input) => {\n        if (typeof input === 'string') {\n          this.overlayManager.addMessage(input, 'user');\n        } else if (input && typeof input === 'object') {\n          const label = this.extractUserLabel(input as Record<string, unknown>);\n          if (label) {\n            this.overlayManager.addMessage(label, 'user');\n          }\n        }\n\n        await this.handleCommand(input);\n      },\n      () => console.log('AssistantService: Overlay closed.')\n    );\n  }\n\n  /** Start listening for activation and commands */\n  startListening(): void {\n    // Voice is currently disabled (text-only mode)\n    console.log('AssistantService: Voice is disabled; startListening() is a no-op.');\n    return;\n\n    /*\n    this.voiceProcessor.startListening(async (transcript: string) => {\n      if (this.processingLock) return;\n\n      const normalizedTranscript = transcript.toLowerCase().trim();\n\n      // Skip repeated or irrelevant inputs\n      if (\n        !normalizedTranscript ||\n        normalizedTranscript.length < 3 ||\n        normalizedTranscript === this.lastProcessedInput\n      ) {\n        console.log('AssistantService: Ignoring irrelevant input.');\n        return;\n      }\n\n      this.lastProcessedInput = normalizedTranscript;\n\n      if (!this.isActivated) {\n        await this.processActivation(normalizedTranscript);\n        return;\n      }\n\n      const isFallbackOrIntroMessage =\n        normalizedTranscript === this.config.fallbackResponse?.toLowerCase() ||\n        normalizedTranscript === this.config.introMessage?.toLowerCase() ||\n        normalizedTranscript === this.defaultIntroMessage.toLowerCase();\n\n      if (!isFallbackOrIntroMessage) {\n        await this.handleCommand(normalizedTranscript);\n      } else {\n        console.log('AssistantService: Ignoring fallback or intro message.');\n      }\n\n      // Throttle input processing to prevent rapid feedback\n      this.processingLock = true;\n      setTimeout(() => (this.processingLock = false), 1000);\n    });\n    */\n  }\n\n  /** Stop listening for voice input */\n  stopListening(): void {\n    // Voice is currently disabled (text-only mode)\n    console.log('AssistantService: Voice is disabled; stopListening() is a no-op.');\n    this.isActivated = false;\n  }\n\n  /** Reset activation state so the next activation flow can occur. */\n  reactivate(): void {\n    console.log('AssistantService: Reactivating assistant...');\n    this.isActivated = false;\n    try {\n      this.startListening();\n    } catch {\n      // no-op\n    }\n  }\n\n  /** Process activation command */\n  private async processActivation(transcript: string): Promise<void> {\n    const activationCmd = this.config.activationCommand?.toLowerCase();\n\n    // If no activation command is set, we can't activate via voice\n    if (!activationCmd) return;\n\n    if (transcript === activationCmd) {\n      console.log('AssistantService: Activation matched.');\n      this.isActivated = true;\n      this.textToSpeech.speak(\n        this.config.introMessage || this.defaultIntroMessage\n      );\n      // this.stateManager.setState('listening'); // DISABLED - no gradient animation\n    } else {\n      console.log('AssistantService: Activation command not recognized.');\n    }\n  }\n\n  /** Handle recognized commands */\n  private async handleCommand(\n    input: string | Record<string, unknown>\n  ): Promise<void> {\n    this.overlayManager.showLoading();\n    let response: InteractiveResponse;\n    try {\n      response = await this.commandHandler.executeCommand(input);\n    } finally {\n      this.overlayManager.hideLoading();\n    }\n\n    const originalText = typeof input === 'string' ? input : undefined;\n    this.processResponse(response, originalText);\n  }\n\n  /**\n   * Cleanup resources\n   */\n  destroy(): void {\n    this.voiceProcessor.stopListening();\n    this.gestureHandler.destroy();\n    this.overlayManager.destroy();\n  }\n\n  /** Unified response processing */\n  private processResponse(\n    response: InteractiveResponse,\n    originalText?: string\n  ): void {\n    if (response.type === 'error' && originalText) {\n      this.fallbackHandler.handleFallback(originalText);\n      this.overlayManager.addMessage(this.fallbackHandler.getFallbackMessage(), 'system');\n      return;\n    }\n\n    if (response.type === 'form' && response.fields) {\n      this.overlayManager.addForm(\n        response.message,\n        response.fields,\n        async (data: Record<string, unknown>) => {\n          this.overlayManager.showLoading();\n          let nextReponse: InteractiveResponse;\n          try {\n            nextReponse = await this.commandHandler.executeCommand(data);\n          } finally {\n            this.overlayManager.hideLoading();\n          }\n          this.processResponse(nextReponse);\n        }\n      );\n      return;\n    }\n\n    if ((response.type === 'ambiguous' || response.type === 'confirm') && response.options) {\n      if (response.message) {\n        this.overlayManager.addMessage(response.message, 'system');\n      }\n      this.overlayManager.addOptions(response.options);\n      return;\n    }\n\n    if (response.message) {\n      this.overlayManager.addMessage(response.message, 'system');\n    }\n  }\n\n  /** Add a command dynamically (supports string or rich object) */\n  addCommand(\n    commandOrObj: string | AssistantCommand,\n    action?: (\n      params?: AssistantCommandParams\n    ) => Promise<string | InteractiveResponse | void> | void\n  ): void {\n    if (typeof commandOrObj === 'string') {\n      console.log(`AssistantService: Adding command \"${commandOrObj}\".`);\n    } else {\n      console.log(\n        `AssistantService: Adding rich command \"${commandOrObj.command}\".`\n      );\n    }\n    this.commandHandler.addCommand(commandOrObj, action);\n  }\n\n  /** Remove a command dynamically */\n  removeCommand(command: string): void {\n    console.log(`AssistantService: Removing command \"${command}\".`);\n    this.commandHandler.removeCommand(command);\n  }\n\n  /** Get all registered commands */\n  getCommands(): string[] {\n    return this.commandHandler.getCommands();\n  }\n\n  /** Toggle the assistant overlay */\n  toggle(\n    onSubmit?: (input: string | Record<string, unknown>) => void,\n    onClose?: () => void\n  ): void {\n    console.log('AssistantService: Toggling overlay...');\n    this.overlayManager.toggle(\n      async (input) => {\n        if (typeof input === 'string') {\n          this.overlayManager.addMessage(input, 'user');\n        } else if (input && typeof input === 'object') {\n          const label = this.extractUserLabel(input);\n          if (label) {\n            this.overlayManager.addMessage(label, 'user');\n          }\n        }\n\n        if (onSubmit) onSubmit(input);\n        await this.handleCommand(input);\n      },\n      () => {\n        console.log('AssistantService: Overlay closed.');\n        if (onClose) onClose();\n      }\n    );\n  }\n\n  private extractUserLabel(payload: Record<string, unknown>): string | null {\n    const label = payload['label'];\n    if (typeof label === 'string' && label.trim()) {\n      return label.trim();\n    }\n\n    const commandId = payload['commandId'];\n    if (typeof commandId === 'string' && commandId.trim()) {\n      return commandId.trim();\n    }\n\n    return null;\n  }\n}\n","import { ModuleWithProviders, NgModule } from '@angular/core';\nimport { AssistantService } from './service/assistant.service';\nimport { AssistantConfig } from '@foisit/core';\n\n@NgModule({})\nexport class AssistantModule {\n  static forRoot(config: AssistantConfig): ModuleWithProviders<AssistantModule> {\n    return {\n      ngModule: AssistantModule,\n      providers: [\n        { provide: 'ASSISTANT_CONFIG', useValue: config },\n        AssistantService,\n      ],\n    };\n  }\n}\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './index';\n"],"names":[],"mappings":"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"}

package/index.d.ts

@@ -0,0 +1,3 @@
+export * from './lib/angular-wrapper/angular-wrapper.component';
+export * from './lib/service/assistant.service';
+export * from './lib/assistant.module';

package/package.json

@@ -1,13 +1,15 @@
 {
   "name": "@foisit/angular-wrapper",
-  "version": "2.1.1",
+  "version": "2.4.2",
   "peerDependencies": {
     "@angular/common": "^19.0.0",
     "@angular/core": "^19.0.0"
   },
   "sideEffects": false,
   "files": [
-    "dist",
+    "fesm2022",
+    "esm2022",
+    "index.d.ts",
     "README.md"
   ],
   "description": "Foisit: Speak, and its done. A voice assistant library for angular apps",