Function notifyDesktop

src/utils/notify.ts:38–63

(n: DesktopNotification)

 * when the (very fast) osascript call finishes. Never rejects.
 */
export async function notifyDesktop(n: DesktopNotification): Promise<void> {
  if (process.platform !== 'darwin') return; // macOS only

  // Build: display notification "msg" with title "t" subtitle "s" sound name "Glass"
  let script = `display notification "${escapeAppleScript(n.message)}" with title "${escapeAppleScript(n.title)}"`;
  if (n.subtitle) script += ` subtitle "${escapeAppleScript(n.subtitle)}"`;
  if (n.sound) script += ` sound name "Glass"`;

  await new Promise<void>((resolve) => {
    let done = false;
    const finish = () => { if (!done) { done = true; resolve(); } };
    try {
      const child = spawn('osascript', ['-e', script], { stdio: 'ignore' });
      child.on('error', (e: any) => {
        logger.debug?.('desktop notification unavailable', { err: e?.message });
        finish();
      });
      child.on('close', () => finish());
      // Safety: never hang the caller on a stuck osascript.
      setTimeout(() => { try { child.kill(); } catch {} finish(); }, 5000);
    } catch (e: any) {
      logger.debug?.('desktop notification failed to spawn', { err: e?.message });
      finish();
    }
  });
}