feat(tests): add TTS test, fix offline tests for mocks

Author: lukeocodes

jest.config.js

@@ -47,4 +47,8 @@ module.exports = {
   // Clear mocks between tests
   clearMocks: true,
   restoreMocks: true,
+
+  // Force Jest to exit after tests complete
+  // This prevents hanging caused by lingering HTTP connections (TLSWRAP handles)
+  forceExit: true,
 };

package.json

@@ -55,6 +55,8 @@
     "docs:json": "typedoc --entryPoints src/index.ts --includes src/packages/**/*.ts --json docs/spec.json   --emit none",
     "test": "jest",
     "test:unit": "jest --testPathPattern=tests/unit",
+    "test:e2e": "jest --testPathPattern=tests/e2e",
+    "test:e2e:offline": "node scripts/test-offline.js",
     "test:watch": "jest --watch",
     "test:coverage": "jest --coverage",
     "test:ci": "jest --ci --coverage --watchAll=false"
@@ -82,7 +84,6 @@
     "jest-environment-jsdom": "^29.7.0",
     "markdownlint": "^0.35.0",
     "markdownlint-cli": "^0.42.0",
-    "nock": "^13.5.4",
     "nodemon": "^3.0.1",
     "npm-run-all": "^4.1.5",
     "prettier": "^2.5.1",

pnpm-lock.yaml

@@ -0,0 +1,54 @@
+#!/usr/bin/env node
+
+/* eslint-env node */
+/* eslint-disable @typescript-eslint/no-var-requires, import/no-commonjs */
+
+/**
+ * Test script to verify e2e tests work properly offline
+ * This script simulates offline conditions and runs the tests
+ */
+
+const { spawn } = require("child_process");
+
+console.log("🧪 Testing Deepgram JS SDK e2e tests in offline mode\n");
+
+// Environment variables to ensure offline testing
+const env = {
+  ...process.env,
+  JEST_SILENT: "false",
+  NODE_ENV: "test",
+  // Remove any real API key to force mock usage
+  DEEPGRAM_API_KEY: "mock-api-key-for-offline-testing",
+};
+
+// Test command
+const testCommand = "npm";
+const testArgs = ["test", "--", "tests/e2e/", "--verbose"];
+
+console.log("🎭 Running e2e tests with mocked API calls...");
+console.log(`Command: ${testCommand} ${testArgs.join(" ")}\n`);
+
+const testProcess = spawn(testCommand, testArgs, {
+  env,
+  stdio: "inherit",
+  shell: true,
+});
+
+testProcess.on("close", (code) => {
+  if (code === 0) {
+    console.log("\n✅ All e2e tests passed in offline mode!");
+    console.log("🎉 Your tests are properly configured to work without internet connection.");
+    console.log("\n💡 To run tests with real API calls (for updating snapshots):");
+    console.log("   npm test -- tests/e2e/ --updateSnapshot");
+    console.log("\n🔧 To force real API calls without updating snapshots:");
+    console.log("   DEEPGRAM_FORCE_REAL_API=true npm test -- tests/e2e/");
+  } else {
+    console.log(`\n❌ Tests failed with exit code ${code}`);
+    console.log("🔍 This indicates there might be network dependencies that need to be mocked.");
+  }
+});
+
+testProcess.on("error", (error) => {
+  console.error("❌ Failed to run tests:", error);
+  process.exit(1);
+});

scripts/test-offline.js

@@ -55,3 +55,41 @@ export const transcriptionOptions = {
     keyterm: ["spacewalk"],
   },
 } as const;
+
+/**
+ * Common TTS options used across multiple tests
+ */
+export const commonTTSOptions = {
+  model: "aura-2-thalia-en",
+  encoding: "mp3",
+} as const;
+
+/**
+ * Test text sources for TTS scenarios
+ */
+export const testTextSources = {
+  greeting: { text: "Hello, how can I help you today?" },
+  longText: {
+    text: "This is a longer text sample for testing text-to-speech functionality with multiple sentences. It should demonstrate how the API handles longer content.",
+  },
+  multiline: { text: "Line one.\nLine two.\nLine three with more content." },
+} as const;
+
+/**
+ * Alternative TTS options for different test scenarios
+ */
+export const ttsOptions = {
+  basic: {
+    model: "aura-2-thalia-en",
+  },
+  highQuality: {
+    model: "aura-2-thalia-en",
+    encoding: "linear16",
+    sample_rate: 48000,
+  },
+  compressed: {
+    model: "aura-2-thalia-en",
+    encoding: "mp3",
+    bit_rate: 128000,
+  },
+} as const;