Merge beta into Arabic localization PR

Author: steveseguin

.gitignore

@@ -10,9 +10,10 @@ settings.json
 *.backup
 AGENTS.md
 CLAUDE.md
-node_modules/
-package.lock
-electron_app_reference/
+node_modules/
+ssn-streamdeck/
+package.lock
+electron_app_reference/
 .npm-cache/
 
 # Local browser model blobs (download at install/runtime, not in git)

AGENTS.md

@@ -36,7 +36,11 @@ If you need more context on how Electron wiring differs from the extension boots
 ## Message Contracts
 
 - Every outbound event follows the canonical structure referenced in `docs/event-reference.html`. Required fields (`platform`, `type`, `chatname`, `chatmessage`, etc.) must stay intact.
-- Additional, non-standard details belong inside the top-level `meta` object. Populate `meta` with plain JSON values (no functions/classes) so downstream consumers can safely parse them.
+- `textonly` applies only to `chatmessage`: `true` means render `chatmessage` as plain text, while `false` means `chatmessage` may contain sanitized/renderable HTML. Other normal fields are expected to be plain text; media fields such as `chatimg` and `contentimg` carry URLs/data.
+- Donation-style chat rows should use `hasDonation` and optional `donoValue`. Do not set `event: "donation"` just because a normal chat/tip row has a donation value; `event` changes routing/filter behavior and should only be used for true normalized platform actions or paid item types.
+- Prefer specific event names over generic donation names when a platform exposes distinct paid support types. For example, YouTube Super Chat uses `event: "superchat"`, Super Sticker uses `event: "supersticker"`, and Jewels/Gifts use `event: "jeweldonation"`.
+- Use existing payload fields first. Only populate `meta` when there is additional structured data that downstream consumers actually need and no existing field handles it well.
+- Additional, non-standard details that truly need to be transmitted belong inside the top-level `meta` object. Populate `meta` with plain JSON values (no functions/classes) so downstream consumers can safely parse them.
 - Avoid emitting ad-hoc top-level keys—coordinate changes through the event reference doc before shipping.
 
 ## Custom Overlay Notes

README.md

@@ -203,6 +203,7 @@ Much more than just an overlay - Social Stream Ninja is a complete chat ecosyste
 - bigo.tv (no pop out)
 - circle.so (and community domains like community.talkinghealthtech.com or members.firstinfam.com)
 - sooplive.com (pop out the chat to use; supports https://play.sooplive.com/*?vtype=chat)
+- flextv.co.kr (open the live channel page with chat visible)
 - on24.com ( Q&A - questions supported)
 - meetme
 - moonbeam.stream (no pop out)
@@ -879,7 +880,7 @@ The `voice` parameter works with partial matching, so you can use terms like "si
 
 #### Premium TTS Options
 
-Unlike the system TTS (free), all premium TTS options are fully supported by both the Social Stream Ninja app and OBS browser sources with direct audio capture capabilities. These options provide superior language support and much easier integration.
+Unlike the system TTS (free), browser/provider TTS options are designed to play through the page, which makes OBS capture much easier when "Control audio via OBS" is enabled. Self-hosted local endpoints also work, but the endpoint still needs to be reachable from the page that is playing TTS; see the Local AI TTS Guide for localhost, CORS, and OBS browser-source setup notes.
 
 ##### Kokoro Premium FREE TTS
 Social Stream Ninja now includes Kokoro TTS, a high-quality browser-based text-to-speech solution that runs directly in the browser. Benefits include:

actions.html

@@ -321,6 +321,44 @@ <h2>Session ID Required</h2>
         })(window);
 
         var urlParams = new URLSearchParams(window.location.search);
+        var SERVER_EXCLUSIVE_TRANSPORT_VERSION = "3.52.0";
+        // Transport migration guard: only pages with full server parity may skip the legacy bridge.
+        var TRANSPORT_CAPABILITIES = {
+            serverFeed: false,
+            serverTargeted: false,
+            upstreamCommands: false,
+            customChannel: true,
+            legacyBridgeRequired: true,
+            legacyBridgeReason: "Flow Actions uses channel 6 and sendTargetP2P('actions') is still bridge-only."
+        };
+        function versionAtLeast(value, minimum) {
+            var a = String(value || "").split(".");
+            var b = String(minimum || "").split(".");
+            var len = Math.max(a.length, b.length);
+            for (var i = 0; i < len; i++) {
+                var av = parseInt(a[i], 10) || 0;
+                var bv = parseInt(b[i], 10) || 0;
+                if (av > bv) return true;
+                if (av < bv) return false;
+            }
+            return true;
+        }
+        // Only feed-carrying server params listed by this page may disable the bridge; server3 alone is command-only.
+        function hasExclusiveServerTransport(caps) {
+            var params = caps && typeof caps.exclusiveServerParams === "object" ? caps.exclusiveServerParams : { server2: true };
+            return (params.server === true && urlParams.has("server")) ||
+                (params.server2 !== false && urlParams.has("server2")) ||
+                (params.server3 === true && urlParams.has("server2") && urlParams.has("server3"));
+        }
+        function useServerOnlyTransport() {
+            var caps = (typeof TRANSPORT_CAPABILITIES === "object" && TRANSPORT_CAPABILITIES) ? TRANSPORT_CAPABILITIES : {};
+            return hasExclusiveServerTransport(caps) &&
+                versionAtLeast(urlParams.get("v"), SERVER_EXCLUSIVE_TRANSPORT_VERSION) &&
+                caps.serverFeed === true &&
+                caps.legacyBridgeRequired !== true &&
+                caps.upstreamCommands !== true &&
+                caps.customChannel !== true;
+        }
         var iframe = null;
         var connectedPeers = {};
         var roomID = "test";
@@ -1242,18 +1280,19 @@ <h2>Session ID Required</h2>
                 setupSocket();
             }
 
-            // Create iframe for receiving WebRTC data channel messages
-            iframe = document.createElement("iframe");
-            iframe.connectedPeers = connectedPeers;
-            iframe.src = "https://vdo.socialstream.ninja/?ln&salt=vdo.ninja&password=" + password +
-                "&solo&view=" + roomID + "&novideo&noaudio&label=actions&cleanoutput&room=" + roomID;
-            iframe.style.width = "0px";
-            iframe.style.height = "0px";
-            iframe.style.position = "fixed";
-            iframe.style.left = "-100px";
-            iframe.style.top = "-100px";
-            iframe.id = "frame1";
-            document.body.appendChild(iframe);
+            if (!useServerOnlyTransport()) {
+                iframe = document.createElement("iframe");
+                iframe.connectedPeers = connectedPeers;
+                iframe.src = "https://vdo.socialstream.ninja/?ln&salt=vdo.ninja&password=" + encodeURIComponent(password) +
+                    "&solo&view=" + roomID + "&novideo&noaudio&label=actions&cleanoutput&room=" + roomID;
+                iframe.style.width = "0px";
+                iframe.style.height = "0px";
+                iframe.style.position = "fixed";
+                iframe.style.left = "-100px";
+                iframe.style.top = "-100px";
+                iframe.id = "frame1";
+                document.body.appendChild(iframe);
+            }
 
             console.log("Actions page initialized with session ID:", roomID);