voiceai-sdk/TELEMETRY.md

Official SDK for SLNG.AI Voice API - Text-to-Speech, Speech-to-Text, and LLM services

# Telemetry

## What data is collected?

This SDK includes anonymous telemetry to help us understand usage patterns and improve the developer experience. We collect:

- **SDK version** - Which version you're using
- **Install metrics** - First install vs updates, install frequency
- **Environment info** - Node.js version, platform (Windows/Mac/Linux), architecture
- **Package manager** - npm, yarn, or pnpm
- **Project fingerprint** - Hashed identifier (cannot be traced back to you)

## What data is NOT collected?

- No personal information
- No code or file contents
- No environment variables or secrets
- No project names or paths
- No IP addresses (beyond what's needed for the HTTP request)

## How to disable telemetry

Set the environment variable:

```bash
export SLNG_DISABLE_TELEMETRY=1
```

Or add to your `.env` file:

```
SLNG_DISABLE_TELEMETRY=1
```

Telemetry is also automatically disabled in CI environments.

## Technical details

- Telemetry runs during `postinstall` and fails silently
- 3 second timeout - won't slow down your installs
- Data sent to `https://slng.ai/api/sdk-install`
- Uses SHA-256 hashing for anonymization
- Local install tracking stored in `.telemetry/` (gitignored)

## Privacy commitment

We are committed to transparency and privacy. Telemetry helps us:

- Prioritize which Node.js versions to support
- Understand which features are most used
- Identify installation issues across different environments
- Make data-driven decisions about SDK improvements

If you have concerns or questions about telemetry, please [open an issue](https://github.com/slng-ai/voiceai-sdk/issues).