markupr 2.1.8

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (299) hide show
  1. package/.claude/commands/review-feedback.md +47 -0
  2. package/.eslintrc.json +35 -0
  3. package/.github/CODEOWNERS +16 -0
  4. package/.github/FUNDING.yml +1 -0
  5. package/.github/ISSUE_TEMPLATE/bug_report.md +56 -0
  6. package/.github/ISSUE_TEMPLATE/feature_request.md +54 -0
  7. package/.github/PULL_REQUEST_TEMPLATE.md +89 -0
  8. package/.github/dependabot.yml +70 -0
  9. package/.github/workflows/ci.yml +184 -0
  10. package/.github/workflows/deploy-landing.yml +134 -0
  11. package/.github/workflows/nightly.yml +288 -0
  12. package/.github/workflows/release.yml +318 -0
  13. package/CHANGELOG.md +127 -0
  14. package/CLAUDE.md +137 -0
  15. package/CODE_OF_CONDUCT.md +9 -0
  16. package/CONTRIBUTING.md +390 -0
  17. package/LICENSE +21 -0
  18. package/PRODUCT_VISION.md +277 -0
  19. package/README.md +517 -0
  20. package/SECURITY.md +51 -0
  21. package/SIGNING_INSTRUCTIONS.md +284 -0
  22. package/assets/DMG_BACKGROUND_INSTRUCTIONS.md +130 -0
  23. package/assets/svg-source/dmg-background.svg +70 -0
  24. package/assets/svg-source/icon.svg +20 -0
  25. package/assets/svg-source/tray-icon-processing.svg +7 -0
  26. package/assets/svg-source/tray-icon-recording.svg +7 -0
  27. package/assets/svg-source/tray-icon.svg +6 -0
  28. package/assets/tray-complete.png +0 -0
  29. package/assets/tray-complete@2x.png +0 -0
  30. package/assets/tray-completeTemplate.png +0 -0
  31. package/assets/tray-completeTemplate@2x.png +0 -0
  32. package/assets/tray-error.png +0 -0
  33. package/assets/tray-error@2x.png +0 -0
  34. package/assets/tray-errorTemplate.png +0 -0
  35. package/assets/tray-errorTemplate@2x.png +0 -0
  36. package/assets/tray-icon-processing.png +0 -0
  37. package/assets/tray-icon-processing@2x.png +0 -0
  38. package/assets/tray-icon-processingTemplate.png +0 -0
  39. package/assets/tray-icon-processingTemplate@2x.png +0 -0
  40. package/assets/tray-icon-recording.png +0 -0
  41. package/assets/tray-icon-recording@2x.png +0 -0
  42. package/assets/tray-icon-recordingTemplate.png +0 -0
  43. package/assets/tray-icon-recordingTemplate@2x.png +0 -0
  44. package/assets/tray-icon.png +0 -0
  45. package/assets/tray-icon@2x.png +0 -0
  46. package/assets/tray-iconTemplate.png +0 -0
  47. package/assets/tray-iconTemplate@2x.png +0 -0
  48. package/assets/tray-idle.png +0 -0
  49. package/assets/tray-idle@2x.png +0 -0
  50. package/assets/tray-idleTemplate.png +0 -0
  51. package/assets/tray-idleTemplate@2x.png +0 -0
  52. package/assets/tray-processing-0.png +0 -0
  53. package/assets/tray-processing-0@2x.png +0 -0
  54. package/assets/tray-processing-0Template.png +0 -0
  55. package/assets/tray-processing-0Template@2x.png +0 -0
  56. package/assets/tray-processing-1.png +0 -0
  57. package/assets/tray-processing-1@2x.png +0 -0
  58. package/assets/tray-processing-1Template.png +0 -0
  59. package/assets/tray-processing-1Template@2x.png +0 -0
  60. package/assets/tray-processing-2.png +0 -0
  61. package/assets/tray-processing-2@2x.png +0 -0
  62. package/assets/tray-processing-2Template.png +0 -0
  63. package/assets/tray-processing-2Template@2x.png +0 -0
  64. package/assets/tray-processing-3.png +0 -0
  65. package/assets/tray-processing-3@2x.png +0 -0
  66. package/assets/tray-processing-3Template.png +0 -0
  67. package/assets/tray-processing-3Template@2x.png +0 -0
  68. package/assets/tray-processing.png +0 -0
  69. package/assets/tray-processing@2x.png +0 -0
  70. package/assets/tray-processingTemplate.png +0 -0
  71. package/assets/tray-processingTemplate@2x.png +0 -0
  72. package/assets/tray-recording.png +0 -0
  73. package/assets/tray-recording@2x.png +0 -0
  74. package/assets/tray-recordingTemplate.png +0 -0
  75. package/assets/tray-recordingTemplate@2x.png +0 -0
  76. package/build/DMG_BACKGROUND_SPEC.md +50 -0
  77. package/build/dmg-background.png +0 -0
  78. package/build/dmg-background@2x.png +0 -0
  79. package/build/entitlements.mac.inherit.plist +27 -0
  80. package/build/entitlements.mac.plist +41 -0
  81. package/build/favicon-16.png +0 -0
  82. package/build/favicon-180.png +0 -0
  83. package/build/favicon-192.png +0 -0
  84. package/build/favicon-32.png +0 -0
  85. package/build/favicon-48.png +0 -0
  86. package/build/favicon-512.png +0 -0
  87. package/build/favicon-64.png +0 -0
  88. package/build/icon-128.png +0 -0
  89. package/build/icon-16.png +0 -0
  90. package/build/icon-24.png +0 -0
  91. package/build/icon-256.png +0 -0
  92. package/build/icon-32.png +0 -0
  93. package/build/icon-48.png +0 -0
  94. package/build/icon-64.png +0 -0
  95. package/build/icon.icns +0 -0
  96. package/build/icon.ico +0 -0
  97. package/build/icon.iconset/icon_128x128.png +0 -0
  98. package/build/icon.iconset/icon_128x128@2x.png +0 -0
  99. package/build/icon.iconset/icon_16x16.png +0 -0
  100. package/build/icon.iconset/icon_16x16@2x.png +0 -0
  101. package/build/icon.iconset/icon_256x256.png +0 -0
  102. package/build/icon.iconset/icon_256x256@2x.png +0 -0
  103. package/build/icon.iconset/icon_32x32.png +0 -0
  104. package/build/icon.iconset/icon_32x32@2x.png +0 -0
  105. package/build/icon.iconset/icon_512x512.png +0 -0
  106. package/build/icon.iconset/icon_512x512@2x.png +0 -0
  107. package/build/icon.png +0 -0
  108. package/build/installer-header.bmp +0 -0
  109. package/build/installer-header.png +0 -0
  110. package/build/installer-sidebar.bmp +0 -0
  111. package/build/installer-sidebar.png +0 -0
  112. package/build/installer.nsh +45 -0
  113. package/build/overlay-processing.png +0 -0
  114. package/build/overlay-recording.png +0 -0
  115. package/build/toolbar-record.png +0 -0
  116. package/build/toolbar-screenshot.png +0 -0
  117. package/build/toolbar-settings.png +0 -0
  118. package/build/toolbar-stop.png +0 -0
  119. package/dist/main/index.mjs +12612 -0
  120. package/dist/preload/index.mjs +907 -0
  121. package/dist/renderer/assets/index-CCmUjl9K.js +19495 -0
  122. package/dist/renderer/assets/index-CUqz_Gs6.css +2270 -0
  123. package/dist/renderer/index.html +27 -0
  124. package/docs/AI_AGENT_QUICKSTART.md +42 -0
  125. package/docs/AI_PIPELINE_DESIGN.md +595 -0
  126. package/docs/API.md +514 -0
  127. package/docs/ARCHITECTURE.md +460 -0
  128. package/docs/CONFIGURATION.md +336 -0
  129. package/docs/DEVELOPMENT.md +508 -0
  130. package/docs/EXPORT_FORMATS.md +451 -0
  131. package/docs/GETTING_STARTED.md +236 -0
  132. package/docs/KEYBOARD_SHORTCUTS.md +334 -0
  133. package/docs/TROUBLESHOOTING.md +418 -0
  134. package/docs/landing/index.html +672 -0
  135. package/docs/landing/script.js +342 -0
  136. package/docs/landing/styles.css +1543 -0
  137. package/electron-builder.yml +140 -0
  138. package/electron.vite.config.ts +63 -0
  139. package/package.json +108 -0
  140. package/railway.json +12 -0
  141. package/scripts/build.mjs +51 -0
  142. package/scripts/generate-icons.mjs +314 -0
  143. package/scripts/generate-installer-images.cjs +253 -0
  144. package/scripts/generate-tray-icons.mjs +258 -0
  145. package/scripts/notarize.cjs +180 -0
  146. package/scripts/one-click-clean-test.sh +147 -0
  147. package/scripts/postinstall.mjs +36 -0
  148. package/scripts/setup-markupr.sh +55 -0
  149. package/setup +17 -0
  150. package/site/index.html +1835 -0
  151. package/site/package.json +11 -0
  152. package/site/railway.json +12 -0
  153. package/site/server.js +31 -0
  154. package/src/main/AutoUpdater.ts +392 -0
  155. package/src/main/CrashRecovery.ts +655 -0
  156. package/src/main/ErrorHandler.ts +703 -0
  157. package/src/main/HotkeyManager.ts +399 -0
  158. package/src/main/MenuManager.ts +529 -0
  159. package/src/main/PermissionManager.ts +420 -0
  160. package/src/main/SessionController.ts +1465 -0
  161. package/src/main/TrayManager.ts +540 -0
  162. package/src/main/ai/AIPipelineManager.ts +199 -0
  163. package/src/main/ai/ClaudeAnalyzer.ts +339 -0
  164. package/src/main/ai/ImageOptimizer.ts +176 -0
  165. package/src/main/ai/StructuredMarkdownBuilder.ts +379 -0
  166. package/src/main/ai/index.ts +16 -0
  167. package/src/main/ai/types.ts +258 -0
  168. package/src/main/analysis/ClarificationGenerator.ts +385 -0
  169. package/src/main/analysis/FeedbackAnalyzer.ts +531 -0
  170. package/src/main/analysis/index.ts +19 -0
  171. package/src/main/audio/AudioCapture.ts +978 -0
  172. package/src/main/audio/audioUtils.ts +100 -0
  173. package/src/main/audio/index.ts +20 -0
  174. package/src/main/capture/index.ts +1 -0
  175. package/src/main/index.ts +1693 -0
  176. package/src/main/ipc/captureHandlers.ts +272 -0
  177. package/src/main/ipc/index.ts +45 -0
  178. package/src/main/ipc/outputHandlers.ts +302 -0
  179. package/src/main/ipc/sessionHandlers.ts +56 -0
  180. package/src/main/ipc/settingsHandlers.ts +471 -0
  181. package/src/main/ipc/types.ts +56 -0
  182. package/src/main/ipc/windowHandlers.ts +277 -0
  183. package/src/main/output/ClipboardService.ts +369 -0
  184. package/src/main/output/ExportService.ts +539 -0
  185. package/src/main/output/FileManager.ts +416 -0
  186. package/src/main/output/MarkdownGenerator.ts +791 -0
  187. package/src/main/output/MarkdownPatcher.ts +299 -0
  188. package/src/main/output/index.ts +186 -0
  189. package/src/main/output/sessionAdapter.ts +207 -0
  190. package/src/main/output/templates/html-template.ts +553 -0
  191. package/src/main/pipeline/FrameExtractor.ts +330 -0
  192. package/src/main/pipeline/PostProcessor.ts +399 -0
  193. package/src/main/pipeline/TranscriptAnalyzer.ts +226 -0
  194. package/src/main/pipeline/index.ts +36 -0
  195. package/src/main/platform/WindowsTaskbar.ts +600 -0
  196. package/src/main/platform/index.ts +16 -0
  197. package/src/main/settings/SettingsManager.ts +730 -0
  198. package/src/main/settings/index.ts +19 -0
  199. package/src/main/transcription/ModelDownloadManager.ts +494 -0
  200. package/src/main/transcription/TierManager.ts +219 -0
  201. package/src/main/transcription/TranscriptionRecoveryService.ts +340 -0
  202. package/src/main/transcription/WhisperService.ts +748 -0
  203. package/src/main/transcription/index.ts +56 -0
  204. package/src/main/transcription/types.ts +135 -0
  205. package/src/main/windows/PopoverManager.ts +284 -0
  206. package/src/main/windows/TaskbarIntegration.ts +452 -0
  207. package/src/main/windows/index.ts +23 -0
  208. package/src/preload/index.ts +1047 -0
  209. package/src/renderer/App.tsx +515 -0
  210. package/src/renderer/AppWrapper.tsx +28 -0
  211. package/src/renderer/assets/logo-dark.svg +7 -0
  212. package/src/renderer/assets/logo.svg +7 -0
  213. package/src/renderer/audio/AudioCaptureRenderer.ts +454 -0
  214. package/src/renderer/capture/ScreenRecordingRenderer.ts +492 -0
  215. package/src/renderer/components/AnnotationOverlay.tsx +836 -0
  216. package/src/renderer/components/AudioWaveform.tsx +811 -0
  217. package/src/renderer/components/ClarificationQuestions.tsx +656 -0
  218. package/src/renderer/components/CountdownTimer.tsx +495 -0
  219. package/src/renderer/components/CrashRecoveryDialog.tsx +632 -0
  220. package/src/renderer/components/DonateButton.tsx +127 -0
  221. package/src/renderer/components/ErrorBoundary.tsx +308 -0
  222. package/src/renderer/components/ExportDialog.tsx +872 -0
  223. package/src/renderer/components/HotkeyHint.tsx +261 -0
  224. package/src/renderer/components/KeyboardShortcuts.tsx +787 -0
  225. package/src/renderer/components/ModelDownloadDialog.tsx +844 -0
  226. package/src/renderer/components/Onboarding.tsx +1830 -0
  227. package/src/renderer/components/ProcessingOverlay.tsx +157 -0
  228. package/src/renderer/components/RecordingOverlay.tsx +423 -0
  229. package/src/renderer/components/SessionHistory.tsx +1746 -0
  230. package/src/renderer/components/SessionReview.tsx +1321 -0
  231. package/src/renderer/components/SettingsPanel.tsx +217 -0
  232. package/src/renderer/components/Skeleton.tsx +347 -0
  233. package/src/renderer/components/StatusIndicator.tsx +86 -0
  234. package/src/renderer/components/ThemeProvider.tsx +429 -0
  235. package/src/renderer/components/Tooltip.tsx +370 -0
  236. package/src/renderer/components/TranscriptionPreview.tsx +183 -0
  237. package/src/renderer/components/TranscriptionTierSelector.tsx +640 -0
  238. package/src/renderer/components/UpdateNotification.tsx +377 -0
  239. package/src/renderer/components/WindowSelector.tsx +947 -0
  240. package/src/renderer/components/index.ts +99 -0
  241. package/src/renderer/components/primitives/ApiKeyInput.tsx +98 -0
  242. package/src/renderer/components/primitives/ColorPicker.tsx +65 -0
  243. package/src/renderer/components/primitives/DangerButton.tsx +45 -0
  244. package/src/renderer/components/primitives/DirectoryPicker.tsx +41 -0
  245. package/src/renderer/components/primitives/Dropdown.tsx +34 -0
  246. package/src/renderer/components/primitives/KeyRecorder.tsx +117 -0
  247. package/src/renderer/components/primitives/SettingsSection.tsx +32 -0
  248. package/src/renderer/components/primitives/Slider.tsx +43 -0
  249. package/src/renderer/components/primitives/Toggle.tsx +36 -0
  250. package/src/renderer/components/primitives/index.ts +10 -0
  251. package/src/renderer/components/settings/AdvancedTab.tsx +174 -0
  252. package/src/renderer/components/settings/AppearanceTab.tsx +77 -0
  253. package/src/renderer/components/settings/GeneralTab.tsx +40 -0
  254. package/src/renderer/components/settings/HotkeysTab.tsx +79 -0
  255. package/src/renderer/components/settings/RecordingTab.tsx +84 -0
  256. package/src/renderer/components/settings/index.ts +9 -0
  257. package/src/renderer/components/settings/settingsStyles.ts +673 -0
  258. package/src/renderer/components/settings/tabConfig.tsx +85 -0
  259. package/src/renderer/components/settings/useSettingsPanel.ts +447 -0
  260. package/src/renderer/contexts/ProcessingContext.tsx +227 -0
  261. package/src/renderer/contexts/RecordingContext.tsx +683 -0
  262. package/src/renderer/contexts/UIContext.tsx +326 -0
  263. package/src/renderer/contexts/index.ts +24 -0
  264. package/src/renderer/donateMessages.ts +69 -0
  265. package/src/renderer/hooks/index.ts +75 -0
  266. package/src/renderer/hooks/useAnimation.tsx +544 -0
  267. package/src/renderer/hooks/useTheme.ts +313 -0
  268. package/src/renderer/index.html +26 -0
  269. package/src/renderer/main.tsx +52 -0
  270. package/src/renderer/styles/animations.css +1093 -0
  271. package/src/renderer/styles/app-shell.css +662 -0
  272. package/src/renderer/styles/globals.css +515 -0
  273. package/src/renderer/styles/theme.ts +578 -0
  274. package/src/renderer/types/electron.d.ts +385 -0
  275. package/src/shared/hotkeys.ts +283 -0
  276. package/src/shared/types.ts +809 -0
  277. package/tests/clipboard.test.ts +228 -0
  278. package/tests/e2e/criticalPaths.test.ts +594 -0
  279. package/tests/feedbackAnalyzer.test.ts +303 -0
  280. package/tests/integration/sessionFlow.test.ts +583 -0
  281. package/tests/markdownGenerator.test.ts +418 -0
  282. package/tests/output.test.ts +96 -0
  283. package/tests/setup.ts +486 -0
  284. package/tests/unit/appIntegration.test.ts +676 -0
  285. package/tests/unit/appViewState.test.ts +281 -0
  286. package/tests/unit/audioIpcChannels.test.ts +17 -0
  287. package/tests/unit/exportService.test.ts +492 -0
  288. package/tests/unit/hotkeys.test.ts +92 -0
  289. package/tests/unit/navigationPreload.test.ts +94 -0
  290. package/tests/unit/onboardingFlow.test.ts +345 -0
  291. package/tests/unit/permissionManager.test.ts +175 -0
  292. package/tests/unit/permissionManagerExpanded.test.ts +296 -0
  293. package/tests/unit/screenRecordingRenderer.test.ts +368 -0
  294. package/tests/unit/sessionController.test.ts +515 -0
  295. package/tests/unit/tierManager.test.ts +61 -0
  296. package/tests/unit/tierManagerExpanded.test.ts +142 -0
  297. package/tests/unit/transcriptAnalyzer.test.ts +64 -0
  298. package/tsconfig.json +25 -0
  299. package/vitest.config.ts +46 -0
@@ -0,0 +1,11 @@
1
+ {
2
+ "name": "markupr-landing",
3
+ "version": "1.0.0",
4
+ "private": true,
5
+ "scripts": {
6
+ "start": "node server.js"
7
+ },
8
+ "engines": {
9
+ "node": ">=18"
10
+ }
11
+ }
@@ -0,0 +1,12 @@
1
+ {
2
+ "$schema": "https://railway.com/railway.schema.json",
3
+ "build": {
4
+ "builder": "NIXPACKS"
5
+ },
6
+ "deploy": {
7
+ "startCommand": "node server.js",
8
+ "healthcheckPath": "/",
9
+ "restartPolicyType": "ON_FAILURE",
10
+ "restartPolicyMaxRetries": 3
11
+ }
12
+ }
package/site/server.js ADDED
@@ -0,0 +1,31 @@
1
+ const http = require('http');
2
+ const fs = require('fs');
3
+ const path = require('path');
4
+ const zlib = require('zlib');
5
+
6
+ const PORT = process.env.PORT || 3000;
7
+ const indexPath = path.join(__dirname, 'index.html');
8
+ const indexHtml = fs.readFileSync(indexPath);
9
+ const indexGzip = zlib.gzipSync(indexHtml);
10
+
11
+ const headers = {
12
+ 'Content-Type': 'text/html; charset=utf-8',
13
+ 'X-Content-Type-Options': 'nosniff',
14
+ 'Cache-Control': 'public, max-age=3600',
15
+ };
16
+
17
+ const server = http.createServer((req, res) => {
18
+ const acceptGzip = (req.headers['accept-encoding'] || '').includes('gzip');
19
+
20
+ if (acceptGzip) {
21
+ res.writeHead(200, { ...headers, 'Content-Encoding': 'gzip' });
22
+ res.end(indexGzip);
23
+ } else {
24
+ res.writeHead(200, headers);
25
+ res.end(indexHtml);
26
+ }
27
+ });
28
+
29
+ server.listen(PORT, () => {
30
+ console.log(`markupR landing page serving on port ${PORT}`);
31
+ });
@@ -0,0 +1,392 @@
1
+ /**
2
+ * markupr - Auto Updater Manager
3
+ *
4
+ * Handles automatic updates using electron-updater with GitHub Releases.
5
+ *
6
+ * Features:
7
+ * - Check for updates on app launch
8
+ * - Background download of updates
9
+ * - Show release notes to user
10
+ * - User-controlled restart for installation
11
+ * - Download progress indicator
12
+ *
13
+ * The update flow:
14
+ * 1. App launches -> check for updates
15
+ * 2. Update available -> notify renderer with version & release notes
16
+ * 3. User clicks "Download" -> download in background with progress
17
+ * 4. Download complete -> notify renderer that update is ready
18
+ * 5. User clicks "Restart Now" -> quit and install
19
+ */
20
+
21
+ import electronUpdater from 'electron-updater';
22
+ const { autoUpdater } = electronUpdater;
23
+ type UpdateCheckResult = electronUpdater.UpdateCheckResult;
24
+ type UpdateInfo = electronUpdater.UpdateInfo;
25
+ type ProgressInfo = electronUpdater.ProgressInfo;
26
+ import { BrowserWindow, ipcMain, app } from 'electron';
27
+ import { existsSync } from 'fs';
28
+ import { join } from 'path';
29
+ import electronLog from 'electron-log';
30
+ const log = electronLog.default ?? electronLog;
31
+ import { IPC_CHANNELS, type UpdateStatusPayload, type UpdateStatusType } from '../shared/types';
32
+
33
+ // =============================================================================
34
+ // Types
35
+ // =============================================================================
36
+
37
+ interface UpdateManagerState {
38
+ status: UpdateStatusType;
39
+ currentVersion: string;
40
+ availableVersion?: string;
41
+ releaseNotes?: string | null;
42
+ downloadProgress?: number;
43
+ }
44
+
45
+ // =============================================================================
46
+ // AutoUpdater Manager Class
47
+ // =============================================================================
48
+
49
+ class AutoUpdaterManager {
50
+ private mainWindow: BrowserWindow | null = null;
51
+ private state: UpdateManagerState;
52
+ private initialized = false;
53
+ private updaterAvailable = false;
54
+ private autoCheckEnabled = true;
55
+ private isChecking = false;
56
+ private startupCheckTimer: NodeJS.Timeout | null = null;
57
+ private periodicCheckTimer: NodeJS.Timeout | null = null;
58
+ private readonly STARTUP_CHECK_DELAY_MS = 5000;
59
+ private readonly PERIODIC_CHECK_INTERVAL_MS = 4 * 60 * 60 * 1000;
60
+
61
+ constructor() {
62
+ this.state = {
63
+ status: 'idle',
64
+ currentVersion: app.getVersion(),
65
+ };
66
+ }
67
+
68
+ /**
69
+ * Initialize the auto-updater with a reference to the main window
70
+ */
71
+ initialize(window: BrowserWindow): void {
72
+ if (this.initialized) {
73
+ console.warn('[AutoUpdater] Already initialized');
74
+ return;
75
+ }
76
+
77
+ this.mainWindow = window;
78
+ this.initialized = true;
79
+ this.updaterAvailable = this.canUseUpdater();
80
+
81
+ // Set up IPC handlers even if updater is unavailable, so renderer calls remain safe.
82
+ this.setupIPCHandlers();
83
+
84
+ if (!this.updaterAvailable) {
85
+ log.info('[AutoUpdater] Updater disabled (unpackaged app or missing app-update.yml)');
86
+ this.updateState('not-available');
87
+ return;
88
+ }
89
+
90
+ // Configure logging
91
+ log.transports.file.level = 'info';
92
+ autoUpdater.logger = log;
93
+ log.info('[AutoUpdater] Initializing auto-updater');
94
+
95
+ // Configure update behavior
96
+ autoUpdater.autoDownload = false; // Let user decide when to download
97
+ autoUpdater.autoInstallOnAppQuit = true; // Install on quit if downloaded
98
+ autoUpdater.allowDowngrade = false;
99
+ autoUpdater.allowPrerelease = false;
100
+
101
+ // Set up event handlers
102
+ this.setupEventHandlers();
103
+
104
+ this.scheduleAutoChecks();
105
+
106
+ log.info('[AutoUpdater] Initialized successfully');
107
+ }
108
+
109
+ setAutoCheckEnabled(enabled: boolean): void {
110
+ this.autoCheckEnabled = enabled;
111
+ log.info(`[AutoUpdater] Auto-check ${enabled ? 'enabled' : 'disabled'}`);
112
+
113
+ if (!this.initialized || !this.updaterAvailable) {
114
+ return;
115
+ }
116
+
117
+ this.scheduleAutoChecks();
118
+ }
119
+
120
+ private scheduleAutoChecks(): void {
121
+ this.clearAutoCheckTimers();
122
+
123
+ if (!this.autoCheckEnabled) {
124
+ return;
125
+ }
126
+
127
+ this.startupCheckTimer = setTimeout(() => {
128
+ void this.checkForUpdates();
129
+ }, this.STARTUP_CHECK_DELAY_MS);
130
+
131
+ this.periodicCheckTimer = setInterval(() => {
132
+ void this.checkForUpdates();
133
+ }, this.PERIODIC_CHECK_INTERVAL_MS);
134
+ }
135
+
136
+ private clearAutoCheckTimers(): void {
137
+ if (this.startupCheckTimer) {
138
+ clearTimeout(this.startupCheckTimer);
139
+ this.startupCheckTimer = null;
140
+ }
141
+ if (this.periodicCheckTimer) {
142
+ clearInterval(this.periodicCheckTimer);
143
+ this.periodicCheckTimer = null;
144
+ }
145
+ }
146
+
147
+ /**
148
+ * Set up auto-updater event handlers
149
+ */
150
+ private setupEventHandlers(): void {
151
+ // Checking for updates
152
+ autoUpdater.on('checking-for-update', () => {
153
+ log.info('[AutoUpdater] Checking for update...');
154
+ this.updateState('checking');
155
+ });
156
+
157
+ // Update available
158
+ autoUpdater.on('update-available', (info: UpdateInfo) => {
159
+ log.info(`[AutoUpdater] Update available: ${info.version}`);
160
+ this.state.availableVersion = info.version;
161
+ this.state.releaseNotes = this.parseReleaseNotes(info.releaseNotes);
162
+ this.sendStatus('available', {
163
+ version: info.version,
164
+ releaseNotes: this.state.releaseNotes,
165
+ releaseDate: info.releaseDate,
166
+ });
167
+ });
168
+
169
+ // No update available
170
+ autoUpdater.on('update-not-available', (info: UpdateInfo) => {
171
+ log.info(`[AutoUpdater] No update available. Current: ${this.state.currentVersion}, Latest: ${info.version}`);
172
+ this.updateState('not-available');
173
+ });
174
+
175
+ // Download progress
176
+ autoUpdater.on('download-progress', (progress: ProgressInfo) => {
177
+ const percent = Math.round(progress.percent);
178
+ log.info(`[AutoUpdater] Download progress: ${percent}%`);
179
+ this.state.downloadProgress = percent;
180
+ this.sendStatus('downloading', {
181
+ percent: progress.percent,
182
+ bytesPerSecond: progress.bytesPerSecond,
183
+ total: progress.total,
184
+ transferred: progress.transferred,
185
+ });
186
+ });
187
+
188
+ // Update downloaded
189
+ autoUpdater.on('update-downloaded', (info: UpdateInfo) => {
190
+ log.info(`[AutoUpdater] Update downloaded: ${info.version}`);
191
+ this.sendStatus('ready', {
192
+ version: info.version,
193
+ releaseNotes: this.parseReleaseNotes(info.releaseNotes),
194
+ });
195
+ });
196
+
197
+ // Error handling
198
+ autoUpdater.on('error', (error: Error) => {
199
+ if (this.shouldSuppressUpdateError(error)) {
200
+ log.warn('[AutoUpdater] Suppressing expected updater error:', error.message);
201
+ this.updateState('not-available');
202
+ return;
203
+ }
204
+
205
+ log.error('[AutoUpdater] Error:', error);
206
+ this.sendStatus('error', {
207
+ message: error.message,
208
+ });
209
+ });
210
+ }
211
+
212
+ /**
213
+ * Set up IPC handlers for renderer communication
214
+ */
215
+ private setupIPCHandlers(): void {
216
+ // Check for updates
217
+ ipcMain.handle(IPC_CHANNELS.UPDATE_CHECK, async () => {
218
+ return this.checkForUpdates();
219
+ });
220
+
221
+ // Download update
222
+ ipcMain.handle(IPC_CHANNELS.UPDATE_DOWNLOAD, async () => {
223
+ return this.downloadUpdate();
224
+ });
225
+
226
+ // Install update (quit and install)
227
+ ipcMain.handle(IPC_CHANNELS.UPDATE_INSTALL, () => {
228
+ return this.installUpdate();
229
+ });
230
+ }
231
+
232
+ /**
233
+ * Check for available updates
234
+ */
235
+ async checkForUpdates(): Promise<UpdateCheckResult | null> {
236
+ if (!this.updaterAvailable) {
237
+ this.updateState('not-available');
238
+ return null;
239
+ }
240
+ if (this.isChecking) {
241
+ return null;
242
+ }
243
+ if (this.state.status === 'downloading') {
244
+ return null;
245
+ }
246
+
247
+ try {
248
+ this.isChecking = true;
249
+ log.info('[AutoUpdater] Checking for updates');
250
+ const result = await autoUpdater.checkForUpdates();
251
+ return result;
252
+ } catch (error) {
253
+ if (error instanceof Error && this.shouldSuppressUpdateError(error)) {
254
+ log.warn('[AutoUpdater] Update check skipped:', error.message);
255
+ this.updateState('not-available');
256
+ return null;
257
+ }
258
+
259
+ log.error('[AutoUpdater] Check for updates failed:', error);
260
+ this.sendStatus('error', {
261
+ message: error instanceof Error ? error.message : 'Failed to check for updates',
262
+ });
263
+ return null;
264
+ } finally {
265
+ this.isChecking = false;
266
+ }
267
+ }
268
+
269
+ /**
270
+ * Download the available update
271
+ */
272
+ async downloadUpdate(): Promise<void> {
273
+ if (!this.updaterAvailable) {
274
+ this.updateState('not-available');
275
+ return;
276
+ }
277
+
278
+ try {
279
+ log.info('[AutoUpdater] Starting download');
280
+ this.updateState('downloading');
281
+ await autoUpdater.downloadUpdate();
282
+ } catch (error) {
283
+ log.error('[AutoUpdater] Download failed:', error);
284
+ this.sendStatus('error', {
285
+ message: error instanceof Error ? error.message : 'Failed to download update',
286
+ });
287
+ }
288
+ }
289
+
290
+ /**
291
+ * Install the downloaded update (quits app and installs)
292
+ */
293
+ installUpdate(): void {
294
+ if (!this.updaterAvailable) {
295
+ this.updateState('not-available');
296
+ return;
297
+ }
298
+
299
+ log.info('[AutoUpdater] Installing update and restarting');
300
+ // Quit and install
301
+ // isSilent: false - show installer UI
302
+ // isForceRunAfter: true - restart app after update
303
+ autoUpdater.quitAndInstall(false, true);
304
+ }
305
+
306
+ /**
307
+ * Update internal state and send to renderer
308
+ */
309
+ private updateState(status: UpdateStatusType): void {
310
+ this.state.status = status;
311
+ this.sendStatus(status);
312
+ }
313
+
314
+ /**
315
+ * Send status update to renderer process
316
+ */
317
+ private sendStatus(status: UpdateStatusType, data?: Partial<UpdateStatusPayload>): void {
318
+ const payload: UpdateStatusPayload = {
319
+ status,
320
+ ...data,
321
+ };
322
+
323
+ this.mainWindow?.webContents.send(IPC_CHANNELS.UPDATE_STATUS, payload);
324
+ }
325
+
326
+ /**
327
+ * Parse release notes from various formats
328
+ */
329
+ private parseReleaseNotes(notes: string | UpdateInfo['releaseNotes'] | null | undefined): string | null {
330
+ if (!notes) return null;
331
+
332
+ if (typeof notes === 'string') {
333
+ return notes;
334
+ }
335
+
336
+ // Handle array of release notes (multiple releases)
337
+ if (Array.isArray(notes)) {
338
+ return notes
339
+ .map((note) => {
340
+ if (typeof note === 'string') return note;
341
+ return note.note || '';
342
+ })
343
+ .join('\n\n');
344
+ }
345
+
346
+ return null;
347
+ }
348
+
349
+ /**
350
+ * Electron auto-updater requires a packaged app and app-update.yml.
351
+ * Local --dir installs and dev runs do not have updater metadata.
352
+ */
353
+ private canUseUpdater(): boolean {
354
+ if (!app.isPackaged) {
355
+ return false;
356
+ }
357
+
358
+ const configPath = join(process.resourcesPath, 'app-update.yml');
359
+ return existsSync(configPath);
360
+ }
361
+
362
+ /**
363
+ * Suppress known local-install update errors (not actionable for users).
364
+ */
365
+ private shouldSuppressUpdateError(error: Error): boolean {
366
+ const message = error.message.toLowerCase();
367
+ return message.includes('app-update.yml') || message.includes('latest.yml') || message.includes('enoent');
368
+ }
369
+
370
+ /**
371
+ * Get current update state
372
+ */
373
+ getState(): UpdateManagerState {
374
+ return { ...this.state };
375
+ }
376
+
377
+ /**
378
+ * Clean up resources
379
+ */
380
+ destroy(): void {
381
+ this.clearAutoCheckTimers();
382
+ this.mainWindow = null;
383
+ this.initialized = false;
384
+ log.info('[AutoUpdater] Destroyed');
385
+ }
386
+ }
387
+
388
+ // =============================================================================
389
+ // Singleton Export
390
+ // =============================================================================
391
+
392
+ export const autoUpdaterManager = new AutoUpdaterManager();