@statesync/electron

---

@statesync/electron / createElectronBroadcaster

Function: createElectronBroadcaster()

function createElectronBroadcaster(options): ElectronBroadcasterHandle;

Defined in: main.ts:104

Creates a broadcaster that pushes InvalidationEvent payloads to renderer windows over Electron IPC.

Call ElectronBroadcasterHandle.invalidate whenever the authoritative state changes (e.g. after a database write) to notify all connected renderers that their cached data is stale.

Process context: main process only.

Safety: Iterates targets with try/catch + isDestroyed() guard. The TOCTOU race (webContents destroyed between check and send()) is a real scenario in Electron multi-window apps — the try/catch handles it gracefully. Non-TOCTOU errors are logged to console.warn so they are not silently lost.

Parameters

Parameter	Type	Description
options	ElectronBroadcasterOptions	Configuration for the broadcaster.

Returns

ElectronBroadcasterHandle

A handle with an ElectronBroadcasterHandle.invalidate method.

Example

import { BrowserWindow } from 'electron';
import { createElectronBroadcaster } from '@statesync/electron';

const broadcaster = createElectronBroadcaster({
  topic: 'todos',
  getTargets: () => BrowserWindow.getAllWindows().map(w => w.webContents),
});

// After a database write:
broadcaster.invalidate('42', { sourceId: 'api-handler' });