Fan auto-off

const definition = {
  name: 'Fan Auto-off',
  namespace: 'com.example',
  description: 'Turns a fan off a set number of minutes after it turns on.',
  category: 'climate',
};

const preferences = {
  pages: [{
    id: 'main',
    title: 'Fan Auto-off',
    inputs: [
      { key: 'fan', label: 'Fan', type: 'entity', domainFilter: 'fan', required: true },
      { key: 'offAfterMinutes', label: 'Turn off after (minutes)', type: 'number', default: 15, minValue: 1, maxValue: 240 },
      { key: 'manualOnly', label: 'Only when switched on by hand',
        description: 'Ignore the fan being turned on by another automation or from the app.',
        type: 'boolean', default: false },
      { key: 'logging', label: 'Enable logging', type: 'boolean', default: false },
    ],
  }],
};

function installed() { initialize(); }
function updated() { unsubscribe(); unschedule(); initialize(); }

function initialize() {
  if (!fan) { console.warn('No fan configured'); return; }
  subscribe(fan, { to: 'on' }, onFanOn);
  subscribe(fan, { to: 'off' }, onFanOff);
}

function onFanOn(evt) {
  const actor = evt.newState.context?.actorType ?? 'system';
  if (manualOnly === true && actor !== 'physical') {
    logInfo(`Fan turned on by ${actor}; leaving it alone`);
    return;
  }
  const minutes = typeof offAfterMinutes === 'number' && offAfterMinutes > 0 ? offAfterMinutes : 15;
  state.lastOnAt = new Date().toISOString();
  logInfo(`Fan on, off again in ${minutes} min`);
  runIn(minutes * 60, turnFanOff);          // re-arming replaces any pending timer
}

function onFanOff() {
  unschedule(turnFanOff);                   // switched off early, by hand or by us: nothing left to do
}

function turnFanOff() {
  logInfo('Auto-off elapsed');
  fan.turnOff();
}

function logInfo(...args) {
  if (logging === true) console.log(...args);
}