GMW/services/backend/src/ws/broadcast.ts

/**
 * Global broadcast functions for WebSocket events.
 *
 * These are assigned by ws/server.ts when the WebSocket server initializes.
 * Other modules call them to push real-time events to connected frontend clients.
 *
 * Usage:
 *   import { broadcastMessageCreated } from "../ws/broadcast.js";
 *   broadcastMessageCreated(messageData);
 */

type BroadcastFn = (data: unknown) => void;
type BroadcastRawFn = (type: string, data: unknown) => void;

// Extend globalThis with broadcast function types
declare global {
  // biome-ignore lint/suspicious/noAssignInExpressions: intentional global broadcast registry
  var __broadcastFns:
    | {
        messageCreated: BroadcastFn;
        messageUpdated: BroadcastFn;
        messageDeleted: BroadcastFn;
        attachmentUploaded: BroadcastFn;
        raw: BroadcastRawFn;
      }
    | undefined;
}

const noop: BroadcastFn = () => {};
const noopRaw: BroadcastRawFn = () => {};

export const broadcastMessageCreated: BroadcastFn = (data) =>
  (globalThis.__broadcastFns?.messageCreated ?? noop)(data);

export const broadcastMessageUpdated: BroadcastFn = (data) =>
  (globalThis.__broadcastFns?.messageUpdated ?? noop)(data);

export const broadcastMessageDeleted: BroadcastFn = (data) =>
  (globalThis.__broadcastFns?.messageDeleted ?? noop)(data);

export const broadcastAttachmentUploaded: BroadcastFn = (data) =>
  (globalThis.__broadcastFns?.attachmentUploaded ?? noop)(data);

export const broadcastRaw: BroadcastRawFn = (type, data) =>
  (globalThis.__broadcastFns?.raw ?? noopRaw)(type, data);