electron-native-speech-backend-macos 0.1.0

package/dist/availability.d.ts

@@ -0,0 +1,3 @@
+import type { SpeechAvailability } from "electron-native-speech";
+export declare function checkAvailability(): Promise<SpeechAvailability>;
+//# sourceMappingURL=availability.d.ts.map

package/dist/availability.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"availability.d.ts","sourceRoot":"","sources":["../src/availability.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAA;AAYhE,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,kBAAkB,CAAC,CAqCrE"}

package/dist/availability.js

@@ -0,0 +1,42 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.checkAvailability = checkAvailability;
+const helper_process_1 = require("./helper-process");
+async function checkAvailability() {
+    if (process.platform !== "darwin") {
+        return {
+            available: false,
+            platform: process.platform,
+            reason: "electron-native-speech macOS backend requires macOS",
+        };
+    }
+    const helper = (0, helper_process_1.getHelperProcess)();
+    try {
+        await helper.start();
+    }
+    catch (err) {
+        return {
+            available: false,
+            platform: "darwin",
+            reason: err instanceof Error ? err.message : String(err),
+        };
+    }
+    try {
+        const raw = (await helper.send({ command: "checkAvailability" }, 5000));
+        return {
+            available: raw.available,
+            platform: raw.platform ?? "darwin",
+            mode: raw.mode,
+            reason: raw.reason,
+            details: raw.details,
+        };
+    }
+    catch {
+        return {
+            available: false,
+            platform: "darwin",
+            reason: "Failed to query SpeechHelper availability",
+        };
+    }
+}
+//# sourceMappingURL=availability.js.map

package/dist/availability.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"availability.js","sourceRoot":"","sources":["../src/availability.ts"],"names":[],"mappings":";;AAYA,8CAqCC;AAhDD,qDAAmD;AAW5C,KAAK,UAAU,iBAAiB;IACrC,IAAI,OAAO,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;QAClC,OAAO;YACL,SAAS,EAAE,KAAK;YAChB,QAAQ,EAAE,OAAO,CAAC,QAAQ;YAC1B,MAAM,EAAE,qDAAqD;SAC9D,CAAA;IACH,CAAC;IAED,MAAM,MAAM,GAAG,IAAA,iCAAgB,GAAE,CAAA;IAEjC,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,KAAK,EAAE,CAAA;IACtB,CAAC;IAAC,OAAO,GAAY,EAAE,CAAC;QACtB,OAAO;YACL,SAAS,EAAE,KAAK;YAChB,QAAQ,EAAE,QAAQ;YAClB,MAAM,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;SACzD,CAAA;IACH,CAAC;IAED,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,CAAC,MAAM,MAAM,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,mBAAmB,EAAE,EAAE,IAAI,CAAC,CAAyB,CAAA;QAC/F,OAAO;YACL,SAAS,EAAE,GAAG,CAAC,SAAS;YACxB,QAAQ,EAAE,GAAG,CAAC,QAAQ,IAAI,QAAQ;YAClC,IAAI,EAAE,GAAG,CAAC,IAAI;YACd,MAAM,EAAE,GAAG,CAAC,MAAM;YAClB,OAAO,EAAE,GAAG,CAAC,OAAO;SACrB,CAAA;IACH,CAAC;IAAC,MAAM,CAAC;QACP,OAAO;YACL,SAAS,EAAE,KAAK;YAChB,QAAQ,EAAE,QAAQ;YAClB,MAAM,EAAE,2CAA2C;SACpD,CAAA;IACH,CAAC;AACH,CAAC"}

package/dist/file-transcriber.d.ts

@@ -0,0 +1,3 @@
+import type { FileTranscriptionOptions, FileTranscriptionResult } from "electron-native-speech";
+export declare function transcribeFile(options: FileTranscriptionOptions): Promise<FileTranscriptionResult>;
+//# sourceMappingURL=file-transcriber.d.ts.map

package/dist/file-transcriber.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-transcriber.d.ts","sourceRoot":"","sources":["../src/file-transcriber.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,wBAAwB,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAA;AA0B/F,wBAAsB,cAAc,CAClC,OAAO,EAAE,wBAAwB,GAChC,OAAO,CAAC,uBAAuB,CAAC,CAyClC"}

package/dist/file-transcriber.js

@@ -0,0 +1,79 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.transcribeFile = transcribeFile;
+const fs = __importStar(require("fs"));
+const electron_native_speech_1 = require("electron-native-speech");
+const helper_process_1 = require("./helper-process");
+async function transcribeFile(options) {
+    const { filePath, locale } = options;
+    if (!filePath) {
+        throw new electron_native_speech_1.SpeechRecognitionError({ code: "unsupported-input", message: "filePath is required" });
+    }
+    if (!fs.existsSync(filePath)) {
+        throw new electron_native_speech_1.SpeechRecognitionError({
+            code: "unsupported-input",
+            message: `File not found: ${filePath}`,
+        });
+    }
+    const helper = (0, helper_process_1.getHelperProcess)();
+    await helper.start();
+    let raw;
+    try {
+        raw = await helper.send({ command: "transcribeFile", filePath, locale: locale ?? null }, 
+        // Large files can take a while — allow up to 5 minutes
+        5 * 60 * 1000);
+    }
+    catch (err) {
+        if (isErrorResponse(err)) {
+            throw new electron_native_speech_1.SpeechRecognitionError({
+                code: err.code,
+                message: err.message,
+                details: err.details,
+            });
+        }
+        throw err;
+    }
+    const resp = raw;
+    return {
+        segments: resp.segments ?? [],
+        durationMs: resp.durationMs,
+        locale: resp.locale,
+    };
+}
+function isErrorResponse(v) {
+    return (typeof v === "object" && v !== null && "type" in v && v.type === "error");
+}
+//# sourceMappingURL=file-transcriber.js.map

package/dist/file-transcriber.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-transcriber.js","sourceRoot":"","sources":["../src/file-transcriber.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA2BA,wCA2CC;AAtED,uCAAwB;AAExB,mEAA+D;AAC/D,qDAAmD;AAwB5C,KAAK,UAAU,cAAc,CAClC,OAAiC;IAEjC,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,OAAO,CAAA;IAEpC,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,IAAI,+CAAsB,CAAC,EAAE,IAAI,EAAE,mBAAmB,EAAE,OAAO,EAAE,sBAAsB,EAAE,CAAC,CAAA;IAClG,CAAC;IAED,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC7B,MAAM,IAAI,+CAAsB,CAAC;YAC/B,IAAI,EAAE,mBAAmB;YACzB,OAAO,EAAE,mBAAmB,QAAQ,EAAE;SACvC,CAAC,CAAA;IACJ,CAAC;IAED,MAAM,MAAM,GAAG,IAAA,iCAAgB,GAAE,CAAA;IACjC,MAAM,MAAM,CAAC,KAAK,EAAE,CAAA;IAEpB,IAAI,GAAY,CAAA;IAChB,IAAI,CAAC;QACH,GAAG,GAAG,MAAM,MAAM,CAAC,IAAI,CACrB,EAAE,OAAO,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,IAAI,IAAI,EAAE;QAC/D,uDAAuD;QACvD,CAAC,GAAG,EAAE,GAAG,IAAI,CACd,CAAA;IACH,CAAC;IAAC,OAAO,GAAY,EAAE,CAAC;QACtB,IAAI,eAAe,CAAC,GAAG,CAAC,EAAE,CAAC;YACzB,MAAM,IAAI,+CAAsB,CAAC;gBAC/B,IAAI,EAAE,GAAG,CAAC,IAAa;gBACvB,OAAO,EAAE,GAAG,CAAC,OAAO;gBACpB,OAAO,EAAE,GAAG,CAAC,OAAO;aACrB,CAAC,CAAA;QACJ,CAAC;QACD,MAAM,GAAG,CAAA;IACX,CAAC;IAED,MAAM,IAAI,GAAG,GAA6B,CAAA;IAC1C,OAAO;QACL,QAAQ,EAAE,IAAI,CAAC,QAAQ,IAAI,EAAE;QAC7B,UAAU,EAAE,IAAI,CAAC,UAAU;QAC3B,MAAM,EAAE,IAAI,CAAC,MAAM;KACpB,CAAA;AACH,CAAC;AAED,SAAS,eAAe,CAAC,CAAU;IACjC,OAAO,CACL,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,IAAI,IAAI,MAAM,IAAI,CAAC,IAAK,CAAmB,CAAC,IAAI,KAAK,OAAO,CAC5F,CAAA;AACH,CAAC"}

package/dist/helper-process.d.ts

@@ -0,0 +1,59 @@
+import { EventEmitter } from "events";
+export type HelperMessage = {
+    id: string;
+    type: "result";
+    [key: string]: unknown;
+} | {
+    id: string;
+    type: "event";
+    event: string;
+    [key: string]: unknown;
+} | {
+    id: string;
+    type: "error";
+    code: string;
+    message: string;
+    details?: unknown;
+} | {
+    type: "ready";
+} | {
+    type: "log";
+    level: "debug" | "info" | "warn" | "error";
+    message: string;
+};
+/**
+ * Manages a single persistent SpeechHelper process.
+ *
+ * The process starts once and handles all requests for the lifetime of the
+ * backend. This avoids per-call startup overhead (~200–400 ms cold start).
+ *
+ * Communication: newline-delimited JSON over stdin/stdout.
+ */
+export declare class HelperProcess extends EventEmitter {
+    private proc;
+    private pending;
+    private buffer;
+    private _ready;
+    private _starting;
+    private _idCounter;
+    private get binaryPath();
+    /** Start the helper process. Idempotent — safe to call multiple times. */
+    start(): Promise<void>;
+    private handleMessage;
+    /**
+     * Send a command and wait for its response.
+     * @param timeoutMs  Maximum wait time. Defaults to 60 s for file transcription.
+     */
+    send(command: Record<string, unknown>, timeoutMs?: number): Promise<unknown>;
+    /**
+     * Send a command that will produce streaming events rather than a single response.
+     * Returns the request ID so the caller can subscribe to `event:<id>` emissions.
+     */
+    sendStreaming(command: Record<string, unknown>): string;
+    /** Send a fire-and-forget control message (no response expected) */
+    sendControl(command: Record<string, unknown>): void;
+    dispose(): Promise<void>;
+}
+export declare function getHelperProcess(): HelperProcess;
+export declare function disposeHelperProcess(): Promise<void>;
+//# sourceMappingURL=helper-process.d.ts.map

package/dist/helper-process.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helper-process.d.ts","sourceRoot":"","sources":["../src/helper-process.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAA;AAErC,MAAM,MAAM,aAAa,GACrB;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CAAE,GACtD;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CAAE,GACpE;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,GAC/E;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,GACjB;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAA;AAQhF;;;;;;;GAOG;AACH,qBAAa,aAAc,SAAQ,YAAY;IAC7C,OAAO,CAAC,IAAI,CAA8C;IAC1D,OAAO,CAAC,OAAO,CAAoC;IACnD,OAAO,CAAC,MAAM,CAAK;IACnB,OAAO,CAAC,MAAM,CAAQ;IACtB,OAAO,CAAC,SAAS,CAA6B;IAC9C,OAAO,CAAC,UAAU,CAAI;IAEtB,OAAO,KAAK,UAAU,GAqBrB;IAED,0EAA0E;IAC1E,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IA2EtB,OAAO,CAAC,aAAa;IAuCrB;;;OAGG;IACH,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,SAAS,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC;IAoB5E;;;OAGG;IACH,aAAa,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM;IAWvD,oEAAoE;IACpE,WAAW,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAM7C,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAgB/B;AAKD,wBAAgB,gBAAgB,IAAI,aAAa,CAGhD;AAED,wBAAsB,oBAAoB,IAAI,OAAO,CAAC,IAAI,CAAC,CAK1D"}

package/dist/helper-process.js

@@ -0,0 +1,257 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HelperProcess = void 0;
+exports.getHelperProcess = getHelperProcess;
+exports.disposeHelperProcess = disposeHelperProcess;
+const child_process_1 = require("child_process");
+const path = __importStar(require("path"));
+const fs = __importStar(require("fs"));
+const events_1 = require("events");
+/**
+ * Manages a single persistent SpeechHelper process.
+ *
+ * The process starts once and handles all requests for the lifetime of the
+ * backend. This avoids per-call startup overhead (~200–400 ms cold start).
+ *
+ * Communication: newline-delimited JSON over stdin/stdout.
+ */
+class HelperProcess extends events_1.EventEmitter {
+    constructor() {
+        super(...arguments);
+        this.proc = null;
+        this.pending = new Map();
+        this.buffer = "";
+        this._ready = false;
+        this._starting = null;
+        this._idCounter = 0;
+    }
+    get binaryPath() {
+        // In development: packages/backend-macos/bin/SpeechHelper
+        // In packaged app: resources/SpeechHelper (set by electron-builder extraResources)
+        const candidates = [
+            // packaged Electron app (process.resourcesPath is injected by Electron)
+            process.resourcesPath
+                ? path.join(process.resourcesPath, "SpeechHelper")
+                : null,
+            // workspace development
+            path.join(__dirname, "..", "bin", "SpeechHelper"),
+            // running from dist/
+            path.join(__dirname, "..", "..", "bin", "SpeechHelper"),
+        ].filter(Boolean);
+        for (const p of candidates) {
+            if (fs.existsSync(p))
+                return p;
+        }
+        throw new Error(`SpeechHelper binary not found. Run: npm run build:swift (in packages/backend-macos)`);
+    }
+    /** Start the helper process. Idempotent — safe to call multiple times. */
+    start() {
+        if (this._ready)
+            return Promise.resolve();
+        if (this._starting)
+            return this._starting;
+        this._starting = new Promise((resolve, reject) => {
+            let binary;
+            try {
+                binary = this.binaryPath;
+            }
+            catch (err) {
+                reject(err);
+                return;
+            }
+            this.proc = (0, child_process_1.spawn)(binary, [], {
+                stdio: ["pipe", "pipe", "pipe"],
+            });
+            const readyTimeout = setTimeout(() => {
+                reject(new Error("SpeechHelper did not become ready within 5 seconds"));
+            }, 5000);
+            this.proc.stdout.setEncoding("utf8");
+            this.proc.stdout.on("data", (chunk) => {
+                this.buffer += chunk;
+                const lines = this.buffer.split("\n");
+                this.buffer = lines.pop() ?? "";
+                for (const line of lines) {
+                    if (line.trim())
+                        this.handleMessage(line);
+                }
+            });
+            this.proc.stderr.setEncoding("utf8");
+            this.proc.stderr.on("data", (chunk) => {
+                // Surface helper stderr as debug info only
+                for (const line of chunk.split("\n")) {
+                    if (line.trim()) {
+                        this.emit("log", { level: "debug", message: line.trim() });
+                    }
+                }
+            });
+            this.proc.once("spawn", () => {
+                // Process spawned — wait for the ready message
+            });
+            this.proc.once("error", (err) => {
+                clearTimeout(readyTimeout);
+                this._starting = null;
+                reject(err);
+            });
+            this.proc.once("exit", (code, signal) => {
+                this._ready = false;
+                this._starting = null;
+                this.proc = null;
+                // Reject any pending requests
+                for (const [, req] of this.pending) {
+                    clearTimeout(req.timeout);
+                    req.reject(new Error(`SpeechHelper exited (code=${code}, signal=${signal})`));
+                }
+                this.pending.clear();
+                this.emit("exit", code, signal);
+            });
+            this.once("ready", () => {
+                clearTimeout(readyTimeout);
+                this._ready = true;
+                this._starting = null;
+                resolve();
+            });
+        });
+        return this._starting;
+    }
+    handleMessage(line) {
+        let msg;
+        try {
+            msg = JSON.parse(line);
+        }
+        catch {
+            return;
+        }
+        if (msg.type === "ready") {
+            this.emit("ready");
+            return;
+        }
+        if (msg.type === "log") {
+            this.emit("log", msg);
+            return;
+        }
+        // Event messages are emitted to subscribers (live session events)
+        if (msg.type === "event" && "id" in msg) {
+            this.emit(`event:${msg.id}`, msg);
+            return;
+        }
+        // Result or error for a pending request
+        if ("id" in msg && msg.id) {
+            const pending = this.pending.get(msg.id);
+            if (!pending)
+                return;
+            clearTimeout(pending.timeout);
+            this.pending.delete(msg.id);
+            if (msg.type === "error") {
+                pending.reject(msg);
+            }
+            else {
+                pending.resolve(msg);
+            }
+        }
+    }
+    /**
+     * Send a command and wait for its response.
+     * @param timeoutMs  Maximum wait time. Defaults to 60 s for file transcription.
+     */
+    send(command, timeoutMs = 60000) {
+        return new Promise((resolve, reject) => {
+            if (!this._ready || !this.proc) {
+                reject(new Error("SpeechHelper is not running"));
+                return;
+            }
+            const id = String(++this._idCounter);
+            const payload = JSON.stringify({ ...command, id }) + "\n";
+            const timeout = setTimeout(() => {
+                this.pending.delete(id);
+                reject(new Error(`SpeechHelper command timed out after ${timeoutMs}ms`));
+            }, timeoutMs);
+            this.pending.set(id, { resolve, reject, timeout });
+            this.proc.stdin.write(payload);
+        });
+    }
+    /**
+     * Send a command that will produce streaming events rather than a single response.
+     * Returns the request ID so the caller can subscribe to `event:<id>` emissions.
+     */
+    sendStreaming(command) {
+        if (!this._ready || !this.proc) {
+            throw new Error("SpeechHelper is not running");
+        }
+        const id = String(++this._idCounter);
+        const payload = JSON.stringify({ ...command, id }) + "\n";
+        this.proc.stdin.write(payload);
+        return id;
+    }
+    /** Send a fire-and-forget control message (no response expected) */
+    sendControl(command) {
+        if (!this._ready || !this.proc)
+            return;
+        const payload = JSON.stringify(command) + "\n";
+        this.proc.stdin.write(payload);
+    }
+    async dispose() {
+        if (!this.proc)
+            return;
+        this.sendControl({ command: "shutdown" });
+        await new Promise((resolve) => {
+            const t = setTimeout(() => {
+                this.proc?.kill("SIGTERM");
+                resolve();
+            }, 2000);
+            this.proc?.once("exit", () => {
+                clearTimeout(t);
+                resolve();
+            });
+        });
+        this.proc = null;
+        this._ready = false;
+    }
+}
+exports.HelperProcess = HelperProcess;
+// Singleton — one helper process for the lifetime of the main process
+let _instance = null;
+function getHelperProcess() {
+    if (!_instance)
+        _instance = new HelperProcess();
+    return _instance;
+}
+async function disposeHelperProcess() {
+    if (_instance) {
+        await _instance.dispose();
+        _instance = null;
+    }
+}
+//# sourceMappingURL=helper-process.js.map

package/dist/helper-process.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"helper-process.js","sourceRoot":"","sources":["../src/helper-process.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,13 @@
+import type { ISpeechBackend, SpeechAvailability, FileTranscriptionOptions, FileTranscriptionResult, SpeechSession } from "electron-native-speech";
+import { checkAvailability } from "./availability";
+import { transcribeFile } from "./file-transcriber";
+import { MacOSLiveSpeechSession } from "./live-session";
+import { disposeHelperProcess } from "./helper-process";
+export declare class MacOSSpeechBackend implements ISpeechBackend {
+    checkAvailability(): Promise<SpeechAvailability>;
+    transcribeFile(options: FileTranscriptionOptions): Promise<FileTranscriptionResult>;
+    createSession(): Promise<SpeechSession>;
+    dispose(): Promise<void>;
+}
+export { checkAvailability, transcribeFile, MacOSLiveSpeechSession, disposeHelperProcess };
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,EACd,kBAAkB,EAClB,wBAAwB,EACxB,uBAAuB,EACvB,aAAa,EACd,MAAM,wBAAwB,CAAA;AAC/B,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAA;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAA;AACnD,OAAO,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAA;AACvD,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAA;AAEvD,qBAAa,kBAAmB,YAAW,cAAc;IACjD,iBAAiB,IAAI,OAAO,CAAC,kBAAkB,CAAC;IAIhD,cAAc,CAAC,OAAO,EAAE,wBAAwB,GAAG,OAAO,CAAC,uBAAuB,CAAC;IAInF,aAAa,IAAI,OAAO,CAAC,aAAa,CAAC;IAIvC,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAG/B;AAGD,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,sBAAsB,EAAE,oBAAoB,EAAE,CAAA"}

package/dist/index.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.disposeHelperProcess = exports.MacOSLiveSpeechSession = exports.transcribeFile = exports.checkAvailability = exports.MacOSSpeechBackend = void 0;
+const availability_1 = require("./availability");
+Object.defineProperty(exports, "checkAvailability", { enumerable: true, get: function () { return availability_1.checkAvailability; } });
+const file_transcriber_1 = require("./file-transcriber");
+Object.defineProperty(exports, "transcribeFile", { enumerable: true, get: function () { return file_transcriber_1.transcribeFile; } });
+const live_session_1 = require("./live-session");
+Object.defineProperty(exports, "MacOSLiveSpeechSession", { enumerable: true, get: function () { return live_session_1.MacOSLiveSpeechSession; } });
+const helper_process_1 = require("./helper-process");
+Object.defineProperty(exports, "disposeHelperProcess", { enumerable: true, get: function () { return helper_process_1.disposeHelperProcess; } });
+class MacOSSpeechBackend {
+    async checkAvailability() {
+        return (0, availability_1.checkAvailability)();
+    }
+    async transcribeFile(options) {
+        return (0, file_transcriber_1.transcribeFile)(options);
+    }
+    async createSession() {
+        return new live_session_1.MacOSLiveSpeechSession();
+    }
+    async dispose() {
+        await (0, helper_process_1.disposeHelperProcess)();
+    }
+}
+exports.MacOSSpeechBackend = MacOSSpeechBackend;
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAOA,iDAAkD;AAwBzC,kGAxBA,gCAAiB,OAwBA;AAvB1B,yDAAmD;AAuBvB,+FAvBnB,iCAAc,OAuBmB;AAtB1C,iDAAuD;AAsBX,uGAtBnC,qCAAsB,OAsBmC;AArBlE,qDAAuD;AAqBa,qGArB3D,qCAAoB,OAqB2D;AAnBxF,MAAa,kBAAkB;IAC7B,KAAK,CAAC,iBAAiB;QACrB,OAAO,IAAA,gCAAiB,GAAE,CAAA;IAC5B,CAAC;IAED,KAAK,CAAC,cAAc,CAAC,OAAiC;QACpD,OAAO,IAAA,iCAAc,EAAC,OAAO,CAAC,CAAA;IAChC,CAAC;IAED,KAAK,CAAC,aAAa;QACjB,OAAO,IAAI,qCAAsB,EAAE,CAAA;IACrC,CAAC;IAED,KAAK,CAAC,OAAO;QACX,MAAM,IAAA,qCAAoB,GAAE,CAAA;IAC9B,CAAC;CACF;AAhBD,gDAgBC"}

package/dist/live-session.d.ts

@@ -0,0 +1,18 @@
+import type { SpeechSession, SpeechSessionStartOptions, SpeechSessionState, LiveSpeechResult, SpeechError } from "electron-native-speech";
+export declare class MacOSLiveSpeechSession implements SpeechSession {
+    private emitter;
+    private sessionId;
+    private unsubscribe;
+    private _state;
+    start(options?: SpeechSessionStartOptions): Promise<void>;
+    stop(): Promise<void>;
+    abort(): Promise<void>;
+    dispose(): Promise<void>;
+    on(event: "result", listener: (result: LiveSpeechResult) => void): () => void;
+    on(event: "error", listener: (error: SpeechError) => void): () => void;
+    on(event: "state", listener: (state: SpeechSessionState) => void): () => void;
+    private setState;
+    private cleanup;
+    private waitForStopped;
+}
+//# sourceMappingURL=live-session.d.ts.map

package/dist/live-session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"live-session.d.ts","sourceRoot":"","sources":["../src/live-session.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,aAAa,EACb,yBAAyB,EACzB,kBAAkB,EAClB,gBAAgB,EAChB,WAAW,EACZ,MAAM,wBAAwB,CAAA;AAY/B,qBAAa,sBAAuB,YAAW,aAAa;IAC1D,OAAO,CAAC,OAAO,CAAqB;IACpC,OAAO,CAAC,SAAS,CAAsB;IACvC,OAAO,CAAC,WAAW,CAA4B;IAC/C,OAAO,CAAC,MAAM,CAA6B;IAErC,KAAK,CAAC,OAAO,GAAE,yBAA8B,GAAG,OAAO,CAAC,IAAI,CAAC;IA2E7D,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAQrB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAOtB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAQ9B,EAAE,CAAC,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC,MAAM,EAAE,gBAAgB,KAAK,IAAI,GAAG,MAAM,IAAI;IAC7E,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,GAAG,MAAM,IAAI;IACtE,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,kBAAkB,KAAK,IAAI,GAAG,MAAM,IAAI;IAO7E,OAAO,CAAC,QAAQ;IAMhB,OAAO,CAAC,OAAO;IAMf,OAAO,CAAC,cAAc;CASvB"}

package/dist/live-session.js

@@ -0,0 +1,136 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MacOSLiveSpeechSession = void 0;
+const events_1 = require("events");
+const electron_native_speech_1 = require("electron-native-speech");
+const helper_process_1 = require("./helper-process");
+class MacOSLiveSpeechSession {
+    constructor() {
+        this.emitter = new events_1.EventEmitter();
+        this.sessionId = null;
+        this.unsubscribe = null;
+        this._state = "idle";
+    }
+    async start(options = {}) {
+        if (this._state !== "idle" && this._state !== "stopped") {
+            throw new electron_native_speech_1.SpeechRecognitionError({
+                code: "invalid-state",
+                message: `Cannot start session in state "${this._state}"`,
+            });
+        }
+        this.setState("starting");
+        const helper = (0, helper_process_1.getHelperProcess)();
+        await helper.start();
+        // Send the start command and get back a streaming session ID
+        const sessionId = helper.sendStreaming({
+            command: "startSession",
+            locale: options.locale ?? null,
+            interimResults: options.interimResults ?? true,
+            continuous: options.continuous ?? false,
+        });
+        this.sessionId = sessionId;
+        // Subscribe to events from the helper for this session
+        const onEvent = (msg) => {
+            switch (msg.event) {
+                case "result":
+                    if (msg.result)
+                        this.emitter.emit("result", msg.result);
+                    break;
+                case "state":
+                    if (msg.state)
+                        this.setState(msg.state);
+                    break;
+                case "error":
+                    if (msg.error)
+                        this.emitter.emit("error", msg.error);
+                    break;
+                case "stopped":
+                    this.setState("stopped");
+                    this.cleanup();
+                    break;
+            }
+        };
+        helper.on(`event:${sessionId}`, onEvent);
+        this.unsubscribe = () => helper.off(`event:${sessionId}`, onEvent);
+        // Wait for the "listening" state (or error)
+        await new Promise((resolve, reject) => {
+            const onState = (state) => {
+                if (state === "listening") {
+                    this.emitter.off("state", onState);
+                    this.emitter.off("error", onError);
+                    resolve();
+                }
+            };
+            const onError = (err) => {
+                this.emitter.off("state", onState);
+                this.emitter.off("error", onError);
+                reject(new electron_native_speech_1.SpeechRecognitionError(err));
+            };
+            // Timeout safety
+            const t = setTimeout(() => {
+                this.emitter.off("state", onState);
+                this.emitter.off("error", onError);
+                reject(new electron_native_speech_1.SpeechRecognitionError({ code: "backend-failure", message: "Session start timed out" }));
+            }, 8000);
+            this.emitter.on("state", onState);
+            this.emitter.on("error", onError);
+            // Clear timeout on resolution
+            const origResolve = resolve;
+            resolve = () => { clearTimeout(t); origResolve(); };
+        });
+    }
+    async stop() {
+        if (!this.sessionId)
+            return;
+        if (this._state !== "listening" && this._state !== "starting")
+            return;
+        this.setState("stopping");
+        (0, helper_process_1.getHelperProcess)().sendControl({ command: "stopSession", sessionId: this.sessionId });
+        await this.waitForStopped();
+    }
+    async abort() {
+        if (!this.sessionId)
+            return;
+        (0, helper_process_1.getHelperProcess)().sendControl({ command: "abortSession", sessionId: this.sessionId });
+        this.setState("stopped");
+        this.cleanup();
+    }
+    async dispose() {
+        if (this._state === "listening" || this._state === "starting") {
+            await this.abort();
+        }
+        this.emitter.removeAllListeners();
+        this.cleanup();
+    }
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    on(event, listener) {
+        this.emitter.on(event, listener);
+        return () => this.emitter.off(event, listener);
+    }
+    setState(state) {
+        if (this._state === state)
+            return;
+        this._state = state;
+        this.emitter.emit("state", state);
+    }
+    cleanup() {
+        this.unsubscribe?.();
+        this.unsubscribe = null;
+        this.sessionId = null;
+    }
+    waitForStopped() {
+        if (this._state === "stopped")
+            return Promise.resolve();
+        return new Promise((resolve) => {
+            const off = this.on("state", (state) => {
+                if (state === "stopped" || state === "error") {
+                    off();
+                    resolve();
+                }
+            });
+            setTimeout(() => { off(); resolve(); }, 5000);
+        });
+    }
+}
+exports.MacOSLiveSpeechSession = MacOSLiveSpeechSession;
+//# sourceMappingURL=live-session.js.map

package/dist/live-session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"live-session.js","sourceRoot":"","sources":["../src/live-session.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,25 @@
+{
+  "name": "electron-native-speech-backend-macos",
+  "version": "0.1.0",
+  "description": "macOS backend for electron-native-speech using Apple Speech framework",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist/",
+    "bin/"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "build:swift": "cd swift && swift build -c release --arch arm64 && swift build -c release --arch x86_64 && mkdir -p ../bin && lipo -create .build/arm64-apple-macosx/release/SpeechHelper .build/x86_64-apple-macosx/release/SpeechHelper -output ../bin/SpeechHelper",
+    "build:all": "npm run build:swift && npm run build",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "clean": "rm -rf dist bin"
+  },
+  "license": "MIT",
+  "devDependencies": {
+    "typescript": "^5.4.0"
+  },
+  "dependencies": {
+    "electron-native-speech": "*"
+  }
+}