preload.js

/**
 * ==============================================================================
 * PRELOAD SCRIPT
 * ==============================================================================
 * 
 * This script runs BEFORE the web page loads. It acts as a secure bridge
 * between the "Backend" (Node.js/Electron) and the "Frontend" (React).
 * 
 * Security Note: We do NOT expose the full Node.js API to the frontend.
 * We only expose specific functions via 'window.lazyfish'.
 */

const { contextBridge, ipcRenderer } = require("electron")

contextBridge.exposeInMainWorld('lazyfish', {
  /**
   * Listen for new clipboard text from the backend.
   */
  onClipboard: (callback) => {
    // We wrap the callback to ensure we strip the 'event' object from Electron
    // and only pass the data.
    ipcRenderer.on("clipboard-update", (event, text) => callback(text))
  },

  /**
   * Listen for AI suggestions from the backend.
   */
  onAIResponse: (callback) => {
    ipcRenderer.on("ai-response", (event, analysis) => callback(analysis))
  },

  /**
   * Listen for tray bounds from the backend.
   */
  onTrayBounds: (callback) => {
    ipcRenderer.on("tray-bounds", (event, bounds) => callback(bounds))
  },

  /**
   * Tell the backend to quit the app.
   */
  quit: () => {
    ipcRenderer.send("quit-app")
  },

  /**
   * Tell the backend if the mouse should click *through* the window.
   * @param {boolean} shouldPassThrough - true = clicks go to desktop; false = clicks hit the app.
   */
  setPassthrough: (shouldPassThrough) => {
    ipcRenderer.send('set-mouse-passthrough', shouldPassThrough)
  },

  /**
   * Open a URL in the system's default browser.
   * @param {string} url - The URL to open.
   */
  openExternal: (url) => {
    ipcRenderer.send('open-external', url)
  },

  /**
   * Open an ICS calendar event directly in Apple Calendar.
   * @param {string} icsContent - The ICS file content.
   * @param {string} filename - The filename for the temp file.
   * @returns {Promise<boolean>} - Whether the file was opened successfully.
   */
  openICSFile: (icsContent, filename) => {
    return ipcRenderer.invoke('open-ics-file', icsContent, filename)
  }
})