Files
GMW/services/backend/src/ws/broadcast.ts
T
MythEclipse f04b0f0b42 refactor(voice): optimize recording pipeline and improve performance
Refactor the voice recording and playback systems to improve efficiency, reduce latency, and enhance Docker build performance.

- **Infrastructure**: Optimize Dockerfiles using build mounts for pnpm cache and reorder layers for better caching of dependencies and build tools.
- **Backend/Gateway**:
  - Refactor `broadcast` module to use a generic event-based system instead of hardcoded functions.
  - Simplify voice recording logic by merging metadata and segment management into a unified `segment.ts`.
  - Optimize audio downsampling in `streamSetup.ts` using `Int16Array` views for better performance.
  - Implement `withFallback` utility for more robust Redis/Database command execution.
- **Frontend**:
  - Optimize audio playback visualization using pre-computed level shapes and efficient RMS calculation.
  - Reduce latency in voice commands by prioritizing WebSocket communication over HTTP.
  - Improve base64 encoding efficiency in audio transmission.
- **General**:
  - Add default value for `ADMIN_PASSWORD` in shared config.
  - Fix Docker healthcheck to use `127.0.0.1` instead of `localhost`.
2026-06-09 22:04:05 +07:00

72 lines
1.9 KiB
TypeScript

/**
* Broadcast functions for WebSocket events.
*
* These are injected by ws/server.ts when the WebSocket server initializes.
* Other modules call them to push real-time events to connected frontend clients.
*
* Usage:
* import { broadcastEvent } from "../ws/broadcast.js";
* broadcastEvent("message_created", messageData);
*/
import { createChildLogger } from "@bete/shared/logger";
const logger = createChildLogger("broadcast");
type BroadcastFn = (type: string, data: unknown) => void;
type BroadcastBinaryFn = (data: Buffer) => void;
let _broadcast: BroadcastFn | null = null;
let _broadcastBinary: BroadcastBinaryFn | null = null;
let _enabled = true;
/** Enable or disable broadcast logging (disabled by default to reduce noise). */
export function setBroadcastLogging(enabled: boolean): void {
_enabled = enabled;
}
/**
* Inject broadcast functions from the WebSocket server initializer.
* Must be called once during server startup before any broadcast is used.
*/
export function setBroadcastFunctions(
bf: BroadcastFn,
bfBinary: BroadcastBinaryFn,
): void {
_broadcast = bf;
_broadcastBinary = bfBinary;
logger.info("Broadcast functions initialized");
}
/** Clear injected functions (used during cleanup). */
export function clearBroadcastFunctions(): void {
_broadcast = null;
_broadcastBinary = null;
logger.info("Broadcast functions cleared");
}
function shouldLog(type: string): boolean {
if (!_enabled) return false;
// Avoid logging high-volume events
if (type === "voice_pcm_data") return false;
return true;
}
/**
* Broadcast a JSON event to all connected WebSocket clients.
*/
export function broadcastEvent(type: string, data: unknown): void {
if (shouldLog(type)) {
logger.debug({ event: type }, "Broadcasting event");
}
_broadcast?.(type, data);
}
/**
* Broadcast binary data to all connected WebSocket clients.
*/
export function broadcastBinary(data: Buffer): void {
_broadcastBinary?.(data);
}