Referral program (#251)

* feat: added initial oAuth integration setup

* fix: show local time not utc, add link to platform.openai

* feat: add complete cleanup script and troubleshooting docs

- Add automated uninstall script for complete system cleanup
- Add detailed cleanup instructions with manual steps
- Add comprehensive troubleshooting guide for common issues
- Fix architecture mismatch documentation (ARM64 vs x64)
- Document proper macOS permission reset using tccutil
- Resolve environment contamination between production and dev

Fixes issues with:
- better-sqlite3 architecture mismatch on Apple Silicon
- Database/settings conflicts between DMG and dev mode
- Microphone printing 'you' instead of transcription
- Node running under Rosetta emulation

* chore: update lockfile

* fix: register hotkey immediately after step

* chore: version bump

* refactor: migration to neon auth

* refactor: make sure to use own UI components

* refactor: ui overhaul

* refactor: replace IPC-based OAuth callback with deep-link flow, add main-process session clearing for sign-out, and remove GitHub social provider

* feat: add skills

* feat: ignore claude skills and agents

* feat: add OpenWhispr cloud transcription with usage tracking, limits, and session refresh

* refactor: Fix cloud transcription binary handling, add auth state sync, clean up debug logging

* feat: Show UpgradePrompt dialog in ControlPanel when daily transcription limit is reached

* feat: add AssemblyAI real-time streaming transcription with WebSocket pre-warming and mic caching for instant-start recording

* fix: streaming handling when no api key

* fix: persist AI provider selection to localStorage so Custom/Local tabs don't reset to OpenAI on settings reopen

* chore: version bump

* refactor: onboarding style refactor

* feat: Add Stripe billing with trial support, refactor duplicate API handlers for DRY, migrate to weekly usage limits, and enhance auth flow with user existence check

* feat: complete OAuth flow with branded redirect, UI refinements, code quality improvements

* fix: ui polish

* refactor: consolidate session refresh logic with withSessionRefresh utility, streamline onboarding flow for signed-in users, and persist permission states

* chore: update .gitignore

* feat(ui): add ReferralDashboard component with full referral UI

ReferralDashboard.tsx:
- Dashboard tab with stats cards (referrals, pending, converted, months earned)
- Gift card preview showing referral reward
- Invite tab with email input and send functionality
- History tabs showing referrals and sent invites
- Copy-to-clipboard for referral link
- Loading, error, and empty states
- Toast notifications for user feedback

Settings integration:
- Add Referrals section to SettingsModal sidebar
- Add referrals case to SettingsPage section renderer

Design:
- Follows OpenWhispr design language
- Uses existing UI components (Button, Badge, Input, Tabs)
- Proper TypeScript typing throughout

Co-Authored-By: Claude Opus 4.5 <[email protected]>

* feat(ipc): add referral IPC handlers and type definitions

IPC Handlers (ipcHandlers.js):
- get-referral-stats: fetch user's referral dashboard data
- send-referral-invite: send email invitation via API
- get-referral-invites: list sent invitations
- Proper cookie forwarding for authentication
- Error handling consistent with other cloud handlers

Preload (preload.js):
- Expose getReferralStats, sendReferralInvite, getReferralInvites

Types (electron.ts):
- ReferralStats interface with proper union types for status
- ReferralInvite interface for email invitations
- Type-safe method signatures

Co-Authored-By: Claude Opus 4.5 <[email protected]>

* chore: update dependencies

Co-Authored-By: Claude Opus 4.5 <[email protected]>

* feat: Add sidebar navigation, notes system, and dictionary view

* feat: referral card redesign

* fix: neon auth build config

---------

Co-authored-by: Claude Opus 4.5 <[email protected]>

Author: gabrielste1n

main.js

@@ -320,6 +320,7 @@ function navigateControlPanelWithVerifier(verifier) {
   windowManager.controlPanelWindow.focus();
 }
 
+
 function handleOAuthDeepLink(deepLinkUrl) {
   try {
     const parsed = new URL(deepLinkUrl);

package-lock.json

@@ -83,6 +83,7 @@
     "vite": "^6.3.5"
   },
   "dependencies": {
+    "@neondatabase/auth": "^0.1.0-beta.21",
     "@neondatabase/neon-js": "^0.1.0-beta.22",
     "@radix-ui/react-accordion": "^1.1.2",
     "@radix-ui/react-dialog": "^1.1.14",

package.json

@@ -1,4 +1,4 @@
-const { contextBridge, ipcRenderer } = require("electron");
+const { contextBridge, ipcRenderer, webUtils } = require("electron");
 
 /**
  * Helper to register an IPC listener and return a cleanup function.
@@ -51,6 +51,37 @@ contextBridge.exposeInMainWorld("electronAPI", {
   getDictionary: () => ipcRenderer.invoke("db-get-dictionary"),
   setDictionary: (words) => ipcRenderer.invoke("db-set-dictionary", words),
 
+  // Note functions
+  saveNote: (title, content, noteType, sourceFile, audioDuration) =>
+    ipcRenderer.invoke("db-save-note", title, content, noteType, sourceFile, audioDuration),
+  getNote: (id) => ipcRenderer.invoke("db-get-note", id),
+  getNotes: (noteType, limit) => ipcRenderer.invoke("db-get-notes", noteType, limit),
+  updateNote: (id, updates) => ipcRenderer.invoke("db-update-note", id, updates),
+  deleteNote: (id) => ipcRenderer.invoke("db-delete-note", id),
+  exportNote: (noteId, format) => ipcRenderer.invoke("export-note", noteId, format),
+
+  // Audio file operations
+  selectAudioFile: () => ipcRenderer.invoke("select-audio-file"),
+  transcribeAudioFile: (filePath, options) =>
+    ipcRenderer.invoke("transcribe-audio-file", filePath, options),
+  getPathForFile: (file) => webUtils.getPathForFile(file),
+
+  onNoteAdded: (callback) => {
+    const listener = (_event, note) => callback?.(note);
+    ipcRenderer.on("note-added", listener);
+    return () => ipcRenderer.removeListener("note-added", listener);
+  },
+  onNoteUpdated: (callback) => {
+    const listener = (_event, note) => callback?.(note);
+    ipcRenderer.on("note-updated", listener);
+    return () => ipcRenderer.removeListener("note-updated", listener);
+  },
+  onNoteDeleted: (callback) => {
+    const listener = (_event, data) => callback?.(data);
+    ipcRenderer.on("note-deleted", listener);
+    return () => ipcRenderer.removeListener("note-deleted", listener);
+  },
+
   onTranscriptionAdded: (callback) => {
     const listener = (_event, transcription) => callback?.(transcription);
     ipcRenderer.on("transcription-added", listener);
@@ -256,6 +287,11 @@ contextBridge.exposeInMainWorld("electronAPI", {
   cloudCheckout: () => ipcRenderer.invoke("cloud-checkout"),
   cloudBillingPortal: () => ipcRenderer.invoke("cloud-billing-portal"),
 
+  // Referral stats
+  getReferralStats: () => ipcRenderer.invoke("get-referral-stats"),
+  sendReferralInvite: (email) => ipcRenderer.invoke("send-referral-invite", email),
+  getReferralInvites: () => ipcRenderer.invoke("get-referral-invites"),
+
   // Assembly AI Streaming
   assemblyAiStreamingWarmup: (options) => ipcRenderer.invoke("assemblyai-streaming-warmup", options),
   assemblyAiStreamingStart: (options) => ipcRenderer.invoke("assemblyai-streaming-start", options),