Add Flux streaming transcription support #131

* feat: add flux support

* fix: remove unused import to match websocket.rs pattern

* fix: replace json! macro with serde_json::to_string for minimal versions

- Replace serde_json::json! macro with ControlMessage enum + serde_json::to_string
- Matches websocket.rs pattern for compatibility with minimal dependency versions
- Fix clippy warning in text_to_speech_to_stream example

* Add 32-bit linear PCM audio encoding format

* Add mono audio sample for Flux and update sample application

* Add auth module for v1/auth/grant API

* Add working Flux example with short-lived auth token

* Update version and changelog

* Add Cargo.lock file

* Fix formatting

* Update serde dependency versions

* Update dependency versions

* Update checkout action to v5

* Add setup Rust toolchain

* Remove Cargo.lock

* Reduce version of rodio

* Allow Cargo.lock

---------

Co-authored-by: Trevor Sullivan <trevor.sullivan@deepgram.com>

Author: dpmishler

.github/workflows/ci.yaml

@@ -11,7 +11,10 @@ jobs:
   Features:
     runs-on: ubuntu-latest
     steps:
-    - uses: actions/checkout@v3
+    - uses: actions-rust-lang/setup-rust-toolchain@v1
+      with:
+        components: rustfmt
+    - uses: actions/checkout@v5
     - name: Install dependencies
       run: |
         sudo apt-get update
@@ -28,7 +31,7 @@ jobs:
   Build:
     runs-on: ubuntu-latest
     steps:
-    - uses: actions/checkout@v3
+    - uses: actions/checkout@v5
     - name: Install dependencies
       run: |
         sudo apt-get update
@@ -39,7 +42,10 @@ jobs:
   Clippy:
     runs-on: ubuntu-latest
     steps:
-    - uses: actions/checkout@v3
+    - uses: actions-rust-lang/setup-rust-toolchain@v1
+      with:
+        components: rustfmt
+    - uses: actions/checkout@v5
     - name: Install dependencies
       run: |
         sudo apt-get update
@@ -50,7 +56,7 @@ jobs:
   Test:
     runs-on: ubuntu-latest
     steps:
-    - uses: actions/checkout@v3
+    - uses: actions/checkout@v5
     - name: Install dependencies
       run: |
         sudo apt-get update
@@ -61,13 +67,13 @@ jobs:
   Format:
     runs-on: ubuntu-latest
     steps:
-    - uses: actions/checkout@v3
+    - uses: actions/checkout@v5
     - name: Cargo Fmt
       run: cargo fmt --check --all
   Documentation:
     runs-on: ubuntu-latest
     steps:
-    - uses: actions/checkout@v3
+    - uses: actions/checkout@v5
     - name: Install dependencies
       run: |
         sudo apt-get update
@@ -78,7 +84,7 @@ jobs:
   Audit:
     runs-on: ubuntu-latest
     steps:
-    - uses: actions/checkout@v3
+    - uses: actions/checkout@v5
     - name: Install dependencies
       run: sudo apt-get update
     - name: Install cargo-audit
@@ -93,7 +99,7 @@ jobs:
   Minimal-Versions:
     runs-on: ubuntu-latest
     steps:
-    - uses: actions/checkout@v3
+    - uses: actions/checkout@v5
     - name: Install dependencies
       run: |
         sudo apt-get update
@@ -115,7 +121,7 @@ jobs:
   SemVer:
     runs-on: ubuntu-latest
     steps:
-    - uses: actions/checkout@v3
+    - uses: actions/checkout@v5
     - name: Install dependencies
       run: |
         sudo apt-get update

.gitignore

@@ -1,4 +1,3 @@
 /target
-/Cargo.lock
 your_output_file.wav
 .DS_Store

CHANGELOG.md

@@ -1,17 +1,24 @@
 # Changelog
+
 All notable changes to this project will be documented in this file.
 
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
-## [Unreleased](https://github.com/deepgram/deepgram-rust-sdk/compare/0.6.2...HEAD)
+## [0.8.0](https://github.com/deepgram/deepgram-rust-sdk/compare/0.6.2...HEAD)
 
-- Update documentation to point to 
-  [deepgram/deepgram-rust-sdk](https://github.com/deepgram/deepgram-rust-sdk).
+- Add Flux conversational speech recognition model support (`flux-general-en`)
+  - New `flux_request()` and `flux_request_with_options()` methods for Flux streaming
+  - Support for turn-based conversation detection with `FluxResponse` types
+  - Configurable end-of-turn detection parameters (`eot_threshold`, `eager_eot_threshold`, `eot_timeout_ms`)
+  - New `TurnEvent` enum: `StartOfTurn`, `EndOfTurn`, `EagerEndOfTurn`, `TurnResumed`, `Update`
+  - Examples: `simple_flux` (file streaming) and `microphone_flux` (real-time microphone)
+  - Uses `/v2/listen` endpoint for Flux API
+- Update documentation to point to [deepgram/deepgram-rust-sdk](https://github.com/deepgram/deepgram-rust-sdk).
+- Added support for [short-lived auth tokens](https://developers.deepgram.com/reference/auth/tokens/grant) using Deepgram `v1/auth/grant` API
 
 ## [0.6.1](https://github.com/deepgram/deepgram-rust-sdk/compare/0.6.1...0.6.2)
 
-- 
 ## [0.6.1](https://github.com/deepgram/deepgram-rust-sdk/compare/0.6.0...0.6.1)
 
 - Implement `From<String>` for `Model`, `Language`, and `Redact`
@@ -98,22 +105,25 @@ Some Enums have changed and may need to be updated
 - Add Speech to Text
 - Reorganize Code
 
-
 ### Streaming Features
+
 - endpointing
 - utterance_end_ms
 - interim_results
 - no_delay
 - vad_events
 
 ### Streaming Functions
+
 - keep_alive
 
 ### New Streaming Message Types
+
 - Utterance End
 - Speech Started
 
 ### Pre-Recorded Features
+
 - encoding
 - smart_format
 - callback
@@ -126,6 +136,7 @@ Some Enums have changed and may need to be updated
 - extra
 
 ### Pre-Recorded Audio Intelligence Features
+
 - detect_entities
 - sentiment
 - topics
@@ -147,21 +158,26 @@ Some Enums have changed and may need to be updated
 ## [0.4.0](https://github.com/deepgram/deepgram-rust-sdk/compare/0.3.0...0.4.0) - 2023-11-01
 
 ### Added
+
 - `detect_language` option.
 
 ### Changed
+
 - Remove generic from `Deepgram` struct.
 - Upgrade dependencies: `tungstenite`, `tokio-tungstenite`, `reqwest`.
 
 ## [0.3.0](https://github.com/deepgram/deepgram-rust-sdk/compare/0.2.1...0.3.0) - 2023-07-26
 
 ### Added
+
 - Derive `Serialize` for all response types.
 
 ### Fixed
+
 - Use the users builder options when building a streaming URL.
 - Make sure that `Future` returned from `StreamRequestBuilder::start()` is `Send`.
 
 ### Changed
+
 - Use Rustls instead of OpenSSL.