glirastes 0.4.0 → 0.5.0

package/dist/react/stt/deepgram.d.ts

@@ -0,0 +1,30 @@
+import type { SttProviderAdapter, SttProviderConnection } from './controller.js';
+import type { SttSegment } from './segments.js';
+interface DeepgramMessage {
+    type?: string;
+    message?: string;
+    start?: number;
+    duration?: number;
+    is_final?: boolean;
+    speech_final?: boolean;
+    channel?: {
+        alternatives?: Array<{
+            transcript?: string;
+        }>;
+    };
+}
+export declare function createDeepgramSegmentParser(): (message: DeepgramMessage) => SttSegment | null;
+export interface DeepgramSttAdapterOptions {
+    baseUrl?: string;
+    getToken?: () => string | null | undefined;
+    connectTimeoutMs?: number;
+    finalizeGraceMs?: number;
+}
+/** Microphone audio as 16 kHz mono 16-bit PCM chunks; returns its stop function. */
+export declare function createPcmPipeline(stream: MediaStream, onAudio: (audio: ArrayBuffer) => void): Promise<() => Promise<void>>;
+export declare class DeepgramSttAdapter implements SttProviderAdapter {
+    private readonly options;
+    constructor(options?: DeepgramSttAdapterOptions);
+    connect(input: Parameters<SttProviderAdapter['connect']>[0]): Promise<SttProviderConnection>;
+}
+export {};

package/dist/react/stt/deepgram.js

@@ -0,0 +1,199 @@
+export function createDeepgramSegmentParser() {
+    const sequences = new Map();
+    let nextUntimedSequence = 0;
+    return (message) => {
+        const text = message.channel?.alternatives?.[0]?.transcript?.trim();
+        if (!text)
+            return null;
+        const hasProviderTimestamp = Number.isFinite(message.start);
+        const id = hasProviderTimestamp
+            ? `deepgram-${message.start}`
+            : `deepgram-sequence-${nextUntimedSequence}`;
+        let sequence = sequences.get(id);
+        if (sequence === undefined) {
+            sequence = hasProviderTimestamp
+                ? message.start
+                : 1_000_000_000 + nextUntimedSequence;
+            sequences.set(id, sequence);
+            if (!hasProviderTimestamp)
+                nextUntimedSequence += 1;
+        }
+        return {
+            id,
+            sequence,
+            text,
+            isFinal: message.is_final === true,
+        };
+    };
+}
+function resolveWebSocketUrl(baseUrl, language, token) {
+    const fallbackProtocol = window.location.protocol === 'https:' ? 'wss:' : 'ws:';
+    const fallback = `${fallbackProtocol}//${window.location.host}/api/ai/speech-stream`;
+    const url = new URL(baseUrl ?? fallback, window.location.href);
+    if (url.protocol === 'http:')
+        url.protocol = 'ws:';
+    if (url.protocol === 'https:')
+        url.protocol = 'wss:';
+    url.searchParams.set('language', language);
+    if (token)
+        url.searchParams.set('token', token);
+    return url.toString();
+}
+/** Microphone audio as 16 kHz mono 16-bit PCM chunks; returns its stop function. */
+export async function createPcmPipeline(stream, onAudio) {
+    const AudioContextCtor = globalThis.AudioContext
+        ?? globalThis.webkitAudioContext;
+    if (!AudioContextCtor)
+        throw new Error('Browser does not support AudioContext');
+    const context = new AudioContextCtor({ sampleRate: 16_000 });
+    await context.audioWorklet.addModule('/audio-worklet-processor.js');
+    const source = context.createMediaStreamSource(stream);
+    const processor = new AudioWorkletNode(context, 'audio-processor');
+    processor.port.onmessage = (event) => {
+        onAudio(event.data.buffer);
+    };
+    source.connect(processor);
+    processor.connect(context.destination);
+    return async () => {
+        processor.port.onmessage = null;
+        processor.disconnect();
+        source.disconnect();
+        await context.close();
+    };
+}
+export class DeepgramSttAdapter {
+    options;
+    constructor(options = {}) {
+        this.options = options;
+    }
+    async connect(input) {
+        const token = this.options.getToken?.();
+        const url = resolveWebSocketUrl(this.options.baseUrl, input.language, token);
+        const socket = new WebSocket(url);
+        const parser = createDeepgramSegmentParser();
+        const connectTimeoutMs = this.options.connectTimeoutMs ?? 5_000;
+        const finalizeGraceMs = this.options.finalizeGraceMs ?? 750;
+        let disposed = false;
+        let closeAudio = null;
+        let finalizePromise = null;
+        let resolveFinalize = null;
+        let finalizeTimeout = null;
+        const settleFinalization = () => {
+            if (!resolveFinalize)
+                return;
+            if (finalizeTimeout)
+                clearTimeout(finalizeTimeout);
+            finalizeTimeout = null;
+            const resolve = resolveFinalize;
+            resolveFinalize = null;
+            resolve();
+        };
+        try {
+            await new Promise((resolve, reject) => {
+                const abort = () => finish('aborted');
+                const finish = (result) => {
+                    clearTimeout(timeout);
+                    input.signal.removeEventListener('abort', abort);
+                    if (result === 'open')
+                        resolve();
+                    if (result === 'error')
+                        reject(new Error('Speech provider connection failed'));
+                    if (result === 'aborted')
+                        reject(new Error('Speech provider connection cancelled'));
+                    if (result === 'timeout')
+                        reject(new Error('Speech provider connection timeout'));
+                };
+                const timeout = setTimeout(() => finish('timeout'), connectTimeoutMs);
+                socket.onopen = () => finish('open');
+                socket.onerror = () => finish('error');
+                input.signal.addEventListener('abort', abort, { once: true });
+            });
+        }
+        catch (error) {
+            socket.onopen = null;
+            socket.onerror = null;
+            if (socket.readyState === WebSocket.OPEN
+                || socket.readyState === WebSocket.CONNECTING) {
+                socket.close();
+            }
+            throw error;
+        }
+        socket.onmessage = (event) => {
+            if (typeof event.data !== 'string')
+                return;
+            try {
+                const message = JSON.parse(event.data);
+                if (message.type === 'error') {
+                    input.events.onError(new Error(message.message ?? 'Transcription failed'));
+                    return;
+                }
+                const segment = parser(message);
+                if (segment)
+                    input.events.onSegment(segment);
+                if (message.is_final === true || message.speech_final === true) {
+                    settleFinalization();
+                }
+            }
+            catch {
+                // Provider metadata may be non-JSON; it carries no transcript.
+            }
+        };
+        socket.onerror = () => input.events.onError(new Error('Speech provider connection failed'));
+        socket.onclose = () => {
+            settleFinalization();
+            input.events.onClosed();
+        };
+        const close = async () => {
+            if (disposed)
+                return;
+            disposed = true;
+            settleFinalization();
+            await closeAudio?.();
+            closeAudio = null;
+            socket.onopen = null;
+            socket.onmessage = null;
+            socket.onerror = null;
+            socket.onclose = null;
+            if (socket.readyState === WebSocket.OPEN
+                || socket.readyState === WebSocket.CONNECTING) {
+                socket.close();
+            }
+        };
+        input.signal.addEventListener('abort', () => {
+            void close();
+        }, { once: true });
+        try {
+            closeAudio = await createPcmPipeline(input.stream, (audio) => {
+                if (socket.readyState === WebSocket.OPEN)
+                    socket.send(audio);
+            });
+        }
+        catch (error) {
+            await close();
+            throw error;
+        }
+        return {
+            finalize: () => {
+                if (socket.readyState !== WebSocket.OPEN)
+                    return Promise.resolve();
+                if (finalizePromise)
+                    return finalizePromise;
+                finalizePromise = new Promise((resolve) => {
+                    resolveFinalize = resolve;
+                    finalizeTimeout = setTimeout(settleFinalization, finalizeGraceMs);
+                });
+                try {
+                    socket.send(JSON.stringify({ type: 'Finalize' }));
+                }
+                catch (error) {
+                    settleFinalization();
+                    return Promise.reject(error);
+                }
+                return finalizePromise;
+            },
+            cancel: close,
+            close,
+        };
+    }
+}
+//# sourceMappingURL=deepgram.js.map

package/dist/react/stt/deepgram.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deepgram.js","sourceRoot":"","sources":["../../../src/react/stt/deepgram.ts"],"names":[],"mappings":"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"}

package/dist/react/stt/recorded.d.ts

@@ -0,0 +1,29 @@
+import type { SttProviderAdapter, SttProviderConnection } from './controller.js';
+export interface RecordedSttAdapterOptions {
+    /** Endpoint that takes the WAV and answers `{ text }`. Default: `/api/ai/speech-recognize`. */
+    url?: string;
+    /** Extra request headers, read when the recording is sent. */
+    getHeaders?: () => Record<string, string> | undefined;
+    /** Longest recording kept, in seconds; later audio is dropped. Default: 120. */
+    maxSeconds?: number;
+    /** For tests and non-browser hosts. */
+    fetch?: typeof fetch;
+    /** Audio capture as 16 kHz mono PCM chunks; returns its stop function. */
+    capture?: (stream: MediaStream, onAudio: (audio: ArrayBuffer) => void) => Promise<() => Promise<void>>;
+}
+/** 16-bit mono PCM chunks as one WAV file. */
+export declare function encodeWav(chunks: ReadonlyArray<Int16Array>, sampleRate: number): ArrayBuffer;
+/**
+ * Speech input for a transcription model that takes a finished recording
+ * instead of a live stream (Parakeet, Whisper and the like): the audio is
+ * kept in the browser while the user speaks and sent once when they stop.
+ * There is no interim text; the transcript arrives as one final segment.
+ *
+ * The endpoint is the app's own route. It receives `audio/wav` (16 kHz, mono,
+ * 16 bit) with the language as a query parameter and answers `{ "text": … }`.
+ */
+export declare class RecordedSttAdapter implements SttProviderAdapter {
+    private readonly options;
+    constructor(options?: RecordedSttAdapterOptions);
+    connect(input: Parameters<SttProviderAdapter['connect']>[0]): Promise<SttProviderConnection>;
+}

package/dist/react/stt/recorded.js

@@ -0,0 +1,111 @@
+import { createPcmPipeline } from './deepgram.js';
+const SAMPLE_RATE = 16_000;
+/** 16-bit mono PCM chunks as one WAV file. */
+export function encodeWav(chunks, sampleRate) {
+    const samples = chunks.reduce((sum, chunk) => sum + chunk.length, 0);
+    const buffer = new ArrayBuffer(44 + samples * 2);
+    const view = new DataView(buffer);
+    const text = (offset, value) => {
+        for (let i = 0; i < value.length; i += 1)
+            view.setUint8(offset + i, value.charCodeAt(i));
+    };
+    text(0, 'RIFF');
+    view.setUint32(4, 36 + samples * 2, true);
+    text(8, 'WAVE');
+    text(12, 'fmt ');
+    view.setUint32(16, 16, true);
+    view.setUint16(20, 1, true); // PCM
+    view.setUint16(22, 1, true); // mono
+    view.setUint32(24, sampleRate, true);
+    view.setUint32(28, sampleRate * 2, true);
+    view.setUint16(32, 2, true);
+    view.setUint16(34, 16, true);
+    text(36, 'data');
+    view.setUint32(40, samples * 2, true);
+    let offset = 44;
+    for (const chunk of chunks) {
+        for (let i = 0; i < chunk.length; i += 1, offset += 2)
+            view.setInt16(offset, chunk[i], true);
+    }
+    return buffer;
+}
+/**
+ * Speech input for a transcription model that takes a finished recording
+ * instead of a live stream (Parakeet, Whisper and the like): the audio is
+ * kept in the browser while the user speaks and sent once when they stop.
+ * There is no interim text; the transcript arrives as one final segment.
+ *
+ * The endpoint is the app's own route. It receives `audio/wav` (16 kHz, mono,
+ * 16 bit) with the language as a query parameter and answers `{ "text": … }`.
+ */
+export class RecordedSttAdapter {
+    options;
+    constructor(options = {}) {
+        this.options = options;
+    }
+    async connect(input) {
+        const maxSamples = (this.options.maxSeconds ?? 120) * SAMPLE_RATE;
+        const chunks = [];
+        let kept = 0;
+        let discarded = false;
+        let sent = null;
+        const request = new AbortController();
+        let stopCapture = await (this.options.capture ?? createPcmPipeline)(input.stream, (audio) => {
+            if (discarded || kept >= maxSamples)
+                return;
+            const chunk = new Int16Array(audio).slice(0, maxSamples - kept);
+            chunks.push(chunk);
+            kept += chunk.length;
+        });
+        const endCapture = async () => {
+            const stop = stopCapture;
+            stopCapture = null;
+            await stop?.();
+        };
+        const discard = async () => {
+            discarded = true;
+            chunks.length = 0;
+            request.abort();
+            await endCapture();
+        };
+        input.signal.addEventListener('abort', () => { void discard(); }, { once: true });
+        const send = async () => {
+            await endCapture();
+            if (discarded || kept === 0)
+                return;
+            const base = typeof window === 'undefined' ? undefined : window.location.href;
+            const url = new URL(this.options.url ?? '/api/ai/speech-recognize', base);
+            url.searchParams.set('language', input.language);
+            try {
+                const response = await (this.options.fetch ?? fetch)(url.toString(), {
+                    method: 'POST',
+                    headers: { ...this.options.getHeaders?.(), 'content-type': 'audio/wav' },
+                    body: encodeWav(chunks, SAMPLE_RATE),
+                    credentials: 'same-origin',
+                    signal: request.signal,
+                });
+                if (!response.ok)
+                    throw new Error('Transcription failed');
+                const result = await response.json();
+                const text = typeof result.text === 'string' ? result.text.trim() : '';
+                if (text && !discarded) {
+                    input.events.onSegment({ id: 'recording', sequence: 0, text, isFinal: true });
+                }
+            }
+            catch {
+                // The server's own words stay out of the UI.
+                if (!discarded)
+                    input.events.onError(new Error('Transcription failed'));
+            }
+            finally {
+                chunks.length = 0;
+            }
+        };
+        return {
+            finalize: () => (sent ??= send()),
+            cancel: discard,
+            close: discard,
+        };
+    }
+}
+//# sourceMappingURL=recorded.js.map

package/dist/react/stt/recorded.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"recorded.js","sourceRoot":"","sources":["../../../src/react/stt/recorded.ts"],"names":[],"mappings":"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"}

package/dist/react/stt/segments.d.ts

@@ -0,0 +1,18 @@
+export interface SttSegment {
+    id: string;
+    sequence: number;
+    text: string;
+    isFinal: boolean;
+}
+interface StoredSttSegment extends SttSegment {
+    text: string;
+}
+export interface SttTranscript {
+    readonly segments: ReadonlyArray<StoredSttSegment>;
+    readonly finalText: string;
+    readonly interimText: string;
+    readonly displayText: string;
+}
+export declare function createSttTranscript(): SttTranscript;
+export declare function applySttSegment(transcript: SttTranscript, segment: SttSegment): SttTranscript;
+export {};

package/dist/react/stt/segments.js

@@ -0,0 +1,29 @@
+function joinText(segments) {
+    return segments
+        .map((segment) => segment.text.trim())
+        .filter(Boolean)
+        .join(' ')
+        .replace(/\s+/g, ' ')
+        .trim();
+}
+function materialize(segments) {
+    const ordered = [...segments].sort((left, right) => (left.sequence - right.sequence || left.id.localeCompare(right.id)));
+    return {
+        segments: ordered,
+        finalText: joinText(ordered.filter((segment) => segment.isFinal)),
+        interimText: joinText(ordered.filter((segment) => !segment.isFinal)),
+        displayText: joinText(ordered),
+    };
+}
+export function createSttTranscript() {
+    return materialize([]);
+}
+export function applySttSegment(transcript, segment) {
+    const text = segment.text.trim();
+    if (!text)
+        return transcript;
+    const next = transcript.segments.filter((candidate) => candidate.id !== segment.id);
+    next.push({ ...segment, text });
+    return materialize(next);
+}
+//# sourceMappingURL=segments.js.map

package/dist/react/stt/segments.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"segments.js","sourceRoot":"","sources":["../../../src/react/stt/segments.ts"],"names":[],"mappings":"AAkBA,SAAS,QAAQ,CAAC,QAAyC;IACzD,OAAO,QAAQ;SACZ,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;SACrC,MAAM,CAAC,OAAO,CAAC;SACf,IAAI,CAAC,GAAG,CAAC;SACT,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC;SACpB,IAAI,EAAE,CAAC;AACZ,CAAC;AAED,SAAS,WAAW,CAAC,QAAyC;IAC5D,MAAM,OAAO,GAAG,CAAC,GAAG,QAAQ,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,CAClD,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC,QAAQ,IAAI,IAAI,CAAC,EAAE,CAAC,aAAa,CAAC,KAAK,CAAC,EAAE,CAAC,CAClE,CAAC,CAAC;IACH,OAAO;QACL,QAAQ,EAAE,OAAO;QACjB,SAAS,EAAE,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QACjE,WAAW,EAAE,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QACpE,WAAW,EAAE,QAAQ,CAAC,OAAO,CAAC;KAC/B,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,mBAAmB;IACjC,OAAO,WAAW,CAAC,EAAE,CAAC,CAAC;AACzB,CAAC;AAED,MAAM,UAAU,eAAe,CAC7B,UAAyB,EACzB,OAAmB;IAEnB,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;IACjC,IAAI,CAAC,IAAI;QAAE,OAAO,UAAU,CAAC;IAE7B,MAAM,IAAI,GAAG,UAAU,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,EAAE,KAAK,OAAO,CAAC,EAAE,CAAC,CAAC;IACpF,IAAI,CAAC,IAAI,CAAC,EAAE,GAAG,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;IAChC,OAAO,WAAW,CAAC,IAAI,CAAC,CAAC;AAC3B,CAAC"}

package/dist/react/stt/use-stt.d.ts

@@ -0,0 +1,17 @@
+import { type SttProviderAdapter, type SttSessionSnapshot } from './controller.js';
+export interface UseSttOptions {
+    adapter: SttProviderAdapter;
+    language: string;
+    onInterimTranscript?: (text: string) => void;
+    onError?: (error: string) => void;
+}
+export interface UseSttReturn extends SttSessionSnapshot {
+    isRecording: boolean;
+    isConnecting: boolean;
+    stream: MediaStream | null;
+    startRecording: (previousDraft?: string) => Promise<void>;
+    stopRecording: () => Promise<string>;
+    cancelRecording: () => Promise<string>;
+    retry: () => Promise<void>;
+}
+export declare function useStt(options: UseSttOptions): UseSttReturn;

package/dist/react/stt/use-stt.js

@@ -0,0 +1,39 @@
+import { useCallback, useEffect, useMemo, useSyncExternalStore, } from 'react';
+import { SttSessionController, } from './controller.js';
+export function useStt(options) {
+    const controller = useMemo(() => new SttSessionController({
+        adapter: options.adapter,
+        language: options.language,
+    }), [options.adapter, options.language]);
+    const snapshot = useSyncExternalStore((listener) => controller.subscribe(listener), () => controller.snapshot, () => controller.snapshot);
+    useEffect(() => () => {
+        void controller.dispose();
+    }, [controller]);
+    useEffect(() => {
+        if (snapshot.phase === 'failed' && snapshot.error) {
+            options.onError?.(snapshot.error);
+        }
+    }, [options.onError, snapshot.error, snapshot.phase]);
+    useEffect(() => {
+        if (snapshot.interimTranscript) {
+            options.onInterimTranscript?.(snapshot.displayTranscript);
+        }
+    }, [
+        options.onInterimTranscript,
+        snapshot.displayTranscript,
+        snapshot.interimTranscript,
+    ]);
+    const startRecording = useCallback((previousDraft = '') => controller.start(previousDraft), [controller]);
+    return {
+        ...snapshot,
+        isRecording: snapshot.phase === 'recording' || snapshot.phase === 'finalizing',
+        isConnecting: snapshot.phase === 'requesting_permission'
+            || snapshot.phase === 'connecting',
+        stream: controller.getStream(),
+        startRecording,
+        stopRecording: () => controller.stop(),
+        cancelRecording: () => controller.cancel(),
+        retry: () => controller.retry(),
+    };
+}
+//# sourceMappingURL=use-stt.js.map

package/dist/react/stt/use-stt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-stt.js","sourceRoot":"","sources":["../../../src/react/stt/use-stt.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,WAAW,EACX,SAAS,EACT,OAAO,EACP,oBAAoB,GACrB,MAAM,OAAO,CAAC;AACf,OAAO,EACL,oBAAoB,GAGrB,MAAM,iBAAiB,CAAC;AAmBzB,MAAM,UAAU,MAAM,CAAC,OAAsB;IAC3C,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC,IAAI,oBAAoB,CAAC;QACxD,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,QAAQ,EAAE,OAAO,CAAC,QAAQ;KAC3B,CAAC,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC;IAEzC,MAAM,QAAQ,GAAG,oBAAoB,CACnC,CAAC,QAAQ,EAAE,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC,QAAQ,CAAC,EAC5C,GAAG,EAAE,CAAC,UAAU,CAAC,QAAQ,EACzB,GAAG,EAAE,CAAC,UAAU,CAAC,QAAQ,CAC1B,CAAC;IAEF,SAAS,CAAC,GAAG,EAAE,CAAC,GAAG,EAAE;QACnB,KAAK,UAAU,CAAC,OAAO,EAAE,CAAC;IAC5B,CAAC,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC;IAEjB,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,QAAQ,CAAC,KAAK,KAAK,QAAQ,IAAI,QAAQ,CAAC,KAAK,EAAE,CAAC;YAClD,OAAO,CAAC,OAAO,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QACpC,CAAC;IACH,CAAC,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC;IAEtD,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,QAAQ,CAAC,iBAAiB,EAAE,CAAC;YAC/B,OAAO,CAAC,mBAAmB,EAAE,CAAC,QAAQ,CAAC,iBAAiB,CAAC,CAAC;QAC5D,CAAC;IACH,CAAC,EAAE;QACD,OAAO,CAAC,mBAAmB;QAC3B,QAAQ,CAAC,iBAAiB;QAC1B,QAAQ,CAAC,iBAAiB;KAC3B,CAAC,CAAC;IAEH,MAAM,cAAc,GAAG,WAAW,CAChC,CAAC,aAAa,GAAG,EAAE,EAAE,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,aAAa,CAAC,EACvD,CAAC,UAAU,CAAC,CACb,CAAC;IAEF,OAAO;QACL,GAAG,QAAQ;QACX,WAAW,EAAE,QAAQ,CAAC,KAAK,KAAK,WAAW,IAAI,QAAQ,CAAC,KAAK,KAAK,YAAY;QAC9E,YAAY,EACV,QAAQ,CAAC,KAAK,KAAK,uBAAuB;eACvC,QAAQ,CAAC,KAAK,KAAK,YAAY;QACpC,MAAM,EAAE,UAAU,CAAC,SAAS,EAAE;QAC9B,cAAc;QACd,aAAa,EAAE,GAAG,EAAE,CAAC,UAAU,CAAC,IAAI,EAAE;QACtC,eAAe,EAAE,GAAG,EAAE,CAAC,UAAU,CAAC,MAAM,EAAE;QAC1C,KAAK,EAAE,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE;KAChC,CAAC;AACJ,CAAC"}

package/dist/react/stt/waveform.d.ts

@@ -0,0 +1,5 @@
+export interface StreamAnalyser {
+    readLevel(): number;
+    close(): Promise<void>;
+}
+export declare function createStreamAnalyser(stream: MediaStream, createContext?: () => AudioContext): StreamAnalyser;

package/dist/react/stt/waveform.js

@@ -0,0 +1,29 @@
+export function createStreamAnalyser(stream, createContext = () => new AudioContext()) {
+    const context = createContext();
+    const source = context.createMediaStreamSource(stream);
+    const analyser = context.createAnalyser();
+    analyser.fftSize = 256;
+    source.connect(analyser);
+    const values = new Uint8Array(analyser.frequencyBinCount);
+    let closed = false;
+    return {
+        readLevel() {
+            analyser.getByteTimeDomainData(values);
+            let sumOfSquares = 0;
+            for (const value of values) {
+                const normalized = (value - 128) / 128;
+                sumOfSquares += normalized * normalized;
+            }
+            return Math.min(1, Math.sqrt(sumOfSquares / Math.max(values.length, 1)) * 4);
+        },
+        async close() {
+            if (closed)
+                return;
+            closed = true;
+            source.disconnect();
+            analyser.disconnect();
+            await context.close();
+        },
+    };
+}
+//# sourceMappingURL=waveform.js.map

package/dist/react/stt/waveform.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"waveform.js","sourceRoot":"","sources":["../../../src/react/stt/waveform.ts"],"names":[],"mappings":"AAKA,MAAM,UAAU,oBAAoB,CAClC,MAAmB,EACnB,gBAAoC,GAAG,EAAE,CAAC,IAAI,YAAY,EAAE;IAE5D,MAAM,OAAO,GAAG,aAAa,EAAE,CAAC;IAChC,MAAM,MAAM,GAAG,OAAO,CAAC,uBAAuB,CAAC,MAAM,CAAC,CAAC;IACvD,MAAM,QAAQ,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IAC1C,QAAQ,CAAC,OAAO,GAAG,GAAG,CAAC;IACvB,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACzB,MAAM,MAAM,GAAG,IAAI,UAAU,CAAC,QAAQ,CAAC,iBAAiB,CAAC,CAAC;IAC1D,IAAI,MAAM,GAAG,KAAK,CAAC;IAEnB,OAAO;QACL,SAAS;YACP,QAAQ,CAAC,qBAAqB,CAAC,MAAM,CAAC,CAAC;YACvC,IAAI,YAAY,GAAG,CAAC,CAAC;YACrB,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;gBAC3B,MAAM,UAAU,GAAG,CAAC,KAAK,GAAG,GAAG,CAAC,GAAG,GAAG,CAAC;gBACvC,YAAY,IAAI,UAAU,GAAG,UAAU,CAAC;YAC1C,CAAC;YACD,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QAC/E,CAAC;QACD,KAAK,CAAC,KAAK;YACT,IAAI,MAAM;gBAAE,OAAO;YACnB,MAAM,GAAG,IAAI,CAAC;YACd,MAAM,CAAC,UAAU,EAAE,CAAC;YACpB,QAAQ,CAAC,UAAU,EAAE,CAAC;YACtB,MAAM,OAAO,CAAC,KAAK,EAAE,CAAC;QACxB,CAAC;KACF,CAAC;AACJ,CAAC"}