Release Healer Man 0.1.9

src/game/combatAudio.test.ts

@@ -0,0 +1,70 @@
+import { afterEach, describe, expect, it, vi } from "vitest";
+import {
+  DEFAULT_COMBAT_PRESENTATION_SETTINGS,
+  type CombatPresentationEvent,
+} from "./combatPresentation";
+import {
+  combatAudioOutputEnabled,
+  configureCombatAudio,
+  masterAudioOutputEnabled,
+  playCombatAudio,
+  playMasterAudioCue,
+} from "./combatAudio";
+
+const fixtureEvent: CombatPresentationEvent = {
+  id: 1,
+  sessionId: 1,
+  occurredAt: 1,
+  phase: "impact",
+  actorGroup: "player",
+  sourceActorId: "player",
+  targetActorId: "enemy",
+  abilityId: "fixture",
+  name: "Fixture",
+  source: "fallback",
+  school: "holy",
+  delivery: "projectile",
+  origin: [0, 0, 0],
+  targetPosition: [1, 0, 0],
+};
+
+afterEach(() => vi.unstubAllGlobals());
+
+describe("combat audio output policy", () => {
+  it("does not create or fetch audio while the master volume is disabled", async () => {
+    const AudioContextConstructor = vi.fn();
+    const fetch = vi.fn();
+    vi.stubGlobal("window", { AudioContext: AudioContextConstructor });
+    vi.stubGlobal("fetch", fetch);
+    configureCombatAudio(DEFAULT_COMBAT_PRESENTATION_SETTINGS, 0);
+
+    playCombatAudio(fixtureEvent);
+    await expect(playMasterAudioCue("/fixture.wav")).resolves.toBeNull();
+
+    expect(AudioContextConstructor).not.toHaveBeenCalled();
+    expect(fetch).not.toHaveBeenCalled();
+  });
+
+  it("allows explicitly enabled positive-volume output", () => {
+    expect(masterAudioOutputEnabled(0)).toBe(false);
+    expect(masterAudioOutputEnabled(0.6)).toBe(true);
+    expect(combatAudioOutputEnabled(DEFAULT_COMBAT_PRESENTATION_SETTINGS, 0)).toBe(false);
+    expect(combatAudioOutputEnabled(DEFAULT_COMBAT_PRESENTATION_SETTINGS, 0.6)).toBe(true);
+  });
+
+  it("does not initialize audio for a zero-volume actor group", () => {
+    const AudioContextConstructor = vi.fn();
+    vi.stubGlobal("window", { AudioContext: AudioContextConstructor });
+    configureCombatAudio({
+      ...DEFAULT_COMBAT_PRESENTATION_SETTINGS,
+      audioVolume: {
+        ...DEFAULT_COMBAT_PRESENTATION_SETTINGS.audioVolume,
+        player: 0,
+      },
+    }, 0.6);
+
+    playCombatAudio(fixtureEvent);
+
+    expect(AudioContextConstructor).not.toHaveBeenCalled();
+  });
+});