@mastra/voice-cloudflare 0.12.0 → 0.12.1

package/dist/docs/references/reference-voice-cloudflare.md

@@ -0,0 +1,83 @@
+# Cloudflare
+
+The CloudflareVoice class in Mastra provides text-to-speech capabilities using Cloudflare Workers AI. This provider specializes in efficient, low-latency speech synthesis suitable for edge computing environments.
+
+## Usage example
+
+```typescript
+import { CloudflareVoice } from '@mastra/voice-cloudflare'
+
+// Initialize with configuration
+const voice = new CloudflareVoice({
+  speechModel: {
+    name: '@cf/meta/m2m100-1.2b',
+    apiKey: 'your-cloudflare-api-token',
+    accountId: 'your-cloudflare-account-id',
+  },
+  speaker: 'en-US-1', // Default voice
+})
+
+// Convert text to speech
+const audioStream = await voice.speak('Hello, how can I help you?', {
+  speaker: 'en-US-2', // Override default voice
+})
+
+// Get available voices
+const speakers = await voice.getSpeakers()
+console.log(speakers)
+```
+
+## Configuration
+
+### Constructor options
+
+**speechModel** (`CloudflareSpeechConfig`): Configuration for text-to-speech synthesis.
+
+**speechModel.name** (`string`): Model name to use for TTS.
+
+**speechModel.apiKey** (`string`): Cloudflare API token with Workers AI access. Falls back to CLOUDFLARE\_API\_TOKEN environment variable.
+
+**speechModel.accountId** (`string`): Cloudflare account ID. Falls back to CLOUDFLARE\_ACCOUNT\_ID environment variable.
+
+**speaker** (`string`): Default voice ID for speech synthesis. (Default: `'en-US-1'`)
+
+## Methods
+
+### `speak()`
+
+Converts text to speech using Cloudflare's text-to-speech service.
+
+**input** (`string | NodeJS.ReadableStream`): Text or text stream to convert to speech.
+
+**options** (`Options`): Configuration options.
+
+**options.speaker** (`string`): Voice ID to use for speech synthesis.
+
+**options.format** (`string`): Output audio format.
+
+Returns: `Promise<NodeJS.ReadableStream>`
+
+### `getSpeakers()`
+
+Returns an array of available voice options, where each node contains:
+
+**voiceId** (`string`): Unique identifier for the voice (e.g., 'en-US-1')
+
+**language** (`string`): Language code of the voice (e.g., 'en-US')
+
+## Notes
+
+- API tokens can be provided via constructor options or environment variables (CLOUDFLARE\_API\_TOKEN and CLOUDFLARE\_ACCOUNT\_ID)
+- Cloudflare Workers AI is optimized for edge computing with low latency
+- This provider only supports text-to-speech (TTS) functionality, not speech-to-text (STT)
+- The service integrates well with other Cloudflare Workers products
+- For production use, ensure your Cloudflare account has the appropriate Workers AI subscription
+- Voice options are more limited compared to some other providers, but performance at the edge is excellent
+
+## Related providers
+
+If you need speech-to-text capabilities in addition to text-to-speech, consider using one of these providers:
+
+- [OpenAI](https://mastra.ai/reference/voice/openai) - Provides both TTS and STT
+- [Google](https://mastra.ai/reference/voice/google) - Provides both TTS and STT
+- [Azure](https://mastra.ai/reference/voice/azure) - Provides both TTS and STT

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mastra/voice-cloudflare",
-  "version": "0.12.0",
+  "version": "0.12.1",
   "description": "Mastra Cloudflare AI voice integration",
   "type": "module",
   "files": [
@@ -24,21 +24,21 @@
   },
   "license": "Apache-2.0",
   "dependencies": {
-    "cloudflare": "^4.5.0"
+    "cloudflare": "^5.2.0"
   },
   "devDependencies": {
-    "@cloudflare/workers-types": "^4.20251111.0",
-    "@types/node": "22.13.17",
-    "@vitest/coverage-v8": "4.0.12",
-    "@vitest/ui": "4.0.12",
-    "eslint": "^9.37.0",
-    "tsup": "^8.5.0",
+    "@cloudflare/workers-types": "^4.20260316.1",
+    "@types/node": "22.19.15",
+    "@vitest/coverage-v8": "4.0.18",
+    "@vitest/ui": "4.0.18",
+    "eslint": "^9.39.4",
+    "tsup": "^8.5.1",
     "typescript": "^5.9.3",
-    "vitest": "4.0.16",
-    "zod": "^3.25.76",
-    "@internal/lint": "0.0.54",
-    "@internal/types-builder": "0.0.29",
-    "@mastra/core": "1.0.0"
+    "vitest": "4.0.18",
+    "zod": "^4.3.6",
+    "@internal/lint": "0.0.75",
+    "@internal/types-builder": "0.0.50",
+    "@mastra/core": "1.18.0"
   },
   "keywords": [
     "mastra",
@@ -68,7 +68,6 @@
   },
   "scripts": {
     "build": "tsup --silent --config tsup.config.ts",
-    "postbuild": "pnpx tsx ../../scripts/generate-package-docs.ts voice/cloudflare",
     "build:watch": "tsup --watch --silent --config tsup.config.ts",
     "test": "vitest run",
     "test:watch": "vitest watch",

package/dist/docs/README.md

@@ -1,32 +0,0 @@
-# @mastra/voice-cloudflare Documentation
-
-> Embedded documentation for coding agents
-
-## Quick Start
-
-```bash
-# Read the skill overview
-cat docs/SKILL.md
-
-# Get the source map
-cat docs/SOURCE_MAP.json
-
-# Read topic documentation
-cat docs/<topic>/01-overview.md
-```
-
-## Structure
-
-```
-docs/
-├── SKILL.md           # Entry point
-├── README.md          # This file
-├── SOURCE_MAP.json    # Export index
-├── agents/ (1 files)
-├── voice/ (2 files)
-```
-
-## Version
-
-Package: @mastra/voice-cloudflare
-Version: 0.12.0