@anganyai/voice-sdk 0.0.1

package/CHANGELOG.md

@@ -0,0 +1,33 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to
+[Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+### Added
+
+- Initial SDK structure and TypeScript setup
+- Core authentication module with Frontend, Backend, and Service Account
+  patterns
+- Conversation management with real-time transcriptions
+- Platform-specific implementations for Web, Node.js, and React Native
+- Comprehensive type definitions
+- Enterprise-grade tooling (oxlint, knip, prettier, vitest)
+- Documentation generation with TypeDoc
+- E2E testing setup with Playwright
+- Automated release management with changesets
+
+### Security
+
+- Secure OAuth2/OIDC authentication flows
+- Dynamic client registration for backend auth
+
+## [0.0.1] - 2025-01-20
+
+### Added
+
+- Initial release (pre-alpha)

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Angany AI
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE. 

package/README.md

@@ -0,0 +1,203 @@
+# Angany Voice SDK
+
+[![npm version](https://img.shields.io/npm/v/@angany/voice-sdk.svg)](https://www.npmjs.com/package/@angany/voice-sdk)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![TypeScript](https://img.shields.io/badge/TypeScript-5.0+-blue.svg)](https://www.typescriptlang.org/)
+[![Documentation](https://img.shields.io/badge/docs-typedoc-blue.svg)](https://angany.github.io/voice-sdk)
+
+Enterprise-grade SDK for building AI-powered voice conversations with Angany.
+
+## Features
+
+- 🎙️ **Real-time Voice Conversations** - Natural, low-latency voice interactions
+- 🔐 **Enterprise Authentication** - Multiple auth patterns (Frontend, Backend,
+  Service Account)
+- 🌐 **Cross-Platform** - Works on Web, Node.js, and React Native
+- 📝 **Live Transcriptions** - Real-time speech-to-text with speaker attribution
+- 🔄 **Automatic Reconnection** - Resilient connection handling
+- 📊 **Quality Monitoring** - Built-in connection quality metrics
+- 🎛️ **Advanced Audio Controls** - Echo cancellation, noise suppression, AGC
+- 🏗️ **TypeScript First** - Full type safety and IntelliSense support
+
+## Installation
+
+```bash
+npm install @angany/voice-sdk
+# or
+yarn add @angany/voice-sdk
+# or
+pnpm add @angany/voice-sdk
+```
+
+## Quick Start
+
+```typescript
+import { AnganyVoice } from '@angany/voice-sdk';
+
+// Initialize the SDK
+const voice = new AnganyVoice({
+  apiUrl: 'https://api.angany.ai',
+  debug: true,
+});
+
+// Authenticate (Frontend flow)
+await voice.auth.authenticateFrontend();
+
+// Start a conversation
+const conversation = await voice.startConversation('customer-support');
+
+// Listen to transcriptions
+conversation.on('transcription', (event) => {
+  console.log(`${event.role}: ${event.text}`);
+});
+
+// Send a message to the AI
+await conversation.speak('Hello, I need help with my account');
+```
+
+## Documentation
+
+- [Architecture Guide](./docs/architecture.md)
+- [API Reference](./docs/api/README.md)
+- [Security Policy](./SECURITY.md)
+- [Quick Start Guide](./QUICK_START.md)
+
+## Platform Support
+
+### Web
+
+```typescript
+import { AnganyVoice } from '@angany/voice-sdk/web';
+```
+
+### Node.js
+
+```typescript
+import { AnganyVoice } from '@angany/voice-sdk/node';
+```
+
+### React Native
+
+```typescript
+import { AnganyVoice } from '@angany/voice-sdk/react-native';
+```
+
+## Authentication
+
+The SDK supports multiple authentication patterns:
+
+### Frontend Authentication
+
+Best for SPAs and web applications:
+
+```typescript
+await voice.auth.authenticateFrontend({
+  redirectUri: 'https://app.example.com/callback',
+});
+```
+
+### Backend Authentication
+
+For server-side applications:
+
+```typescript
+const { authUrl } = await voice.auth.authenticateBackend({
+  branding: {
+    applicationName: 'My App',
+    applicationIcon: 'https://example.com/icon.png',
+  },
+});
+// Redirect user to authUrl
+```
+
+### Service Account
+
+For machine-to-machine communication:
+
+```typescript
+await voice.auth.authenticateServiceAccount({
+  credentials: {
+    clientId: process.env.CLIENT_ID,
+    clientSecret: process.env.CLIENT_SECRET,
+  },
+});
+```
+
+## Examples
+
+### Handle Connection States
+
+```typescript
+conversation.on('stateChange', (state, previousState) => {
+  console.log(`State changed from ${previousState} to ${state}`);
+});
+
+conversation.on('error', (error) => {
+  console.error('Conversation error:', error);
+});
+```
+
+### Monitor Connection Quality
+
+```typescript
+conversation.on('qualityChange', (quality) => {
+  console.log(`Connection quality: ${quality.level} (${quality.score}/100)`);
+});
+```
+
+### Mute/Unmute
+
+```typescript
+// Mute the user's microphone
+await conversation.muteUser();
+
+// Mute the AI agent
+await conversation.muteAgent();
+```
+
+## Development
+
+```bash
+# Install dependencies
+pnpm install
+
+# Run tests
+pnpm test
+
+# Build the SDK
+pnpm build
+
+# Run linting
+pnpm lint
+
+# Check for unused code
+pnpm knip
+```
+
+## Contributing
+
+We welcome contributions! Please see our [Contributing Guide](CONTRIBUTING.md)
+for details.
+
+## License
+
+MIT © Angany AI
+
+## Support
+
+- 📧 Email: sdk@angany.ai
+- 💬 Discord: [Join our community](https://discord.gg/angany)
+- 🐛 Issues: [GitHub Issues](https://github.com/angany/voice-sdk/issues)
+
+---
+
+<p align="center">
+  Built with ❤️ by <a href="https://angany.ai">Angany AI</a>
+</p>
+
+<p align="center">
+  <a href="https://angany.ai/docs">Docs</a> •
+  <a href="https://angany.ai/examples">Examples</a> •
+  <a href="https://angany.ai/discord">Discord</a> •
+  <a href="https://angany.ai/blog">Blog</a>
+</p>