68fed087-9049-446f-bfc5-3f83b2da1ce1/Sources/engine/SoundPlayer.swift

//
//  SoundPlayer.swift
//  摸鱼侠 plugin v0.2.1
//
//  Sit-reminder alert tone. The bundled UN notification sound is a
//  ~1s ding that's easy to miss in a meeting — for sit alerts we want
//  a 15s nag that makes you actually stand up.
//
//  Implementation: repeat the macOS system "Morse" sound (0.7s) once
//  per second for 15 ticks. Morse is the most distinctive notification
//  sound shipped with macOS — staccato 3-tone "S O S" pattern that
//  pierces background noise better than Glass/Hero/Ping/Funk/etc.
//
//  Plays via NSSound (not UNNotificationContent.sound) because UN
//  sounds are limited to ~30s but get truncated to ~5s on macOS, and
//  attach a single tone to a single notification — no way to fire a
//  repeated sequence from UN.
//

import AppKit
import Foundation

@MainActor
final class SoundPlayer {
    static let shared = SoundPlayer()
    private init() {}

    /// System Morse sound — 0.7s staccato 3-tone "S".
    /// Shipped on every macOS since at least 10.0; safe to hard-code path.
    private let morseURL = URL(fileURLWithPath: "/System/Library/Sounds/Morse.aiff")

    private var timer: Timer?
    private var remaining: Int = 0
    private var currentSound: NSSound?

    /// Repeated Morse alert: play `count` times at 1Hz. Each play is a
    /// fresh NSSound so previous-in-flight playback doesn't get stomped
    /// (NSSound.play() is non-blocking and the 0.7s tone overlaps with
    /// the next-second silence — acceptable acoustic gap).
    ///
    /// Calling while a previous alert is still running cancels the old
    /// one and restarts from `count`. This keeps "user sat back down +
    /// trigger fired again 45min later" clean.
    func playMorseSitAlert(count: Int = 15) {
        stop()
        remaining = count
        playOnce()  // fire immediately, then 1Hz repeat
        timer = Timer.scheduledTimer(withTimeInterval: 1.0, repeats: true) { [weak self] _ in
            Task { @MainActor in self?.playOnce() }
        }
    }

    /// Clockout celebration tone — Glass (1.0s sustained "✨" tone)
    /// played 3 times with 0.5s gap. Distinct from sit Morse so the
    /// user instantly knows "下班" not "起来动一下".
    func playClockoutCelebration() {
        stop()
        let glassURL = URL(fileURLWithPath: "/System/Library/Sounds/Glass.aiff")
        // 3 chimes at 0s, 0.6s, 1.2s — shorter cadence than sit (full
        // shot of joy, not a nag). Schedule with DispatchQueue async
        // since this is a fixed-shot pattern, no need for a Timer loop.
        for delay in [0.0, 0.6, 1.2] {
            DispatchQueue.main.asyncAfter(deadline: .now() + delay) { [weak self] in
                guard let _ = self else { return }
                if let s = NSSound(contentsOf: glassURL, byReference: true) {
                    s.play()
                }
            }
        }
    }

    /// Cancel any in-flight alert. Called by WorkerStore.sitStop() so
    /// "user stopped sit monitoring" silences the nag immediately.
    func stop() {
        timer?.invalidate()
        timer = nil
        remaining = 0
        currentSound?.stop()
        currentSound = nil
    }

    private func playOnce() {
        guard remaining > 0 else {
            stop()
            return
        }
        remaining -= 1
        // byReference: true — load lazily from the system path each call.
        // The cost is negligible (< 1ms) and avoids keeping a 200KB AIFF
        // resident across the 45min idle stretch between alerts.
        if let sound = NSSound(contentsOf: morseURL, byReference: true) {
            sound.play()
            currentSound = sound
        } else {
            WorkerDebugLog.write("SoundPlayer: failed to load \(morseURL.path)")
            stop()
        }
    }
}