Skip to content

Voice-to-text dictation app with local (Nvidia Parakeet/Whisper) and cloud models (BYOK). Privacy-first and available cross-platform.

fix(parakeet): Clarify unsupported-macOS guidance and dedupe version compare

Gabriel Steincd4dedc7477d
diff --git a/src/helpers/audioTapManager.js b/src/helpers/audioTapManager.js
index fbd2aac83..9b3b129e1 100644
--- a/src/helpers/audioTapManager.js
+++ b/src/helpers/audioTapManager.js
@@ -2,6 +2,7 @@ const { spawn } = require("child_process");
const fs = require("fs");
const path = require("path");
const debugLogger = require("./debugLogger");
+const { compareVersions } = require("./parakeetCapability");
const ARCH_CPU_TYPE = {
arm64: 0x0100000c,
@@ -14,26 +15,6 @@ const START_TIMEOUT_MS = 3000;
const REQUEST_TIMEOUT_MS = 60000;
const STOP_TIMEOUT_MS = 5000;
-function compareVersions(left, right) {
- const leftParts = String(left)
- .split(".")
- .map((part) => parseInt(part, 10) || 0);
- const rightParts = String(right)
- .split(".")
- .map((part) => parseInt(part, 10) || 0);
- const length = Math.max(leftParts.length, rightParts.length);
-
- for (let index = 0; index < length; index += 1) {
- const leftPart = leftParts[index] || 0;
- const rightPart = rightParts[index] || 0;
- if (leftPart !== rightPart) {
- return leftPart > rightPart ? 1 : -1;
- }
- }
-
- return 0;
-}
-
class AudioTapManager {
constructor() {
this.process = null;
diff --git a/src/helpers/ipcHandlers.js b/src/helpers/ipcHandlers.js
index 50d792b85..e81ce4f31 100644
--- a/src/helpers/ipcHandlers.js
+++ b/src/helpers/ipcHandlers.js
@@ -2620,6 +2620,7 @@ class IPCHandlers {
message: errorMessage,
};
}
+
throw error;
}
});
diff --git a/src/helpers/parakeetCapability.js b/src/helpers/parakeetCapability.js
index 136d53a7e..f72b8e359 100644
--- a/src/helpers/parakeetCapability.js
+++ b/src/helpers/parakeetCapability.js
@@ -30,7 +30,7 @@ function getParakeetCapability({ platform = process.platform, systemVersion } =
return {
supported: false,
code: PARAKEET_UNSUPPORTED_OS_CODE,
- message: `Parakeet requires macOS ${PARAKEET_MINIMUM_MACOS_VERSION} or later. Use Whisper or cloud transcription on this Mac.`,
+ message: `Parakeet requires macOS ${PARAKEET_MINIMUM_MACOS_VERSION} or later. Use cloud transcription (or Whisper where supported) on this Mac.`,
minimumMacOSVersion: PARAKEET_MINIMUM_MACOS_VERSION,
};
}
diff --git a/test/helpers/parakeetCapability.test.js b/test/helpers/parakeetCapability.test.js
index b89dc1c0a..0ad72d4fd 100644
--- a/test/helpers/parakeetCapability.test.js
+++ b/test/helpers/parakeetCapability.test.js
@@ -17,11 +17,21 @@ test("Parakeet rejects macOS below the packaged ONNX Runtime floor", () => {
supported: false,
code: "PARAKEET_UNSUPPORTED_OS",
message:
- "Parakeet requires macOS 15.5 or later. Use Whisper or cloud transcription on this Mac.",
+ "Parakeet requires macOS 15.5 or later. Use cloud transcription (or Whisper where supported) on this Mac.",
minimumMacOSVersion: "15.5",
});
});
+test("Parakeet treats a missing system-version API as supported (plain Node)", (t) => {
+ const descriptor = Object.getOwnPropertyDescriptor(process, "getSystemVersion");
+ delete process.getSystemVersion;
+ t.after(() => {
+ if (descriptor) Object.defineProperty(process, "getSystemVersion", descriptor);
+ });
+
+ assert.deepEqual(getParakeetCapability({ platform: "darwin" }), { supported: true });
+});
+
test("Parakeet capability gating does not change Windows or Linux", () => {
for (const platform of ["win32", "linux"]) {
assert.deepEqual(getParakeetCapability({ platform, systemVersion: "1.0" }), {
diff --git a/test/helpers/transcriptionModelDownloadStatus.test.js b/test/helpers/transcriptionModelDownloadStatus.test.js
index 4f49e0174..caa6adb7f 100644
--- a/test/helpers/transcriptionModelDownloadStatus.test.js
+++ b/test/helpers/transcriptionModelDownloadStatus.test.js
@@ -56,7 +56,7 @@ test("Parakeet reports its packaged runtime as unsupported on macOS below 15.5",
supported: false,
code: "PARAKEET_UNSUPPORTED_OS",
message:
- "Parakeet requires macOS 15.5 or later. Use Whisper or cloud transcription on this Mac.",
+ "Parakeet requires macOS 15.5 or later. Use cloud transcription (or Whisper where supported) on this Mac.",
minimumMacOSVersion: "15.5",
});
});
@@ -77,7 +77,7 @@ test("Parakeet refuses explicit server startup on unsupported macOS", async (t)
success: false,
code: "PARAKEET_UNSUPPORTED_OS",
reason:
- "Parakeet requires macOS 15.5 or later. Use Whisper or cloud transcription on this Mac.",
+ "Parakeet requires macOS 15.5 or later. Use cloud transcription (or Whisper where supported) on this Mac.",
});
assert.equal(startCalls, 0);
});
@@ -102,7 +102,7 @@ test("Parakeet refuses a missing-model download before filesystem or download se
(error) =>
error.code === "PARAKEET_UNSUPPORTED_OS" &&
error.message ===
- "Parakeet requires macOS 15.5 or later. Use Whisper or cloud transcription on this Mac."
+ "Parakeet requires macOS 15.5 or later. Use cloud transcription (or Whisper where supported) on this Mac."
);
assert.equal(modelStatusChecks, 0);
assert.equal(modelDirectoryChecks, 0);