@sayue_ltr/fleq 1.50.1 → 2.0.0

package/dist/engine/notification/sound-player.js

@@ -35,7 +35,13 @@ var __importStar = (this && this.__importStar) || (function () {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.SOUND_LEVELS = void 0;
 exports.isSoundLevel = isSoundLevel;
+exports.clearCustomSoundCache = clearCustomSoundCache;
+exports._setUptimeProviderForTest = _setUptimeProviderForTest;
+exports._nowMsForTest = _nowMsForTest;
 exports.playSound = playSound;
+exports.dispose = dispose;
+exports.resetSoundPlayer = resetSoundPlayer;
+exports.checkSoundBackend = checkSoundBackend;
 const child_process_1 = require("child_process");
 const fs = __importStar(require("fs"));
 const path = __importStar(require("path"));
@@ -82,143 +88,446 @@ const LINUX_CANBERRA_EVENTS = {
     info: "dialog-information",
     cancel: "bell",
 };
+// ── findCustomSound キャッシュ ──
+/** findCustomSound の結果キャッシュ (null = 存在しない, undefined = 未検索) */
+const customSoundCache = new Map();
 /**
  * カスタム効果音ファイルのパスを返す。見つからなければ null。
- * mp3 → wav の順で探索する。
+ * mp3 → wav の順で探索する。結果はキャッシュして再利用する。
  */
 function findCustomSound(level) {
+    if (customSoundCache.has(level)) {
+        return customSoundCache.get(level);
+    }
     const baseName = CUSTOM_SOUND_FILES[level];
     for (const ext of SUPPORTED_EXTENSIONS) {
         const filePath = path.join(CUSTOM_SOUNDS_DIR, baseName + ext);
         if (fs.existsSync(filePath)) {
+            customSoundCache.set(level, filePath);
             return filePath;
         }
     }
+    customSoundCache.set(level, null);
     return null;
 }
+/** サウンドキャッシュをクリアする (テスト用) */
+function clearCustomSoundCache() {
+    customSoundCache.clear();
+    windowsSoundCache.clear();
+}
+// ── 起動ウィンドウ用の単調時計 ──
+/** 起動後リトライのウィンドウ (ms) */
+const STARTUP_WINDOW_MS = 60_000;
+/** 失敗時のリトライ待機 (ms) */
+const RETRY_DELAY_MS = 20_000;
+/** テスト用に差し替え可能な uptime プロバイダ (秒) */
+let uptimeProvider = null;
+/** プロセス起動からの経過ミリ秒 (Date.now の非単調性を避ける) */
+function nowMs() {
+    const seconds = uptimeProvider != null ? uptimeProvider() : process.uptime();
+    return Math.floor(seconds * 1000);
+}
+/** テスト用: uptime プロバイダを差し替える (null で本物に戻す) */
+function _setUptimeProviderForTest(fn) {
+    uptimeProvider = fn;
+}
+/** テスト用: 現在の nowMs 値を返す */
+function _nowMsForTest() {
+    return nowMs();
+}
+// ── 有界キュー ──
+/** 同時再生の最大数 */
+const MAX_CONCURRENT = 1;
+/** キューの最大サイズ (超えたら古いエントリを破棄) */
+const MAX_QUEUE_SIZE = 3;
+/** 再生プロセスのタイムアウト (ms) */
+const PLAY_TIMEOUT_MS = 10_000;
+/** 再生中のプロセス数 */
+let activeCount = 0;
+/** 再生待ちキュー (level と isRetry フラグを保持) */
+const playQueue = [];
+/** 現在再生中のプロセス (タイムアウト kill 用) */
+let activeProcess = null;
+/** タイムアウトタイマー */
+let activeTimer = null;
+/** 起動後リトライのタイマーハンドル集合 (dispose でクリア) */
+const retryTimers = new Set();
 /**
- * 通知音を再生する (fire-and-forget)。
- * カスタム効果音ファイルがあればそちらを優先、なければ OS システムサウンドにフォールバック。
- * 再生失敗はログに記録するのみで例外は投げない。
+ * 再生世代カウンタ。dispose/resetSoundPlayer で増やすことで、
+ * 旧世代の子プロセスコールバックが戻ってきても completion を拒否する。
+ */
+let runGeneration = 0;
+/** dispose 済みフラグ */
+let disposed = false;
+/**
+ * 再生完了後にキューから次のエントリを取り出して再生する。
+ */
+function onPlayFinished() {
+    activeCount--;
+    activeProcess = null;
+    if (activeTimer != null) {
+        clearTimeout(activeTimer);
+        activeTimer = null;
+    }
+    if (disposed)
+        return;
+    if (playQueue.length > 0) {
+        const next = playQueue.shift();
+        runPlay(next.level, { isRetry: next.isRetry });
+    }
+}
+/**
+ * 起動ウィンドウ内で失敗した場合に、指定秒後の再試行をスケジュールする。
+ * - リトライ由来の失敗 (opts.isRetry) は再リトライしない
+ * - 起動ウィンドウ判定は runPlay 開始時に捕捉済みの値を渡すこと
+ */
+function scheduleRetryIfNeeded(level, opts) {
+    if (opts?.isRetry)
+        return;
+    if (disposed)
+        return;
+    log.warn(`通知音を ${RETRY_DELAY_MS / 1000} 秒後に再試行します (${level})`);
+    const timer = setTimeout(() => {
+        retryTimers.delete(timer);
+        if (!disposed)
+            playSound(level, { isRetry: true });
+    }, RETRY_DELAY_MS);
+    retryTimers.add(timer);
+}
+/**
+ * プロセスを起動して再生を実行する。
+ * タイムアウトと launch 経路のコールバックが競合した場合、先に claim() した
+ * 側だけが log/bell/キュー進行を実行する (二重完了ガード)。
+ * dispose/resetSoundPlayer で runGeneration が変わると旧 runPlay の完了は拒否される。
  */
-function playSound(level) {
+function runPlay(level, opts) {
+    activeCount++;
+    let finished = false;
+    const myGeneration = runGeneration;
+    // リトライ対象判定は runPlay 開始時の uptime で確定させる。
+    // 10 秒 timeout などで失敗確定時点でウィンドウ外でも、
+    // 起動直後に始まった再生はリトライ対象とする。
+    const startedInStartupWindow = nowMs() < STARTUP_WINDOW_MS;
+    const handle = {
+        claim: () => {
+            if (finished)
+                return false;
+            // dispose/reset された旧世代の runPlay は完了処理を行わない
+            if (myGeneration !== runGeneration)
+                return false;
+            finished = true;
+            return true;
+        },
+        done: (failed) => {
+            if (failed === true && startedInStartupWindow) {
+                scheduleRetryIfNeeded(level, opts);
+            }
+            onPlayFinished();
+        },
+    };
     try {
         const customPath = findCustomSound(level);
         const platform = process.platform;
         if (customPath) {
-            playCustomSound(customPath, platform);
+            activeProcess = launchCustomSound(customPath, platform, handle);
         }
         else if (platform === "win32") {
-            playSystemSoundWindows(level);
+            activeProcess = launchSystemSoundWindows(level, handle);
         }
         else if (platform === "darwin") {
-            playSystemSoundMacOS(level);
+            activeProcess = launchSystemSoundMacOS(level, handle);
         }
         else {
-            playSystemSoundLinux(level);
+            activeProcess = launchSystemSoundLinux(level, handle);
+        }
+        if (activeProcess != null) {
+            activeTimer = setTimeout(() => {
+                if (!handle.claim())
+                    return;
+                log.warn(`通知音の再生がタイムアウトしました (${PLAY_TIMEOUT_MS}ms)`);
+                try {
+                    activeProcess?.kill();
+                }
+                catch {
+                    // ignore
+                }
+                handle.done(true);
+            }, PLAY_TIMEOUT_MS);
         }
     }
     catch (err) {
+        if (!handle.claim())
+            return;
         if (err instanceof Error) {
-            log.debug(`通知音の再生に失敗しました: ${err.message}`);
+            log.warn(`通知音の再生に失敗しました: ${err.message}`);
+        }
+        handle.done(true);
+    }
+}
+/**
+ * 通知音を再生する (fire-and-forget)。
+ * 同時再生は MAX_CONCURRENT 件に制限し、超えた場合はキューに積む。
+ * キューが MAX_QUEUE_SIZE を超えた場合は先頭 (最古) を破棄する。
+ * カスタム効果音ファイルがあればそちらを優先、なければ OS システムサウンドにフォールバック。
+ * 再生失敗はログに記録するのみで例外は投げない。
+ */
+function playSound(level, opts) {
+    if (disposed)
+        return;
+    if (activeCount < MAX_CONCURRENT) {
+        runPlay(level, opts);
+    }
+    else {
+        if (playQueue.length >= MAX_QUEUE_SIZE) {
+            // critical は警報相当のため drop 候補から除外。それ以外の最古を落とす。
+            const dropIdx = playQueue.findIndex((e) => e.level !== "critical");
+            if (dropIdx >= 0) {
+                const [dropped] = playQueue.splice(dropIdx, 1);
+                log.debug(`通知音キューが上限 (${MAX_QUEUE_SIZE}) に達したため破棄しました: ${dropped.level}`);
+            }
+            else if (level !== "critical") {
+                // キューが critical で埋まっている → 非 critical の新規は諦める
+                log.debug(`通知音キューが critical で飽和しているため新規再生を破棄しました: ${level}`);
+                return;
+            }
+            else {
+                // 新規も critical で、既存も全て critical → 最古の critical を落とす (従来動作)
+                const dropped = playQueue.shift();
+                log.debug(`通知音キューが上限 (${MAX_QUEUE_SIZE}) に達したため破棄しました: ${dropped?.level}`);
+            }
+        }
+        playQueue.push({ level, isRetry: opts?.isRetry === true });
+    }
+}
+/**
+ * 進行中の再生を停止し、キューをクリアする。
+ * アプリ終了時に呼ぶことでプロセスリークを防ぐ。
+ */
+function dispose() {
+    disposed = true;
+    // 世代を進めて旧 runPlay の遅延コールバックを無効化する
+    runGeneration++;
+    playQueue.length = 0;
+    if (activeTimer != null) {
+        clearTimeout(activeTimer);
+        activeTimer = null;
+    }
+    for (const timer of retryTimers) {
+        clearTimeout(timer);
+    }
+    retryTimers.clear();
+    if (activeProcess != null) {
+        try {
+            activeProcess.kill();
+        }
+        catch {
+            // ignore
         }
+        activeProcess = null;
     }
+    activeCount = 0;
+}
+/**
+ * dispose 後に再利用できるよう内部状態をリセットする (テスト用)。
+ */
+function resetSoundPlayer() {
+    disposed = false;
+    // 世代を進めて旧 runPlay の遅延コールバックを無効化する
+    runGeneration++;
+    activeCount = 0;
+    playQueue.length = 0;
+    activeProcess = null;
+    if (activeTimer != null) {
+        clearTimeout(activeTimer);
+        activeTimer = null;
+    }
+    for (const timer of retryTimers) {
+        clearTimeout(timer);
+    }
+    retryTimers.clear();
 }
 // ── カスタム効果音再生 ──
-function playCustomSound(filePath, platform) {
+function launchCustomSound(filePath, platform, onDone) {
     if (platform === "win32") {
-        playCustomSoundWindows(filePath);
+        return launchCustomSoundWindows(filePath, onDone);
     }
     else if (platform === "darwin") {
-        playCustomSoundMacOS(filePath);
+        return launchCustomSoundMacOS(filePath, onDone);
     }
     else {
-        playCustomSoundLinux(filePath);
+        return launchCustomSoundLinux(filePath, onDone);
     }
 }
 /** Windows: winmm.dll mciSendString で mp3/wav を同期再生 */
-function playCustomSoundWindows(filePath) {
+function launchCustomSoundWindows(filePath, onDone) {
     // MediaPlayer (WPF) は非同期ロードのためタイミング問題が起きやすい。
     // mciSendString は同期 (wait) で確実に再生できる。
+    // execFile を使い cmd.exe のダブルクォーテーション解釈を回避する。
     const escaped = filePath.replace(/'/g, "''");
     const psCommand = [
-        `Add-Type -Namespace Win32 -Name Mci -MemberDefinition '[DllImport("winmm.dll",CharSet=[System.Runtime.InteropServices.CharSet]::Unicode)]public static extern int mciSendStringW(string cmd,System.Text.StringBuilder ret,int retLen,System.IntPtr hwnd);';`,
+        `Add-Type -Namespace Win32 -Name Mci -MemberDefinition '[DllImport("winmm.dll",CharSet=CharSet.Unicode)]public static extern int mciSendStringW(string cmd,System.Text.StringBuilder ret,int retLen,System.IntPtr hwnd);';`,
         `[Win32.Mci]::mciSendStringW('open "' + '${escaped}' + '" type mpegvideo alias fleqsnd',$null,0,[IntPtr]::Zero)|Out-Null;`,
         `[Win32.Mci]::mciSendStringW('play fleqsnd wait',$null,0,[IntPtr]::Zero)|Out-Null;`,
         `[Win32.Mci]::mciSendStringW('close fleqsnd',$null,0,[IntPtr]::Zero)|Out-Null`,
     ].join(" ");
-    (0, child_process_1.exec)(`powershell -NoProfile -Command "${psCommand}"`, (err) => {
+    const proc = (0, child_process_1.execFile)("powershell", ["-NoProfile", "-Command", psCommand], (err) => {
+        if (!onDone.claim())
+            return;
         if (err) {
-            log.debug(`Windows カスタム通知音の再生に失敗しました: ${err.message}`);
+            log.warn(`Windows カスタム通知音の再生に失敗しました: ${err.message}`);
+            onDone.done(true);
+        }
+        else {
+            onDone.done();
         }
     });
+    return proc;
 }
 /** macOS: afplay で mp3/wav を再生 */
-function playCustomSoundMacOS(filePath) {
-    (0, child_process_1.execFile)("afplay", [filePath], (err) => {
+function launchCustomSoundMacOS(filePath, onDone) {
+    const proc = (0, child_process_1.execFile)("afplay", [filePath], (err) => {
+        if (!onDone.claim())
+            return;
         if (err) {
-            log.debug(`macOS カスタム通知音の再生に失敗しました: ${err.message}`);
+            log.warn(`macOS カスタム通知音の再生に失敗しました: ${err.message}`);
+            onDone.done(true);
+        }
+        else {
+            onDone.done();
         }
     });
+    return proc;
 }
 /** Linux: ffplay → paplay → aplay のフォールバック */
-function playCustomSoundLinux(filePath) {
+function launchCustomSoundLinux(filePath, onDone) {
     const ext = path.extname(filePath).toLowerCase();
     if (ext === ".mp3") {
         // mp3 は ffplay で再生
-        (0, child_process_1.execFile)("ffplay", ["-nodisp", "-autoexit", "-loglevel", "quiet", filePath], (err) => {
+        const proc = (0, child_process_1.execFile)("ffplay", ["-nodisp", "-autoexit", "-loglevel", "quiet", filePath], (err) => {
+            if (!onDone.claim())
+                return;
             if (err) {
-                log.debug(`Linux ffplay での再生に失敗しました: ${err.message}`);
+                log.warn(`Linux ffplay での再生に失敗しました: ${err.message}`);
                 printBell();
+                onDone.done(true);
+            }
+            else {
+                onDone.done();
             }
         });
+        return proc;
     }
     else {
         // wav は paplay → aplay のフォールバック
-        (0, child_process_1.execFile)("paplay", [filePath], (err) => {
+        const proc = (0, child_process_1.execFile)("paplay", [filePath], (err) => {
             if (err) {
                 (0, child_process_1.execFile)("aplay", ["-q", filePath], (err2) => {
+                    if (!onDone.claim())
+                        return;
                     if (err2) {
-                        log.debug(`Linux 通知音の再生に失敗しました: ${err2.message}`);
+                        log.warn(`Linux 通知音の再生に失敗しました: ${err2.message}`);
                         printBell();
+                        onDone.done(true);
+                    }
+                    else {
+                        onDone.done();
                     }
                 });
             }
+            else {
+                if (!onDone.claim())
+                    return;
+                onDone.done();
+            }
         });
+        return proc;
     }
 }
 // ── システムサウンドフォールバック ──
-function playSystemSoundWindows(level) {
+/** Windows システムサウンドの存在確認キャッシュ (null = 存在しない, undefined = 未検索) */
+const windowsSoundCache = new Map();
+/** Windows サウンドファイルの確認済みパスを返す。存在しなければ null。 */
+function findWindowsSystemSound(level) {
+    if (windowsSoundCache.has(level)) {
+        return windowsSoundCache.get(level);
+    }
     const soundFile = WINDOWS_SOUNDS[level];
     const soundPath = path.join(process.env.SYSTEMROOT || "C:\\Windows", "Media", soundFile);
+    if (fs.existsSync(soundPath)) {
+        windowsSoundCache.set(level, soundPath);
+        return soundPath;
+    }
+    // フォールバック: Windows Default.wav
+    const defaultPath = path.join(process.env.SYSTEMROOT || "C:\\Windows", "Media", "Windows Default.wav");
+    if (fs.existsSync(defaultPath)) {
+        windowsSoundCache.set(level, defaultPath);
+        return defaultPath;
+    }
+    windowsSoundCache.set(level, null);
+    return null;
+}
+function launchSystemSoundWindows(level, onDone) {
+    const soundPath = findWindowsSystemSound(level);
+    if (soundPath == null) {
+        if (!onDone.claim())
+            return null;
+        log.warn(`Windows 通知音が見つかりません。bell にフォールバックします: ${WINDOWS_SOUNDS[level]}`);
+        printBell();
+        onDone.done(true);
+        return null;
+    }
     const psCommand = `(New-Object System.Media.SoundPlayer '${soundPath}').PlaySync()`;
-    (0, child_process_1.exec)(`powershell -NoProfile -Command "${psCommand}"`, (err) => {
+    const proc = (0, child_process_1.execFile)("powershell", ["-NoProfile", "-Command", psCommand], (err) => {
+        if (!onDone.claim())
+            return;
         if (err) {
-            log.debug(`Windows 通知音の再生に失敗しました: ${err.message}`);
+            log.warn(`Windows 通知音の再生に失敗しました: ${err.message}`);
+            onDone.done(true);
+        }
+        else {
+            onDone.done();
         }
     });
+    return proc;
 }
-function playSystemSoundMacOS(level) {
+function launchSystemSoundMacOS(level, onDone) {
     const soundFile = MACOS_SOUNDS[level];
     const soundPath = `/System/Library/Sounds/${soundFile}`;
-    (0, child_process_1.execFile)("afplay", [soundPath], (err) => {
+    const proc = (0, child_process_1.execFile)("afplay", [soundPath], (err) => {
+        if (!onDone.claim())
+            return;
         if (err) {
-            log.debug(`macOS 通知音の再生に失敗しました: ${err.message}`);
+            log.warn(`macOS 通知音の再生に失敗しました: ${err.message}`);
+            onDone.done(true);
+        }
+        else {
+            onDone.done();
         }
     });
+    return proc;
 }
-function playSystemSoundLinux(level) {
+function launchSystemSoundLinux(level, onDone) {
     const eventName = LINUX_CANBERRA_EVENTS[level];
     if (eventName === "bell") {
+        if (!onDone.claim())
+            return null;
         printBell();
-        return;
+        onDone.done();
+        return null;
     }
-    (0, child_process_1.execFile)("canberra-gtk-play", ["-i", eventName], (err) => {
+    const proc = (0, child_process_1.execFile)("canberra-gtk-play", ["-i", eventName], (err) => {
+        if (!onDone.claim())
+            return;
         if (err) {
-            log.debug(`canberra-gtk-play 失敗、bell にフォールバック: ${err.message}`);
+            log.warn(`canberra-gtk-play 失敗、bell にフォールバック: ${err.message}`);
             printBell();
+            onDone.done(true);
+        }
+        else {
+            onDone.done();
         }
     });
+    return proc;
 }
 function printBell() {
     try {
@@ -228,3 +537,56 @@ function printBell() {
         // ignore
     }
 }
+// ── バックエンド健康チェック ──
+/** バックエンドプローブの timeout (ms) */
+const BACKEND_PROBE_TIMEOUT_MS = 2_000;
+/**
+ * 音声バックエンドが利用可能かを判定する。
+ * Linux: ffplay で 0.1 秒の無音サンプルを再生し、終了コードで判定する。
+ *        PATH 上に ffplay があっても音声デバイスが使えない場合は ok=false を返す。
+ * Windows / macOS: 即座に ok=true を返す (ビルトインの再生経路が常に利用可能)。
+ */
+async function checkSoundBackend() {
+    const platform = process.platform;
+    if (platform === "win32")
+        return { ok: true, label: "winmm" };
+    if (platform === "darwin")
+        return { ok: true, label: "afplay" };
+    return await new Promise((resolve) => {
+        let settled = false;
+        let timer = null;
+        const proc = (0, child_process_1.execFile)("ffplay", ["-f", "lavfi", "-i", "anullsrc=d=0.1", "-nodisp", "-autoexit", "-loglevel", "quiet"], (err) => {
+            if (settled)
+                return;
+            settled = true;
+            if (timer != null)
+                clearTimeout(timer);
+            if (err) {
+                const e = err;
+                const reason = e.code === "ENOENT"
+                    ? "ffplay not found in PATH"
+                    : `ffplay probe failed: ${e.message}`;
+                resolve({ ok: false, label: "ffplay", reason });
+            }
+            else {
+                resolve({ ok: true, label: "ffplay" });
+            }
+        });
+        // モック環境などで execFile のコールバックが同期的に呼ばれ settled=true に
+        // なっている場合、ここで timer を作らないようガードする。
+        if (settled)
+            return;
+        timer = setTimeout(() => {
+            if (settled)
+                return;
+            settled = true;
+            try {
+                proc?.kill();
+            }
+            catch {
+                // ignore
+            }
+            resolve({ ok: false, label: "ffplay", reason: "probe timeout" });
+        }, BACKEND_PROBE_TIMEOUT_MS);
+    });
+}