{"_id":"@amittrrajputtt/voice-navigation-ai","name":"@amittrrajputtt/voice-navigation-ai","dist-tags":{"latest":"1.0.0"},"versions":{"1.0.0":{"name":"@amittrrajputtt/voice-navigation-ai","version":"1.0.0","description":"Universal AI-powered voice navigation for any website. No configuration required.","main":"dist/voice-navigation.js","module":"dist/voice-navigation.esm.js","types":"dist/voice-navigation.d.ts","scripts":{"build":"npm run build:umd && npm run build:esm","build:umd":"cp ../voice-navigation-dynamic.js dist/voice-navigation.js","build:esm":"cp ../voice-navigation-dynamic.js dist/voice-navigation.esm.js","prepublishOnly":"npm run build","test":"echo \"No tests yet\" && exit 0"},"repository":{"type":"git","url":"git+https://github.com/amittrrajputtt/voice-navigation-ai.git"},"keywords":["voice","navigation","accessibility","a11y","speech","ai","voice-control","hands-free","azure-speech","openai","form-filling","voice-assistant","web-accessibility","voice-commands","speech-recognition"],"author":{"name":"LiaPlus Technologies","email":"support@liaplus.com","url":"https://liaplus.com"},"license":"MIT","bugs":{"url":"https://github.com/amittrrajputtt/voice-navigation-ai/issues"},"homepage":"https://liaplus.com","publishConfig":{"access":"public","registry":"https://registry.npmjs.org/"},"engines":{"node":">=14.0.0"},"peerDependencies":{},"devDependencies":{},"_id":"@amittrrajputtt/voice-navigation-ai@1.0.0","gitHead":"a3722fec905faa2e9e8e067c9592632d5220cb1f","_nodeVersion":"22.11.0","_npmVersion":"10.9.0","dist":{"integrity":"sha512-DQAfHLK9ScUV48iRgk412TSyFDmTYT1R0yzyIq+8gROA+n0dJ2M7GAVv1z3a0zrThJqEGseFA0JFwxcVFtYchg==","shasum":"e4d3561497be5907a2b251568cfc7ed206a37fd2","tarball":"https://registry.npmjs.org/@amittrrajputtt/voice-navigation-ai/-/voice-navigation-ai-1.0.0.tgz","fileCount":6,"unpackedSize":57302,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIDC3S92cJKn/CHPi+lq0gbYg9O1QmQzvVsOjeGf5ijjGAiEA6Bc6L6h8AOL19Hqhxd3rR09qUi11yg61VigKZN5z4tQ="}]},"_npmUser":{"name":"amittrrajputtt","email":"amitr3245@gmail.com"},"directories":{},"maintainers":[{"name":"amittrrajputtt","email":"amitr3245@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/voice-navigation-ai_1.0.0_1771262089621_0.9778546267652544"},"_hasShrinkwrap":false}},"time":{"created":"2026-02-16T17:14:49.503Z","1.0.0":"2026-02-16T17:14:49.778Z","modified":"2026-02-16T17:14:49.947Z"},"maintainers":[{"name":"amittrrajputtt","email":"amitr3245@gmail.com"}],"description":"Universal AI-powered voice navigation for any website. No configuration required.","homepage":"https://liaplus.com","keywords":["voice","navigation","accessibility","a11y","speech","ai","voice-control","hands-free","azure-speech","openai","form-filling","voice-assistant","web-accessibility","voice-commands","speech-recognition"],"repository":{"type":"git","url":"git+https://github.com/amittrrajputtt/voice-navigation-ai.git"},"author":{"name":"LiaPlus Technologies","email":"support@liaplus.com","url":"https://liaplus.com"},"bugs":{"url":"https://github.com/amittrrajputtt/voice-navigation-ai/issues"},"license":"MIT","readme":"# @amittrrajputtt/voice-navigation-ai\n\n[![npm version](https://img.shields.io/npm/v/@amittrrajputtt/voice-navigation-ai.svg)](https://www.npmjs.com/package/@amittrrajputtt/voice-navigation-ai)\n[![npm downloads](https://img.shields.io/npm/dm/@amittrrajputtt/voice-navigation-ai.svg)](https://www.npmjs.com/package/@amittrrajputtt/voice-navigation-ai)\n[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)\n\n**Universal AI-powered voice navigation for any website. No configuration required.**\n\nAdd voice control to your website with just 2 lines of code. Works on any site - e-commerce, forms, blogs, web apps. Powered by Azure OpenAI (GPT-4) and Azure Speech Services.\n\n## ✨ Features\n\n- 🎯 **Zero Configuration** - Works on any website out of the box\n- 🧠 **AI-Powered** - GPT-4 understands natural language commands\n- 📝 **Dynamic Form Filling** - Automatically detects and fills any form\n- 🖱️ **Smart Element Detection** - Finds buttons, links, and inputs intelligently\n- 🌍 **Multi-Language** - English (en-US) and Hindi (hi-IN)\n- ♿ **Accessibility First** - Helps users with mobility or visual impairments\n- 🔒 **Privacy Focused** - All credentials server-side, no data storage\n- 📦 **Tiny Bundle** - ~50KB gzipped\n\n## 🚀 Quick Start\n\n### Installation\n\n```bash\nnpm install @amittrrajputtt/voice-navigation-ai\n```\n\nOr via CDN:\n\n```html\n<script src=\"https://unpkg.com/@amittrrajputtt/voice-navigation-ai@latest/dist/voice-navigation.js\"></script>\n```\n\n### Usage\n\n#### Simple (Use LiaPlus API - Recommended)\n\n```html\n<script src=\"https://unpkg.com/@amittrrajputtt/voice-navigation-ai\"></script>\n<script>\n  // That's it! No credentials needed\n  LiaPlusVoice.init();\n</script>\n```\n\n#### Custom Configuration\n\n```html\n<script src=\"https://unpkg.com/@amittrrajputtt/voice-navigation-ai\"></script>\n<script>\n  LiaPlusVoice.init({\n    apiBase: 'https://liaplus.com/api',  // Your API base URL\n    language: 'en-US',                    // 'en-US' or 'hi-IN'\n    autoStart: true,                      // Auto-start on load\n    debug: false                          // Disable console logs\n  });\n</script>\n```\n\n#### With Module Bundlers (Webpack, Vite, etc.)\n\n```javascript\nimport '@amittrrajputtt/voice-navigation-ai';\n\n// Initialize when ready\ndocument.addEventListener('DOMContentLoaded', () => {\n  window.LiaPlusVoice.init({\n    language: 'en-US'\n  });\n});\n```\n\n#### React\n\n```jsx\nimport { useEffect } from 'react';\nimport '@amittrrajputtt/voice-navigation-ai';\n\nfunction App() {\n  useEffect(() => {\n    if (typeof window !== 'undefined' && window.LiaPlusVoice) {\n      window.LiaPlusVoice.init({\n        language: 'en-US',\n        autoStart: true\n      });\n    }\n  }, []);\n\n  return <div>Your app content</div>;\n}\n```\n\n#### Next.js\n\n```jsx\n// app/layout.tsx or pages/_app.tsx\n'use client';\n\nimport { useEffect } from 'react';\nimport Script from 'next/script';\n\nexport default function RootLayout({ children }) {\n  return (\n    <html>\n      <body>\n        {children}\n        <Script\n          src=\"https://unpkg.com/@amittrrajputtt/voice-navigation-ai\"\n          strategy=\"afterInteractive\"\n          onLoad={() => {\n            window.LiaPlusVoice?.init();\n          }}\n        />\n      </body>\n    </html>\n  );\n}\n```\n\n## 🎤 Voice Commands\n\nOnce activated, users can say:\n\n### Form Filling\n- \"Fill my name as John Smith\"\n- \"Enter email as john@example.com\"\n- \"Set phone number as 555-1234\"\n\n### Navigation\n- \"Scroll down\"\n- \"Go to top\"\n- \"Go back\"\n- \"Click submit button\"\n\n### Content\n- \"Read the page\"\n- \"Read this to me\"\n\n### Hindi Commands\n- \"मेरा नाम राज भरें\"\n- \"नीचे स्क्रॉल करें\"\n- \"सबमिट बटन पर क्लिक करें\"\n\n## 🔧 API Reference\n\n### `LiaPlusVoice.init(config?)`\n\nInitialize voice navigation with optional configuration.\n\n**Parameters:**\n\n| Option | Type | Default | Description |\n|--------|------|---------|-------------|\n| `apiBase` | string | `'https://liaplus.com/api'` | Base URL for API endpoints |\n| `language` | string | `'en-US'` | Language code (`'en-US'` or `'hi-IN'`) |\n| `autoStart` | boolean | `true` | Auto-start listening on initialization |\n| `debug` | boolean | `true` | Enable console logging |\n\n**Example:**\n\n```javascript\nLiaPlusVoice.init({\n  language: 'hi-IN',\n  autoStart: false,\n  debug: false\n});\n```\n\n### `LiaPlusVoice.start()`\n\nStart voice recognition manually.\n\n```javascript\nLiaPlusVoice.start();\n```\n\n### `LiaPlusVoice.stop()`\n\nStop voice recognition.\n\n```javascript\nLiaPlusVoice.stop();\n```\n\n### `LiaPlusVoice.analyzePage()`\n\nRe-analyze the current page structure (useful after dynamic content loads).\n\n```javascript\n// After loading dynamic content\nloadMoreContent().then(() => {\n  LiaPlusVoice.analyzePage();\n});\n```\n\n## 🎨 UI Customization\n\nThe library creates a floating voice button. Customize it with CSS:\n\n```css\n/* Change button color */\n#liaplus-voice-button {\n  background: linear-gradient(135deg, #ff6b6b 0%, #ee5a6f 100%) !important;\n}\n\n/* Change position */\n#liaplus-voice-widget {\n  bottom: 80px !important;\n  left: 20px !important;\n  right: auto !important;\n}\n\n/* Change size */\n#liaplus-voice-button {\n  width: 70px !important;\n  height: 70px !important;\n  font-size: 28px !important;\n}\n\n/* Hide button completely (use programmatic API instead) */\n#liaplus-voice-widget {\n  display: none !important;\n}\n```\n\n## 🔐 Self-Hosting (Advanced)\n\nTo use your own API endpoints instead of LiaPlus servers:\n\n### 1. Set up API endpoints\n\nYou need three endpoints:\n\n- `GET /api/voice-credentials` - Returns temporary Azure Speech tokens\n- `POST /api/voice-synthesize` - Text-to-speech conversion\n- `POST /api/voice-ai` - AI command processing\n\nExample implementations available in our [GitHub repo](https://github.com/liaplus/voice-navigation).\n\n### 2. Configure the library\n\n```javascript\nLiaPlusVoice.init({\n  apiBase: 'https://your-domain.com/api'\n});\n```\n\n## 📱 Browser Support\n\n| Browser | Support |\n|---------|---------|\n| Chrome 75+ | ✅ Full support |\n| Edge 79+ | ✅ Full support |\n| Safari 14.1+ | ✅ Full support |\n| Firefox 125+ | ⚠️ Limited |\n| Chrome Android | ✅ Full support |\n| Safari iOS | ⚠️ Limited |\n\n**Note:** Requires HTTPS (or localhost for development).\n\n## 🐛 Troubleshooting\n\n### Microphone not working?\n- Ensure HTTPS (required for microphone access)\n- Check browser permissions\n- Test on a supported browser\n\n### Commands not executing?\n- Check browser console for errors\n- Verify API endpoints are accessible\n- Enable `debug: true` to see detailed logs\n\n### \"Failed to fetch credentials\" error?\n- Verify API base URL is correct\n- Check CORS headers on your API\n- Ensure API endpoints are publicly accessible\n\n## 📊 TypeScript Support\n\nFull TypeScript definitions included:\n\n```typescript\nimport type { VoiceNavigationConfig, DOMAnalysis } from '@liaplus/voice-navigation';\n\nconst config: VoiceNavigationConfig = {\n  language: 'en-US',\n  autoStart: true\n};\n\nwindow.LiaPlusVoice.init(config);\n```\n\n## 🔒 Security & Privacy\n\n- **Server-side credentials** - Azure keys never exposed to client\n- **Short-lived tokens** - Auto-refresh every 9 minutes\n- **No data storage** - All processing in real-time\n- **HTTPS required** - Ensures secure communication\n- **CORS-enabled** - But rate-limited on server\n\n## 💰 Pricing\n\n### Free Tier\n- 100 commands/month per domain\n- Community support\n- All features included\n\n### Pro ($49/month)\n- 10,000 commands/month\n- Priority support\n- Custom branding\n- Analytics dashboard\n\n### Enterprise (Custom)\n- Unlimited commands\n- SLA guarantee\n- Dedicated support\n- Self-hosted option\n\n[View Pricing Details](https://liaplus.com/pricing)\n\n## 📚 Examples\n\n### E-commerce Checkout\n\n```html\n<!-- Customers can say: \"Fill shipping address\", \"Enter card number\", etc. -->\n<script src=\"https://unpkg.com/@amittrrajputtt/voice-navigation-ai\"></script>\n<script>\n  LiaPlusVoice.init({ language: 'en-US' });\n</script>\n```\n\n### Government Forms\n\n```html\n<!-- Citizens can fill complex forms by voice -->\n<script src=\"https://unpkg.com/@amittrrajputtt/voice-navigation-ai\"></script>\n<script>\n  LiaPlusVoice.init({ \n    language: 'hi-IN',  // Hindi for Indian users\n    autoStart: true \n  });\n</script>\n```\n\n### React SPA\n\n```jsx\nimport { useEffect } from 'react';\nimport '@amittrrajputtt/voice-navigation-ai';\n\nexport default function VoiceEnabledApp() {\n  useEffect(() => {\n    window.LiaPlusVoice?.init({\n      language: 'en-US',\n      debug: process.env.NODE_ENV === 'development'\n    });\n\n    return () => {\n      window.LiaPlusVoice?.stop();\n    };\n  }, []);\n\n  return <YourApp />;\n}\n```\n\n## 🤝 Contributing\n\nWe welcome contributions! Please see our [Contributing Guide](CONTRIBUTING.md).\n\n## 📄 License\n\nMIT License - see [LICENSE](LICENSE) file for details.\n\n## 🔗 Links\n\n- **Website:** [https://liaplus.com](https://liaplus.com)\n- **NPM:** [https://www.npmjs.com/package/@amittrrajputtt/voice-navigation-ai](https://www.npmjs.com/package/@amittrrajputtt/voice-navigation-ai)\n- **GitHub:** [https://github.com/amittrrajputtt/voice-navigation-ai](https://github.com/amittrrajputtt/voice-navigation-ai)\n- **Support:** [support@liaplus.com](mailto:support@liaplus.com)\n\n## ⭐ Show Your Support\n\nIf you find this library helpful, please give it a star on [GitHub](https://github.com/amittrrajputtt/voice-navigation-ai)!\n\n---\n\nMade with ❤️ by [LiaPlus Technologies](https://liaplus.com)\n","readmeFilename":"README.md","_rev":"1-b5d0eb850d4977744a57c8d60b323aa8"}