MultiRoombaRover/server/src/services/homeAssistantActivitiesService/actions.js

// User and idle commands share one dispatch contract, while only the trusted
// idle entry point can bypass per-item user locks.
const { buildEntity, buildCommand } = require('./entityHelpers');

function assertAccess(actor = {}) {
  if (!['user', 'admin', 'lockdown'].includes(actor.role)) throw new Error('Spectators cannot control activities');
  if (actor.mode === 'lockdown' && actor.role !== 'lockdown') throw new Error('Server in lockdown');
  if (actor.mode === 'admin' && !['admin', 'lockdown'].includes(actor.role)) throw new Error('Admin mode: admins only');
}

function createActions({ getConfig, ha, locks }) {
  async function execute(id, value, actor, idle = false) {
    if (!idle) assertAccess(actor);
    const config = getConfig();
    if (!config.enabled) throw new Error('Home Assistant activities are disabled');
    const item = config.items.find((entry) => entry.id === id);
    if (!item) throw new Error('Unknown activity item');
    if (!idle && locks.isLocked(id) && !['admin', 'lockdown'].includes(actor.role)) throw new Error('This item is locked');
    if (!ha.enabled || !ha.isConnected()) throw new Error('Home Assistant is offline');
    const entity = buildEntity(item, ha.getRawEntitySnapshot(id));
    if (!entity.available) throw new Error('This item is unavailable');
    const command = buildCommand(entity, value);
    // Let HA process independent commands normally; an outstanding service
    // response must not block later user changes or configured idle cleanup.
    await ha.callHomeAssistantService(entity.domain, command.service, command.data);
  }

  async function runIdleActions() {
    const config = getConfig();
    if (!config.enabled) return { action: 'homeAssistantActivitiesIdle', skipped: true };
    const results = [];
    // Catch per item so one offline integration cannot prevent the remaining
    // configured cleanup actions from running during this idle window.
    for (const item of config.items) {
      if (!item.idleAction || item.idleAction === 'unchanged' || item.readOnly) continue;
      try {
        const entity = buildEntity(item, ha.getRawEntitySnapshot(item.id));
        if (entity.type === 'readOnly') continue;
        if ((item.idleAction === 'press') !== (entity.type === 'button')) throw new Error('Idle action does not match the control type');
        // The admin form omits an empty optional string. Treat that as empty
        // text so clearing a message works; other types still reject it through
        // their normal value validation rather than silently receiving zero.
        await execute(item.id, item.idleAction === 'press' ? 'press' : (item.idleValue ?? ''), null, true);
        results.push({ id: item.id, ok: true });
      } catch (error) {
        results.push({ id: item.id, ok: false, error: error.message });
      }
    }
    return { action: 'homeAssistantActivitiesIdle', results };
  }
  return { act: (id, value, actor) => execute(id, value, actor), runIdleActions };
}

module.exports = { createActions, assertAccess };