Migrate to facebook.com/messages (Messenger discontinuation fix) - #2378

- Add nativeTheme.on('updated') listener to detect OS theme changes
- Only set nativeTheme.themeSource when it differs from config value to prevent infinite loop
- Move ThemeSource type to top-level for cleaner code

This fixes the issue where changing OS theme from dark→light with 'system' theme
selected only updated conversation list but left background and navigation bar in
dark mode. The fix also resolves high CPU usage caused by recursive theme updates.

- Add dedicated drag bar overlay at top 24px of window on macOS
- Enable window dragging via -webkit-app-region: drag
- Toggle pointer-events based on mouse position to preserve clickability
- Remove conflicting CSS draggable regions
- Debounce mousemove events to reduce CPU usage (100ms)

Display recent 10 conversations in Windows taskbar jump list when user right-clicks the app icon

Clear jump list on app quit to prevent background processes from spawning

Fix lint errors in index.ts:
- Import process from 'node:process'
- Fix mixed spaces and tabs indentation

- Build/lint/test commands (no unit tests, only type check + lint)
- TypeScript/JavaScript guidelines (XO + disabled rules)
- CSS/Style conventions (BEM-style, attribute selectors, !important)
- Error handling, naming conventions, and import rules
- No Cursor/Copilot rules found

Facebook is shutting down messenger.com in April 2026. This migrates
the app to use facebook.com/messages/ as the base URL.

- Update main URL from messenger.com/login/ to facebook.com/messages/
- Simplify messengerDomain to always use facebook.com
- Replace isMessengerDotCom + isTwoFactorAuth with unified isFacebookMessages
  that whitelists /messages, /login, /checkpoint, /two_step_verification
- Hide Facebook top navbar via [role='banner']
- Zero out --header-height and --messenger-card-spacing CSS variables
- Add 16px card-style margins and gaps around all panels to match
  the messenger.com floating card layout

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

After migrating to facebook.com/messages, the CSS selector for conversation

names was outdated. It used an exact class match that no longer existed,

causing it to fall back to other selectors that matched timestamps.

Changes:

- Update selector from exact match to attribute selectors

- Use querySelectorAll() and take first match to ensure we get conversation name

This fixes both macOS dock icon context menu and Windows jump list.

Clicking on a chat name in individual conversations now opens the
profile page in the default browser instead of navigating within
the app. Group chats remain unaffected and continue to open the
popup modal.

Changes:
- Add click handler in browser.ts to intercept profile clicks
- Add IPC handler in index.ts to open URLs via shell.openExternal()
- Detect individual chats by checking for numeric user ID pattern

The messenger.com → facebook.com/messages migration broke both the macOS
dock badge and cross-platform notifications because several DOM selectors
no longer matched the new page structure.

Root causes:
- `updateTrayIcon` waited forever on `elementReady(chatsIcon)` — the
  messenger.com nav icon with an "Chats, X unread" aria-label does not
  exist on facebook.com/messages — so the tray observer was never set up.
- `countUnread` filtered mutations by exact CSS class strings
  (`conversationSidebarUnreadDot`, `conversationSidebarTextParent`) that
  no longer match the facebook.com/messages DOM — all mutations were
  silently dropped and no notifications were sent.
- `leftSidebar` used an exact class string for messenger.com's nav
  element, causing `elementReady` to hang indefinitely.
- `conversationSidebarSelector` and `conversationSidebarTextSelector`
  also had stale exact-class-match strings.

Fixes:
- Add `isUnreadConversation()` helper that detects unread conversations
  via the visually-hidden "Unread message:" accessibility label Facebook
  inserts into the DOM for screen readers — a stable semantic signal.
- Fix `createConversationNewDesign` to use `isUnreadConversation` instead
  of the never-visible `[aria-label="Mark as Read"]` hover button.
- Rewrite `updateTrayIcon` to count unread rows in `[role=grid]` directly
  (no external icon or aria-label required). Badge reflects the number of
  conversations with unread messages (the sidebar exposes no per-
  conversation unread message count on facebook.com/messages).
- Fix `countUnread` to use semantic `closest('[role=row]')` instead of
  fragile class-name ancestor checks; also handles the case where an
  entire row is added (conversation moves to top of list).
- Fix observer setup: remove broken `leftSidebar`/`chatsIcon` dependency;
  add `trayIconObserver` on the same `sidebar` element; call
  `updateTrayIcon()` once on page load for the initial badge.
- Update `conversationSidebarSelector` → `[role=row]` (semantic).
- Update `conversationSidebarTextSelector` class string to match current
  facebook.com/messages DOM.
- Update `leftSidebar` → `[role="navigation"][aria-label="Thread list"]`
  so `isNewSidebar()` in browser.ts no longer hangs.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

- Generate unique notification IDs from conversation hrefs to prevent closing different conversations' notifications

- Close all notifications when badge count reaches 0 to clear GNOME dock badge

- Restore deduplication logic to prevent duplicate notifications from same conversation

- Add notification cooldown (5 min) to prevent repeated sounds for same conversation
- Implement consecutive zero confirmation (3 readings) before clearing badge
- Add 2-second polling + focus/restore triggers for badge updates
- Fix flashFrame to only trigger on new messages (count increase)

Fixes issues:
1. Icon flashing every X minutes until app opened
2. Notification sound repeating every X seconds when unread
3. Badge disappearing on window restore even with unread messages

… sound

- Download official Messenger notification sound from Facebook CDN
- Add sound-play library for cross-platform audio playback
- Implement platform-specific audio playback (afplay on macOS, sound-play on Linux/Windows)
- Configure electron-builder to include sounds in app bundle
- Add proper path resolution for both development and packaged app

Replace the unreliable sound-play library on Linux with GStreamer's
gst-play-1.0 which properly decodes MP3 files. This ensures Linux
users hear the actual messenger notification sound instead of generic
system sounds.

Changes:
- Linux now uses gst-play-1.0 (GStreamer) for MP3 playback
- Fallback to paplay (PulseAudio/PipeWire) and aplay (ALSA)
- Simplified Windows to use soundPlay directly
- Mirrors the macOS approach using native audio tools

Fixes noise/glitching issues caused by aplay trying to play MP3 files
directly without proper decoding.

Remove sound-play library dependency and use exec() directly with
platform-specific audio players, making the code more consistent
and reducing dependencies.

Changes:
- macOS: afplay (already using exec, unchanged)
- Linux: gst-play-1.0 with fallbacks (already using exec, unchanged)
- Windows: PowerShell with Windows Media Player (now uses exec directly)
- Remove sound-play dependency from package.json
- Remove sound-play.d.ts type definition file

All platforms now use the same pattern with native audio tools,
ensuring proper MP3 playback without external libraries.

Intercepts all links within the main chat area ([role=main]) and opens
them in the OS default browser. This prevents users from getting trapped
on external pages without a back button.

Exceptions:
- Links clicked directly on images open in-app modal
- Links outside chat area (login, navigation) work normally

Closes sindresorhus#2166

- Update selectors to use semantic ARIA attributes instead of fragile CSS classes
- Fix userMenuNewSidebar selector: [aria-label='Settings, help and more']
- Fix preferencesSelector: [role='dialog']:has(h2)
- Fix closePreferencesButton: [role='dialog'] [aria-label='Close']
- Add userProfileButton selector for Log Out menu
- Fix openPreferences() to find menu item by text content
- Fix log-out handler to use new User Profile menu location
- Fix withMenu() to avoid hanging on non-existent menu layer
- Update isNewSidebar() to always return true for facebook.com/messages
- Add /logout and / (homepage) to allowed navigation paths
- Add automatic redirect from facebook.com/ to /messages after login

Fixes menu bar items not working after migration from messenger.com to facebook.com/messages

- Update notificationCheckbox selector to use semantic ARIA attributes
  Old: ._374b:nth-of-type(4) ._4ng2 input (messenger.com legacy)
  New: [role="dialog"] [role="switch"]:first-of-type

- Fix toggle handler to check current state before toggling
  Handler now reads Facebook's actual notification setting first
  Only toggles if current state doesn't match desired state
  Prevents menu and Facebook settings from becoming out of sync

- Fix menu item always appearing checked on startup
  Initialize as unchecked (false) instead of reading from config
  Ensures menu shows correct state when app starts

- Fix menu naming inconsistency on Linux/Windows
  Change 'Messenger Settings' to 'Messenger Preferences'
  Consistent with macOS menu naming

- Update IToggleMuteNotifications type
  Change 'defaultStatus' to 'checked' for clarity

Fixes notification mute toggle not working after migration from
messenger.com to facebook.com/messages

After migrating from messenger.com to facebook.com/messages, the conversation
menu actions stopped working due to DOM changes:

- Menu button aria-label changed from 'Menu' to 'More options for ...'
- Menu item positions changed between individual and group conversations

Changes:
- Update menu button selector to use [aria-label*='More options']
- Convert Mute, Archive, Delete to use text-based menu item detection
- Remove hardcoded indices and conversation type detection functions
- Search for menu items containing 'Mute', 'Archive', 'Delete' text

This approach is more robust and works for all conversation types
(individual, group, Meta AI) regardless of menu item order.

…tifications

- Enable Show Message Preview in Notifications for production
- Fix Show Unread Badge to clear immediately when unchecked (no refresh needed)
- Fix Mute Notifications to properly save config and block notifications/sounds
- Implement message-level tracking for notifications (prevents duplicates without
  blocking new messages in same conversation)
- Add get-mute-notifications-state handler for state checking

Fixes multiple TODOs related to notification features after facebook.com/messages
migration.

…sed cooldown

- Fix broken CSS selector for message preview (use partial class matching)
- Replace 5-minute cooldown with content-based deduplication
- Track last notified content per conversation to prevent DOM mutation repeats
- Allow new messages with different content to notify immediately
- Clear tracking when conversations are marked as read

On Linux with HiDPI/fractional scaling, window size was not properly restored
after logout and login. The issue was caused by:

1. Window bounds saved as logical pixels (scaled by display scale factor)
2. After logout/login, display scale might differ
3. Saved logical pixels resulted in different physical window sizes

Changes:
- Add scaleFactor field to lastWindowState config
- Save display scale factor when storing window state
- Adjust window size on Linux based on scale factor changes
- Add SIGTERM/SIGHUP handlers to save state during shutdown
- Validate window dimensions before saving

This ensures the window maintains the same physical size regardless of
display scaling changes between sessions.

Update DOM selectors to use aria-label attributes instead of fragile
auto-generated class names that changed with the migration:

- Insert GIF: [aria-label="Choose a GIF"]
- Insert Sticker: [aria-label="Choose a sticker"]
- Insert Emoji: [aria-label="Choose an emoji"]
- Attach Files: [aria-label="Attach a file up to 25 MB"]
- Find Conversation: [aria-label="Search Messenger"] (was selecting Facebook search)
- Search in Conversation: Simplified to click [aria-label="Search"] directly

Fixes issues introduced in commit 5d4e29c

- Attach Files: Fixed to work with E2EE encrypted chats (supports both 25 MB and 100 MB file limits)
- New Conversation: Updated selector from href to aria-label
- Create Channel: Replaced deprecated 'New Room' feature with new 'Create Channel' using elementReady()
- View > Show Main Chats: Navigate to /messages URL
- View > Show Message Requests: Click through Settings menu
- View > Show Archived Chats: Click through Settings menu
- View > Show Restricted Accounts: NEW - Added handler for Settings menu
- View > Show Marketplace Chats: REMOVED - Feature no longer exists on Facebook
- Refactored: Created unified openSettingsMenuAndClickItem() helper for Settings menu interactions
- Cleanup: Removed deprecated functions (selectOtherListViews, withSettingsMenu, etc.)