use-scribe

1"use client"
2 
3import { useCallback, useEffect, useRef, useState } from "react"
4import { RealtimeEvents, Scribe } from "@elevenlabs/client"
5import type {
6  AudioFormat,
7  AudioOptions,
8  CommitStrategy,
9  CommittedTranscriptMessage,
10  CommittedTranscriptWithTimestampsMessage,
11  MicrophoneOptions,
12  PartialTranscriptMessage,
13  RealtimeConnection,
14  ScribeAuthErrorMessage,
15  ScribeChunkSizeExceededErrorMessage,
16  ScribeCommitThrottledErrorMessage,
17  ScribeErrorMessage,
18  ScribeInputErrorMessage,
19  ScribeInsufficientAudioActivityErrorMessage,
20  ScribeQueueOverflowErrorMessage,
21  ScribeQuotaExceededErrorMessage,
22  ScribeRateLimitedErrorMessage,
23  ScribeResourceExhaustedErrorMessage,
24  ScribeSessionTimeLimitExceededErrorMessage,
25  ScribeTranscriberErrorMessage,
26  ScribeUnacceptedTermsErrorMessage,
27} from "@elevenlabs/client"
28 
29// ============= Types =============
30 
31export type ScribeStatus =
32  | "disconnected"
33  | "connecting"
34  | "connected"
35  | "transcribing"
36  | "error"
37 
38export interface TranscriptSegment {
39  id: string
40  text: string
41  timestamp: number
42  isFinal: boolean
43}
44 
45export interface ScribeCallbacks {
46  onSessionStarted?: () => void
47  onPartialTranscript?: (data: { text: string }) => void
48  onCommittedTranscript?: (data: { text: string }) => void
49  onCommittedTranscriptWithTimestamps?: (data: {
50    text: string
51    timestamps?: { start: number; end: number }[]
52  }) => void
53  /** Called for any error (also called when specific error callbacks fire) */
54  onError?: (error: Error | Event) => void
55  onAuthError?: (data: { error: string }) => void
56  onQuotaExceededError?: (data: { error: string }) => void
57  onCommitThrottledError?: (data: { error: string }) => void
58  onTranscriberError?: (data: { error: string }) => void
59  onUnacceptedTermsError?: (data: { error: string }) => void
60  onRateLimitedError?: (data: { error: string }) => void
61  onInputError?: (data: { error: string }) => void
62  onQueueOverflowError?: (data: { error: string }) => void
63  onResourceExhaustedError?: (data: { error: string }) => void
64  onSessionTimeLimitExceededError?: (data: { error: string }) => void
65  onChunkSizeExceededError?: (data: { error: string }) => void
66  onInsufficientAudioActivityError?: (data: { error: string }) => void
67 
68  onConnect?: () => void
69  onDisconnect?: () => void
70}
71 
72export interface ScribeHookOptions extends ScribeCallbacks {
73  // Connection options
74  token?: string
75  modelId?: string
76  baseUri?: string
77 
78  // VAD options
79  commitStrategy?: CommitStrategy
80// … truncated