@360labs/live-transcribe 0.1.1 → 0.2.0

package/CHANGELOG.md

@@ -7,6 +7,17 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.2.0] - 2026-01-18
+
+### Added
+- **Language Switching**: Change language mid-transcription with `setLanguage()`
+- New `getLanguage()` method to get current language
+- New `languageChange` event emitted when language changes
+- Automatic stop/restart handling when switching languages during active transcription
+- Session-level language switching support
+- Documentation for language switching feature
+- Tests for language switching functionality (6 new tests)
+
 ## [0.1.0] - 2026-01-17
 
 ### Added
@@ -37,5 +48,6 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ### Security
 - N/A
 
-[Unreleased]: https://github.com/yourusername/live-transcribe/compare/v0.1.0...HEAD
-[0.1.0]: https://github.com/yourusername/live-transcribe/releases/tag/v0.1.0
+[Unreleased]: https://github.com/360labs/live-transcribe/compare/v0.2.0...HEAD
+[0.2.0]: https://github.com/360labs/live-transcribe/compare/v0.1.0...v0.2.0
+[0.1.0]: https://github.com/360labs/live-transcribe/releases/tag/v0.1.0

package/README.md

@@ -407,6 +407,11 @@ transcriber.on('stateChange', (state) => {
   console.log('State changed to:', state);
 });
 
+// Language changes
+transcriber.on('languageChange', (change) => {
+  console.log(`Language: ${change.from} -> ${change.to}`);
+});
+
 // Error handling
 transcriber.on('error', (error) => {
   console.error('Error code:', error.code);
@@ -553,6 +558,81 @@ const session = createSession({
 });
 ```
 
+### Changing Language Mid-Transcript
+
+You can change the language during an active transcription session. The library automatically handles stopping and restarting the transcription with the new language:
+
+```typescript
+const session = createSession({
+  provider: TranscriptionProvider.WebSpeechAPI,
+  language: 'en-US',
+});
+
+await session.start();
+
+// User switches to Spanish mid-conversation
+await session.setLanguage('es-ES');
+// Transcription continues seamlessly in Spanish
+
+// Switch to French
+await session.setLanguage('fr-FR');
+
+// Get current language
+console.log(session.getLanguage()); // 'fr-FR'
+```
+
+**With Transcriber Directly:**
+
+```typescript
+const transcriber = createTranscriber({
+  provider: TranscriptionProvider.WebSpeechAPI,
+  language: 'en-US',
+});
+
+// Listen for language changes
+transcriber.on('languageChange', (change) => {
+  console.log(`Language changed from ${change.from} to ${change.to}`);
+});
+
+await transcriber.initialize();
+await transcriber.start();
+
+// Change language while recording
+await transcriber.setLanguage('de-DE');
+
+// Get current language
+console.log(transcriber.getLanguage()); // 'de-DE'
+```
+
+**React Example with Language Selector:**
+
+```tsx
+function TranscriptionWithLanguageSwitch() {
+  const [language, setLanguage] = useState('en-US');
+  const sessionRef = useRef<TranscriptionSession | null>(null);
+
+  const changeLanguage = async (newLang: string) => {
+    setLanguage(newLang);
+    if (sessionRef.current) {
+      await sessionRef.current.setLanguage(newLang);
+    }
+  };
+
+  return (
+    <div>
+      <select value={language} onChange={(e) => changeLanguage(e.target.value)}>
+        <option value="en-US">English</option>
+        <option value="es-ES">Spanish</option>
+        <option value="fr-FR">French</option>
+        <option value="de-DE">German</option>
+        <option value="ja-JP">Japanese</option>
+      </select>
+      {/* Transcription continues without interruption */}
+    </div>
+  );
+}
+```
+
 ---
 
 ## API Reference
@@ -598,6 +678,8 @@ function createSession(config: TranscriptionConfig): TranscriptionSession;
 | `getStatistics()` | SessionStatistics | Get session stats |
 | `addTranscript(result)` | void | Add a transcript |
 | `export(format)` | ExportResult | Export transcripts |
+| `setLanguage(language)` | Promise<void> | Change language mid-session |
+| `getLanguage()` | string | Get current language |
 
 ### SessionStatistics
 

package/dist/index.d.mts

@@ -392,6 +392,11 @@ interface TranscriptionEvents {
     silence: () => void;
     /** Emitted when speech is detected */
     speech: () => void;
+    /** Emitted when language is changed */
+    languageChange: (change: {
+        from: string | undefined;
+        to: string;
+    }) => void;
     /** Index signature for extensibility */
     [key: string]: (...args: any[]) => void;
 }
@@ -442,6 +447,18 @@ interface ITranscriptionProvider {
      * Clean up resources and connections
      */
     cleanup(): Promise<void>;
+    /**
+     * Change the transcription language
+     * Automatically handles stop/restart if currently active
+     * @param language - New language code (e.g., 'en-US', 'es-ES')
+     * @returns Promise that resolves when language change is complete
+     */
+    setLanguage(language: string): Promise<void>;
+    /**
+     * Get the current language
+     * @returns Current language code
+     */
+    getLanguage(): string;
 }
 /**
  * Describes the capabilities of a transcription provider
@@ -550,6 +567,27 @@ declare abstract class BaseTranscriber extends EventEmitter<TranscriptionEvents>
      * Get session metadata
      */
     getMetadata(): SessionMetadata;
+    /**
+     * Get the current language
+     * @returns Current language code
+     */
+    getLanguage(): string;
+    /**
+     * Change the transcription language
+     * Automatically handles stop/restart if currently active
+     * @param language - New language code (e.g., 'en-US', 'es-ES')
+     */
+    setLanguage(language: string): Promise<void>;
+    /**
+     * Restart transcription with new language (called internally)
+     * Override in providers if needed
+     */
+    protected restartWithNewLanguage(): Promise<void>;
+    /**
+     * Apply language change without restarting
+     * Override in providers to update language settings
+     */
+    protected applyLanguageChange(): Promise<void>;
     /**
      * Get recorded audio data
      * @returns Combined audio data or null if not recording
@@ -693,6 +731,17 @@ declare class TranscriptionSession {
      * Clear all transcripts
      */
     clear(): void;
+    /**
+     * Change the transcription language
+     * Automatically handles stop/restart if session is active
+     * @param language - New language code (e.g., 'en-US', 'es-ES')
+     */
+    setLanguage(language: string): Promise<void>;
+    /**
+     * Get the current transcription language
+     * @returns Current language code
+     */
+    getLanguage(): string;
     /**
      * Get the total word count from final transcripts
      */
@@ -940,6 +989,15 @@ declare class WebSpeechProvider extends BaseTranscriber {
      * Get provider capabilities
      */
     getCapabilities(): ProviderCapabilities;
+    /**
+     * Restart with new language - optimized for Web Speech API
+     * Performs a quick stop/start cycle to apply new language
+     */
+    protected restartWithNewLanguage(): Promise<void>;
+    /**
+     * Apply language change when paused
+     */
+    protected applyLanguageChange(): Promise<void>;
     /**
      * Set up event handlers for speech recognition
      */

package/dist/index.d.ts

@@ -392,6 +392,11 @@ interface TranscriptionEvents {
     silence: () => void;
     /** Emitted when speech is detected */
     speech: () => void;
+    /** Emitted when language is changed */
+    languageChange: (change: {
+        from: string | undefined;
+        to: string;
+    }) => void;
     /** Index signature for extensibility */
     [key: string]: (...args: any[]) => void;
 }
@@ -442,6 +447,18 @@ interface ITranscriptionProvider {
      * Clean up resources and connections
      */
     cleanup(): Promise<void>;
+    /**
+     * Change the transcription language
+     * Automatically handles stop/restart if currently active
+     * @param language - New language code (e.g., 'en-US', 'es-ES')
+     * @returns Promise that resolves when language change is complete
+     */
+    setLanguage(language: string): Promise<void>;
+    /**
+     * Get the current language
+     * @returns Current language code
+     */
+    getLanguage(): string;
 }
 /**
  * Describes the capabilities of a transcription provider
@@ -550,6 +567,27 @@ declare abstract class BaseTranscriber extends EventEmitter<TranscriptionEvents>
      * Get session metadata
      */
     getMetadata(): SessionMetadata;
+    /**
+     * Get the current language
+     * @returns Current language code
+     */
+    getLanguage(): string;
+    /**
+     * Change the transcription language
+     * Automatically handles stop/restart if currently active
+     * @param language - New language code (e.g., 'en-US', 'es-ES')
+     */
+    setLanguage(language: string): Promise<void>;
+    /**
+     * Restart transcription with new language (called internally)
+     * Override in providers if needed
+     */
+    protected restartWithNewLanguage(): Promise<void>;
+    /**
+     * Apply language change without restarting
+     * Override in providers to update language settings
+     */
+    protected applyLanguageChange(): Promise<void>;
     /**
      * Get recorded audio data
      * @returns Combined audio data or null if not recording
@@ -693,6 +731,17 @@ declare class TranscriptionSession {
      * Clear all transcripts
      */
     clear(): void;
+    /**
+     * Change the transcription language
+     * Automatically handles stop/restart if session is active
+     * @param language - New language code (e.g., 'en-US', 'es-ES')
+     */
+    setLanguage(language: string): Promise<void>;
+    /**
+     * Get the current transcription language
+     * @returns Current language code
+     */
+    getLanguage(): string;
     /**
      * Get the total word count from final transcripts
      */
@@ -940,6 +989,15 @@ declare class WebSpeechProvider extends BaseTranscriber {
      * Get provider capabilities
      */
     getCapabilities(): ProviderCapabilities;
+    /**
+     * Restart with new language - optimized for Web Speech API
+     * Performs a quick stop/start cycle to apply new language
+     */
+    protected restartWithNewLanguage(): Promise<void>;
+    /**
+     * Apply language change when paused
+     */
+    protected applyLanguageChange(): Promise<void>;
     /**
      * Set up event handlers for speech recognition
      */

package/dist/index.js

@@ -206,6 +206,43 @@ var BaseTranscriber = class extends EventEmitter {
       wordCount: this.wordCount
     };
   }
+  /**
+   * Get the current language
+   * @returns Current language code
+   */
+  getLanguage() {
+    return this.config.language || "en-US";
+  }
+  /**
+   * Change the transcription language
+   * Automatically handles stop/restart if currently active
+   * @param language - New language code (e.g., 'en-US', 'es-ES')
+   */
+  async setLanguage(language) {
+    const previousLanguage = this.config.language;
+    this.config.language = language;
+    this.emit("languageChange", { from: previousLanguage, to: language });
+    if (this.state === "active" /* ACTIVE */) {
+      await this.restartWithNewLanguage();
+    } else if (this.state === "paused" /* PAUSED */) {
+      await this.applyLanguageChange();
+    }
+  }
+  /**
+   * Restart transcription with new language (called internally)
+   * Override in providers if needed
+   */
+  async restartWithNewLanguage() {
+    await this.stop();
+    await this.initialize();
+    await this.start();
+  }
+  /**
+   * Apply language change without restarting
+   * Override in providers to update language settings
+   */
+  async applyLanguageChange() {
+  }
   /**
    * Get recorded audio data
    * @returns Combined audio data or null if not recording
@@ -883,6 +920,21 @@ var TranscriptionSession = class {
   clear() {
     this.transcripts = [];
   }
+  /**
+   * Change the transcription language
+   * Automatically handles stop/restart if session is active
+   * @param language - New language code (e.g., 'en-US', 'es-ES')
+   */
+  async setLanguage(language) {
+    await this.provider.setLanguage(language);
+  }
+  /**
+   * Get the current transcription language
+   * @returns Current language code
+   */
+  getLanguage() {
+    return this.provider.getLanguage();
+  }
   /**
    * Get the total word count from final transcripts
    */
@@ -1355,6 +1407,38 @@ var _WebSpeechProvider = class _WebSpeechProvider extends BaseTranscriber {
   getCapabilities() {
     return _WebSpeechProvider.capabilities;
   }
+  // ==================== Language Switching ====================
+  /**
+   * Restart with new language - optimized for Web Speech API
+   * Performs a quick stop/start cycle to apply new language
+   */
+  async restartWithNewLanguage() {
+    if (!this.recognition) {
+      return;
+    }
+    const wasActive = this.state === "active" /* ACTIVE */;
+    this.isRestarting = true;
+    try {
+      this.recognition.stop();
+      await new Promise((resolve) => setTimeout(resolve, 50));
+      this.recognition.lang = this.config.language || "en-US";
+      if (wasActive) {
+        this.recognition.start();
+      }
+    } catch (error) {
+      this.handleError(error);
+    } finally {
+      this.isRestarting = false;
+    }
+  }
+  /**
+   * Apply language change when paused
+   */
+  async applyLanguageChange() {
+    if (this.recognition) {
+      this.recognition.lang = this.config.language || "en-US";
+    }
+  }
   // ==================== Private Methods ====================
   /**
    * Set up event handlers for speech recognition