@mastra/voice-deepgram 0.1.3-alpha.8 → 0.1.3

package/dist/index.cjs

@@ -79,7 +79,11 @@ var DeepgramVoice = class extends voice.MastraVoice {
     if (typeof input !== "string") {
       const chunks = [];
       for await (const chunk of input) {
-        chunks.push(Buffer.from(chunk));
+        if (typeof chunk === "string") {
+          chunks.push(Buffer.from(chunk));
+        } else {
+          chunks.push(chunk);
+        }
       }
       text = Buffer.concat(chunks).toString("utf-8");
     } else {
@@ -137,7 +141,11 @@ var DeepgramVoice = class extends voice.MastraVoice {
     }
     const chunks = [];
     for await (const chunk of audioStream) {
-      chunks.push(Buffer.from(chunk));
+      if (typeof chunk === "string") {
+        chunks.push(Buffer.from(chunk));
+      } else {
+        chunks.push(chunk);
+      }
     }
     const buffer = Buffer.concat(chunks);
     return this.traced(async () => {

package/dist/index.js

@@ -77,7 +77,11 @@ var DeepgramVoice = class extends MastraVoice {
     if (typeof input !== "string") {
       const chunks = [];
       for await (const chunk of input) {
-        chunks.push(Buffer.from(chunk));
+        if (typeof chunk === "string") {
+          chunks.push(Buffer.from(chunk));
+        } else {
+          chunks.push(chunk);
+        }
       }
       text = Buffer.concat(chunks).toString("utf-8");
     } else {
@@ -135,7 +139,11 @@ var DeepgramVoice = class extends MastraVoice {
     }
     const chunks = [];
     for await (const chunk of audioStream) {
-      chunks.push(Buffer.from(chunk));
+      if (typeof chunk === "string") {
+        chunks.push(Buffer.from(chunk));
+      } else {
+        chunks.push(chunk);
+      }
     }
     const buffer = Buffer.concat(chunks);
     return this.traced(async () => {

package/package.json

@@ -1,8 +1,11 @@
 {
   "name": "@mastra/voice-deepgram",
-  "version": "0.1.3-alpha.8",
+  "version": "0.1.3",
   "description": "Mastra Deepgram voice integration",
   "type": "module",
+  "files": [
+    "dist"
+  ],
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "exports": {
@@ -19,21 +22,21 @@
     "./package.json": "./package.json"
   },
   "dependencies": {
-    "@deepgram/sdk": "^3.9.0",
-    "zod": "^3.24.1",
-    "@mastra/core": "^0.5.0-alpha.8"
+    "@deepgram/sdk": "^3.11.2",
+    "zod": "^3.24.2",
+    "@mastra/core": "^0.5.0"
   },
   "devDependencies": {
-    "@microsoft/api-extractor": "^7.49.2",
-    "@types/node": "^22.13.1",
-    "tsup": "^8.3.6",
-    "typescript": "^5.7.3",
-    "vitest": "^2.1.8",
-    "eslint": "^9.20.1",
-    "@internal/lint": "0.0.0"
+    "@microsoft/api-extractor": "^7.52.1",
+    "@types/node": "^22.13.10",
+    "eslint": "^9.22.0",
+    "tsup": "^8.4.0",
+    "typescript": "^5.8.2",
+    "vitest": "^2.1.9",
+    "@internal/lint": "0.0.1"
   },
   "scripts": {
-    "build": "tsup src/index.ts --format esm,cjs --experimental-dts --clean --treeshake",
+    "build": "tsup src/index.ts --format esm,cjs --experimental-dts --clean --treeshake=smallest --splitting",
     "build:watch": "pnpm build --watch",
     "test": "vitest run",
     "lint": "eslint ."

package/.turbo/turbo-build.log

@@ -1,23 +0,0 @@
-
-> @mastra/voice-deepgram@0.1.3-alpha.8 build /home/runner/work/mastra/mastra/voice/deepgram
-> tsup src/index.ts --format esm,cjs --experimental-dts --clean --treeshake
-
-CLI Building entry: src/index.ts
-CLI Using tsconfig: tsconfig.json
-CLI tsup v8.3.6
-TSC Build start
-TSC ⚡️ Build success in 8012ms
-DTS Build start
-CLI Target: es2022
-Analysis will use the bundled TypeScript version 5.7.3
-Writing package typings: /home/runner/work/mastra/mastra/voice/deepgram/dist/_tsup-dts-rollup.d.ts
-Analysis will use the bundled TypeScript version 5.7.3
-Writing package typings: /home/runner/work/mastra/mastra/voice/deepgram/dist/_tsup-dts-rollup.d.cts
-DTS ⚡️ Build success in 9392ms
-CLI Cleaning output folder
-ESM Build start
-CJS Build start
-ESM dist/index.js 4.40 KB
-ESM ⚡️ Build success in 420ms
-CJS dist/index.cjs 4.43 KB
-CJS ⚡️ Build success in 421ms

package/CHANGELOG.md

@@ -1,219 +0,0 @@
-# Changelog
-
-## 0.1.3-alpha.8
-
-### Patch Changes
-
-- Updated dependencies [506f1d5]
-  - @mastra/core@0.5.0-alpha.8
-
-## 0.1.3-alpha.7
-
-### Patch Changes
-
-- Updated dependencies [ee667a2]
-  - @mastra/core@0.5.0-alpha.7
-
-## 0.1.3-alpha.6
-
-### Patch Changes
-
-- Updated dependencies [f6678e4]
-  - @mastra/core@0.5.0-alpha.6
-
-## 0.1.3-alpha.5
-
-### Patch Changes
-
-- Updated dependencies [22643eb]
-- Updated dependencies [6feb23f]
-- Updated dependencies [f2d6727]
-- Updated dependencies [301e4ee]
-- Updated dependencies [dfbe4e9]
-- Updated dependencies [9e81f35]
-- Updated dependencies [caefaa2]
-- Updated dependencies [c151ae6]
-- Updated dependencies [52e0418]
-- Updated dependencies [03236ec]
-- Updated dependencies [3764e71]
-- Updated dependencies [df982db]
-- Updated dependencies [0461849]
-- Updated dependencies [2259379]
-- Updated dependencies [358f069]
-  - @mastra/core@0.5.0-alpha.5
-
-## 0.1.3-alpha.4
-
-### Patch Changes
-
-- Updated dependencies [d79aedf]
-  - @mastra/core@0.5.0-alpha.4
-
-## 0.1.3-alpha.3
-
-### Patch Changes
-
-- Updated dependencies [3d0e290]
-  - @mastra/core@0.5.0-alpha.3
-
-## 0.1.3-alpha.2
-
-### Patch Changes
-
-- Updated dependencies [02ffb7b]
-  - @mastra/core@0.5.0-alpha.2
-
-## 0.1.3-alpha.1
-
-### Patch Changes
-
-- Updated dependencies [dab255b]
-  - @mastra/core@0.5.0-alpha.1
-
-## 0.1.3-alpha.0
-
-### Patch Changes
-
-- Updated dependencies [59df7b6]
-- Updated dependencies [29f3a82]
-- Updated dependencies [59df7b6]
-- Updated dependencies [c139344]
-  - @mastra/core@0.5.0-alpha.0
-
-## 0.1.2
-
-### Patch Changes
-
-- Updated dependencies [1da20e7]
-  - @mastra/core@0.4.4
-
-## 0.1.2-alpha.0
-
-### Patch Changes
-
-- Updated dependencies [1da20e7]
-  - @mastra/core@0.4.4-alpha.0
-
-## 0.1.1
-
-### Patch Changes
-
-- bb4f447: Add support for commonjs
-- Updated dependencies [0d185b1]
-- Updated dependencies [ed55f1d]
-- Updated dependencies [06aa827]
-- Updated dependencies [0fd78ac]
-- Updated dependencies [2512a93]
-- Updated dependencies [e62de74]
-- Updated dependencies [0d25b75]
-- Updated dependencies [fd14a3f]
-- Updated dependencies [8d13b14]
-- Updated dependencies [3f369a2]
-- Updated dependencies [3ee4831]
-- Updated dependencies [4d4e1e1]
-- Updated dependencies [bb4f447]
-- Updated dependencies [108793c]
-- Updated dependencies [5f28f44]
-- Updated dependencies [dabecf4]
-  - @mastra/core@0.4.3
-
-## 0.1.1-alpha.4
-
-### Patch Changes
-
-- Updated dependencies [dabecf4]
-  - @mastra/core@0.4.3-alpha.4
-
-## 0.1.1-alpha.3
-
-### Patch Changes
-
-- bb4f447: Add support for commonjs
-- Updated dependencies [0fd78ac]
-- Updated dependencies [0d25b75]
-- Updated dependencies [fd14a3f]
-- Updated dependencies [3f369a2]
-- Updated dependencies [4d4e1e1]
-- Updated dependencies [bb4f447]
-  - @mastra/core@0.4.3-alpha.3
-
-## 0.1.1-alpha.2
-
-### Patch Changes
-
-- Updated dependencies [2512a93]
-- Updated dependencies [e62de74]
-  - @mastra/core@0.4.3-alpha.2
-
-## 0.1.1-alpha.1
-
-### Patch Changes
-
-- Updated dependencies [0d185b1]
-- Updated dependencies [ed55f1d]
-- Updated dependencies [8d13b14]
-- Updated dependencies [3ee4831]
-- Updated dependencies [108793c]
-- Updated dependencies [5f28f44]
-  - @mastra/core@0.4.3-alpha.1
-
-## 0.1.1-alpha.0
-
-### Patch Changes
-
-- Updated dependencies [06aa827]
-  - @mastra/core@0.4.3-alpha.0
-
-## 0.1.0
-
-### Patch Changes
-
-- abe4600: deprecate @mastra/speech-deepgram for @mastra/voice-deepgram
-- 1a10ac1: fix deepgram security issue
-- Updated dependencies [7fceae1]
-- Updated dependencies [8d94c3e]
-- Updated dependencies [99dcdb5]
-- Updated dependencies [6cb63e0]
-- Updated dependencies [f626fbb]
-- Updated dependencies [e752340]
-- Updated dependencies [eb91535]
-  - @mastra/core@0.4.2
-
-## 0.1.0-alpha.4
-
-### Patch Changes
-
-- Updated dependencies [8d94c3e]
-- Updated dependencies [99dcdb5]
-- Updated dependencies [e752340]
-- Updated dependencies [eb91535]
-  - @mastra/core@0.4.2-alpha.2
-
-## 0.1.0-alpha.3
-
-### Patch Changes
-
-- 1a10ac1: fix deepgram security issue
-- Updated dependencies [6cb63e0]
-  - @mastra/core@0.4.2-alpha.1
-
-## 0.1.0-alpha.2
-
-### Patch Changes
-
-- abe4600: deprecate @mastra/speech-deepgram for @mastra/voice-deepgram
-- Updated dependencies [7fceae1]
-- Updated dependencies [f626fbb]
-  - @mastra/core@0.4.2-alpha.0
-
-## 0.1.0 (2024-XX-XX)
-
-This package replaces the deprecated @mastra/speech-deepgram package. All functionality has been migrated to this new package with a more consistent naming scheme.
-
-### Changes from @mastra/speech-deepgram
-
-- Package renamed from @mastra/speech-deepgram to @mastra/voice-deepgram
-- All functionality remains the same
-- Import paths should be updated from '@mastra/speech-deepgram' to '@mastra/voice-deepgram'
-
-For a complete history of changes prior to the rename, please see the changelog of the original package.

package/eslint.config.js

@@ -1,6 +0,0 @@
-import { createConfig } from '@internal/lint/eslint';
-
-const config = await createConfig();
-
-/** @type {import("eslint").Linter.Config[]} */
-export default [...config];

package/src/index.test.ts

@@ -1,134 +0,0 @@
-import { writeFileSync, mkdirSync, createReadStream } from 'fs';
-import path from 'path';
-import { PassThrough } from 'stream';
-import { describe, expect, it, beforeAll } from 'vitest';
-
-import { DeepgramVoice } from './index.js';
-
-describe('DeepgramVoice Integration Tests', () => {
-  let voice: DeepgramVoice;
-  const outputDir = path.join(process.cwd(), 'test-outputs');
-
-  beforeAll(() => {
-    try {
-      mkdirSync(outputDir, { recursive: true });
-    } catch (err) {
-      console.log('Directory already exists: ', err);
-    }
-
-    voice = new DeepgramVoice({
-      speechModel: {
-        name: 'aura',
-      },
-      listeningModel: {
-        name: 'whisper',
-      },
-      speaker: 'asteria-en',
-    });
-  });
-
-  describe('getSpeakers', () => {
-    it('should list available voices', async () => {
-      const speakers = await voice.getSpeakers();
-      const expectedVoiceIds = ['asteria-en', 'stella-en', 'luna-en'];
-      expectedVoiceIds.forEach(voiceId => {
-        expect(speakers.some(s => s.voiceId === voiceId)).toBe(true);
-      });
-    });
-  });
-
-  describe('speak', () => {
-    it('should generate audio and save to file', async () => {
-      const audioResult = await voice.speak('Hello World', {
-        text: 'Hello World',
-      });
-
-      const chunks: Buffer[] = [];
-      for await (const chunk of audioResult) {
-        chunks.push(Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk));
-      }
-      const audioBuffer = Buffer.concat(chunks);
-      const outputPath = path.join(outputDir, 'deepgram-speech-test.mp3');
-      writeFileSync(outputPath, audioBuffer);
-      expect(audioBuffer.length).toBeGreaterThan(0);
-    }, 10000);
-
-    it('should work with different parameters', async () => {
-      const audioResult = await voice.speak('Hello World', {
-        text: 'Test with parameters',
-        speaker: 'luna-en',
-      });
-
-      const chunks: Buffer[] = [];
-      for await (const chunk of audioResult) {
-        chunks.push(Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk));
-      }
-      const audioBuffer = Buffer.concat(chunks);
-      const outputPath = path.join(outputDir, 'deepgram-speech-test-params.mp3');
-      writeFileSync(outputPath, audioBuffer);
-      expect(audioBuffer.length).toBeGreaterThan(0);
-    }, 10000);
-  });
-
-  // Error cases
-  describe('error handling', () => {
-    it('should handle invalid voice names', async () => {
-      await expect(voice.speak('Test', { speaker: 'invalid_voice' })).rejects.toThrow();
-    });
-
-    it('should handle empty text', async () => {
-      await expect(voice.speak('', { speaker: 'asteria-en' })).rejects.toThrow('Input text is empty');
-    });
-
-    it('should handle whitespace-only text', async () => {
-      await expect(voice.speak('   \n\t  ', { speaker: 'asteria-en' })).rejects.toThrow('Input text is empty');
-    });
-  });
-
-  describe('listen', () => {
-    it('should transcribe audio buffer', async () => {
-      // First generate some audio to transcribe
-      const audioResult = await voice.speak('This is a test of transcription');
-
-      // Collect audio chunks
-      const chunks: Buffer[] = [];
-      for await (const chunk of audioResult) {
-        chunks.push(Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk));
-      }
-      const audioBuffer = Buffer.concat(chunks);
-
-      // Create stream from the buffer
-      const stream = new PassThrough();
-      stream.end(audioBuffer);
-      const result = await voice.listen(stream);
-
-      expect(typeof result).toBe('string');
-      expect(result.toLowerCase()).toContain('test');
-      expect(result.toLowerCase()).toContain('transcription');
-    }, 15000);
-
-    it('should transcribe audio from fixture file', async () => {
-      const fixturePath = path.join(process.cwd(), '__fixtures__', 'voice-test.m4a');
-      const audioStream = createReadStream(fixturePath);
-
-      console.log('listening to audio stream');
-      const text = await voice.listen(audioStream, {
-        filetype: 'm4a',
-      });
-      console.log('text', text);
-
-      expect(text).toBeTruthy();
-      console.log(text);
-      expect(typeof text).toBe('string');
-      expect(text.length).toBeGreaterThan(0);
-    }, 15000);
-
-    it('should handle invalid audio', async () => {
-      const invalidAudio = Buffer.from('not valid audio');
-      const stream = new PassThrough();
-      stream.end(invalidAudio);
-
-      await expect(voice.listen(stream)).rejects.toThrow();
-    });
-  });
-});

package/src/index.ts

@@ -1,190 +0,0 @@
-import { PassThrough } from 'stream';
-
-import { createClient } from '@deepgram/sdk';
-import { MastraVoice } from '@mastra/core/voice';
-
-import { DEEPGRAM_VOICES } from './voices';
-import type { DeepgramVoiceId, DeepgramModel } from './voices';
-
-interface DeepgramVoiceConfig {
-  name?: DeepgramModel;
-  apiKey?: string;
-  properties?: Record<string, any>;
-  language?: string;
-}
-
-export class DeepgramVoice extends MastraVoice {
-  private speechClient?: ReturnType<typeof createClient>;
-  private listeningClient?: ReturnType<typeof createClient>;
-
-  constructor({
-    speechModel,
-    listeningModel,
-    speaker,
-  }: { speechModel?: DeepgramVoiceConfig; listeningModel?: DeepgramVoiceConfig; speaker?: DeepgramVoiceId } = {}) {
-    const defaultApiKey = process.env.DEEPGRAM_API_KEY;
-
-    const defaultSpeechModel = {
-      name: 'aura',
-      apiKey: defaultApiKey,
-    };
-
-    const defaultListeningModel = {
-      name: 'nova',
-      apiKey: defaultApiKey,
-    };
-
-    super({
-      speechModel: {
-        name: speechModel?.name ?? defaultSpeechModel.name,
-        apiKey: speechModel?.apiKey ?? defaultSpeechModel.apiKey,
-      },
-      listeningModel: {
-        name: listeningModel?.name ?? defaultListeningModel.name,
-        apiKey: listeningModel?.apiKey ?? defaultListeningModel.apiKey,
-      },
-      speaker,
-    });
-
-    const speechApiKey = speechModel?.apiKey || defaultApiKey;
-    const listeningApiKey = listeningModel?.apiKey || defaultApiKey;
-
-    if (!speechApiKey && !listeningApiKey) {
-      throw new Error('At least one of DEEPGRAM_API_KEY, speechModel.apiKey, or listeningModel.apiKey must be set');
-    }
-
-    if (speechApiKey) {
-      this.speechClient = createClient(speechApiKey);
-    }
-    if (listeningApiKey) {
-      this.listeningClient = createClient(listeningApiKey);
-    }
-
-    this.speaker = speaker || 'asteria-en';
-  }
-
-  async getSpeakers() {
-    return this.traced(async () => {
-      return DEEPGRAM_VOICES.map(voice => ({
-        voiceId: voice,
-      }));
-    }, 'voice.deepgram.getSpeakers')();
-  }
-
-  async speak(
-    input: string | NodeJS.ReadableStream,
-    options?: {
-      speaker?: string;
-      [key: string]: any;
-    },
-  ): Promise<NodeJS.ReadableStream> {
-    if (!this.speechClient) {
-      throw new Error('Deepgram speech client not configured');
-    }
-
-    let text: string;
-    if (typeof input !== 'string') {
-      const chunks: Buffer[] = [];
-      for await (const chunk of input) {
-        chunks.push(Buffer.from(chunk));
-      }
-      text = Buffer.concat(chunks).toString('utf-8');
-    } else {
-      text = input;
-    }
-
-    if (text.trim().length === 0) {
-      throw new Error('Input text is empty');
-    }
-
-    return this.traced(async () => {
-      if (!this.speechClient) {
-        throw new Error('No speech client configured');
-      }
-
-      let model;
-      if (options?.speaker) {
-        model = this.speechModel?.name + '-' + options.speaker;
-      } else if (this.speaker) {
-        model = this.speechModel?.name + '-' + this.speaker;
-      }
-
-      const speakClient = this.speechClient.speak;
-      const response = await speakClient.request(
-        { text },
-        {
-          model,
-          ...options,
-        },
-      );
-
-      const webStream = await response.getStream();
-      if (!webStream) {
-        throw new Error('No stream returned from Deepgram');
-      }
-
-      const reader = webStream.getReader();
-      const nodeStream = new PassThrough();
-
-      // Add error handling for the stream processing
-      (async () => {
-        try {
-          while (true) {
-            const { done, value } = await reader.read();
-            if (done) {
-              nodeStream.end();
-              break;
-            }
-            nodeStream.write(value);
-          }
-        } catch (error) {
-          nodeStream.destroy(error as Error);
-        }
-      })().catch(error => {
-        nodeStream.destroy(error as Error);
-      });
-
-      return nodeStream;
-    }, 'voice.deepgram.speak')();
-  }
-
-  async listen(
-    audioStream: NodeJS.ReadableStream,
-    options?: {
-      [key: string]: any;
-    },
-  ): Promise<string> {
-    if (!this.listeningClient) {
-      throw new Error('Deepgram listening client not configured');
-    }
-
-    const chunks: Buffer[] = [];
-    for await (const chunk of audioStream) {
-      chunks.push(Buffer.from(chunk));
-    }
-    const buffer = Buffer.concat(chunks);
-
-    return this.traced(async () => {
-      if (!this.listeningClient) {
-        throw new Error('No listening client configured');
-      }
-      const { result, error } = await this.listeningClient.listen.prerecorded.transcribeFile(buffer, {
-        model: this.listeningModel?.name,
-        ...options,
-      });
-
-      if (error) {
-        throw error;
-      }
-
-      const transcript = result.results?.channels?.[0]?.alternatives?.[0]?.transcript;
-      if (!transcript) {
-        throw new Error('No transcript found in Deepgram response');
-      }
-
-      return transcript;
-    }, 'voice.deepgram.listen')();
-  }
-}
-
-export type { DeepgramVoiceConfig, DeepgramVoiceId, DeepgramModel };

package/src/voices.ts

@@ -1,28 +0,0 @@
-/**
- * List of available Deepgram voice models for text-to-speech
- * Each voice is designed for specific use cases and languages
- * Format: {name}-{language} (e.g. asteria-en)
- */
-export const DEEPGRAM_VOICES = [
-  'asteria-en',
-  'luna-en',
-  'stella-en',
-  'athena-en',
-  'hera-en',
-  'orion-en',
-  'arcas-en',
-  'perseus-en',
-  'angus-en',
-  'orpheus-en',
-  'helios-en',
-  'zeus-en',
-] as const;
-
-export type DeepgramVoiceId = (typeof DEEPGRAM_VOICES)[number];
-
-/**
- * List of available Deepgram models for text-to-speech and speech-to-text
- */
-export const DEEPGRAM_MODELS = ['aura', 'whisper', 'base', 'enhanced', 'nova', 'nova-2', 'nova-3'] as const;
-
-export type DeepgramModel = (typeof DEEPGRAM_MODELS)[number];

package/tsconfig.json

@@ -1,5 +0,0 @@
-{
-  "extends": "../../tsconfig.node.json",
-  "include": ["src/**/*"],
-  "exclude": ["node_modules", "**/*.test.ts"]
-}

package/vitest.config.ts

@@ -1,9 +0,0 @@
-import { defineConfig } from 'vitest/config';
-
-export default defineConfig({
-  test: {
-    globals: true,
-    environment: 'node',
-    include: ['src/**/*.test.ts'],
-  },
-});