nixos/modules/services/home-automation/default.nix

# home automation
{
  config,
  lib,
  pkgs,
  ...
}:
let
  cfg = config.my.services.home-automation;
  inherit (config.networking) domain;
in
{
  options.my.services.home-automation = with lib; {
    enable = mkEnableOption "home-assistant server";

    package = lib.mkPackageOption pkgs "home-assistant" { };

    extraComponents = mkOption {
      type = types.listOf (types.enum cfg.package.availableComponents);
      example = literalExpression ''
        [
          "analytics"
          "default_config"
          "esphome"
          "my"
          "wled"
        ]
      '';
      default = [ ];
      description = ''
          List
          of [ components ]
          (https://www.home-assistant.io/integrations/)
          that
          have
          their
          dependencies
          included in the package.

        The component name can be found in the URL, for example `https://www.home-assistant.io/integrations/ffmpeg/` would map to `ffmpeg`.
      '';
    };

    latitude = mkOption {
      type = types.nullOr (types.either types.float types.str);
      default = null;
      example = 52.3;
      description = ''
        your location latitude. Impacts sunrise data.
      '';
    };

    longitude = mkOption {
      type = types.nullOr (types.either types.float types.str);
      default = null;
      example = 4.9;
      description = ''
        your location longitude. Impacts sunrise data.
      '';
    };

    elevation = mkOption {
      type = types.nullOr (types.either types.float types.str);
      default = null;
      description = ''
        your location elevation. Impacts sunrise data.
      '';
    };

    timezone = mkOption {
      type = types.str;
      default = "GMT";
      description = ''
        your timezone.
      '';
    };
  };

  config = lib.mkIf cfg.enable {
    services = {
      home-assistant = {
        enable = true;

        inherit (cfg) package;

        config = {
          default_config = { };
          homeassistant = {
            name = "Home";
            inherit (cfg) latitude longitude elevation;
            unit_system = "metric";
            time_zone = cfg.timezone;
            external_url = "https://automation.${domain}";
            internal_url = "http://localhost:${toString config.services.home-assistant.config.http.server_port}";
          };
          http = {
            use_x_forwarded_for = true;
            trusted_proxies = [
              "127.0.0.1"
              "::1"
            ];
          };
          prometheus.requires_auth = false;
        };

        extraComponents = [
          "backup"
          "esphome"
          "shelly"
          "prometheus"
        ] ++ cfg.extraComponents;
      };

      prometheus.scrapeConfigs = [
        {
          job_name = "home-assistant";
          metrics_path = "/api/prometheus";
          static_configs = [
            {
              targets = [ "localhost:${toString config.services.home-assistant.config.http.server_port}" ];
              labels = {
                instance = config.networking.hostName;
              };
            }
          ];
        }
      ];

      esphome.enable = true;
    };

    my.services.prometheus.rules = {
      homeassistant = {
        condition = ''homeassistant_entity_available{domain="persistent_notification", entity!~"persistent_notification.http_login|persistent_notification.recorder_database_migration"} >= 0'';
        description = "homeassistant notification {{$labels.entity}} ({{$labels.friendly_name}}): {{$value}}";
      };
    };

    my.services.webserver.virtualHosts = [
      {
        subdomain = "automation";
        port = config.services.home-assistant.config.http.server_port;
      }
      {
        subdomain = "esphome";
        inherit (config.services.esphome) port;
      }
    ];

    webapps.apps = {
      home-assistant = {
        dashboard = {
          name = "Home-Automation";
          category = "infra";
          icon = "house-signal";
          url = "https://automation.${domain}";
          method = "get";
        };
      };
      esphome = {
        dashboard = {
          name = "Home-Firmware";
          category = "infra";
          icon = "house-laptop";
          url = "https://esphome.${domain}";
          method = "get";
        };
      };
    };
  };
}