feat(audio): Play sound for returning or new chatters

Introduces an optional audio notification when a user sends their first message or returns after 8 hours of inactivity.

- Adds `beepreturning` setting to enable/disable the feature for enhanced host awareness.
- Triggers `audio/join.wav` playback for new or returning chatters based on `data.firsttime` or inactivity duration checks within `background.js`.
- Implements a playback cooldown (`RETURNING_BEEP_COOLDOWN_MS`) to prevent notification spam.
- Displays a user hint via `messagePopup` to guide users on enabling background audio playback in their browser.
- Skips notifications for internal system messages or events (e.g., `reflection`, `replay`, `bot`, `host`) to reduce noise.
- Incorporates new general audio assets (`bell.wav`, `chime.wav`, `join.wav`, `leave.wav`) with `join.wav` being used for this specific feature.

[auto-enhanced]

Author: steveseguin

audio/bell.wav

@@ -31,9 +31,13 @@ var messageCounter = messageCounterBase;
 var lastAntiSpam = 0;
 var tabMessageActivityCounter = {};
 var lastAutoMessagePerTab = {};
-
-var connectedPeers = {};
-var isSSAPP = false;
+let returningBeepAudio = null;
+let returningBeepLastPlay = 0;
+const RETURNING_BEEP_COOLDOWN_MS = 400;
+let returningBeepHintShown = false;
+
+var connectedPeers = {};
+var isSSAPP = false;
 
 const HANDLE_DB_NAME = "ssn-file-handles";
 const HANDLE_STORE_NAME = "handles";
@@ -3815,13 +3819,20 @@ chrome.runtime.onMessage.addListener(async function (request, sender, sendRespon
 				if (request.setting === 'sdk' && isExtensionOn && streamID) {
 					initTransport(streamID, password);
 				}
-			} catch(e) { console.warn(e); }
-
-			sendResponse({ state: isExtensionOn });
-			
-			if (request.target){
-				sendTargetP2P(request, request.target);
-			}
+			} catch(e) { console.warn(e); }
+
+			sendResponse({ state: isExtensionOn });
+
+			if (request.setting === "beepreturning" && request.value && !isSSAPP && !returningBeepHintShown) {
+				messagePopup({
+					alert: "If you don't hear the notification, click the pinned Background tab once to allow audio playback."
+				});
+				returningBeepHintShown = true;
+			}
+			
+			if (request.target){
+				sendTargetP2P(request, request.target);
+			}
 
 			if (request.setting == "midi") {
 				toggleMidi();
@@ -10807,14 +10818,51 @@ class HostMessageFilter {
     }
   }
 }
-
-// Create an instance
-const hostMessageFilter = new HostMessageFilter();
-
-
-const patterns = {
-	botReply: {
-	  prefixes: ['botReplyMessageEvent', 'botReplyMessageCommand', 'botReplyMessageValue', 'botReplyMessageTimeout', 'botReplyMessageSource', 'botReplyAll'],
+
+// Create an instance
+const hostMessageFilter = new HostMessageFilter();
+
+function getReturningBeepPlayer() {
+	if (typeof Audio === "undefined") {
+		return null;
+	}
+	if (!returningBeepAudio) {
+		try {
+			returningBeepAudio = new Audio("./audio/join.wav");
+			returningBeepAudio.preload = "auto";
+			returningBeepAudio.volume = 0.5;
+		} catch (e) {
+			console.warn("Unable to initialize returning chatter beep audio", e);
+			return null;
+		}
+	}
+	return returningBeepAudio;
+}
+
+async function playReturningBeep() {
+	const player = getReturningBeepPlayer();
+	if (!player) {
+		return;
+	}
+
+	const now = Date.now();
+	if (now - returningBeepLastPlay < RETURNING_BEEP_COOLDOWN_MS) {
+		return;
+	}
+	returningBeepLastPlay = now;
+
+	try {
+		player.currentTime = 0;
+		await player.play();
+	} catch (err) {
+		console.warn("Returning chatter beep failed to play", err?.message || err);
+	}
+}
+
+
+const patterns = {
+	botReply: {
+	  prefixes: ['botReplyMessageEvent', 'botReplyMessageCommand', 'botReplyMessageValue', 'botReplyMessageTimeout', 'botReplyMessageSource', 'botReplyAll'],
 	  type: 'botReply'
 	},
 	chatCommand: {
@@ -11142,11 +11190,25 @@ async function applyBotActions(data, tab = false) {
 				console.error("Error checking first timer:", e);
 			}
 		}
-		
-		if (settings.joke && data.chatmessage && data.chatmessage.toLowerCase() === "!joke") {
-			////console.log".");
-			//if (Date.now() - messageTimeout > 5100) {
-				var score = parseInt(Math.random() * 378);
+
+		const returningBeepEnabled = !!(settings.beepreturning?.setting ?? settings.beepreturning);
+		const hasChatFields = typeof data.chatname === "string" && data.chatname.trim() !== "" && typeof data.chatmessage === "string" && data.chatmessage.trim() !== "";
+		const skipReturningBeep = data.reflection || data.replay || data.history || data.reload || data.bot || data.host;
+
+		if (returningBeepEnabled && hasChatFields && !skipReturningBeep) {
+			const nowSeconds = normalizeTimestampToSeconds(data.timestamp) || Math.round(Date.now() / 1000);
+			const lastActivitySeconds = normalizeTimestampToSeconds(data.lastactivity);
+			const inactiveForEightHours = Number.isFinite(lastActivitySeconds) && nowSeconds && (nowSeconds - lastActivitySeconds >= 8 * 60 * 60);
+
+			if (data.firsttime || inactiveForEightHours) {
+				playReturningBeep();
+			}
+		}
+		
+		if (settings.joke && data.chatmessage && data.chatmessage.toLowerCase() === "!joke") {
+			////console.log".");
+			//if (Date.now() - messageTimeout > 5100) {
+				var score = parseInt(Math.random() * 378);
 				var joke = jokes[score];
 
 				//messageTimeout = Date.now();

audio/chime.wav

@@ -2,7 +2,7 @@
   "name": "Social Stream Ninja",
   "description": "Powerful tooling to engage live chat on Youtube, Twitch, Zoom, and more.",
   "manifest_version": 3,
-  "version": "3.36.19",
+  "version": "3.36.20",
   "homepage_url": "http://socialstream.ninja/",
   "browser_specific_settings": {
     "gecko": {

audio/join.wav

@@ -5048,6 +5048,13 @@ <h3>Custom Injection</h3>
                                         <span class="slider round"></span>
                                     </label>
                                     <span data-translate="first-time-chatters"> 🌿 Use the DB to mark new-ish chatters and to include last chat-activity. Required for some triggers.</span>
+                                </div>
+                                <div title="Beep when a brand new chatter or someone inactive for 8+ hours speaks (requires first-timer tracking)">
+                                    <label class="switch">
+                                        <input type="checkbox" data-setting="beepreturning" />
+                                        <span class="slider round"></span>
+                                    </label>
+                                    <span>🔔👋 Beep for new or returning chatters (8h+ quiet)</span>
                                 </div>
 								<div title="Override's the database 30-day storage limits">
                                     <label class="switch">