feat(poll): Add API for poll management

Implement new WebSocket API actions in `background.js` to control the poll feature. This allows external applications or tools to manage polls programmatically.

Added actions include:
- `resetpoll`: Resets the current poll, clearing votes.
- `closepoll`: Closes the current poll, preventing new votes.
- `loadpoll`: Loads a saved poll preset by its ID.
- `setpollsettings`: Updates various settings of the current poll.
- `getpollpresets`: Retrieves a list of saved poll presets.
- `createpoll`: Creates a new poll with specified initial settings.

Updated `api.md` to document the new poll API section, explaining each action and providing usage examples.

Added corresponding UI elements and JavaScript logic in `sampleapi.html` to demonstrate how to call these new poll API actions, including loading presets and creating custom polls.

Bumped extension version in `manifest.json` to reflect the added feature.

[auto-enhanced]

Author: steveseguin

api.md

@@ -182,6 +182,14 @@ When a message is sent, it goes to the specified output channel. Those who have
 14. **Draw Mode**
     - `{"action": "drawmode", "value": true}`
 
+15. **Poll Operations**
+    - Reset: `{"action": "resetpoll"}`
+    - Close: `{"action": "closepoll"}`
+    - Load Preset: `{"action": "loadpoll", "value": {"pollId": "poll-123456"}}`
+    - Set Settings: `{"action": "setpollsettings", "value": {"pollQuestion": "What's your favorite color?", "pollType": "multiple", "multipleChoiceOptions": "Red\nBlue\nGreen"}}`
+    - Get Presets: `{"action": "getpollpresets"}`
+    - Create New: `{"action": "createpoll", "value": {"settings": {"pollQuestion": "New Poll", "pollType": "freeform"}}}`
+
 ### Channel-Specific Messaging
 
 You can send messages to specific channels using the `content` action with a channel number:
@@ -762,7 +770,7 @@ This integration allows streamers or moderators to manage waitlists or giveaways
 
 These pages may lack API support directly, however in some cases they can be controlled via the extension's API.
 
-For example the waitlist has some functions that can be controlled via the extensiion:
+For example the waitlist has some functions that can be controlled via the extension:
 
 ```
 removefromwaitlist
@@ -773,6 +781,44 @@ downloadwaitlist
 selectwinner
 ```
 
+## Poll Control via API
+
+The poll system can now be controlled through the API with the following actions:
+
+### Basic Poll Controls
+- **Reset Poll**: `{"action": "resetpoll"}` - Resets the current poll, clearing all votes
+- **Close Poll**: `{"action": "closepoll"}` - Closes the current poll, preventing new votes
+
+### Advanced Poll Controls
+- **Load Poll Preset**: `{"action": "loadpoll", "value": {"pollId": "poll-123456"}}` - Loads a previously saved poll preset by its ID
+- **Get Poll Presets**: `{"action": "getpollpresets"}` - Returns a list of all saved poll presets with their IDs and names
+- **Set Poll Settings**: `{"action": "setpollsettings", "value": {...}}` - Updates the current poll settings
+  - Available settings: `pollType`, `pollQuestion`, `multipleChoiceOptions`, `pollStyle`, `pollTimer`, `pollTimerState`, `pollTally`, `pollSpam`
+- **Create New Poll**: `{"action": "createpoll", "value": {"settings": {...}}}` - Creates a new poll with specified settings
+
+### Example Usage
+```javascript
+// Create a multiple choice poll
+ws.send(JSON.stringify({
+    action: "createpoll",
+    value: {
+        settings: {
+            pollType: "multiple",
+            pollQuestion: "What's your favorite streaming platform?",
+            multipleChoiceOptions: "Twitch\nYouTube\nFacebook\nOther",
+            pollTimer: "120",
+            pollTimerState: true
+        }
+    }
+}));
+
+// Load a saved poll preset
+ws.send(JSON.stringify({
+    action: "loadpoll",
+    value: { pollId: "poll-1234567890" }
+}));
+```
+
 Just to touch on the Battle Royal game though,
 
 ## Battle Page (battle.html)

background.js

@@ -5457,6 +5457,36 @@ function setupSocket() {
 			} else if (data.action && data.action === "closepoll") {
 				sendTargetP2P({cmd:"closepoll"},"poll");
 				resp = true;
+			} else if (data.action && data.action === "loadpoll") {
+				// Load a saved poll preset by ID
+				if (data.value && data.value.pollId) {
+					loadPollPreset(data.value.pollId);
+					resp = true;
+				}
+			} else if (data.action && data.action === "setpollsettings") {
+				// Directly set poll settings via API
+				if (data.value && typeof data.value === 'object') {
+					updatePollSettings(data.value);
+					resp = true;
+				}
+			} else if (data.action && data.action === "getpollpresets") {
+				// Return list of saved poll presets
+				getPollPresets(function(presets) {
+					if (data.get && e.data.UUID) {
+						var ret = {};
+						ret.callback = {};
+						ret.callback.get = data.get;
+						ret.callback.result = presets;
+						socketserver.send(JSON.stringify(ret));
+					}
+				});
+				resp = true;
+			} else if (data.action && data.action === "createpoll") {
+				// Create a new poll with specific settings
+				if (data.value && data.value.settings) {
+					createNewPoll(data.value.settings);
+					resp = true;
+				}
 			} else if (data.action && data.action === "stopentries") {
 				toggleEntries(false);
 				resp = true;
@@ -6474,6 +6504,95 @@ function initializePoll() {
 	} catch (e) {}
 }
 
+function loadPollPreset(pollId) {
+	chrome.storage.local.get(['savedPolls'], function(result) {
+		if (result.savedPolls) {
+			try {
+				const savedPolls = JSON.parse(result.savedPolls);
+				const poll = savedPolls.find(p => p.id === pollId);
+				if (poll && poll.settings) {
+					// Update settings with the loaded poll
+					Object.keys(poll.settings).forEach(key => {
+						if (settings.hasOwnProperty(key)) {
+							settings[key] = poll.settings[key];
+						}
+					});
+					// Send updated settings to poll overlay
+					sendTargetP2P({settings:settings}, "poll");
+					// Save updated settings
+					chrome.storage.local.set({settings: settings});
+				}
+			} catch (e) {
+				log("Error loading poll preset: " + e.message);
+			}
+		}
+	});
+}
+
+function updatePollSettings(newSettings) {
+	try {
+		// Update poll-related settings
+		const pollKeys = ['pollType', 'pollQuestion', 'multipleChoiceOptions', 
+						 'pollStyle', 'pollTimer', 'pollTimerState', 'pollTally', 'pollSpam'];
+		
+		pollKeys.forEach(key => {
+			if (newSettings.hasOwnProperty(key)) {
+				settings[key] = newSettings[key];
+			}
+		});
+		
+		// Send updated settings to poll overlay
+		sendTargetP2P({settings:settings}, "poll");
+		// Save settings
+		chrome.storage.local.set({settings: settings});
+	} catch (e) {
+		log("Error updating poll settings: " + e.message);
+	}
+}
+
+function getPollPresets(callback) {
+	chrome.storage.local.get(['savedPolls'], function(result) {
+		try {
+			if (result.savedPolls) {
+				const savedPolls = JSON.parse(result.savedPolls);
+				// Return simplified list with id and name
+				const presets = savedPolls.map(poll => ({
+					id: poll.id,
+					name: poll.name
+				}));
+				callback(presets);
+			} else {
+				callback([]);
+			}
+		} catch (e) {
+			log("Error getting poll presets: " + e.message);
+			callback([]);
+		}
+	});
+}
+
+function createNewPoll(pollSettings) {
+	try {
+		// Reset to default poll settings
+		const defaultSettings = {
+			pollType: 'freeform',
+			pollQuestion: '',
+			multipleChoiceOptions: '',
+			pollStyle: 'default',
+			pollTimer: '60',
+			pollTimerState: false,
+			pollTally: true,
+			pollSpam: false
+		};
+		
+		// Merge with provided settings
+		const finalSettings = {...defaultSettings, ...pollSettings};
+		updatePollSettings(finalSettings);
+	} catch (e) {
+		log("Error creating new poll: " + e.message);
+	}
+}
+
 function initializeWaitlist() {
 	try {
 		if (!settings.waitlistmode) { // stop and clear

manifest.json

@@ -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.24.2",
+  "version": "3.24.3",
   "homepage_url": "http://socialstream.ninja/",
   "icons": {
     "128": "icons/icon-128.png"

sampleapi.html

@@ -363,10 +363,27 @@ <h2>Waitlist Commands</h2>
 
 		<div class="section">
             <h2>Poll Commands</h2>
+            <div class="mb-3">
+                <select id="pollPresetSelect" class="form-control">
+                    <option value="">Select a poll preset...</option>
+                </select>
+                <button class="btn btn-info btn-sm mt-2" onclick="refreshPollPresets()">Refresh Presets</button>
+            </div>
+            <div class="mb-3">
+                <input type="text" id="pollQuestion" class="form-control" placeholder="Poll question">
+                <select id="pollType" class="form-control mt-2">
+                    <option value="freeform">Freeform</option>
+                    <option value="multiple">Multiple Choice</option>
+                </select>
+                <textarea id="pollOptions" class="form-control mt-2" placeholder="Enter options (one per line)" rows="4" style="display:none;"></textarea>
+            </div>
             <div class="btn-group" role="group">
                 <button class="btn btn-warning" onclick="sendCommand('resetpoll')">Reset Poll</button>
                 <button class="btn btn-warning" onclick="sendCommand('closepoll')">Close Poll</button>
+                <button class="btn btn-warning" onclick="loadPollPreset()">Load Preset</button>
+                <button class="btn btn-warning" onclick="createCustomPoll()">Create Custom Poll</button>
             </div>
+            <p class="note">Extended poll controls allow you to load saved presets, create custom polls, and manage poll settings via the API.</p>
         </div>
 
         <div class="section">
@@ -771,6 +788,96 @@ <h2>Incoming Messages</h2>
 			log.textContent = JSON.stringify(requestData, null, 2);
 			log.style.display = 'block';
 		}
+		
+		// Poll-specific functions
+		function refreshPollPresets() {
+			if (!socket || socket.readyState !== WebSocket.OPEN) {
+				alert('Please connect first');
+				return;
+			}
+			
+			// Generate a unique callback ID
+			const callbackId = 'cb_' + Date.now();
+			
+			// Send request with callback
+			socket.send(JSON.stringify({
+				action: 'getpollpresets',
+				apiid: sessionID,
+				get: callbackId
+			}));
+			
+			// Listen for response
+			socket.addEventListener('message', function handlePresets(event) {
+				try {
+					const data = JSON.parse(event.data);
+					if (data.callback && data.callback.get === callbackId) {
+						// Remove this listener
+						socket.removeEventListener('message', handlePresets);
+						
+						// Update the select dropdown
+						const select = document.getElementById('pollPresetSelect');
+						select.innerHTML = '<option value="">Select a poll preset...</option>';
+						
+						if (data.callback.result && Array.isArray(data.callback.result)) {
+							data.callback.result.forEach(preset => {
+								const option = document.createElement('option');
+								option.value = preset.id;
+								option.textContent = preset.name;
+								select.appendChild(option);
+							});
+						}
+					}
+				} catch (e) {
+					console.error('Error parsing preset response:', e);
+				}
+			});
+		}
+		
+		function loadPollPreset() {
+			const presetId = document.getElementById('pollPresetSelect').value;
+			if (!presetId) {
+				alert('Please select a poll preset');
+				return;
+			}
+			
+			sendCommand('loadpoll', { pollId: presetId });
+		}
+		
+		function createCustomPoll() {
+			const question = document.getElementById('pollQuestion').value;
+			const type = document.getElementById('pollType').value;
+			const optionsText = document.getElementById('pollOptions').value;
+			
+			if (!question) {
+				alert('Please enter a poll question');
+				return;
+			}
+			
+			const settings = {
+				pollQuestion: question,
+				pollType: type,
+				pollTimer: '120',
+				pollTimerState: true,
+				pollTally: true,
+				pollSpam: false
+			};
+			
+			if (type === 'multiple' && optionsText) {
+				settings.multipleChoiceOptions = optionsText;
+			}
+			
+			sendCommand('createpoll', { settings });
+		}
+		
+		// Show/hide options textarea based on poll type
+		document.getElementById('pollType').addEventListener('change', function() {
+			const optionsTextarea = document.getElementById('pollOptions');
+			if (this.value === 'multiple') {
+				optionsTextarea.style.display = 'block';
+			} else {
+				optionsTextarea.style.display = 'none';
+			}
+		});
 		</script>
 		</body>
 		</html>