Gitingest

Include files under: 50kb

Summary

Repository: superioone/nut_webgui
Files analyzed: 81

Estimated tokens: 163.7k

Download

Directory Structure

Directory structure:

└── superioone-nut_webgui/

    ├── README.md

    ├── build_images.sh

    ├── CHANGELOG

    ├── LICENSE

    ├── Makefile

    ├── rustfmt.toml

    ├── start_dev.sh

    ├── client/

    │   ├── package.json

    │   ├── pnpm-lock.yaml

    │   ├── tailwind.config.js

    │   ├── scripts/

    │   │   └── build.js

    │   ├── src/

    │   │   ├── index.js

    │   │   ├── style.css

    │   │   ├── utils.js

    │   │   └── components/

    │   │       ├── confirmation_modal.js

    │   │       ├── notification.js

    │   │       ├── theme_selector.js

    │   │       ├── time_display.js

    │   │       └── charts/

    │   │           └── gauge.js

    │   └── static/

    ├── containers/

    │   ├── amd64-v3.Dockerfile

    │   ├── amd64-v4.Dockerfile

    │   ├── amd64.Dockerfile

    │   ├── annotation.conf

    │   ├── arm64.Dockerfile

    │   ├── armv6.Dockerfile

    │   ├── armv7.Dockerfile

    │   ├── Dockerfile.template

    │   ├── riscv64.Dockerfile

    │   └── server_start.sh

    ├── docs/

    │   ├── building_debugging.md

    │   ├── docker_compose.md

    │   ├── kubernetes_example.md

    │   ├── openapi3_spec.json

    │   ├── openapi3_spec.yaml

    │   └── images/

    │       ├── details.webp

    │       └── home.webp

    ├── nut-ddl/

    ├── server/

    │   ├── askama.toml

    │   ├── Cargo.lock

    │   ├── Cargo.toml

    │   └── src/

    │       ├── base_path.rs

    │       ├── http_server.rs

    │       ├── main.rs

    │       ├── ups_daemon_state.rs

    │       ├── ups_services.rs

    │       ├── upsd_client.rs

    │       ├── http_server/

    │       │   ├── common.rs

    │       │   ├── hypermedia.rs

    │       │   ├── json.rs

    │       │   ├── middlewares.rs

    │       │   ├── probes.rs

    │       │   └── hypermedia/

    │       │       ├── notifications.rs

    │       │       ├── routes.rs

    │       │       ├── utils.rs

    │       │       ├── routes/

    │       │       │   ├── home.rs

    │       │       │   ├── not_found.rs

    │       │       │   └── ups.rs

    │       │       └── templates/

    │       │           ├── +layout.html

    │       │           ├── +page.html

    │       │           ├── icons.html

    │       │           ├── notification.html

    │       │           ├── ups_table.html

    │       │           ├── not_found/

    │       │           │   └── +page.html

    │       │           └── ups/

    │       │               ├── +page.html

    │       │               ├── ups_info.html

    │       │               └── ups_status.html

    │       ├── ups_services/

    │       │   ├── upsd_poll_service.rs

    │       │   └── upsd_state_service.rs

    │       └── upsd_client/

    │           ├── client.rs

    │           ├── errors.rs

    │           ├── parser.rs

    │           ├── ups_variables.rs

    │           └── parser/

    │               ├── unit_tests.rs

    │               └── unit_tests/

    │                   ├── parser_tests.rs

    │                   └── validation_tests.rs

    ├── tools/

    │   ├── generate_test.sh

    │   ├── dummy_server/

    │   │   ├── dummy_server.Dockerfile

    │   │   ├── setup.sh

    │   │   └── upsd_init.sh

    │   └── test_cluster/

    │       └── k8s-cluster.yaml

    └── .gitea/

        └── workflows/

            ├── publish.yaml

            └── test.yaml

Files Content

(Files content cropped to 300k characters, download full ingest to see more)
================================================
FILE: README.md
================================================
# NUT Web GUI

Light weight web interface for [Network UPS Tools](https://networkupstools.org/).

<div style="width: 100%; display: flex; justify-content: space-between; flex-direction: row; gap: 1rem;">

![DetailImage](docs/images/details.webp)

![ListImage](docs/images/home.webp)

</div>

## Quickstart

```shell
docker run -e UPSD_ADDR=10.0.0.1 -e UPSD_USER=test -e UPSD_PASS=strongpass -p 9000:9000 ghcr.io/superioone/nut_webgui:latest
```

## Features

- Monitors UPS variables with auto refresh.
- Supports INSTCMD calls from GUI.
- 🥔 Potato PC friendly. Small footprint on both resource usage and disk size.
- Basic JSON API.
- Supports RISC-V and older ARM devices.

> In order to run `INSTCMD`, make sure the configured user has proper instcmds granted at `upsd.users`. See
> man([upsd.users](https://networkupstools.org/docs/man/upsd.users.html)).

## Examples

- [Kubernetes with EndpointSlice](docs/kubernetes_example.md)
- [Docker compose](docs/docker_compose.md)

## CPU architecture support

| Arch         | Test Hardware           | Notes                                                                                    |
|--------------|-------------------------|------------------------------------------------------------------------------------------|
| amd64        | AM4 CPU                 | Works across all amd64 platforms.                                                        |
| amd64-v3     | AM4 CPU                 | Snake oil level optimizations with AVX. It mostly reduces response compression overhead. |
| amd64-v4     | Intel® SDE              | Snake oil level optimizations with AVX-512.                                              |
| arm64        | Raspberry Pi 4 Model B  |                                                                                          |
| armv7        | Qemu emulation          |                                                                                          |
| armv6        | Qemu emulation          |                                                                                          |
| riscv64      | Qemu emulation          |                                                                                          |

> amd64 v3 and v4 variants require certain CPU feature flags to run. If you are a crackhead min-max enjoyer (like me), you can use `nut_webgui:latest-amd64-v3` and `nut_webgui:latest-amd64-v4` images.
> See [x86-64 Microarchitecture levels](https://en.wikipedia.org/wiki/X86-64#Microarchitecture_levels) for more details.


## Command-Line arguments

* `--base-path`: Overrides HTTP server base path. Default is `/`.
* `--listen`: Listen address for the HTTP server. Default is `0.0.0.0`.
* `--log-level`: Log level for the HTTP server. Default is `info`.
* `--poll-freq`: UPS[pollfreq](https://networkupstools.org/docs/man/ups.conf.html#_global_directives) in seconds. Default is `30`.
* `--poll-interval`: UPS [pollinterval](https://networkupstools.org/docs/man/ups.conf.html#_global_directives) in seconds. Default is `2`.
* `--port`: Port used by the HTTP server. Default is `9000`.
* `--static-dir`: Directory path for static files. Default is `./static`.
* `--upsd-addr`: UPS daemon address. Default is `localhost`.
* `--upsd-pass`: UPS daemon password.
* `--upsd-port`: UPS daemon port. Default is `3493`.
* `--upsd-user`: UPS daemon username.

## Container image environment variables

* `BASE_PATH`: Overrides HTTP server base path. Default is `/`.
* `LISTEN`: Listen address for the HTTP server. Default is `0.0.0.0`.
* `LOG_LEVEL`: Log level. Default is `info`.
* `POLL_FREQ`: UPS [pollfreq](https://networkupstools.org/docs/man/ups.conf.html#_global_directives) in seconds. Default is `30`.
* `POLL_INTERVAL`: UPS [pollinterval](https://networkupstools.org/docs/man/ups.conf.html#_global_directives) in seconds. Default is `2`.
* `PORT`: Port used by the HTTP server. Default is `9000`.
* `UPSD_ADDR`: UPS daemon address. Default is `localhost`.
* `UPSD_PASS`: UPS daemon password.
* `UPSD_PORT`: UPS daemon port. Default is `3493`.
* `UPSD_USER`: UPS daemon username.

> Log level options: `info`, `warn`, `error`, `debug`, `trace`

> `BASE_PATH` rules:
>
> - Allows multiple path segments. (eg. `segment1/segment2/...`)
> - Whitespaces and trailing forward slash `/` characters will be trimmed. For example, `  base_path   ` and `/base_path/` are treated as the same.
> - Percent encoded characters are not supported.
> - Unlike RFC3986 path definition, `:` and `'` characters are not allowed. However, you can still use some questionable base paths such as `(-_-)/(@_@)/($_$)/nut-xyz.monitor/`

## JSON data API

A simple JSON-based API is available for integration and automation purposes.

OpenAPI 3.1.0 specification files: [json minimized](./docs/openapi3_spec.json) | [yaml](./docs/openapi3_spec.yaml)

## Probes

nut_webgui has basic probe endpoints to check server health and readiness:
- `/probes/health`
- `/probes/readiness`

## Building from source and debugging

See [Building and Debugging.](./docs/building_debugging.md)



================================================
FILE: build_images.sh
================================================
#!/bin/bash
set -e;

# ANSI colors
RST='\033[0m'      # reset
C_G='\033[0;32m'   # color green
C_R='\033[0;31m'   # color red
C_Y='\033[0;33m'   # color yellow
C_Cy='\033[0;36m'  # color cyan

REGISTRY="";
TLS_VERIFY="false";
ALIAS_TAGS="";
DRY_RUN="false";
PUBLISH="false";
ANNOTATION_CONF="./containers/annotation.conf";
USER_NAME="";
USER_PASS="";

while getopts "hdtu:p:a:c:r:" opt; do
    case $opt in
        "d")
            DRY_RUN="true";
            ;;
        "r")
            PUBLISH="true";
            REGISTRY="${OPTARG}";
            if [[ -z "$REGISTRY" ]]; then
                echo -e "${C_R}Error: Registry argument is empty${RST}";
                exit 1;
            fi
            ;;
        "t")
            TLS_VERIFY="true";
            ;;
        "u")
            USER_NAME="${OPTARG}";
            ;;
        "p")
            USER_PASS="${OPTARG}";
            ;;
        "a")
            ALIAS_TAGS="${OPTARG}";
            ;;
        "c")
            if [[ -e "${OPTARG}" ]]; then
                ANNOTATION_CONF="${OPTARG}";
            else
                echo -e "${C_R}Annotation config file does not exits.";
                exit 1;
            fi
            ;;
        "h")
            printf "Usage %s: [-h] [-d] [-r registry] [-t] [-a alias-tags] [-l username] [-p password].\n" $0
            echo "Arguments:"
            echo "  -h                 : Help menu."
            echo "  -d                 : Dry-run. Only prints messages."
            echo "  -r <registry-url>  : Pushes images and manifest to the target registry."
            echo "  -t                 : Enable TLS verification. Default is false."
            echo "  -a <tag1 tag2 ...> : Additional alias tags separated with spaces"
            echo "  -u <username>      : Registry username to login"
            echo "  -p <password>      : User password"
            exit 2;
            ;;
        ?)
            printf "Usage %s: [-h] [-d] [-p registry] [-t] [-a alias-tags].\nUse '%s --h' for flag details.\n" $0 $0
            exit 2;
            ;;
    esac;
done;

source "${ANNOTATION_CONF}";

if [ "$DRY_RUN" == "true" ]; then
    echo -e "${C_Cy}Info: Dry run enabled.${RST}"
fi

if [ "$TLS_VERIFY" != "true" ]; then
    echo -e "${C_Y}Warning: TLS verification disabled.${RST}"
fi

if [ "${PUBLISH}" != "true" ]; then
    echo -e "${C_Cy}Info: Local build only. Images won't be published to the container registry.${RST}"
fi

CREATED_IMAGES="";
DOCKER_FILES=$(find ./containers/ -type f -name *.Dockerfile);
OCI_IMAGE_NAMESPACE="org.opencontainers.image";

function find_arch_variant() {
    case "${1}" in
        amd64)
            echo ""
            ;;
        amd64-v3)
            echo "v3"
            ;;
        amd64-v4)
            echo "v4"
            ;;
        arm64)
            echo "v8"
            ;;
        armv7)
            echo "v7"
            ;;
        armv6)
            echo "v6"
            ;;
        riscv64)
            echo ""
            ;;
        *)
            echo -e "${C_R}Unknown architecture type ${1}.${RST}";
            exit 1
            ;;
    esac;
}

for TARGET_FILE in ${DOCKER_FILES}; do
    _ARCH=$(basename -s ".Dockerfile" "${TARGET_FILE}");
    _IMAGE_TAG="${NAME}:${VERSION}-${_ARCH}";
    _ARCH_VARIANT=$(find_arch_variant "${_ARCH}")

    echo -e "${C_Cy}Dockerfile ${TARGET_FILE}${RST}";
    echo -e "${C_Cy}Building ${_IMAGE_TAG}${RST}";

    test "${DRY_RUN}" != "true" && \
        buildah build \
        --layers \
        --variant "${_ARCH_VARIANT}" \
        --annotation "${OCI_IMAGE_NAMESPACE}.authors=${AUTHORS}" \
        --annotation "${OCI_IMAGE_NAMESPACE}.url=${HOME_URL}" \
        --annotation "${OCI_IMAGE_NAMESPACE}.documentation=${DOCUMENTATION}" \
        --annotation "${OCI_IMAGE_NAMESPACE}.source=${SOURCE}" \
        --annotation "${OCI_IMAGE_NAMESPACE}.version=${VERSION}" \
        --annotation "${OCI_IMAGE_NAMESPACE}.revision=${REVISION}" \
        --annotation "${OCI_IMAGE_NAMESPACE}.licenses=${LICENSES}" \
        --annotation "${OCI_IMAGE_NAMESPACE}.title=${NAME}" \
        --annotation "${OCI_IMAGE_NAMESPACE}.description=${DESCRIPTION}" \
        -t "${_IMAGE_TAG}" \
        -f "${TARGET_FILE}"

    echo -e "${C_G}Container image '${_IMAGE_TAG}' built.${RST}";
    CREATED_IMAGES+="${_IMAGE_TAG} ";
done;

MANIFEST_NAME="${NAME}:${VERSION}";

if [[ "${DRY_RUN}" != "true" ]]; then
    if buildah manifest exists "${MANIFEST_NAME}"; then
        echo -e "${C_R}${MANIFEST_NAME} already exists, remove it before proceeding.${RST}";
        buildah manifest rm "${MANIFEST_NAME}"
        echo -e "${C_Y}Removed ${MANIFEST_NAME}${RST}";
    fi

    echo -e "${C_Y}Creating manifest: ${MANIFEST_NAME}.${RST}";

    buildah manifest create \
        --annotation "${OCI_IMAGE_NAMESPACE}.authors=${AUTHORS}" \
        --annotation "${OCI_IMAGE_NAMESPACE}.url=${HOME_URL}" \
        --annotation "${OCI_IMAGE_NAMESPACE}.documentation=${DOCUMENTATION}" \
        --annotation "${OCI_IMAGE_NAMESPACE}.source=${SOURCE}" \
        --annotation "${OCI_IMAGE_NAMESPACE}.version=${VERSION}" \
        --annotation "${OCI_IMAGE_NAMESPACE}.revision=${REVISION}" \
        --annotation "${OCI_IMAGE_NAMESPACE}.licenses=${LICENSES}" \
        --annotation "${OCI_IMAGE_NAMESPACE}.title=${NAME}" \
        --annotation "${OCI_IMAGE_NAMESPACE}.description=${DESCRIPTION}" \
        "${MANIFEST_NAME}"
fi

for IMAGE in ${CREATED_IMAGES}; do
    _TAG_ARCH=$(echo -n "${IMAGE}" | awk "match(\$0,/^${NAME}:${VERSION}-(.*)/, matches) {print matches[1]}");
    _ARCH_VARIANT=$(find_arch_variant "${_TAG_ARCH}")

    test "${DRY_RUN}" != "true" && \
        buildah manifest add --variant "${_ARCH_VARIANT}" "${MANIFEST_NAME}" "${IMAGE}";

    echo -e "${C_Y}${IMAGE} added to ${MANIFEST_NAME}${RST}.";
done;

if [[ "$PUBLISH" == "true" ]]; then
    test "${DRY_RUN}" != "true" && \
        buildah login --tls-verify="${TLS_VERIFY}" -u "${USER_NAME}" -p "${USER_PASS}" "${REGISTRY}";

    TAG_LIST=("${VERSION}" ${ALIAS_TAGS[@]});
    for TAG in "${TAG_LIST[@]}";
    do
        if [ -n "${TAG}" ]; then
            echo -e "${C_Y}Pushing manifest '${MANIFEST_NAME}' as '${REGISTRY,,}/${NAME}:${TAG}'.${RST}"

            test "${DRY_RUN}" != "true" && \
                buildah manifest push --tls-verify="${TLS_VERIFY}" --all "${MANIFEST_NAME}" "docker://${REGISTRY,,}/${NAME}:${TAG}"

            echo -e "${C_G}Push '${MANIFEST_NAME}' completed.${RST}";
        fi
    done;
fi

echo -e "${C_G}Task Completed${RST}"



================================================
FILE: CHANGELOG
================================================
# v0.4.2 - May 08, 2025

## Added

- Configuration option for HTTP server base path.

# v0.4.1 - April 13, 2025

## Changed
- The NUT protocol parser has been optimized slightly better performance.
- The UI notifications have been simplified.

## Fixed
- Missing cache-control headers caused 308 redirects to `not found` pages.
- The page cannot be routed when the URL contains a trailing forward slash.

# v0.4.0 - October 12, 2024

## Changed

- Bump `apexcharts` version from `3.50.0` to `3.53.0`.
- Bump `htmx` version from `2.0.1` to `2.0.3`.
- Bump server crate versions to latest.
- Generalized HTTP error responses based on RFC9457/RFC7807.
- JSON API returns HTTP 5xx error codes with problem details when daemon connection is lost.
- Logger redacts `upsd_pass` config when server starts with `LOG_LEVEL=DEBUG`
- Logging style is improved in general. No more `{:?}` dumps.
- Remaining battery runtime shown in yMdhms date-time format instead of raw seconds.
- UPS table elements are sorted by UPS name.
- Voltage texts are vertically centered on the UI.
- `health` probe returns HTTP 500 status code when daemon connection is lost.
- `health` probe returns application/json response. Response contains basic info like last sync time, daemon status, and daemon host.

## Added

- Display UPS manufacturer and model information on UPS page.
- `readiness` probe for Kubernetes deployments.
- upsd_client logs upsd protocol messages when `LOG_LEVEL` is set to `TRACE`.
- OpenAPI specification is added to docs.

## Fixed

- A single failing UPS driver distrupts other UPS devices' states.
- Probe endpoints don't support CORS.
- Server doesn't delete failing/disconnected UPS devices from both HTML and JSON responses.
- Texts get overlap in table elements when screen size is too small.
- UPS info page displays incorrect power unit for the apparent power values (ups.power).
- On certain light themes, text colors blend with background and becomes unreadable.
- upsd_client uses wrong error types when list commands fail.

# v0.3.2 - September 29, 2024

## Fixed

- Corrected numeric type handling to prevent `Invalid digit found` errors on certain UPS devices.

# v0.3.1 - July 19, 2024

## Fixed

- Inconsistent UPS table cell sizing. (Chromium)
- Missing gauge track background color. (Chromium)

# v0.3.0 - July 17, 2024

## Added

- Brotli compression support.
- UPS beeper, UPS status and server connectivity indicators.
- --poll-interval and partial update support to get critical variable updates more often.
- Support for ARM-v6, ARM-v7, RISC-v64 and x86-64 micro-architecture levels.
- Self-contained binary releases for non-container environments.

## Changed

- Container base image changed to busybox, image sizes are now ~5MiB smaller than 0.2.1.
- Security updates for dependencies.
- Switched to apexcharts.

## Fixed

- Gauge colors change correctly when theme changes.
- Better theme initialization to prevent flashbang effect when page loaded.

## Deleted

- Lofi theme.

# v0.2.1 - April 08, 2024

## Added

- 18 additional theme options.

## Changed

- Updated all dependencies.

# v0.2.0 - March 18, 2024

## Added

- Basic JSON API.
- Health probe endpoint at `/probes/health`.
- Input and battery voltage details on the individual UPS info page.
- Gzip/deflate compression support for HTTP responses.
- Added logo to the UI header.
- `hx-boost` support at the HTML body level. 

## Changed

- UI will show `ups.realpower` value if UPS is supports this variable; otherwise, power is calculated using the formula (`ups.realpower.nominal` * `ups.load` ) / 100.
- All dependencies have been updated to their latest stable versions.

# v0.1.1, January 21, 2024

## Added 

- New icon and title names to make browsers tabs more distinguishable.

## Changed

- All dependencies are up-to-date, addressing [RUSTSEC-2024-0003](https://rustsec.org/advisories/RUSTSEC-2024-0003.html)

## Fixed

- Incorrect page sizing on mobile devices.
- UPS path now routes to 404 page when requested UPS does not exists.



================================================
FILE: LICENSE
================================================

                                 Apache License
                           Version 2.0, January 2004
                        http://www.apache.org/licenses/

   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION

   1. Definitions.

      "License" shall mean the terms and conditions for use, reproduction,
      and distribution as defined by Sections 1 through 9 of this document.

      "Licensor" shall mean the copyright owner or entity authorized by
      the copyright owner that is granting the License.

      "Legal Entity" shall mean the union of the acting entity and all
      other entities that control, are controlled by, or are under common
      control with that entity. For the purposes of this definition,
      "control" means (i) the power, direct or indirect, to cause the
      direction or management of such entity, whether by contract or
      otherwise, or (ii) ownership of fifty percent (50%) or more of the
      outstanding shares, or (iii) beneficial ownership of such entity.

      "You" (or "Your") shall mean an individual or Legal Entity
      exercising permissions granted by this License.

      "Source" form shall mean the preferred form for making modifications,
      including but not limited to software source code, documentation
      source, and configuration files.

      "Object" form shall mean any form resulting from mechanical
      transformation or translation of a Source form, including but
      not limited to compiled object code, generated documentation,
      and conversions to other media types.

      "Work" shall mean the work of authorship, whether in Source or
      Object form, made available under the License, as indicated by a
      copyright notice that is included in or attached to the work
      (an example is provided in the Appendix below).

      "Derivative Works" shall mean any work, whether in Source or Object
      form, that is based on (or derived from) the Work and for which the
      editorial revisions, annotations, elaborations, or other modifications
      represent, as a whole, an original work of authorship. For the purposes
      of this License, Derivative Works shall not include works that remain
      separable from, or merely link (or bind by name) to the interfaces of,
      the Work and Derivative Works thereof.

      "Contribution" shall mean any work of authorship, including
      the original version of the Work and any modifications or additions
      to that Work or Derivative Works thereof, that is intentionally
      submitted to Licensor for inclusion in the Work by the copyright owner
      or by an individual or Legal Entity authorized to submit on behalf of
      the copyright owner. For the purposes of this definition, "submitted"
      means any form of electronic, verbal, or written communication sent
      to the Licensor or its representatives, including but not limited to
      communication on electronic mailing lists, source code control systems,
      and issue tracking systems that are managed by, or on behalf of, the
      Licensor for the purpose of discussing and improving the Work, but
      excluding communication that is conspicuously marked or otherwise
      designated in writing by the copyright owner as "Not a Contribution."

      "Contributor" shall mean Licensor and any individual or Legal Entity
      on behalf of whom a Contribution has been received by Licensor and
      subsequently incorporated within the Work.

   2. Grant of Copyright License. Subject to the terms and conditions of
      this License, each Contributor hereby grants to You a perpetual,
      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
      copyright license to reproduce, prepare Derivative Works of,
      publicly display, publicly perform, sublicense, and distribute the
      Work and such Derivative Works in Source or Object form.

   3. Grant of Patent License. Subject to the terms and conditions of
      this License, each Contributor hereby grants to You a perpetual,
      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
      (except as stated in this section) patent license to make, have made,
      use, offer to sell, sell, import, and otherwise transfer the Work,
      where such license applies only to those patent claims licensable
      by such Contributor that are necessarily infringed by their
      Contribution(s) alone or by combination of their Contribution(s)
      with the Work to which such Contribution(s) was submitted. If You
      institute patent litigation against any entity (including a
      cross-claim or counterclaim in a lawsuit) alleging that the Work
      or a Contribution incorporated within the Work constitutes direct
      or contributory patent infringement, then any patent licenses
      granted to You under this License for that Work shall terminate
      as of the date such litigation is filed.

   4. Redistribution. You may reproduce and distribute copies of the
      Work or Derivative Works thereof in any medium, with or without
      modifications, and in Source or Object form, provided that You
      meet the following conditions:

      (a) You must give any other recipients of the Work or
          Derivative Works a copy of this License; and

      (b) You must cause any modified files to carry prominent notices
          stating that You changed the files; and

      (c) You must retain, in the Source form of any Derivative Works
          that You distribute, all copyright, patent, trademark, and
          attribution notices from the Source form of the Work,
          excluding those notices that do not pertain to any part of
          the Derivative Works; and

      (d) If the Work includes a "NOTICE" text file as part of its
          distribution, then any Derivative Works that You distribute must
          include a readable copy of the attribution notices contained
          within such NOTICE file, excluding those notices that do not
          pertain to any part of the Derivative Works, in at least one
          of the following places: within a NOTICE text file distributed
          as part of the Derivative Works; within the Source form or
          documentation, if provided along with the Derivative Works; or,
          within a display generated by the Derivative Works, if and
          wherever such third-party notices normally appear. The contents
          of the NOTICE file are for informational purposes only and
          do not modify the License. You may add Your own attribution
          notices within Derivative Works that You distribute, alongside
          or as an addendum to the NOTICE text from the Work, provided
          that such additional attribution notices cannot be construed
          as modifying the License.

      You may add Your own copyright statement to Your modifications and
      may provide additional or different license terms and conditions
      for use, reproduction, or distribution of Your modifications, or
      for any such Derivative Works as a whole, provided Your use,
      reproduction, and distribution of the Work otherwise complies with
      the conditions stated in this License.

   5. Submission of Contributions. Unless You explicitly state otherwise,
      any Contribution intentionally submitted for inclusion in the Work
      by You to the Licensor shall be under the terms and conditions of
      this License, without any additional terms or conditions.
      Notwithstanding the above, nothing herein shall supersede or modify
      the terms of any separate license agreement you may have executed
      with Licensor regarding such Contributions.

   6. Trademarks. This License does not grant permission to use the trade
      names, trademarks, service marks, or product names of the Licensor,
      except as required for reasonable and customary use in describing the
      origin of the Work and reproducing the content of the NOTICE file.

   7. Disclaimer of Warranty. Unless required by applicable law or
      agreed to in writing, Licensor provides the Work (and each
      Contributor provides its Contributions) on an "AS IS" BASIS,
      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
      implied, including, without limitation, any warranties or conditions
      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
      PARTICULAR PURPOSE. You are solely responsible for determining the
      appropriateness of using or redistributing the Work and assume any
      risks associated with Your exercise of permissions under this License.

   8. Limitation of Liability. In no event and under no legal theory,
      whether in tort (including negligence), contract, or otherwise,
      unless required by applicable law (such as deliberate and grossly
      negligent acts) or agreed to in writing, shall any Contributor be
      liable to You for damages, including any direct, indirect, special,
      incidental, or consequential damages of any character arising as a
      result of this License or out of the use or inability to use the
      Work (including but not limited to damages for loss of goodwill,
      work stoppage, computer failure or malfunction, or any and all
      other commercial damages or losses), even if such Contributor
      has been advised of the possibility of such damages.

   9. Accepting Warranty or Additional Liability. While redistributing
      the Work or Derivative Works thereof, You may choose to offer,
      and charge a fee for, acceptance of support, warranty, indemnity,
      or other liability obligations and/or rights consistent with this
      License. However, in accepting such obligations, You may act only
      on Your own behalf and on Your sole responsibility, not on behalf
      of any other Contributor, and only if You agree to indemnify,
      defend, and hold each Contributor harmless for any liability
      incurred by, or claims asserted against, such Contributor by reason
      of your accepting any such warranty or additional liability.

   END OF TERMS AND CONDITIONS

   APPENDIX: How to apply the Apache License to your work.

      To apply the Apache License to your work, attach the following
      boilerplate notice, with the fields enclosed by brackets "[]"
      replaced with your own identifying information. (Don't include
      the brackets!)  The text should be enclosed in the appropriate
      comment syntax for the file format. We also recommend that a
      file or class name and description of purpose be included on the
      same "printed page" as the copyright notice for easier
      identification within third-party archives.

   Copyright [yyyy] [name of copyright owner]

   Licensed under the Apache License, Version 2.0 (the "License");
   you may not use this file except in compliance with the License.
   You may obtain a copy of the License at

       http://www.apache.org/licenses/LICENSE-2.0

   Unless required by applicable law or agreed to in writing, software
   distributed under the License is distributed on an "AS IS" BASIS,
   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
   See the License for the specific language governing permissions and
   limitations under the License.



================================================
FILE: Makefile
================================================
PROJECT_NAME     := $(shell cargo read-manifest --manifest-path ./server/Cargo.toml | jq -r ".name")
PROJECT_VER      := $(shell cargo read-manifest --manifest-path ./server/Cargo.toml | jq -r ".version")
BIN_DIR          := ./bin
STATIC_DIR       := ./client/dist
NODE_MODULES_DIR := ./client/node_modules
PROJECT_SRCS     := $(shell find server/src -type f -iname *.rs) \
		    $(shell find server/src -type f -iname *.html) \
		    ./server/Cargo.toml \
		    ./server/Cargo.lock
STATIC_SRCS      := client/package.json \
		    client/pnpm-lock.yaml \
		    client/tailwind.config.js \
		    client/src/style.css \
		    $(shell find client/src -type f -iname *.js) \
		    $(shell find client/static -type f) \
		    $(shell find server/src -type f -iname *.html)
STATIC_OBJS      := $(addprefix $(BIN_DIR)/static/,index.js style.css icon.svg)
DIST_DIR          = $(BIN_DIR)/dist
DOCKER_TEMPLATE   = ./containers/Dockerfile.template
PACK_TARGETS      = x86-64-musl \
		    x86-64-v3-musl \
		    x86-64-v4-musl \
		    aarch64-musl \
		    aarch64-gnu \
		    armv6-musleabi \
		    armv7-musleabi \
		    riscv64gc-gnu

fn_output_path    = $(BIN_DIR)/$(1)/$(PROJECT_NAME)
fn_target_path    = server/target/$(1)/$(PROJECT_NAME)

# RECIPIES:
# ==============================================================================
# build                : Generates server binary for the current system's CPU 
#                        architecture and OS.
# build-x86-64-musl    : linux/amd64, self contained with musl.
# build-x86-64-v3-musl : linux/amd64/v3, self contained with musl.
# build-x86-64-v4-musl : linux/amd64/v4, self contained with musl.
# build-aarch64-musl   : linux/arm64/v8, self contained with musl.
# build-aarch64-gnu    : linux/arm64/v8, glibc.
# build-armv6-musleabi : linux/arm/v6, self contained with musl, soft-floats.
# build-armv7-musleabi : linux/arm/v7, self contained with musl, soft-floats.
# build-riscv64gc-gnu  : linux/riscv64, glibc.
# build-client         : Generates front-end static files. Requires node and pnpm.
# build-all            : Cross compiles everything. Make sure host system has all
#                        the necessary libs and tools for arm, x86-64 and riscv.
# generate-dockerfiles : Generates dockerfiles for all supported architectures.
# pack                 : tar.gz all compiled targets under the bin directory.
# test                 : Calls available test suites.
# clean                : Clears all build directories.

.PHONY: build
build: $(call fn_output_path,release) build-client

$(call fn_output_path,release) &: $(PROJECT_SRCS)
	@echo "Building binaries for the current system's architecture."
	@cd ./server && cargo build --release
	@install -D $(call fn_target_path,release) $(call fn_output_path,release)

# x86-64 with different micro-architecture levels

.PHONY: build-x86-64-musl
build-x86-64-musl: $(call fn_output_path,x86-64-musl) build-client

$(call fn_output_path,x86-64-musl) &: $(PROJECT_SRCS)
	@echo "Building for x86_64-unknown-linux-musl"
	@cd ./server && \
		export RUSTFLAGS="-Clink-self-contained=yes -Clinker=rust-lld" && \
		cargo build --target=x86_64-unknown-linux-musl --release
	@install -D $(call fn_target_path,x86_64-unknown-linux-musl/release) \
		$(call fn_output_path,x86-64-musl)

.PHONY: build-x86-64-v3-musl
build-x86-64-v3-musl: $(call fn_output_path,x86-64-v3-musl) build-client

$(call fn_output_path,x86-64-v3-musl) &: $(PROJECT_SRCS)
	@echo "Building for x86_64-v3-unknown-linux-musl"
	@cd ./server && \
		export RUSTFLAGS="-Clink-self-contained=yes -Ctarget-cpu=x86-64-v3 -Clinker=rust-lld" && \
		cargo build --target=x86_64-unknown-linux-musl --release
	@install -D $(call fn_target_path,x86_64-unknown-linux-musl/release) \
		$(call fn_output_path,x86-64-v3-musl)

.PHONY: build-x86-64-v4-musl
build-x86-64-v4-musl: $(call fn_output_path,x86-64-v4-musl) build-client

$(call fn_output_path,x86-64-v4-musl) &: $(PROJECT_SRCS)
	@echo "Building for x86_64-v4-unknown-linux-musl"
	@cd ./server && \
		export RUSTFLAGS="-Clink-self-contained=yes -Ctarget-cpu=x86-64-v4 -Clinker=rust-lld" && \
		cargo build --target=x86_64-unknown-linux-musl --release
	@install -D $(call fn_target_path,x86_64-unknown-linux-musl/release) \
		$(call fn_output_path,x86-64-v4-musl)

# ARM64v8

.PHONY: build-aarch64-musl
build-aarch64-musl: $(call fn_output_path,aarch64-musl) build-client

$(call fn_output_path,aarch64-musl) &: $(PROJECT_SRCS)
	@echo "Building for aarch64-unknown-linux-musl"
	@cd ./server && \
		export RUSTFLAGS="-Clink-self-contained=yes -Clinker=rust-lld" && \
		cargo build --target=aarch64-unknown-linux-musl --release
	@install -D $(call fn_target_path,aarch64-unknown-linux-musl/release) \
		$(call fn_output_path,aarch64-musl)

.PHONY: build-aarch64-gnu
build-aarch64-gnu: $(call fn_output_path,aarch64-gnu) build-client

$(call fn_output_path,aarch64-gnu) &: $(PROJECT_SRCS)
	@echo "Building for aarch64-unknown-linux-gnu"
	@cd ./server && \
		export RUSTFLAGS="-Clinker=aarch64-linux-gnu-gcc" && \
		cargo build --target=aarch64-unknown-linux-gnu --release
	@install -D $(call fn_target_path,aarch64-unknown-linux-gnu/release) \
		$(call fn_output_path,aarch64-gnu)

# ARMv7

.PHONY: build-armv7-musleabi
build-armv7-musleabi: $(call fn_output_path,armv7-musleabi) build-client

$(call fn_output_path,armv7-musleabi) &: $(PROJECT_SRCS)
	@echo "Building for armv7-unknown-linux-musleabi"
	@cd ./server && \
		export RUSTFLAGS="-Clink-self-contained=yes -Clinker=rust-lld" && \
		cargo build --target=armv7-unknown-linux-musleabi --release
	@install -D $(call fn_target_path,armv7-unknown-linux-musleabi/release) \
		$(call fn_output_path,armv7-musleabi)

# ARMv6

.PHONY: build-armv6-musleabi
build-armv6-musleabi: $(call fn_output_path,armv6-musleabi) build-client

$(call fn_output_path,armv6-musleabi) &: $(PROJECT_SRCS)
	@echo "Building for arm-unknown-linux-musleabi"
	@cd ./server && \
		export RUSTFLAGS="-Clink-self-contained=yes -Clinker=rust-lld" && \
		cargo build --target=arm-unknown-linux-musleabi --release
	@install -D $(call fn_target_path,arm-unknown-linux-musleabi/release) \
		$(call fn_output_path,armv6-musleabi)

# RISC-V64

.PHONY: build-riscv64gc-gnu
build-riscv64gc-gnu: $(call fn_output_path,riscv64gc-gnu) build-client

$(call fn_output_path,riscv64gc-gnu) &: $(PROJECT_SRCS)
	@echo "Building for riscv64gc-unknown-linux-gnu"
	@cd ./server && \
		export RUSTFLAGS="-Clinker=riscv64-linux-gnu-gcc -Ctarget-feature=+crt-static" && \
		cargo build --target=riscv64gc-unknown-linux-gnu --release
	@install -D $(call fn_target_path,riscv64gc-unknown-linux-gnu/release) \
		$(call fn_output_path,riscv64gc-gnu)

.PHONY: build-client
build-client: $(STATIC_OBJS)

$(STATIC_OBJS) &: $(STATIC_SRCS)
	@pnpm install -C ./client/
	@pnpm run -C ./client/ build --outdir=../$(BIN_DIR)/static --minify

.PHONY: build-all
build-all: $(addprefix build-,$(PACK_TARGETS))

.PHONY: pack
pack: $(STATIC_OBJS)
	@install -d $(DIST_DIR)
	@for target in $(PACK_TARGETS); do \
		if [ -f "$(BIN_DIR)/$${target}/$(PROJECT_NAME)" ]; then \
			OUTPUT_TARGZ="$(DIST_DIR)/$(PROJECT_NAME)_$(PROJECT_VER)_$${target}.tar.gz"; \
			cp -r "$(BIN_DIR)/static" "$(BIN_DIR)/$${target}"; \
			tar -czf "$${OUTPUT_TARGZ}" -C "$(BIN_DIR)/" "$${target}"; \
			echo "Packed $${target}.tar.gz"; \
			sha256sum "$${OUTPUT_TARGZ}" > "$${OUTPUT_TARGZ}.sha256"; \
			echo "Generated $${target}.tar.gz.sha256"; \
		fi; \
	done;

.PHONY: test
test:
	@cd ./server && cargo test

.PHONY: generate-dockerfiles
generate-dockerfiles: 
	@echo "amd64.Dockerfile"
	@sed -e 's/{BIN_DIR}/x86-64-musl/g' \
		-e 's/{PLATFORM}/linux\/amd64/g' \
		-e 's/{BUSYBOX_LABEL}/stable-musl/g' \
		"$(DOCKER_TEMPLATE)" > ./containers/amd64.Dockerfile
	@echo "amd64-v3.Dockerfile"
	@sed -e 's/{BIN_DIR}/x86-64-v3-musl/g' \
		-e 's/{PLATFORM}/linux\/amd64/g' \
		-e 's/{BUSYBOX_LABEL}/stable-musl/g' \
		"$(DOCKER_TEMPLATE)" > ./containers/amd64-v3.Dockerfile
	@echo "amd64-v4.Dockerfile"
	@sed -e 's/{BIN_DIR}/x86-64-v4-musl/g' \
		-e 's/{PLATFORM}/linux\/amd64/g' \
		-e 's/{BUSYBOX_LABEL}/stable-musl/g' \
		"$(DOCKER_TEMPLATE)" > ./containers/amd64-v4.Dockerfile
	@echo "arm64.Dockerfile"
	@sed -e 's/{BIN_DIR}/aarch64-musl/g' \
		-e 's/{PLATFORM}/linux\/arm64\/v8/g' \
		-e 's/{BUSYBOX_LABEL}/stable-musl/g' \
		"$(DOCKER_TEMPLATE)" > ./containers/arm64.Dockerfile
	@echo "armv7.Dockerfile"
	@sed -e 's/{BIN_DIR}/armv7-musleabi/g' \
		-e 's/{PLATFORM}/linux\/arm\/v7/g' \
		-e 's/{BUSYBOX_LABEL}/stable-musl/g' \
		"$(DOCKER_TEMPLATE)" > ./containers/armv7.Dockerfile
	@echo "armv6.Dockerfile"
	@sed -e 's/{BIN_DIR}/armv6-musleabi/g' \
		-e 's/{PLATFORM}/linux\/arm\/v6/g' \
		-e 's/{BUSYBOX_LABEL}/stable-musl/g' \
		"$(DOCKER_TEMPLATE)" > ./containers/armv6.Dockerfile
	@echo "riscv64.Dockerfile"
	@sed -e 's/{BIN_DIR}/riscv64gc-gnu/g' \
		-e 's/{PLATFORM}/linux\/riscv64/g' \
		-e 's/{BUSYBOX_LABEL}/stable-musl/g' \
		"$(DOCKER_TEMPLATE)" > ./containers/riscv64.Dockerfile
	@echo "Generating annotation.conf"
	@CARGO_MANIFEST=$$(cargo read-manifest --manifest-path ./server/Cargo.toml); \
	echo "VERSION=\"$$(echo -n "$${CARGO_MANIFEST}" | jq -r ".version")\"" > ./containers/annotation.conf; \
	echo "HOME_URL=\"$$(echo -n "$${CARGO_MANIFEST}" | jq -r ".homepage")\"" >> ./containers/annotation.conf; \
	echo "NAME=\"$$(echo -n "$${CARGO_MANIFEST}" | jq -r ".name")\"" >> ./containers/annotation.conf; \
	echo "LICENSES=\"$$(echo -n "$${CARGO_MANIFEST}" | jq -r ".license")\"" >> ./containers/annotation.conf; \
	echo "AUTHORS=\"$$(echo -n "$${CARGO_MANIFEST}" | jq -r '.authors | join(" ")')\"" >> ./containers/annotation.conf; \
	echo "DOCUMENTATION=\"$$(echo -n "$${CARGO_MANIFEST}" | jq -r ".documentation")\"" >> ./containers/annotation.conf; \
	echo "SOURCE=\"$$(echo -n "$${CARGO_MANIFEST}" | jq -r ".repository")\"" >> ./containers/annotation.conf; \
	echo "DESCRIPTION=\"$$(echo -n "$${CARGO_MANIFEST}" | jq -r ".description")\"" >> ./containers/annotation.conf; \
	echo "REVISION=\"$$(git rev-parse --verify HEAD)\"" >> ./containers/annotation.conf;
	
.PHONY: clean
clean:
	@echo "Cleaning artifacts"
	@cd server && cargo clean
	@if [ -d "$(BIN_DIR)" ]; then rm -r "$(BIN_DIR)"; fi;
	@if [ -d "$(STATIC_DIR)" ]; then rm -r "$(STATIC_DIR)"; fi;
	@if [ -d "$(NODE_MODULES_DIR)" ]; then rm -r "$(NODE_MODULES_DIR)"; fi;
	@echo "Clean completed"



================================================
FILE: rustfmt.toml
================================================
tab_spaces = 2



================================================
FILE: start_dev.sh
================================================
#!/bin/bash
set -e;

install -D "./client/static/icon.svg" "./client/dist/debug/icon.svg"

# Makes sures node_modules folder is initializes.
pnpm install -C ./client/

trap 'echo "Shutting down dev server"; exit;' INT KILL ABRT;

(pnpm run -C ./client dev-js; echo "Esbuild Stopped";) \
    & (pnpm run -C ./client dev-css; echo "Tailwind Stopped";) \
    & (cargo watch -C ./server -x "run -- --static-dir ../client/dist/debug ${BASE_PATH:+"--base-path=$(printf %q "${BASE_PATH}")"} --log-level debug ${UPSD_ADDR:+"--upsd-addr=$( printf %q "${UPSD_ADDR}")"} ${UPSD_PORT:+"--upsd-addr=$( printf %q "${UPSD_PORT}" )"} ${UPSD_USR:+"--upsd-user=$(printf %q "${UPSD_USR}" )"} ${UPSD_PASS:+"--upsd-pass=$(printf %q "${UPSD_PASS}")"}"; echo "Cargo Watch Stopped";)



================================================
FILE: client/package.json
================================================
{
  "type": "module",
  "engines": {
    "node": ">=20"
  },
  "private": true,
  "name": "nut_webgui-client",
  "version": "0.4.0",
  "description": "Bundles all client side web components and dependencies.",
  "scripts": {
    "dev-js": "esbuild ./src/index.js --bundle --outdir=./dist/debug --target=firefox109,chrome108,safari15 --format=iife --watch=forever",
    "dev-css": "tailwindcss -i ./src/style.css -o ./dist/debug/style.css --minify --watch",
    "build": "node ./scripts/build.js --outdir=./dist/release"
  },
  "keywords": [],
  "author": "Timur Olur",
  "devDependencies": {
    "daisyui": "^4.12.14",
    "esbuild": "^0.24.0",
    "tailwindcss": "^3.4.15",
    "typescript": "^5.7.2"
  },
  "dependencies": {
    "apexcharts": "3.54.1",
    "htmx.org": "^2.0.3",
    "idiomorph": "^0.3.0"
  }
}



================================================
FILE: client/pnpm-lock.yaml
================================================
lockfileVersion: '9.0'

settings:
  autoInstallPeers: true
  excludeLinksFromLockfile: false

importers:

  .:
    dependencies:
      apexcharts:
        specifier: 3.54.1
        version: 3.54.1
      htmx.org:
        specifier: ^2.0.3
        version: 2.0.3
      idiomorph:
        specifier: ^0.3.0
        version: 0.3.0
    devDependencies:
      daisyui:
        specifier: ^4.12.14
        version: 4.12.14(postcss@8.4.49)
      esbuild:
        specifier: ^0.24.0
        version: 0.24.0
      tailwindcss:
        specifier: ^3.4.15
        version: 3.4.15
      typescript:
        specifier: ^5.7.2
        version: 5.7.2

packages:

  '@alloc/quick-lru@5.2.0':
    resolution: {integrity: sha512-UrcABB+4bUrFABwbluTIBErXwvbsU/V7TZWfmbgJfbkwiBuziS9gxdODUyuiecfdGQ85jglMW6juS3+z5TsKLw==}
    engines: {node: '>=10'}

  '@esbuild/aix-ppc64@0.24.0':
    resolution: {integrity: sha512-WtKdFM7ls47zkKHFVzMz8opM7LkcsIp9amDUBIAWirg70RM71WRSjdILPsY5Uv1D42ZpUfaPILDlfactHgsRkw==}
    engines: {node: '>=18'}
    cpu: [ppc64]
    os: [aix]

  '@esbuild/android-arm64@0.24.0':
    resolution: {integrity: sha512-Vsm497xFM7tTIPYK9bNTYJyF/lsP590Qc1WxJdlB6ljCbdZKU9SY8i7+Iin4kyhV/KV5J2rOKsBQbB77Ab7L/w==}
    engines: {node: '>=18'}
    cpu: [arm64]
    os: [android]

  '@esbuild/android-arm@0.24.0':
    resolution: {integrity: sha512-arAtTPo76fJ/ICkXWetLCc9EwEHKaeya4vMrReVlEIUCAUncH7M4bhMQ+M9Vf+FFOZJdTNMXNBrWwW+OXWpSew==}
    engines: {node: '>=18'}
    cpu: [arm]
    os: [android]

  '@esbuild/android-x64@0.24.0':
    resolution: {integrity: sha512-t8GrvnFkiIY7pa7mMgJd7p8p8qqYIz1NYiAoKc75Zyv73L3DZW++oYMSHPRarcotTKuSs6m3hTOa5CKHaS02TQ==}
    engines: {node: '>=18'}
    cpu: [x64]
    os: [android]

  '@esbuild/darwin-arm64@0.24.0':
    resolution: {integrity: sha512-CKyDpRbK1hXwv79soeTJNHb5EiG6ct3efd/FTPdzOWdbZZfGhpbcqIpiD0+vwmpu0wTIL97ZRPZu8vUt46nBSw==}
    engines: {node: '>=18'}
    cpu: [arm64]
    os: [darwin]

  '@esbuild/darwin-x64@0.24.0':
    resolution: {integrity: sha512-rgtz6flkVkh58od4PwTRqxbKH9cOjaXCMZgWD905JOzjFKW+7EiUObfd/Kav+A6Gyud6WZk9w+xu6QLytdi2OA==}
    engines: {node: '>=18'}
    cpu: [x64]
    os: [darwin]

  '@esbuild/freebsd-arm64@0.24.0':
    resolution: {integrity: sha512-6Mtdq5nHggwfDNLAHkPlyLBpE5L6hwsuXZX8XNmHno9JuL2+bg2BX5tRkwjyfn6sKbxZTq68suOjgWqCicvPXA==}
    engines: {node: '>=18'}
    cpu: [arm64]
    os: [freebsd]

  '@esbuild/freebsd-x64@0.24.0':
    resolution: {integrity: sha512-D3H+xh3/zphoX8ck4S2RxKR6gHlHDXXzOf6f/9dbFt/NRBDIE33+cVa49Kil4WUjxMGW0ZIYBYtaGCa2+OsQwQ==}
    engines: {node: '>=18'}
    cpu: [x64]
    os: [freebsd]

  '@esbuild/linux-arm64@0.24.0':
    resolution: {integrity: sha512-TDijPXTOeE3eaMkRYpcy3LarIg13dS9wWHRdwYRnzlwlA370rNdZqbcp0WTyyV/k2zSxfko52+C7jU5F9Tfj1g==}
    engines: {node: '>=18'}
    cpu: [arm64]
    os: [linux]

  '@esbuild/linux-arm@0.24.0':
    resolution: {integrity: sha512-gJKIi2IjRo5G6Glxb8d3DzYXlxdEj2NlkixPsqePSZMhLudqPhtZ4BUrpIuTjJYXxvF9njql+vRjB2oaC9XpBw==}
    engines: {node: '>=18'}
    cpu: [arm]
    os: [linux]

  '@esbuild/linux-ia32@0.24.0':
    resolution: {integrity: sha512-K40ip1LAcA0byL05TbCQ4yJ4swvnbzHscRmUilrmP9Am7//0UjPreh4lpYzvThT2Quw66MhjG//20mrufm40mA==}
    engines: {node: '>=18'}
    cpu: [ia32]
    os: [linux]

  '@esbuild/linux-loong64@0.24.0':
    resolution: {integrity: sha512-0mswrYP/9ai+CU0BzBfPMZ8RVm3RGAN/lmOMgW4aFUSOQBjA31UP8Mr6DDhWSuMwj7jaWOT0p0WoZ6jeHhrD7g==}
    engines: {node: '>=18'}
    cpu: [loong64]
    os: [linux]

  '@esbuild/linux-mips64el@0.24.0':
    resolution: {integrity: sha512-hIKvXm0/3w/5+RDtCJeXqMZGkI2s4oMUGj3/jM0QzhgIASWrGO5/RlzAzm5nNh/awHE0A19h/CvHQe6FaBNrRA==}
    engines: {node: '>=18'}
    cpu: [mips64el]
    os: [linux]

  '@esbuild/linux-ppc64@0.24.0':
    resolution: {integrity: sha512-HcZh5BNq0aC52UoocJxaKORfFODWXZxtBaaZNuN3PUX3MoDsChsZqopzi5UupRhPHSEHotoiptqikjN/B77mYQ==}
    engines: {node: '>=18'}
    cpu: [ppc64]
    os: [linux]

  '@esbuild/linux-riscv64@0.24.0':
    resolution: {integrity: sha512-bEh7dMn/h3QxeR2KTy1DUszQjUrIHPZKyO6aN1X4BCnhfYhuQqedHaa5MxSQA/06j3GpiIlFGSsy1c7Gf9padw==}
    engines: {node: '>=18'}
    cpu: [riscv64]
    os: [linux]

  '@esbuild/linux-s390x@0.24.0':
    resolution: {integrity: sha512-ZcQ6+qRkw1UcZGPyrCiHHkmBaj9SiCD8Oqd556HldP+QlpUIe2Wgn3ehQGVoPOvZvtHm8HPx+bH20c9pvbkX3g==}
    engines: {node: '>=18'}
    cpu: [s390x]
    os: [linux]

  '@esbuild/linux-x64@0.24.0':
    resolution: {integrity: sha512-vbutsFqQ+foy3wSSbmjBXXIJ6PL3scghJoM8zCL142cGaZKAdCZHyf+Bpu/MmX9zT9Q0zFBVKb36Ma5Fzfa8xA==}
    engines: {node: '>=18'}
    cpu: [x64]
    os: [linux]

  '@esbuild/netbsd-x64@0.24.0':
    resolution: {integrity: sha512-hjQ0R/ulkO8fCYFsG0FZoH+pWgTTDreqpqY7UnQntnaKv95uP5iW3+dChxnx7C3trQQU40S+OgWhUVwCjVFLvg==}
    engines: {node: '>=18'}
    cpu: [x64]
    os: [netbsd]

  '@esbuild/openbsd-arm64@0.24.0':
    resolution: {integrity: sha512-MD9uzzkPQbYehwcN583yx3Tu5M8EIoTD+tUgKF982WYL9Pf5rKy9ltgD0eUgs8pvKnmizxjXZyLt0z6DC3rRXg==}
    engines: {node: '>=18'}
    cpu: [arm64]
    os: [openbsd]

  '@esbuild/openbsd-x64@0.24.0':
    resolution: {integrity: sha512-4ir0aY1NGUhIC1hdoCzr1+5b43mw99uNwVzhIq1OY3QcEwPDO3B7WNXBzaKY5Nsf1+N11i1eOfFcq+D/gOS15Q==}
    engines: {node: '>=18'}
    cpu: [x64]
    os: [openbsd]

  '@esbuild/sunos-x64@0.24.0':
    resolution: {integrity: sha512-jVzdzsbM5xrotH+W5f1s+JtUy1UWgjU0Cf4wMvffTB8m6wP5/kx0KiaLHlbJO+dMgtxKV8RQ/JvtlFcdZ1zCPA==}
    engines: {node: '>=18'}
    cpu: [x64]
    os: [sunos]

  '@esbuild/win32-arm64@0.24.0':
    resolution: {integrity: sha512-iKc8GAslzRpBytO2/aN3d2yb2z8XTVfNV0PjGlCxKo5SgWmNXx82I/Q3aG1tFfS+A2igVCY97TJ8tnYwpUWLCA==}
    engines: {node: '>=18'}
    cpu: [arm64]
    os: [win32]

  '@esbuild/win32-ia32@0.24.0':
    resolution: {integrity: sha512-vQW36KZolfIudCcTnaTpmLQ24Ha1RjygBo39/aLkM2kmjkWmZGEJ5Gn9l5/7tzXA42QGIoWbICfg6KLLkIw6yw==}
    engines: {node: '>=18'}
    cpu: [ia32]
    os: [win32]

  '@esbuild/win32-x64@0.24.0':
    resolution: {integrity: sha512-7IAFPrjSQIJrGsK6flwg7NFmwBoSTyF3rl7If0hNUFQU4ilTsEPL6GuMuU9BfIWVVGuRnuIidkSMC+c0Otu8IA==}
    engines: {node: '>=18'}
    cpu: [x64]
    os: [win32]

  '@isaacs/cliui@8.0.2':
    resolution: {integrity: sha512-O8jcjabXaleOG9DQ0+ARXWZBTfnP4WNAqzuiJK7ll44AmxGKv/J2M4TPjxjY3znBCfvBXFzucm1twdyFybFqEA==}
    engines: {node: '>=12'}

  '@jridgewell/gen-mapping@0.3.5':
    resolution: {integrity: sha512-IzL8ZoEDIBRWEzlCcRhOaCupYyN5gdIK+Q6fbFdPDg6HqX6jpkItn7DFIpW9LQzXG6Df9sA7+OKnq0qlz/GaQg==}
    engines: {node: '>=6.0.0'}

  '@jridgewell/resolve-uri@3.1.2':
    resolution: {integrity: sha512-bRISgCIjP20/tbWSPWMEi54QVPRZExkuD9lJL+UIxUKtwVJA8wW1Trb1jMs1RFXo1CBTNZ/5hpC9QvmKWdopKw==}
    engines: {node: '>=6.0.0'}

  '@jridgewell/set-array@1.2.1':
    resolution: {integrity: sha512-R8gLRTZeyp03ymzP/6Lil/28tGeGEzhx1q2k703KGWRAI1VdvPIXdG70VJc2pAMw3NA6JKL5hhFu1sJX0Mnn/A==}
    engines: {node: '>=6.0.0'}

  '@jridgewell/sourcemap-codec@1.5.0':
    resolution: {integrity: sha512-gv3ZRaISU3fjPAgNsriBRqGWQL6quFx04YMPW/zD8XMLsU32mhCCbfbO6KZFLjvYpCZ8zyDEgqsgf+PwPaM7GQ==}

  '@jridgewell/trace-mapping@0.3.25':
    resolution: {integrity: sha512-vNk6aEwybGtawWmy/PzwnGDOjCkLWSD2wqvjGGAgOAwCGWySYXfYoxt00IJkTF+8Lb57DwOb3Aa0o9CApepiYQ==}

  '@nodelib/fs.scandir@2.1.5':
    resolution: {integrity: sha512-vq24Bq3ym5HEQm2NKCr3yXDwjc7vTsEThRDnkp2DK9p1uqLR+DHurm/NOTo0KG7HYHU7eppKZj3MyqYuMBf62g==}
    engines: {node: '>= 8'}

  '@nodelib/fs.stat@2.0.5':
    resolution: {integrity: sha512-RkhPPp2zrqDAQA/2jNhnztcPAlv64XdhIp7a7454A5ovI7Bukxgt7MX7udwAu3zg1DcpPU0rz3VV1SeaqvY4+A==}
    engines: {node: '>= 8'}

  '@nodelib/fs.walk@1.2.8':
    resolution: {integrity: sha512-oGB+UxlgWcgQkgwo8GcEGwemoTFt3FIO9ababBmaGwXIoBKZ+GTy0pP185beGg7Llih/NSHSV2XAs1lnznocSg==}
    engines: {node: '>= 8'}

  '@pkgjs/parseargs@0.11.0':
    resolution: {integrity: sha512-+1VkjdD0QBLPodGrJUeqarH8VAIvQODIbwh9XpP5Syisf7YoQgsJKPNFoqqLQlu+VQ/tVSshMR6loPMn8U+dPg==}
    engines: {node: '>=14'}

  '@yr/monotone-cubic-spline@1.0.3':
    resolution: {integrity: sha512-FQXkOta0XBSUPHndIKON2Y9JeQz5ZeMqLYZVVK93FliNBFm7LNMIZmY6FrMEB9XPcDbE2bekMbZD6kzDkxwYjA==}

  ansi-regex@5.0.1:
    resolution: {integrity: sha512-quJQXlTSUGL2LH9SUXo8VwsY4soanhgo6LNSm84E1LBcE8s3O0wpdiRzyR9z/ZZJMlMWv37qOOb9pdJlMUEKFQ==}
    engines: {node: '>=8'}

  ansi-regex@6.1.0:
    resolution: {integrity: sha512-7HSX4QQb4CspciLpVFwyRe79O3xsIZDDLER21kERQ71oaPodF8jL725AgJMFAYbooIqolJoRLuM81SpeUkpkvA==}
    engines: {node: '>=12'}

  ansi-styles@4.3.0:
    resolution: {integrity: sha512-zbB9rCJAT1rbjiVDb2hqKFHNYLxgtk8NURxZ3IZwD3F6NtxbXZQCnnSi1Lkx+IDohdPlFp222wVALIheZJQSEg==}
    engines: {node: '>=8'}

  ansi-styles@6.2.1:
    resolution: {integrity: sha512-bN798gFfQX+viw3R7yrGWRqnrN2oRkEkUjjl4JNn4E8GxxbjtG3FbrEIIY3l8/hrwUwIeCZvi4QuOTP4MErVug==}
    engines: {node: '>=12'}

  any-promise@1.3.0:
    resolution: {integrity: sha512-7UvmKalWRt1wgjL1RrGxoSJW/0QZFIegpeGvZG9kjp8vrRu55XTHbwnqq2GpXm9uLbcuhxm3IqX9OB4MZR1b2A==}

  anymatch@3.1.3:
    resolution: {integrity: sha512-KMReFUr0B4t+D+OBkjR3KYqvocp2XaSzO55UcB6mgQMd3KbcE+mWTyvVV7D/zsdEbNnV6acZUutkiHQXvTr1Rw==}
    engines: {node: '>= 8'}

  apexcharts@3.54.1:
    resolution: {integrity: sha512-E4et0h/J1U3r3EwS/WlqJCQIbepKbp6wGUmaAwJOMjHUP4Ci0gxanLa7FR3okx6p9coi4st6J853/Cb1NP0vpA==}

  arg@5.0.2:
    resolution: {integrity: sha512-PYjyFOLKQ9y57JvQ6QLo8dAgNqswh8M1RMJYdQduT6xbWSgK36P/Z/v+p888pM69jMMfS8Xd8F6I1kQ/I9HUGg==}

  balanced-match@1.0.2:
    resolution: {integrity: sha512-3oSeUO0TMV67hN1AmbXsK4yaqU7tjiHlbxRDZOpH0KW9+CeX4bRAaX0Anxt0tx2MrpRpWwQaPwIlISEJhYU5Pw==}

  binary-extensions@2.3.0:
    resolution: {integrity: sha512-Ceh+7ox5qe7LJuLHoY0feh3pHuUDHAcRUeyL2VYghZwfpkNIy/+8Ocg0a3UuSoYzavmylwuLWQOf3hl0jjMMIw==}
    engines: {node: '>=8'}

  brace-expansion@2.0.1:
    resolution: {integrity: sha512-XnAIvQ8eM+kC6aULx6wuQiwVsnzsi9d3WxzV3FpWTGA19F621kwdbsAcFKXgKUHZWsy+mY6iL1sHTxWEFCytDA==}

  braces@3.0.3:
    resolution: {integrity: sha512-yQbXgO/OSZVD2IsiLlro+7Hf6Q18EJrKSEsdoMzKePKXct3gvD8oLcOQdIzGupr5Fj+EDe8gO/lxc1BzfMpxvA==}
    engines: {node: '>=8'}

  camelcase-css@2.0.1:
    resolution: {integrity: sha512-QOSvevhslijgYwRx6Rv7zKdMF8lbRmx+uQGx2+vDc+KI/eBnsy9kit5aj23AgGu3pa4t9AgwbnXWqS+iOY+2aA==}
    engines: {node: '>= 6'}

  chokidar@3.6.0:
    resolution: {integrity: sha512-7VT13fmjotKpGipCW9JEQAusEPE+Ei8nl6/g4FBAmIm0GOOLMua9NDDo/DWp0ZAxCr3cPq5ZpBqmPAQgDda2Pw==}
    engines: {node: '>= 8.10.0'}

  color-convert@2.0.1:
    resolution: {integrity: sha512-RRECPsj7iu/xb5oKYcsFHSppFNnsj/52OVTRKb4zP5onXwVF3zVmmToNcOfGC+CRDpfK/U584fMg38ZHCaElKQ==}
    engines: {node: '>=7.0.0'}

  color-name@1.1.4:
    resolution: {integrity: sha512-dOy+3AuW3a2wNbZHIuMZpTcgjGuLU/uBL/ubcZF9OXbDo8ff4O8yVp5Bf0efS8uEoYo5q4Fx7dY9OgQGXgAsQA==}

  commander@4.1.1:
    resolution: {integrity: sha512-NOKm8xhkzAjzFx8B2v5OAHT+u5pRQc2UCa2Vq9jYL/31o2wi9mxBA7LIFs3sV5VSC49z6pEhfbMULvShKj26WA==}
    engines: {node: '>= 6'}

  cross-spawn@7.0.6:
    resolution: {integrity: sha512-uV2QOWP2nWzsy2aMp8aRibhi9dlzF5Hgh5SHaB9OiTGEyDTiJJyx0uy51QXdyWbtAHNua4XJzUKca3OzKUd3vA==}
    engines: {node: '>= 8'}

  css-selector-tokenizer@0.8.0:
    resolution: {integrity: sha512-Jd6Ig3/pe62/qe5SBPTN8h8LeUg/pT4lLgtavPf7updwwHpvFzxvOQBHYj2LZDMjUnBzgvIUSjRcf6oT5HzHFg==}

  cssesc@3.0.0:
    resolution: {integrity: sha512-/Tb/JcjK111nNScGob5MNtsntNM1aCNUDipB/TkwZFhyDrrE47SOx/18wF2bbjgc3ZzCSKW1T5nt5EbFoAz/Vg==}
    engines: {node: '>=4'}
    hasBin: true

  culori@3.3.0:
    resolution: {integrity: sha512-pHJg+jbuFsCjz9iclQBqyL3B2HLCBF71BwVNujUYEvCeQMvV97R59MNK3R2+jgJ3a1fcZgI9B3vYgz8lzr/BFQ==}
    engines: {node: ^12.20.0 || ^14.13.1 || >=16.0.0}

  daisyui@4.12.14:
    resolution: {integrity: sha512-hA27cdBasdwd4/iEjn+aidoCrRroDuo3G5W9NDKaVCJI437Mm/3eSL/2u7MkZ0pt8a+TrYF3aT2pFVemTS3how==}
    engines: {node: '>=16.9.0'}

  didyoumean@1.2.2:
    resolution: {integrity: sha512-gxtyfqMg7GKyhQmb056K7M3xszy/myH8w+B4RT+QXBQsvAOdc3XymqDDPHx1BgPgsdAA5SIifona89YtRATDzw==}

  dlv@1.1.3:
    resolution: {integrity: sha512-+HlytyjlPKnIG8XuRG8WvmBP8xs8P71y+SKKS6ZXWoEgLuePxtDoUEiH7WkdePWrQ5JBpE6aoVqfZfJUQkjXwA==}

  eastasianwidth@0.2.0:
    resolution: {integrity: sha512-I88TYZWc9XiYHRQ4/3c5rjjfgkjhLyW2luGIheGERbNQ6OY7yTybanSpDXZa8y7VUP9YmDcYa+eyq4ca7iLqWA==}

  emoji-regex@8.0.0:
    resolution: {integrity: sha512-MSjYzcWNOA0ewAHpz0MxpYFvwg6yjy1NG3xteoqz644VCo/RPgnr1/GGt+ic3iJTzQ8Eu3TdM14SawnVUmGE6A==}

  emoji-regex@9.2.2:
    resolution: {integrity: sha512-L18DaJsXSUk2+42pv8mLs5jJT2hqFkFE4j21wOmgbUqsZ2hL72NsUU785g9RXgo3s0ZNgVl42TiHp3ZtOv/Vyg==}

  esbuild@0.24.0:
    resolution: {integrity: sha512-FuLPevChGDshgSicjisSooU0cemp/sGXR841D5LHMB7mTVOmsEHcAxaH3irL53+8YDIeVNQEySh4DaYU/iuPqQ==}
    engines: {node: '>=18'}
    hasBin: true

  fast-glob@3.3.2:
    resolution: {integrity: sha512-oX2ruAFQwf/Orj8m737Y5adxDQO0LAB7/S5MnxCdTNDd4p6BsyIVsv9JQsATbTSq8KHRpLwIHbVlUNatxd+1Ow==}
    engines: {node: '>=8.6.0'}

  fastparse@1.1.2:
    resolution: {integrity: sha512-483XLLxTVIwWK3QTrMGRqUfUpoOs/0hbQrl2oz4J0pAcm3A3bu84wxTFqGqkJzewCLdME38xJLJAxBABfQT8sQ==}

  fastq@1.17.1:
    resolution: {integrity: sha512-sRVD3lWVIXWg6By68ZN7vho9a1pQcN/WBFaAAsDDFzlJjvoGx0P8z7V1t72grFJfJhu3YPZBuu25f7Kaw2jN1w==}

  fill-range@7.1.1:
    resolution: {integrity: sha512-YsGpe3WHLK8ZYi4tWDg2Jy3ebRz2rXowDxnld4bkQB00cc/1Zw9AWnC0i9ztDJitivtQvaI9KaLyKrc+hBW0yg==}
    engines: {node: '>=8'}

  foreground-child@3.3.0:
    resolution: {integrity: sha512-Ld2g8rrAyMYFXBhEqMz8ZAHBi4J4uS1i/CxGMDnjyFWddMXLVcDp051DZfu+t7+ab7Wv6SMqpWmyFIj5UbfFvg==}
    engines: {node: '>=14'}

  fsevents@2.3.3:
    resolution: {integrity: sha512-5xoDfX+fL7faATnagmWPpbFtwh/R77WmMMqqHGS65C3vvB0YHrgF+B1YmZ3441tMj5n63k0212XNoJwzlhffQw==}
    engines: {node: ^8.16.0 || ^10.6.0 || >=11.0.0}
    os: [darwin]

  function-bind@1.1.2:
    resolution: {integrity: sha512-7XHNxH7qX9xG5mIwxkhumTox/MIRNcOgDrxWsMt2pAr23WHp6MrRlN7FBSFpCpr+oVO0F744iUgR82nJMfG2SA==}

  glob-parent@5.1.2:
    resolution: {integrity: sha512-AOIgSQCepiJYwP3ARnGx+5VnTu2HBYdzbGP45eLw1vr3zB3vZLeyed1sC9hnbcOc9/SrMyM5RPQrkGz4aS9Zow==}
    engines: {node: '>= 6'}

  glob-parent@6.0.2:
    resolution: {integrity: sha512-XxwI8EOhVQgWp6iDL+3b0r86f4d6AX6zSU55HfB4ydCEuXLXc5FcYeOu+nnGftS4TEju/11rt4KJPTMgbfmv4A==}
    engines: {node: '>=10.13.0'}

  glob@10.4.5:
    resolution: {integrity: sha512-7Bv8RF0k6xjo7d4A/PxYLbUCfb6c+Vpd2/mB2yRDlew7Jb5hEXiCD9ibfO7wpk8i4sevK6DFny9h7EYbM3/sHg==}
    hasBin: true

  hasown@2.0.2:
    resolution: {integrity: sha512-0hJU9SCPvmMzIBdZFqNPXWa6dqh7WdH0cII9y+CyS8rG3nL48Bclra9HmKhVVUHyPWNH5Y7xDwAB7bfgSjkUMQ==}
    engines: {node: '>= 0.4'}

  htmx.org@2.0.3:
    resolution: {integrity: sha512-AeoJUAjkCVVajbfKX+3sVQBTCt8Ct4lif1T+z/tptTXo8+8yyq3QIMQQe/IT+R8ssfrO1I0DeX4CAronzCL6oA==}

  idiomorph@0.3.0:
    resolution: {integrity: sha512-UhV1Ey5xCxIwR9B+OgIjQa+1Jx99XQ1vQHUsKBU1RpQzCx1u+b+N6SOXgf5mEJDqemUI/ffccu6+71l2mJUsRA==}

  is-binary-path@2.1.0:
    resolution: {integrity: sha512-ZMERYes6pDydyuGidse7OsHxtbI7WVeUEozgR/g7rd0xUimYNlvZRE/K2MgZTjWy725IfelLeVcEM97mmtRGXw==}
    engines: {node: '>=8'}

  is-core-module@2.15.1:
    resolution: {integrity: sha512-z0vtXSwucUJtANQWldhbtbt7BnL0vxiFjIdDLAatwhDYty2bad6s+rijD6Ri4YuYJubLzIJLUidCh09e1djEVQ==}
    engines: {node: '>= 0.4'}

  is-extglob@2.1.1:
    resolution: {integrity: sha512-SbKbANkN603Vi4jEZv49LeVJMn4yGwsbzZworEoyEiutsN3nJYdbO36zfhGJ6QEDpOZIFkDtnq5JRxmvl3jsoQ==}
    engines: {node: '>=0.10.0'}

  is-fullwidth-code-point@3.0.0:
    resolution: {integrity: sha512-zymm5+u+sCsSWyD9qNaejV3DFvhCKclKdizYaJUuHA83RLjb7nSuGnddCHGv0hk+KY7BMAlsWeK4Ueg6EV6XQg==}
    engines: {node: '>=8'}

  is-glob@4.0.3:
    resolution: {integrity: sha512-xelSayHH36ZgE7ZWhli7pW34hNbNl8Ojv5KVmkJD4hBdD3th8Tfk9vYasLM+mXWOZhFkgZfxhLSnrwRr4elSSg==}
    engines: {node: '>=0.10.0'}

  is-number@7.0.0:
    resolution: {integrity: sha512-41Cifkg6e8TylSpdtTpeLVMqvSBEVzTttHvERD741+pnZ8ANv0004MRL43QKPDlK9cGvNp6NZWZUBlbGXYxxng==}
    engines: {node: '>=0.12.0'}

  isexe@2.0.0:
    resolution: {integrity: sha512-RHxMLp9lnKHGHRng9QFhRCMbYAcVpn69smSGcq3f36xjgVVWThj4qqLbTLlq7Ssj8B+fIQ1EuCEGI2lKsyQeIw==}

  jackspeak@3.4.3:
    resolution: {integrity: sha512-OGlZQpz2yfahA/Rd1Y8Cd9SIEsqvXkLVoSw/cgwhnhFMDbsQFeZYoJJ7bIZBS9BcamUW96asq/npPWugM+RQBw==}

  jiti@1.21.6:
    resolution: {integrity: sha512-2yTgeWTWzMWkHu6Jp9NKgePDaYHbntiwvYuuJLbbN9vl7DC9DvXKOB2BC3ZZ92D3cvV/aflH0osDfwpHepQ53w==}
    hasBin: true

  lilconfig@2.1.0:
    resolution: {integrity: sha512-utWOt/GHzuUxnLKxB6dk81RoOeoNeHgbrXiuGk4yyF5qlRz+iIVWu56E2fqGHFrXz0QNUhLB/8nKqvRH66JKGQ==}
    engines: {node: '>=10'}

  lilconfig@3.1.2:
    resolution: {integrity: sha512-eop+wDAvpItUys0FWkHIKeC9ybYrTGbU41U5K7+bttZZeohvnY7M9dZ5kB21GNWiFT2q1OoPTvncPCgSOVO5ow==}
    engines: {node: '>=14'}

  lines-and-columns@1.2.4:
    resolution: {integrity: sha512-7ylylesZQ/PV29jhEDl3Ufjo6ZX7gCqJr5F7PKrqc93v7fzSymt1BpwEU8nAUXs8qzzvqhbjhK5QZg6Mt/HkBg==}

  lru-cache@10.4.3:
    resolution: {integrity: sha512-JNAzZcXrCt42VGLuYz0zfAzDfAvJWW6AfYlDBQyDV5DClI2m5sAmK+OIO7s59XfsRsWHp02jAJrRadPRGTt6SQ==}

  merge2@1.4.1:
    resolution: {integrity: sha512-8q7VEgMJW4J8tcfVPy8g09NcQwZdbwFEqhe/WZkoIzjn/3TGDwtOCYtXGxA3O8tPzpczCCDgv+P2P5y00ZJOOg==}
    engines: {node: '>= 8'}

  micromatch@4.0.8:
    resolution: {integrity: sha512-PXwfBhYu0hBCPw8Dn0E+WDYb7af3dSLVWKi3HGv84IdF4TyFoC0ysxFd0Goxw7nSv4T/PzEJQxsYsEiFCKo2BA==}
    engines: {node: '>=8.6'}

  minimatch@9.0.5:
    resolution: {integrity: sha512-G6T0ZX48xgozx7587koeX9Ys2NYy6Gmv//P89sEte9V9whIapMNF4idKxnW2QtCcLiTWlb/wfCabAtAFWhhBow==}
    engines: {node: '>=16 || 14 >=14.17'}

  minipass@7.1.2:
    resolution: {integrity: sha512-qOOzS1cBTWYF4BH8fVePDBOO9iptMnGUEZwNc/cMWnTV2nVLZ7VoNWEPHkYczZA0pdoA7dl6e7FL659nX9S2aw==}
    engines: {node: '>=16 || 14 >=14.17'}

  mz@2.7.0:
    resolution: {integrity: sha512-z81GNO7nnYMEhrGh9LeymoE4+Yr0Wn5McHIZMK5cfQCl+NDX08sCZgUc9/6MHni9IWuFLm1Z3HTCXu2z9fN62Q==}

  nanoid@3.3.7:
    resolution: {integrity: sha512-eSRppjcPIatRIMC1U6UngP8XFcz8MQWGQdt1MTBQ7NaAmvXDfvNxbvWV3x2y6CdEUciCSsDHDQZbhYaB8QEo2g==}
    engines: {node: ^10 || ^12 || ^13.7 || ^14 || >=15.0.1}
    hasBin: true

  normalize-path@3.0.0:
    resolution: {integrity: sha512-6eZs5Ls3WtCisHWp9S2GUy8dqkpGi4BVSz3GaqiE6ezub0512ESztXUwUB6C6IKbQkY2Pnb/mD4WYojCRwcwLA==}
    engines: {node: '>=0.10.0'}

  object-assign@4.1.1:
    resolution: {integrity: sha512-rJgTQnkUnH1sFw8yT6VSU3zD3sWmu6sZhIseY8VX+GRu3P6F7Fu+JNDoXfklElbLJSnc3FUQHVe4cU5hj+BcUg==}
    engines: {node: '>=0.10.0'}

  object-hash@3.0.0:
    resolution: {integrity: sha512-RSn9F68PjH9HqtltsSnqYC1XXoWe9Bju5+213R98cNGttag9q9yAOTzdbsqvIa7aNm5WffBZFpWYr2aWrklWAw==}
    engines: {node: '>= 6'}

  package-json-from-dist@1.0.1:
    resolution: {integrity: sha512-UEZIS3/by4OC8vL3P2dTXRETpebLI2NiI5vIrjaD/5UtrkFX/tNbwjTSRAGC/+7CAo2pIcBaRgWmcBBHcsaCIw==}

  path-key@3.1.1:
    resolution: {integrity: sha512-ojmeN0qd+y0jszEtoY48r0Peq5dwMEkIlCOu6Q5f41lfkswXuKtYrhgoTpLnyIcHm24Uhqx+5Tqm2InSwLhE6Q==}
    engines: {node: '>=8'}

  path-parse@1.0.7:
    resolution: {integrity: sha512-LDJzPVEEEPR+y48z93A0Ed0yXb8pAByGWo/k5YYdYgpY2/2EsOsksJrq7lOHxryrVOn1ejG6oAp8ahvOIQD8sw==}

  path-scurry@1.11.1:
    resolution: {integrity: sha512-Xa4Nw17FS9ApQFJ9umLiJS4orGjm7ZzwUrwamcGQuHSzDyth9boKDaycYdDcZDuqYATXw4HFXgaqWTctW/v1HA==}
    engines: {node: '>=16 || 14 >=14.18'}

  picocolors@1.1.1:
    resolution: {integrity: sha512-xceH2snhtb5M9liqDsmEw56le376mTZkEX/jEb/RxNFyegNul7eNslCXP9FDj/Lcu0X8KEyMceP2ntpaHrDEVA==}

  picomatch@2.3.1:
    resolution: {integrity: sha512-JU3teHTNjmE2VCGFzuY8EXzCDVwEqB2a8fsIvwaStHhAWJEeVd1o1QD80CU6+ZdEXXSLbSsuLwJjkCBWqRQUVA==}
    engines: {node: '>=8.6'}

  pify@2.3.0:
    resolution: {integrity: sha512-udgsAY+fTnvv7kI7aaxbqwWNb0AHiB0qBO89PZKPkoTmGOgdbrHDKD+0B2X4uTfJ/FT1R09r9gTsjUjNJotuog==}
    engines: {node: '>=0.10.0'}

  pirates@4.0.6:
    resolution: {integrity: sha512-saLsH7WeYYPiD25LDuLRRY/i+6HaPYr6G1OUlN39otzkSTxKnubR9RTxS3/Kk50s1g2JTgFwWQDQyplC5/SHZg==}
    engines: {node: '>= 6'}

  postcss-import@15.1.0:
    resolution: {integrity: sha512-hpr+J05B2FVYUAXHeK1YyI267J/dDDhMU6B6civm8hSY1jYJnBXxzKDKDswzJmtLHryrjhnDjqqp/49t8FALew==}
    engines: {node: '>=14.0.0'}
    peerDependencies:
      postcss: ^8.0.0

  postcss-js@4.0.1:
    resolution: {integrity: sha512-dDLF8pEO191hJMtlHFPRa8xsizHaM82MLfNkUHdUtVEV3tgTp5oj+8qbEqYM57SLfc74KSbw//4SeJma2LRVIw==}
    engines: {node: ^12 || ^14 || >= 16}
    peerDependencies:
      postcss: ^8.4.21

  postcss-load-config@4.0.2:
    resolution: {integrity: sha512-bSVhyJGL00wMVoPUzAVAnbEoWyqRxkjv64tUl427SKnPrENtq6hJwUojroMz2VB+Q1edmi4IfrAPpami5VVgMQ==}
    engines: {node: '>= 14'}
    peerDependencies:
      postcss: '>=8.0.9'
      ts-node: '>=9.0.0'
    peerDependenciesMeta:
      postcss:
        optional: true
      ts-node:
        optional: true

  postcss-nested@6.2.0:
    resolution: {integrity: sha512-HQbt28KulC5AJzG+cZtj9kvKB93CFCdLvog1WFLf1D+xmMvPGlBstkpTEZfK5+AN9hfJocyBFCNiqyS48bpgzQ==}
    engines: {node: '>=12.0'}
    peerDependencies:
      postcss: ^8.2.14

  postcss-selector-parser@6.1.2:
    resolution: {integrity: sha512-Q8qQfPiZ+THO/3ZrOrO0cJJKfpYCagtMUkXbnEfmgUjwXg6z/WBeOyS9APBBPCTSiDV+s4SwQGu8yFsiMRIudg==}
    engines: {node: '>=4'}

  postcss-value-parser@4.2.0:
    resolution: {integrity: sha512-1NNCs6uurfkVbeXG4S8JFT9t19m45ICnif8zWLd5oPSZ50QnwMfK+H3jv408d4jw/7Bttv5axS5IiHoLaVNHeQ==}

  postcss@8.4.49:
    resolution: {integrity: sha512-OCVPnIObs4N29kxTjzLfUryOkvZEq+pf8jTF0lg8E7uETuWHA+v7j3c/xJmiqpX450191LlmZfUKkXxkTry7nA==}
    engines: {node: ^10 || ^12 || >=14}

  queue-microtask@1.2.3:
    resolution: {integrity: sha512-NuaNSa6flKT5JaSYQzJok04JzTL1CA6aGhv5rfLW3PgqA+M2ChpZQnAC8h8i4ZFkBS8X5RqkDBHA7r4hej3K9A==}

  read-cache@1.0.0:
    resolution: {integrity: sha512-Owdv/Ft7IjOgm/i0xvNDZ1LrRANRfew4b2prF3OWMQLxLfu3bS8FVhCsrSCMK4lR56Y9ya+AThoTpDCTxCmpRA==}

  readdirp@3.6.0:
    resolution: {integrity: sha512-hOS089on8RduqdbhvQ5Z37A0ESjsqz6qnRcffsMU3495FuTdqSm+7bhJ29JvIOsBDEEnan5DPu9t3To9VRlMzA==}
    engines: {node: '>=8.10.0'}

  resolve@1.22.8:
    resolution: {integrity: sha512-oKWePCxqpd6FlLvGV1VU0x7bkPmmCNolxzjMf4NczoDnQcIWrAF+cPtZn5i6n+RfD2d9i0tzpKnG6Yk168yIyw==}
    hasBin: true

  reusify@1.0.4:
    resolution: {integrity: sha512-U9nH88a3fc/ekCF1l0/UP1IosiuIjyTh7hBvXVMHYgVcfGvt897Xguj2UOLDeI5BG2m7/uwyaLVT6fbtCwTyzw==}
    engines: {iojs: '>=1.0.0', node: '>=0.10.0'}

  run-parallel@1.2.0:
    resolution: {integrity: sha512-5l4VyZR86LZ/lDxZTR6jqL8AFE2S0IFLMP26AbjsLVADxHdhB/c0GUsH+y39UfCi3dzz8OlQuPmnaJOMoDHQBA==}

  shebang-command@2.0.0:
    resolution: {integrity: sha512-kHxr2zZpYtdmrN1qDjrrX/Z1rR1kG8Dx+gkpK1G4eXmvXswmcE1hTWBWYUzlraYw1/yZp6YuDY77YtvbN0dmDA==}
    engines: {node: '>=8'}

  shebang-regex@3.0.0:
    resolution: {integrity: sha512-7++dFhtcx3353uBaq8DDR4NuxBetBzC7ZQOhmTQInHEd6bSrXdiEyzCvG07Z44UYdLShWUyXt5M/yhz8ekcb1A==}
    engines: {node: '>=8'}

  signal-exit@4.1.0:
    resolution: {integrity: sha512-bzyZ1e88w9O1iNJbKnOlvYTrWPDl46O1bG0D3XInv+9tkPrxrN8jUUTiFlDkkmKWgn1M6CfIA13SuGqOa9Korw==}
    engines: {node: '>=14'}

  source-map-js@1.2.1:
    resolution: {integrity: sha512-UXWMKhLOwVKb728IUtQPXxfYU+usdybtUrK/8uGE8CQMvrhOpwvzDBwj0QhSL7MQc7vIsISBG8VQ8+IDQxpfQA==}
    engines: {node: '>=0.10.0'}

  string-width@4.2.3:
    resolution: {integrity: sha512-wKyQRQpjJ0sIp62ErSZdGsjMJWsap5oRNihHhu6G7JVO/9jIB6UyevL+tXuOqrng8j/cxKTWyWUwvSTriiZz/g==}
    engines: {node: '>=8'}

  string-width@5.1.2:
    resolution: {integrity: sha512-HnLOCR3vjcY8beoNLtcjZ5/nxn2afmME6lhrDrebokqMap+XbeW8n9TXpPDOqdGK5qcI3oT0GKTW6wC7EMiVqA==}
    engines: {node: '>=12'}

  strip-ansi@6.0.1:
    resolution: {integrity: sha512-Y38VPSHcqkFrCpFnQ9vuSXmquuv5oXOKpGeT6aGrr3o3Gc9AlVa6JBfUSOCnbxGGZF+/0ooI7KrPuUSztUdU5A==}
    engines: {node: '>=8'}

  strip-ansi@7.1.0:
    resolution: {integrity: sha512-iq6eVVI64nQQTRYq2KtEg2d2uU7LElhTJwsH4YzIHZshxlgZms/wIc4VoDQTlG/IvVIrBKG06CrZnp0qv7hkcQ==}
    engines: {node: '>=12'}

  sucrase@3.35.0:
    resolution: {integrity: sha512-8EbVDiu9iN/nESwxeSxDKe0dunta1GOlHufmSSXxMD2z2/tMZpDMpvXQGsc+ajGo8y2uYUmixaSRUc/QPoQ0GA==}
    engines: {node: '>=16 || 14 >=14.17'}
    hasBin: true

  supports-preserve-symlinks-flag@1.0.0:
    resolution: {integrity: sha512-ot0WnXS9fgdkgIcePe6RHNk1WA8+muPa6cSjeR3V8K27q9BB1rTE3R1p7Hv0z1ZyAc8s6Vvv8DIyWf681MAt0w==}
    engines: {node: '>= 0.4'}

  svg.draggable.js@2.2.2:
    resolution: {integrity: sha512-JzNHBc2fLQMzYCZ90KZHN2ohXL0BQJGQimK1kGk6AvSeibuKcIdDX9Kr0dT9+UJ5O8nYA0RB839Lhvk4CY4MZw==}
    engines: {node: '>= 0.8.0'}

  svg.easing.js@2.0.0:
    resolution: {integrity: sha512-//ctPdJMGy22YoYGV+3HEfHbm6/69LJUTAqI2/5qBvaNHZ9uUFVC82B0Pl299HzgH13rKrBgi4+XyXXyVWWthA==}
    engines: {node: '>= 0.8.0'}

  svg.filter.js@2.0.2:
    resolution: {integrity: sha512-xkGBwU+dKBzqg5PtilaTb0EYPqPfJ9Q6saVldX+5vCRy31P6TlRCP3U9NxH3HEufkKkpNgdTLBJnmhDHeTqAkw==}
    engines: {node: '>= 0.8.0'}

  svg.js@2.7.1:
    resolution: {integrity: sha512-ycbxpizEQktk3FYvn/8BH+6/EuWXg7ZpQREJvgacqn46gIddG24tNNe4Son6omdXCnSOaApnpZw6MPCBA1dODA==}

  svg.pathmorphing.js@0.1.3:
    resolution: {integrity: sha512-49HWI9X4XQR/JG1qXkSDV8xViuTLIWm/B/7YuQELV5KMOPtXjiwH4XPJvr/ghEDibmLQ9Oc22dpWpG0vUDDNww==}
    engines: {node: '>= 0.8.0'}

  svg.resize.js@1.4.3:
    resolution: {integrity: sha512-9k5sXJuPKp+mVzXNvxz7U0uC9oVMQrrf7cFsETznzUDDm0x8+77dtZkWdMfRlmbkEEYvUn9btKuZ3n41oNA+uw==}
    engines: {node: '>= 0.8.0'}

  svg.select.js@2.1.2:
    resolution: {integrity: sha512-tH6ABEyJsAOVAhwcCjF8mw4crjXSI1aa7j2VQR8ZuJ37H2MBUbyeqYr5nEO7sSN3cy9AR9DUwNg0t/962HlDbQ==}
    engines: {node: '>= 0.8.0'}

  svg.select.js@3.0.1:
    resolution: {integrity: sha512-h5IS/hKkuVCbKSieR9uQCj9w+zLHoPh+ce19bBYyqF53g6mnPB8sAtIbe1s9dh2S2fCmYX2xel1Ln3PJBbK4kw==}
    engines: {node: '>= 0.8.0'}

  tailwindcss@3.4.15:
    resolution: {integrity: sha512-r4MeXnfBmSOuKUWmXe6h2CcyfzJCEk4F0pptO5jlnYSIViUkVmsawj80N5h2lO3gwcmSb4n3PuN+e+GC1Guylw==}
    engines: {node: '>=14.0.0'}
    hasBin: true

  thenify-all@1.6.0:
    resolution: {integrity: sha512-RNxQH/qI8/t3thXJDwcstUO4zeqo64+Uy/+sNVRBx4Xn2OX+OZ9oP+iJnNFqplFra2ZUVeKCSa2oVWi3T4uVmA==}
    engines: {node: '>=0.8'}

  thenify@3.3.1:
    resolution: {integrity: sha512-RVZSIV5IG10Hk3enotrhvz0T9em6cyHBLkH/YAZuKqd8hRkKhSfCGIcP2KUY0EPxndzANBmNllzWPwak+bheSw==}

  to-regex-range@5.0.1:
    resolution: {integrity: sha512-65P7iz6X5yEr1cwcgvQxbbIw7Uk3gOy5dIdtZ4rDveLqhrdJP+Li/Hx6tyK0NEb+2GCyneCMJiGqrADCSNk8sQ==}
    engines: {node: '>=8.0'}

  ts-interface-checker@0.1.13:
    resolution: {integrity: sha512-Y/arvbn+rrz3JCKl9C4kVNfTfSm2/mEp5FSz5EsZSANGPSlQrpRI5M4PKF+mJnE52jOO90PnPSc3Ur3bTQw0gA==}

  typescript@5.7.2:
    resolution: {integrity: sha512-i5t66RHxDvVN40HfDd1PsEThGNnlMCMT3jMUuoh9/0TaqWevNontacunWyN02LA9/fIbEWlcHZcgTKb9QoaLfg==}
    engines: {node: '>=14.17'}
    hasBin: true

  util-deprecate@1.0.2:
    resolution: {integrity: sha512-EPD5q1uXyFxJpCrLnCc1nHnq3gOa6DZBocAIiI2TaSCA7VCJ1UJDMagCzIkXNsUYfD1daK//LTEQ8xiIbrHtcw==}

  which@2.0.2:
    resolution: {integrity: sha512-BLI3Tl1TW3Pvl70l3yq3Y64i+awpwXqsGBYWkkqMtnbXgrMD+yj7rhW0kuEDxzJaYXGjEW5ogapKNMEKNMjibA==}
    engines: {node: '>= 8'}
    hasBin: true

  wrap-ansi@7.0.0:
    resolution: {integrity: sha512-YVGIj2kamLSTxw6NsZjoBxfSwsn0ycdesmc4p+Q21c5zPuZ1pl+NfxVdxPtdHvmNVOQ6XSYG4AUtyt/Fi7D16Q==}
    engines: {node: '>=10'}

  wrap-ansi@8.1.0:
    resolution: {integrity: sha512-si7QWI6zUMq56bESFvagtmzMdGOtoxfR+Sez11Mobfc7tm+VkUckk9bW2UeffTGVUbOksxmSw0AA2gs8g71NCQ==}
    engines: {node: '>=12'}

  yaml@2.6.1:
    resolution: {integrity: sha512-7r0XPzioN/Q9kXBro/XPnA6kznR73DHq+GXh5ON7ZozRO6aMjbmiBuKste2wslTFkC5d1dw0GooOCepZXJ2SAg==}
    engines: {node: '>= 14'}
    hasBin: true

snapshots:

  '@alloc/quick-lru@5.2.0': {}

  '@esbuild/aix-ppc64@0.24.0':
    optional: true

  '@esbuild/android-arm64@0.24.0':
    optional: true

  '@esbuild/android-arm@0.24.0':
    optional: true

  '@esbuild/android-x64@0.24.0':
    optional: true

  '@esbuild/darwin-arm64@0.24.0':
    optional: true

  '@esbuild/darwin-x64@0.24.0':
    optional: true

  '@esbuild/freebsd-arm64@0.24.0':
    optional: true

  '@esbuild/freebsd-x64@0.24.0':
    optional: true

  '@esbuild/linux-arm64@0.24.0':
    optional: true

  '@esbuild/linux-arm@0.24.0':
    optional: true

  '@esbuild/linux-ia32@0.24.0':
    optional: true

  '@esbuild/linux-loong64@0.24.0':
    optional: true

  '@esbuild/linux-mips64el@0.24.0':
    optional: true

  '@esbuild/linux-ppc64@0.24.0':
    optional: true

  '@esbuild/linux-riscv64@0.24.0':
    optional: true

  '@esbuild/linux-s390x@0.24.0':
    optional: true

  '@esbuild/linux-x64@0.24.0':
    optional: true

  '@esbuild/netbsd-x64@0.24.0':
    optional: true

  '@esbuild/openbsd-arm64@0.24.0':
    optional: true

  '@esbuild/openbsd-x64@0.24.0':
    optional: true

  '@esbuild/sunos-x64@0.24.0':
    optional: true

  '@esbuild/win32-arm64@0.24.0':
    optional: true

  '@esbuild/win32-ia32@0.24.0':
    optional: true

  '@esbuild/win32-x64@0.24.0':
    optional: true

  '@isaacs/cliui@8.0.2':
    dependencies:
      string-width: 5.1.2
      string-width-cjs: string-width@4.2.3
      strip-ansi: 7.1.0
      strip-ansi-cjs: strip-ansi@6.0.1
      wrap-ansi: 8.1.0
      wrap-ansi-cjs: wrap-ansi@7.0.0

  '@jridgewell/gen-mapping@0.3.5':
    dependencies:
      '@jridgewell/set-array': 1.2.1
      '@jridgewell/sourcemap-codec': 1.5.0
      '@jridgewell/trace-mapping': 0.3.25

  '@jridgewell/resolve-uri@3.1.2': {}

  '@jridgewell/set-array@1.2.1': {}

  '@jridgewell/sourcemap-codec@1.5.0': {}

  '@jridgewell/trace-mapping@0.3.25':
    dependencies:
      '@jridgewell/resolve-uri': 3.1.2
      '@jridgewell/sourcemap-codec': 1.5.0

  '@nodelib/fs.scandir@2.1.5':
    dependencies:
      '@nodelib/fs.stat': 2.0.5
      run-parallel: 1.2.0

  '@nodelib/fs.stat@2.0.5': {}

  '@nodelib/fs.walk@1.2.8':
    dependencies:
      '@nodelib/fs.scandir': 2.1.5
      fastq: 1.17.1

  '@pkgjs/parseargs@0.11.0':
    optional: true

  '@yr/monotone-cubic-spline@1.0.3': {}

  ansi-regex@5.0.1: {}

  ansi-regex@6.1.0: {}

  ansi-styles@4.3.0:
    dependencies:
      color-convert: 2.0.1

  ansi-styles@6.2.1: {}

  any-promise@1.3.0: {}

  anymatch@3.1.3:
    dependencies:
      normalize-path: 3.0.0
      picomatch: 2.3.1

  apexcharts@3.54.1:
    dependencies:
      '@yr/monotone-cubic-spline': 1.0.3
      svg.draggable.js: 2.2.2
      svg.easing.js: 2.0.0
      svg.filter.js: 2.0.2
      svg.pathmorphing.js: 0.1.3
      svg.resize.js: 1.4.3
      svg.select.js: 3.0.1

  arg@5.0.2: {}

  balanced-match@1.0.2: {}

  binary-extensions@2.3.0: {}

  brace-expansion@2.0.1:
    dependencies:
      balanced-match: 1.0.2

  braces@3.0.3:
    dependencies:
      fill-range: 7.1.1

  camelcase-css@2.0.1: {}

  chokidar@3.6.0:
    dependencies:
      anymatch: 3.1.3
      braces: 3.0.3
      glob-parent: 5.1.2
      is-binary-path: 2.1.0
      is-glob: 4.0.3
      normalize-path: 3.0.0
      readdirp: 3.6.0
    optionalDependencies:
      fsevents: 2.3.3

  color-convert@2.0.1:
    dependencies:
      color-name: 1.1.4

  color-name@1.1.4: {}

  commander@4.1.1: {}

  cross-spawn@7.0.6:
    dependencies:
      path-key: 3.1.1
      shebang-command: 2.0.0
      which: 2.0.2

  css-selector-tokenizer@0.8.0:
    dependencies:
      cssesc: 3.0.0
      fastparse: 1.1.2

  cssesc@3.0.0: {}

  culori@3.3.0: {}

  daisyui@4.12.14(postcss@8.4.49):
    dependencies:
      css-selector-tokenizer: 0.8.0
      culori: 3.3.0
      picocolors: 1.1.1
      postcss-js: 4.0.1(postcss@8.4.49)
    transitivePeerDependencies:
      - postcss

  didyoumean@1.2.2: {}

  dlv@1.1.3: {}

  eastasianwidth@0.2.0: {}

  emoji-regex@8.0.0: {}

  emoji-regex@9.2.2: {}

  esbuild@0.24.0:
    optionalDependencies:
      '@esbuild/aix-ppc64': 0.24.0
      '@esbuild/android-arm': 0.24.0
      '@esbuild/android-arm64': 0.24.0
      '@esbuild/android-x64': 0.24.0
      '@esbuild/darwin-arm64': 0.24.0
      '@esbuild/darwin-x64': 0.24.0
      '@esbuild/freebsd-arm64': 0.24.0
      '@esbuild/freebsd-x64': 0.24.0
      '@esbuild/linux-arm': 0.24.0
      '@esbuild/linux-arm64': 0.24.0
      '@esbuild/linux-ia32': 0.24.0
      '@esbuild/linux-loong64': 0.24.0
      '@esbuild/linux-mips64el': 0.24.0
      '@esbuild/linux-ppc64': 0.24.0
      '@esbuild/linux-riscv64': 0.24.0
      '@esbuild/linux-s390x': 0.24.0
      '@esbuild/linux-x64': 0.24.0
      '@esbuild/netbsd-x64': 0.24.0
      '@esbuild/openbsd-arm64': 0.24.0
      '@esbuild/openbsd-x64': 0.24.0
      '@esbuild/sunos-x64': 0.24.0
      '@esbuild/win32-arm64': 0.24.0
      '@esbuild/win32-ia32': 0.24.0
      '@esbuild/win32-x64': 0.24.0

  fast-glob@3.3.2:
    dependencies:
      '@nodelib/fs.stat': 2.0.5
      '@nodelib/fs.walk': 1.2.8
      glob-parent: 5.1.2
      merge2: 1.4.1
      micromatch: 4.0.8

  fastparse@1.1.2: {}

  fastq@1.17.1:
    dependencies:
      reusify: 1.0.4

  fill-range@7.1.1:
    dependencies:
      to-regex-range: 5.0.1

  foreground-child@3.3.0:
    dependencies:
      cross-spawn: 7.0.6
      signal-exit: 4.1.0

  fsevents@2.3.3:
    optional: true

  function-bind@1.1.2: {}

  glob-parent@5.1.2:
    dependencies:
      is-glob: 4.0.3

  glob-parent@6.0.2:
    dependencies:
      is-glob: 4.0.3

  glob@10.4.5:
    dependencies:
      foreground-child: 3.3.0
      jackspeak: 3.4.3
      minimatch: 9.0.5
      minipass: 7.1.2
      package-json-from-dist: 1.0.1
      path-scurry: 1.11.1

  hasown@2.0.2:
    dependencies:
      function-bind: 1.1.2

  htmx.org@2.0.3: {}

  idiomorph@0.3.0: {}

  is-binary-path@2.1.0:
    dependencies:
      binary-extensions: 2.3.0

  is-core-module@2.15.1:
    dependencies:
      hasown: 2.0.2

  is-extglob@2.1.1: {}

  is-fullwidth-code-point@3.0.0: {}

  is-glob@4.0.3:
    dependencies:
      is-extglob: 2.1.1

  is-number@7.0.0: {}

  isexe@2.0.0: {}

  jackspeak@3.4.3:
    dependencies:
      '@isaacs/cliui': 8.0.2
    optionalDependencies:
      '@pkgjs/parseargs': 0.11.0

  jiti@1.21.6: {}

  lilconfig@2.1.0: {}

  lilconfig@3.1.2: {}

  lines-and-columns@1.2.4: {}

  lru-cache@10.4.3: {}

  merge2@1.4.1: {}

  micromatch@4.0.8:
    dependencies:
      braces: 3.0.3
      picomatch: 2.3.1

  minimatch@9.0.5:
    dependencies:
      brace-expansion: 2.0.1

  minipass@7.1.2: {}

  mz@2.7.0:
    dependencies:
      any-promise: 1.3.0
      object-assign: 4.1.1
      thenify-all: 1.6.0

  nanoid@3.3.7: {}

  normalize-path@3.0.0: {}

  object-assign@4.1.1: {}

  object-hash@3.0.0: {}

  package-json-from-dist@1.0.1: {}

  path-key@3.1.1: {}

  path-parse@1.0.7: {}

  path-scurry@1.11.1:
    dependencies:
      lru-cache: 10.4.3
      minipass: 7.1.2

  picocolors@1.1.1: {}

  picomatch@2.3.1: {}

  pify@2.3.0: {}

  pirates@4.0.6: {}

  postcss-import@15.1.0(postcss@8.4.49):
    dependencies:
      postcss: 8.4.49
      postcss-value-parser: 4.2.0
      read-cache: 1.0.0
      resolve: 1.22.8

  postcss-js@4.0.1(postcss@8.4.49):
    dependencies:
      camelcase-css: 2.0.1
      postcss: 8.4.49

  postcss-load-config@4.0.2(postcss@8.4.49):
    dependencies:
      lilconfig: 3.1.2
      yaml: 2.6.1
    optionalDependencies:
      postcss: 8.4.49

  postcss-nested@6.2.0(postcss@8.4.49):
    dependencies:
      postcss: 8.4.49
      postcss-selector-parser: 6.1.2

  postcss-selector-parser@6.1.2:
    dependencies:
      cssesc: 3.0.0
      util-deprecate: 1.0.2

  postcss-value-parser@4.2.0: {}

  postcss@8.4.49:
    dependencies:
      nanoid: 3.3.7
      picocolors: 1.1.1
      source-map-js: 1.2.1

  queue-microtask@1.2.3: {}

  read-cache@1.0.0:
    dependencies:
      pify: 2.3.0

  readdirp@3.6.0:
    dependencies:
      picomatch: 2.3.1

  resolve@1.22.8:
    dependencies:
      is-core-module: 2.15.1
      path-parse: 1.0.7
      supports-preserve-symlinks-flag: 1.0.0

  reusify@1.0.4: {}

  run-parallel@1.2.0:
    dependencies:
      queue-microtask: 1.2.3

  shebang-command@2.0.0:
    dependencies:
      shebang-regex: 3.0.0

  shebang-regex@3.0.0: {}

  signal-exit@4.1.0: {}

  source-map-js@1.2.1: {}

  string-width@4.2.3:
    dependencies:
      emoji-regex: 8.0.0
      is-fullwidth-code-point: 3.0.0
      strip-ansi: 6.0.1

  string-width@5.1.2:
    dependencies:
      eastasianwidth: 0.2.0
      emoji-regex: 9.2.2
      strip-ansi: 7.1.0

  strip-ansi@6.0.1:
    dependencies:
      ansi-regex: 5.0.1

  strip-ansi@7.1.0:
    dependencies:
      ansi-regex: 6.1.0

  sucrase@3.35.0:
    dependencies:
      '@jridgewell/gen-mapping': 0.3.5
      commander: 4.1.1
      glob: 10.4.5
      lines-and-columns: 1.2.4
      mz: 2.7.0
      pirates: 4.0.6
      ts-interface-checker: 0.1.13

  supports-preserve-symlinks-flag@1.0.0: {}

  svg.draggable.js@2.2.2:
    dependencies:
      svg.js: 2.7.1

  svg.easing.js@2.0.0:
    dependencies:
      svg.js: 2.7.1

  svg.filter.js@2.0.2:
    dependencies:
      svg.js: 2.7.1

  svg.js@2.7.1: {}

  svg.pathmorphing.js@0.1.3:
    dependencies:
      svg.js: 2.7.1

  svg.resize.js@1.4.3:
    dependencies:
      svg.js: 2.7.1
      svg.select.js: 2.1.2

  svg.select.js@2.1.2:
    dependencies:
      svg.js: 2.7.1

  svg.select.js@3.0.1:
    dependencies:
      svg.js: 2.7.1

  tailwindcss@3.4.15:
    dependencies:
      '@alloc/quick-lru': 5.2.0
      arg: 5.0.2
      chokidar: 3.6.0
      didyoumean: 1.2.2
      dlv: 1.1.3
      fast-glob: 3.3.2
      glob-parent: 6.0.2
      is-glob: 4.0.3
      jiti: 1.21.6
      lilconfig: 2.1.0
      micromatch: 4.0.8
      normalize-path: 3.0.0
      object-hash: 3.0.0
      picocolors: 1.1.1
      postcss: 8.4.49
      postcss-import: 15.1.0(postcss@8.4.49)
      postcss-js: 4.0.1(postcss@8.4.49)
      postcss-load-config: 4.0.2(postcss@8.4.49)
      postcss-nested: 6.2.0(postcss@8.4.49)
      postcss-selector-parser: 6.1.2
      resolve: 1.22.8
      sucrase: 3.35.0
    transitivePeerDependencies:
      - ts-node

  thenify-all@1.6.0:
    dependencies:
      thenify: 3.3.1

  thenify@3.3.1:
    dependencies:
      any-promise: 1.3.0

  to-regex-range@5.0.1:
    dependencies:
      is-number: 7.0.0

  ts-interface-checker@0.1.13: {}

  typescript@5.7.2: {}

  util-deprecate@1.0.2: {}

  which@2.0.2:
    dependencies:
      isexe: 2.0.0

  wrap-ansi@7.0.0:
    dependencies:
      ansi-styles: 4.3.0
      string-width: 4.2.3
      strip-ansi: 6.0.1

  wrap-ansi@8.1.0:
    dependencies:
      ansi-styles: 6.2.1
      string-width: 5.1.2
      strip-ansi: 7.1.0

  yaml@2.6.1: {}



================================================
FILE: client/tailwind.config.js
================================================
import daisyui from "daisyui";

/** @type {import('tailwindcss').Config} */
export default {
  content: [
    "./src/**/*.{html,js}",
    "../server/src/http_server/hypermedia/templates/**/*.html",
  ],
  safelist: [
    {
      pattern: /(fill|text|progress|alert)-(success|error|warning|info)/,
    },
  ],
  theme: {
    extend: {},
  },
  daisyui: {
    themes: [
      "light",
      "dark",
      "cupcake",
      "emerald",
      "corporate",
      "synthwave",
      "halloween",
      "forest",
      "fantasy",
      "dracula",
      "cmyk",
      "autumn",
      "business",
      "night",
      "winter",
      "dim",
      "nord",
      "sunset",
    ],
    darkTheme: "dark", // name of one of the included themes for dark mode
    base: true, // applies background color and foreground color for root element by default
    styled: true, // include daisyUI colors and design decisions for all components
    utils: true, // adds responsive and modifier utility classes
    prefix: "", // prefix for daisyUI classnames (components, modifiers and responsive class names. Not colors)
    logs: true, // Shows info about daisyUI version and used config in the console when building your CSS
    themeRoot: ":root", // The element that receives theme color CSS variables
  },
  plugins: [daisyui],
};



================================================
FILE: client/scripts/build.js
================================================
import * as esbuild from "esbuild";
import { readdirSync, copyFileSync, mkdirSync } from "node:fs";
import { join, parse } from "node:path";
import { spawnSync } from "node:child_process";

/**
 * @param {string | undefined} value
 * @returns {boolean}
 */
function parse_boolean(value) {
  switch (value?.toLowerCase()) {
    case "true":
    case "1":
    case undefined:
      return true;
    case "false":
    case "0":
      return false;
    default:
      throw new Error(`Expecting a boolean value, got '${value}'`);
  }
}

/**
 * @param {string | undefined} value
 * @returns {number}
 */
function parse_number(value) {
  const integer = parseInt(value);

  if (isNaN(integer)) {
    throw new Error(`Expecting a numeric value, got '${value}'`);
  } else {
    return integer;
  }
}

/**
 * @param {string | undefined} value
 * @returns {string}
 */
function parse_str(value) {
  if (value && value.length > 0) {
    return value;
  } else {
    throw new Error(`Expecting a string value, got '${value}'`);
  }
}

/**
 * Very basic cli arg parser instead of adding 100 more node_modules.
 *
 * @template {Record<string, "number" | "boolean" | "string" >} T
 * @param {T} config
 * @returns {Partial<{
 *    [Property in keyof T]: T[Property] extends "string"
 *        ? string
 *        : T[Property] extends "boolean"
 *            ? boolean
 *        : number
 * }>}
 */
function cli_arg_parser(config) {
  /** @type{T} **/
  let cli_args = {};

  for (const arg of process.argv.slice(2)) {
    const [argn, argv] = arg.trim().split("=", 2);

    try {
      if (argn && !argn.startsWith("--") && argn.length < 3) {
        throw new Error("Unknown flag");
      }

      const name = argn.slice(2);
      /** @type{"number"| "boolean" | "string" | undefined} **/
      const key_type = Reflect.get(config, name);

      switch (key_type) {
        case "string":
          cli_args[name] = parse_str(argv);
          break;
        case "boolean":
          cli_args[name] = parse_boolean(argv);
          break;
        case "number":
          cli_args[name] = parse_number(argv);
          break;
        default:
          throw new Error("Unknown flag");
      }
    } catch (err) {
      console.error(`Parsing ${argn} failed, ${err.message}.`);
      process.exit(1);
    }
  }

  return cli_args;
}

/**
 * @param {string} src
 * @param {string} dest
 */
function copy_dir(src, dest) {
  const files = readdirSync(src, {
    recursive: true,
  });

  for (const file of files) {
    const source_file = join(src, file);
    const target_file = join(dest, file);
    const base_dir = parse(target_file).dir;

    mkdirSync(base_dir, { recursive: true });

    console.log(`Copying ${source_file} -> ${target_file}`);
    copyFileSync(source_file, target_file);
  }
}

/**
 * @param {{
 *   minify?: boolean,
 *   outdir: string,
 * }} config
 */
async function build(config) {
  mkdirSync(config.outdir, { recursive: true });
  copy_dir("./static", config.outdir);

  await esbuild.build({
    bundle: true,
    entryPoints: ["./src/index.js"],
    format: "iife",
    minify: config.minify,
    target: ["firefox109", "chrome108", "safari15"],
    treeShaking: true,
    outdir: config.outdir,
  });

  const output_css = join(config.outdir, "style.css");

  // Don't want to deal with postcss, paths are fixed.
  let tailwind_process = spawnSync("./node_modules/tailwindcss/lib/cli.js", [
    "-i",
    "./src/style.css",
    "-o",
    output_css,
    "--minify",
  ]);

  console.log(tailwind_process.stdout.toString());
  console.error(tailwind_process.stderr.toString());

  if (tailwind_process.error) {
    throw tailwind_process.error;
  } else if (tailwind_process.status != 0) {
    throw new Error("Tailwindcss bundling failed.");
  }
}

async function main() {
  const opts = cli_arg_parser({
    outdir: "string",
    minify: "boolean",
  });

  if (!opts.outdir || opts.outdir.length < 1) {
    console.error("Output directory is not configured.");
    process.exit(1);
  }

  try {
    await build(opts);
    console.log("Build Completed.");
  } catch (err) {
    console.error(err.message);
    process.exit(1);
  }
}

main();



================================================
FILE: client/src/index.js
================================================
/**
 * Main entry point for client
 * Exports all web components, registers dom and htmx events.
 */

/**
 * @typedef HtmxSendError
 * @property {HTMLElement} elt
 * @property {HTMLElement} target
 * @property {any} requestConfig
 * @property {XMLHttpRequest} xhr
 */

/**
 * @typedef HtmxAfterRequest
 * @property {HTMLElement} elt
 * @property {HTMLElement} target
 * @property {any} requestConfig
 * @property {XMLHttpRequest} xhr
 * @property {boolean} successful
 */

/** @typedef {CustomEvent<HtmxSendError>} HtmxSendErrorEvent **/
/** @typedef {CustomEvent<HtmxAfterRequest>} HtmxAfterRequestEvent **/

import htmx from "htmx.org";
import { Idiomorph } from "idiomorph/dist/idiomorph.esm.js";

export * from "./components/charts/gauge.js";
export * from "./components/notification.js";
export * from "./components/confirmation_modal.js";
export * from "./components/theme_selector.js";
export * from "./components/time_display.js";

/**
 * @param {string} attr_name
 * @param {Element} node
 * @param {"updated" | "removed"} mutation_type
 * @returns {boolean}
 */
function attr_preserve(attr_name, node, mutation_type) {
  const preserve = node.getAttribute("morph-preserve-attr");

  if (preserve) {
    const target_attrs = preserve.split(" ");
    return !(target_attrs.findIndex((e) => e === attr_name) > -1);
  } else {
    return true;
  }
}

function create_morph_config(swapStyle) {
  let config;
  if (swapStyle === "morph" || swapStyle === "morph:outerHTML") {
    config = { morphStyle: "outerHTML" };
  } else if (swapStyle === "morph:innerHTML") {
    config = { morphStyle: "innerHTML" };
  } else if (swapStyle.startsWith("morph:")) {
    config = Function("return (" + swapStyle.slice(6) + ")")();
  }

  config.callbacks = { beforeAttributeUpdated: attr_preserve };

  return config;
}

htmx.defineExtension("morph", {
  isInlineSwap: function (swapStyle) {
    const config = create_morph_config(swapStyle);
    return config.swapStyle === "outerHTML" || config.swapStyle == null;
  },
  handleSwap: function (swapStyle, target, fragment) {
    const config = create_morph_config(swapStyle);

    if (config) {
      return Idiomorph.morph(target, fragment.children, config);
    }
  },
});

const ConnectionState = (() => {
  /** @type{boolean} **/
  let state = 0;

  return {
    get is_lost() {
      return state;
    },
    set is_lost(value) {
      state = value;
    },
  };
})();

document.body.addEventListener(
  "htmx:sendError",
  (/** @type{HtmxSendErrorEvent} **/ ev) => {
    if (!ConnectionState.is_lost) {
      ConnectionState.is_lost = true;

      const indicators = document.querySelectorAll(
        ".htmx-send-error-indicator",
      );

      console.warn(
        "Poll send request is failed, check your connection.",
        ev.detail.xhr,
      );

      for (const element of indicators) {
        element.className += " htmx-send-error-active";
      }
    }
  },
);

document.body.addEventListener(
  "htmx:afterRequest",
  (/** @type{HtmxAfterRequestEvent} **/ ev) => {
    if (ConnectionState.is_lost) {
      const indicators = document.querySelectorAll(
        ".htmx-send-error-indicator",
      );

      for (const element of indicators) {
        element.className = element.className
          .replace("htmx-send-error-active", "")
          .trimEnd();
      }

      ConnectionState.is_lost = false;
    }
  },
);



================================================
FILE: client/src/style.css
================================================
/* Register all required css files here*/

@tailwind base;
@tailwind components;
@tailwind utilities;

@layer components {

        .htmx-send-error-indicator {
                @apply text-error animate-pulse hidden;
        }

        .htmx-send-error-active {
                @apply inline-block;
        }
}



================================================
FILE: client/src/utils.js
================================================
/**
 * @param {ShadowRoot} root
 * @returns {void}
 */
export function link_host_styles(root) {
  for (const sheet of document.styleSheets) {
    if (!sheet.href) continue;

    const link = document.createElement("link");

    link.rel = "stylesheet";
    link.href = sheet.href;
    root.prepend(link);
  }
}



================================================
FILE: client/src/components/confirmation_modal.js
================================================
import { link_host_styles } from "../utils";

const TEMPLATE = document.createElement("template");
TEMPLATE.innerHTML = `
<dialog class="modal modal-bottom sm:modal-middle">
   <div class="modal-box">
      <h3 class="font-bold text-lg">
        <slot name="title">Confirm</slot>
      </h3>
      <p class="py-4">
        <slot></slot>
      </p>
      <div class="modal-action">
        <form class="flex flex-row gap-3" method="dialog">
          <button value="cancel" class="btn">
            <slot name="cancel_text">Cancel</slot>
          </button>
          <button value="default" class="btn btn-primary">
            <slot name="confirm_text">Confirm</slot>
          </button>
        </form>
      </div>
    </div>
</dialog>`;

export default class ConfirmationModal extends HTMLElement {
  /** @type{HTMLDialogElement} **/
  #dialog;

  constructor() {
    super();
  }

  /**
   * Create a confirmation modal programmatically
   * @param {{message?: string, title?:string, confirmText?:string, cancelText?:string}} options
   * @return {Promise<boolean>}
   */
  static create(options) {
    /** @type {ConfirmationModal} */
    const modal = new ConfirmationModal();
    document.body.appendChild(modal);

    const title = document.createElement("span");
    title.slot = "title";
    title.textContent = options.title;

    const confirm = document.createElement("span");
    confirm.slot = "confirm_text";
    confirm.textContent = options.confirmText;

    const cancel = document.createElement("span");
    cancel.slot = "cancel_text";
    cancel.textContent = options.cancelText;

    const message = document.createElement("span");
    message.textContent = options.message;

    modal.append(title, confirm, cancel, message);
    modal.showModal();

    return new Promise((resolve) => {
      modal.addEventListener(
        "close",
        (/** @type{CustomEvent<"default" | "cancel">} **/ ev) => {
          setTimeout(() => {
            modal.remove();
          });

          resolve(ev.detail === "default");
        },
        { once: true },
      );
    });
  }

  disconnectedCallback() {
    this.remove();
  }

  connectedCallback() {
    const shadow_root = this.attachShadow({ mode: "open" });
    link_host_styles(shadow_root);
    shadow_root.appendChild(TEMPLATE.content.cloneNode(true));

    this.#dialog = this.shadowRoot.querySelector("dialog");
    this.#dialog.addEventListener("close", () => {
      this.dispatchEvent(
        new CustomEvent("close", {
          detail: this.#dialog.returnValue,
          bubbles: true,
          composed: true,
        }),
      );
    });
  }

  showModal() {
    this.#dialog.showModal();
  }
}

customElements.define("nut-confirm", ConfirmationModal);
Reflect.set(self, "ConfirmationModal", ConfirmationModal);



================================================
FILE: client/src/components/notification.js
================================================
/** @typedef {"ttl" | "title"  | "closeable" | "type"} AttributeKeys */

const TRIGGER_QUERY =
  ".nut-notification-trigger button, .nut-notification-trigger a, .nut-notification-trigger [role=button]";

export default class NutNotification extends HTMLElement {
  /** @type {number|undefined} */
  #timer;

  constructor() {
    super();
    this.#timer = undefined;
  }

  connectedCallback() {
    const ttl_attr = Number(this.getAttribute("ttl"));
    const type = this.getAttribute("type") ?? "info";
    const ttl = isNaN(ttl_attr) || ttl_attr < 1 ? 3000 : ttl_attr;
    const dismissElements = this.querySelectorAll(TRIGGER_QUERY);

    for (const element of dismissElements) {
      element.addEventListener("click", () => this?.remove());
    }

    this.className = `${this.className} alert alert-${type}`;
    this.#timer = setTimeout(() => {
      this?.remove();
    }, ttl);
  }

  disconnectedCallback() {
    if (this.#timer) {
      clearTimeout(this.#timer);
    }

    this.remove();
  }

  dismiss() {
    this.remove();
  }

  /** @param {string} id */
  static dismiss(id) {
    /** @type {UpsMonNotification} */
    const element = document.getElementById(id);
    if (element) {
      element?.dismiss();
    } else {
      console.warn(`${id} does not exists in document.`);
    }
  }
}

customElements.define("nut-notification", NutNotification);
Reflect.set(window, "NutNotification", NutNotification);



================================================
FILE: client/src/components/theme_selector.js
================================================
/**
 * @typedef {"theme-key"} ThemeSelectorAttributes
 */

/**
 * @typedef {CustomEvent<{theme: string}>} ThemeEvent
 */

const LOCAL_STORAGE_KEY = "app_theme";
const DATA_THEME_KEY = "data-theme";

class ThemeSelector extends HTMLElement {
  /** @type{ThemeSelectorAttributes[]} **/
  static observedAttributes = ["theme-key"];
  /** @type{string | null} **/
  #theme_value;

  constructor() {
    super();
  }

  connectedCallback() {
    this.#theme_value = this.getAttribute("theme-key") ?? "default";
    this.role = "button";

    this.addEventListener("click", this.update_theme);
  }

  disconnectedCallback() {
    this.removeEventListener("click", this.update_theme);
  }

  /**
   * @param {ThemeSelectorAttributes} name
   * @param {string | null} old_value
   * @param {string | null} new_value
   * @returns {void}
   */
  attributeChangedCallback(name, old_value, new_value) {
    switch (name) {
      case "theme-key": {
        this.#theme_value = new_value;
        break;
      }
      default: {
        console.warn(`Unhandled attribute change ${name}`, this);
        break;
      }
    }
  }

  update_theme = () => {
    if (this.#theme_value) {
      localStorage.setItem(LOCAL_STORAGE_KEY, this.#theme_value);
      document.documentElement.setAttribute(DATA_THEME_KEY, this.#theme_value);
      document.dispatchEvent(
        new CustomEvent("theme-change", {
          detail: { theme: this.#theme_value },
          cancelable: false,
        }),
      );
    } else {
      console.warn("No theme value attached to the theme selector", this);
    }
  };
}

customElements.define("theme-selector", ThemeSelector);



================================================
FILE: client/src/components/time_display.js
================================================
import { link_host_styles } from "../utils.js";

/** @typedef {"value"} TimeDisplayAttrTypes */

const MINUTE = 60;
const HOUR = 60 * MINUTE;
const DAY = 24 * HOUR;
const MONTH = 30 * DAY;
const YEAR = 365 * DAY;

/**
 * @param {number} divisor
 * @param {number} dividend
 * @returns {[number,number]}
 */
function div_with_remainder(dividend, divisor) {
  // Internal only, no need for divide by 0 check.
  let quotient = Math.floor(dividend / divisor);
  let remainder = dividend - quotient * divisor;

  return [quotient, remainder];
}

/**
 * @param {number} input
 * @returns {string}
 */
function get_time_str(input) {
  /** @type{string[]} **/
  let sections = [];
  let remaining_time = input;

  if (remaining_time > YEAR) {
    let [years, remaining] = div_with_remainder(remaining_time, YEAR);
    remaining_time = remaining;
    sections.push(`${years}y`);
  }

  if (remaining_time > MONTH) {
    let [months, remaining] = div_with_remainder(remaining_time, MONTH);
    remaining_time = remaining;
    sections.push(`${months}M`);
  }

  if (remaining_time > DAY) {
    let [days, remaining] = div_with_remainder(remaining_time, DAY);
    remaining_time = remaining;
    sections.push(`${days}d`);
  }

  if (remaining_time > HOUR) {
    let [hours, remaining] = div_with_remainder(remaining_time, HOUR);
    remaining_time = remaining;
    sections.push(`${hours}h`);
  }

  if (remaining_time > MINUTE) {
    let [minutes, remaining] = div_with_remainder(remaining_time, MINUTE);
    remaining_time = remaining;
    sections.push(`${minutes}m`);
  }

  if (remaining_time > 0) {
    sections.push(`${remaining_time}s`);
  }

  return sections.join(" ");
}

export default class TimeDisplay extends HTMLElement {
  /** @type{TimeDisplayAttrTypes[]} **/
  static observedAttributes = ["value"];

  /** @type{ShadowRoot} **/
  #root;

  constructor() {
    super();
  }

  disconnectedCallback() {
    this.remove();
  }

  connectedCallback() {
    this.innerHTML = null;

    const value = Number(this.getAttribute("value"));
    this.#root = this.attachShadow({ mode: "open" });
    link_host_styles(this.#root);

    this.generate_display(value);
  }

  /** @param {number} value  **/
  generate_display(value) {
    if (this.#root) {
      if (isNaN(value)) {
        this.#root.innerHTML = "[ERR! NaN value]";
        return;
      }

      this.#root.innerHTML = get_time_str(Math.floor(value));
    }
  }

  /**
   * @param {TimeDisplayAttrTypes} name
   * @param {null | undefined | string} _old_value
   * @param {null | undefined | string} new_value
   */
  attributeChangedCallback(name, _old_value, new_value) {
    if (name === "value") {
      this.generate_display(Number(new_value));
    }
  }
}

customElements.define("nut-time-display", TimeDisplay);



================================================
FILE: client/src/components/charts/gauge.js
================================================
import { link_host_styles } from "../../utils.js";
import ApexCharts from "apexcharts";

/** @import {ApexOptions} from "apexcharts" */

/**
 * @typedef {"value" | "height" | "width" | "theme" | "class" } AttributeKeys
 */

export default class Gauge extends HTMLElement {
  /** @type {ApexCharts} */
  #chart;
  /** @type {() => void} **/
  #theme_listener = () => {
    if (this.#chart) {
      /** @type {ApexOptions} **/
      const new_options = {
        plotOptions: {
          radialBar: {
            dataLabels: {
              value: {
                color: [window.getComputedStyle(this).color],
              },
            },
          },
        },
        fill: {
          colors: [window.getComputedStyle(this).fill],
        },
      };

      this.#chart.updateOptions(new_options, false, false).catch(console.error);
    }
  };

  /** @type {AttributeKeys[]} */
  static observedAttributes = ["value", "height", "width", "class"];

  constructor() {
    super();
  }

  connectedCallback() {
    const shadow_root = this.attachShadow({ mode: "closed" });
    const child = document.createElement("div");
    shadow_root.replaceChildren(child);
    link_host_styles(shadow_root);

    const value_text = this.getAttribute("value") ?? "0";
    const height = this.getAttribute("height") ?? "auto";
    const width = this.getAttribute("width") ?? "100%";

    let value_number = Number(value_text);
    value_number = isNaN(value_number) ? 0 : value_number;

    /** @type {ApexOptions} **/
    const options = {
      series: [value_number],
      chart: {
        height: height,
        width: width,
        type: "radialBar",
        offsetY: -20,
        sparkline: {
          enabled: true,
        },
      },
      plotOptions: {
        radialBar: {
          hollow: {
            size: 70,
            margin: 10,
          },
          startAngle: -90,
          endAngle: 90,
          track: {
            background: "#a0a0a0",
            strokeWidth: 90,
            margin: 10,
          },
          dataLabels: {
            name: {
              show: false,
            },
            value: {
              offsetY: -2,
              fontSize: "2.5rem",
              color: [window.getComputedStyle(this).color],
            },
          },
        },
      },
      fill: {
        type: "solid",
        colors: [window.getComputedStyle(this).fill],
        opacity: 0.5,
      },
    };

    this.#chart = new ApexCharts(child, options);
    this.#chart.render().catch(console.error);
    document.addEventListener("theme-change", this.#theme_listener);
  }

  disconnectedCallback() {
    this.#chart?.destroy();
    document.removeEventListener("theme-change", this.#theme_listener);
  }

  /**
   * @param {AttributeKeys} name
   * @param {string} old_value
   * @param {string} new_value
   */
  attributeChangedCallback(name, _old_value, new_value) {
    if (!this.#chart) return;

    switch (name) {
      case "value": {
        const series_value = Number(new_value) ?? 0;
        this.#chart.updateSeries([series_value], true).catch(console.error);
        break;
      }
      case "height":
        this.#chart
          .updateOptions({
            chart: {
              height: new_value ?? "auto",
            },
          })
          .catch(console.error);
        break;
      case "width":
        this.#chart
          .updateOptions({
            chart: {
              width: new_value ?? "100%",
            },
          })
          .catch(console.error);
        break;
      case "class": {
        this.#chart.updateOptions({}, false, false).catch(console.error);
        break;
      }
      default:
        break;
    }
  }
}

customElements.define("nut-gauge", Gauge);




================================================
FILE: containers/amd64-v3.Dockerfile
================================================
FROM --platform=linux/amd64 docker.io/busybox:stable-musl
RUN adduser -H -D -g "<nut_web>" nut_webgui
COPY --chmod=750 --chown=root:nut_webgui ./containers/server_start.sh /opt/nut_webgui/server_start.sh
COPY --chmod=750 --chown=root:nut_webgui ./bin/x86-64-v3-musl/nut_webgui /opt/nut_webgui/nut_webgui
COPY --chmod=744 --chown=root:nut_webgui ./bin/static /opt/nut_webgui/static
WORKDIR /opt/nut_webgui
USER nut_webgui
CMD ["/opt/nut_webgui/server_start.sh"]



================================================
FILE: containers/amd64-v4.Dockerfile
================================================
FROM --platform=linux/amd64 docker.io/busybox:stable-musl
RUN adduser -H -D -g "<nut_web>" nut_webgui
COPY --chmod=750 --chown=root:nut_webgui ./containers/server_start.sh /opt/nut_webgui/server_start.sh
COPY --chmod=750 --chown=root:nut_webgui ./bin/x86-64-v4-musl/nut_webgui /opt/nut_webgui/nut_webgui
COPY --chmod=744 --chown=root:nut_webgui ./bin/static /opt/nut_webgui/static
WORKDIR /opt/nut_webgui
USER nut_webgui
CMD ["/opt/nut_webgui/server_start.sh"]



================================================
FILE: containers/amd64.Dockerfile
================================================
FROM --platform=linux/amd64 docker.io/busybox:stable-musl
RUN adduser -H -D -g "<nut_web>" nut_webgui
COPY --chmod=750 --chown=root:nut_webgui ./containers/server_start.sh /opt/nut_webgui/server_start.sh
COPY --chmod=750 --chown=root:nut_webgui ./bin/x86-64-musl/nut_webgui /opt/nut_webgui/nut_webgui
COPY --chmod=744 --chown=root:nut_webgui ./bin/static /opt/nut_webgui/static
WORKDIR /opt/nut_webgui
USER nut_webgui
CMD ["/opt/nut_webgui/server_start.sh"]



================================================
FILE: containers/annotation.conf
================================================
VERSION="0.4.0"
HOME_URL="https://github.com/SuperioOne/nut_webgui"
NAME="nut_webgui"
LICENSES="Apache-2.0"
AUTHORS="Timur Olur <pm@smdd.dev>"
DOCUMENTATION="https://github.com/SuperioOne/nut_webgui"
SOURCE="https://github.com/SuperioOne/nut_webgui"
DESCRIPTION="Light weight web interface for Network UPS Tools."
REVISION="38aba37149cac2bdee35e0eaad6b8a3d2ced0961"



================================================
FILE: containers/arm64.Dockerfile
================================================
FROM --platform=linux/arm64/v8 docker.io/busybox:stable-musl
RUN adduser -H -D -g "<nut_web>" nut_webgui
COPY --chmod=750 --chown=root:nut_webgui ./containers/server_start.sh /opt/nut_webgui/server_start.sh
COPY --chmod=750 --chown=root:nut_webgui ./bin/aarch64-musl/nut_webgui /opt/nut_webgui/nut_webgui
COPY --chmod=744 --chown=root:nut_webgui ./bin/static /opt/nut_webgui/static
WORKDIR /opt/nut_webgui
USER nut_webgui
CMD ["/opt/nut_webgui/server_start.sh"]



================================================
FILE: containers/armv6.Dockerfile
================================================
FROM --platform=linux/arm/v6 docker.io/busybox:stable-musl
RUN adduser -H -D -g "<nut_web>" nut_webgui
COPY --chmod=750 --chown=root:nut_webgui ./containers/server_start.sh /opt/nut_webgui/server_start.sh
COPY --chmod=750 --chown=root:nut_webgui ./bin/armv6-musleabi/nut_webgui /opt/nut_webgui/nut_webgui
COPY --chmod=744 --chown=root:nut_webgui ./bin/static /opt/nut_webgui/static
WORKDIR /opt/nut_webgui
USER nut_webgui
CMD ["/opt/nut_webgui/server_start.sh"]



================================================
FILE: containers/armv7.Dockerfile
================================================
FROM --platform=linux/arm/v7 docker.io/busybox:stable-musl
RUN adduser -H -D -g "<nut_web>" nut_webgui
COPY --chmod=750 --chown=root:nut_webgui ./containers/server_start.sh /opt/nut_webgui/server_start.sh
COPY --chmod=750 --chown=root:nut_webgui ./bin/armv7-musleabi/nut_webgui /opt/nut_webgui/nut_webgui
COPY --chmod=744 --chown=root:nut_webgui ./bin/static /opt/nut_webgui/static
WORKDIR /opt/nut_webgui
USER nut_webgui
CMD ["/opt/nut_webgui/server_start.sh"]



================================================
FILE: containers/Dockerfile.template
================================================
FROM --platform={PLATFORM} docker.io/busybox:{BUSYBOX_LABEL}
RUN adduser -H -D -g "<nut_web>" nut_webgui
COPY --chmod=750 --chown=root:nut_webgui ./containers/server_start.sh /opt/nut_webgui/server_start.sh
COPY --chmod=750 --chown=root:nut_webgui ./bin/{BIN_DIR}/nut_webgui /opt/nut_webgui/nut_webgui
COPY --chmod=744 --chown=root:nut_webgui ./bin/static /opt/nut_webgui/static
WORKDIR /opt/nut_webgui
USER nut_webgui
CMD ["/opt/nut_webgui/server_start.sh"]



================================================
FILE: containers/riscv64.Dockerfile
================================================
FROM --platform=linux/riscv64 docker.io/busybox:stable-musl
RUN adduser -H -D -g "<nut_web>" nut_webgui
COPY --chmod=750 --chown=root:nut_webgui ./containers/server_start.sh /opt/nut_webgui/server_start.sh
COPY --chmod=750 --chown=root:nut_webgui ./bin/riscv64gc-gnu/nut_webgui /opt/nut_webgui/nut_webgui
COPY --chmod=744 --chown=root:nut_webgui ./bin/static /opt/nut_webgui/static
WORKDIR /opt/nut_webgui
USER nut_webgui
CMD ["/opt/nut_webgui/server_start.sh"]



================================================
FILE: containers/server_start.sh
================================================
#!/usr/bin/env sh
set -e
BIN_LOCATION=/opt/nut_webgui/nut_webgui
STATIC_LOCATION=/opt/nut_webgui/static

exec "$BIN_LOCATION" --static-dir "$STATIC_LOCATION" \
    ${LISTEN:+"--listen"} ${LISTEN:+"${LISTEN}"} \
    ${PORT:+"--port"} ${PORT:+"${PORT}"} \
    ${POLL_FREQ:+"--poll-freq"} ${POLL_FREQ:+"${POLL_FREQ}"} \
    ${POLL_INTERVAL:+"--poll-interval"} ${POLL_INTERVAL:+"${POLL_INTERVAL}"} \
    ${UPSD_PORT:+"--upsd-port"} ${UPSD_PORT:+"${UPSD_PORT}"} \
    ${UPSD_ADDR:+"--upsd-addr"} ${UPSD_ADDR:+"${UPSD_ADDR}"} \
    ${UPSD_USER:+"--upsd-user"} ${UPSD_USER:+"${UPSD_USER}"} \
    ${UPSD_PASS:+"--upsd-pass"} ${UPSD_PASS:+"${UPSD_PASS}"} \
    ${LOG_LEVEL:+"--log-level"} ${LOG_LEVEL:+"${LOG_LEVEL}"} \
    ${BASE_PATH:+"--base-path"} ${BASE_PATH:+"${BASE_PATH}"}



================================================
FILE: docs/building_debugging.md
================================================
# Building from source

## Linux:

### Requirements:
Required host tools are:
  - make
  - cargo
  - node
  - pnpm
  - jq

Optionally, You need the following packages and Rust targets for cross-compilation.

Required packages:
  - riscv64-linux-gnu-gcc
  - aarch64-linux-gnu-gcc

Required Rust targets:
  - aarch64-unknown-linux-gnu
  - aarch64-unknown-linux-musl
  - arm-unknown-linux-musleabi
  - armv7-unknown-linux-musleabi
  - riscv64gc-unknown-linux-gnu
  - x86_64-unknown-linux-gnu
  - x86_64-unknown-linux-musl

### Building

```shell
make build

# Output dirs ./bin/release/ and ./bin/static
```
or cross-compile everything (x86-64, ARM64-v8, ARM7, ARM6, RISC-V64)

```shell
make build-all

# Output dirs ./bin/<target-name> and ./bin/static
```

> For more options, check the available recipes inside the [Makefile](../Makefile).

# Development and Testing

Clone the git repository.

```shell
git clone --recurse-submodules https://github.com/SuperioOne/nut_webgui.git
```

> `--recurse-submodule` flag is required for the UPS validation tests. It pulls 
> [NUT Device Dumps Library](https://github.com/networkupstools/nut-ddl) as submodule, 
> which contains known UPS device dumps.

You can start front-end and back-end server via `./start_dev.sh`. It simply calls
[`cargo-watch`](https://github.com/watchexec/cargo-watch), esbuild and tailwind.

```shell
# (Optional) Set your NUT server address, default is localhost.
export UPSD_ADDR="10.0.0.1"

# (Optional) set username and password to test INST_CMD.
export UPSD_USER="user_name"
export UPSD_PASS="yo"

./start_dev.sh
```

## Testing

Simply use `make test` command to run all available tests.

## Simulating UPS devices with container

A basic NUT server container image is available at [tools/dummy_server](../tools/dummy_server) directory. 
It starts a NUT server, and automatically configures dummy UPS devices with the 
mounted `.seq` and `.dev` files.

> Expected file formats are:
> - <UPS_NAME>.dev
> - <UPS_NAME>.seq

```shell
cd tools/dummy_server

# Build dummy_server image
docker build -t dummy_server:latest -f dummy_server.Dockerfile

# Create a device dump directory to mount.
mkdir example-devices

# Copy your .seq and .dev files to the example-devices directory.

# Start NUT server with dummy devices
docker run --rm -p 3493:3493 -v "$(pwd)/example-devices":/nut_devices dummy_server:latest
```

For `dummy-ups` driver details, see [NetworkUpsTools - dummy-ups.](https://networkupstools.org/docs/man/dummy-ups.html)

For `.dev` and `.seq` details, see [nut-ddl.](https://github.com/networkupstools/nut-ddl)




================================================
FILE: docs/docker_compose.md
================================================
# Docker Compose

# External Host
```
┌──────┐
│ UPS1 ├──┐                                                  ┌─┐
└──────┘  │     Server A                   Server B          │C│
          │     ┌─────────────┐            ┌───────────┐     │L│
┌──────┐  │     │ NUT Service │    TCP     │  Docker   │     │I│
│ UPS2 ├──┼────►│             │◄──────────►│  Compose  │◄───►│E│
└──────┘  │     └─────────────┘            └───────────┘     │N│
          │       myhost:1234                                │T│
┌──────┐  │                                                  │S│
│ UPS3 ├──┘                                                  └─┘
└──────┘
```

**docker-compose.yaml**
```yaml
version: "3.3"
services:
  nutweb:
    image: ghcr.io/superioone/nut_webgui:latest
    restart: always
    ports:
      - 80:1234
    environment:
      POLL_FREQ: "60"
      POLL_INTERVAL: "5"
      UPSD_ADDR: "myhost"
      UPSD_PORT: "1234"
      UPSD_USER: "admin"
      UPSD_PASS: "test"
      LISTEN: "0.0.0.0"
      PORT: "1234"
      LOG_LEVEL: "debug"

# Add other services, reverse proxy of your choice etc.
```

# Same host
```
┌──────┐
│ UPS1 ├──┐     Single Server       ┌─┐
└──────┘  │     ┌─────────────┐     │C│
          │     │   Docker    │     │L│
┌──────┐  │     │   Compose   │     │I│
│ UPS2 ├──┼────►├─────────────┤◄───►│E│
└──────┘  │     │ NUT Service │     │N│
          │     │             │     │T│
┌──────┐  │     └─────────────┘     │S│
│ UPS3 ├──┘     localhost:3493      └─┘
└──────┘

```

**docker-compose.yaml**
```yaml
version: "3.3"
services:
  nutweb:
    image: ghcr.io/superioone/nut_webgui:latest
    restart: always
    network_mode: host         # Share same host
    environment:
      POLL_FREQ: "60"
      POLL_INTERVAL: "5"
      UPSD_ADDR: "localhost"
      UPSD_PORT: "3493"
      UPSD_USER: "admin"
      UPSD_PASS: "test"
      PORT: "80"               # Outgoing port 
      LOG_LEVEL: "debug"
```

# Custom base path

Use `BASE_PATH` environment variable if you use path-base routing between multiple services.

**docker-compose.yaml**
```yaml
version: "3.3"
services:
  nutweb:
    image: ghcr.io/superioone/nut_webgui:latest
    restart: always
    environment:
      POLL_FREQ: "60"
      POLL_INTERVAL: "5"
      UPSD_ADDR: "nut_server_address"
      UPSD_PORT: "3493"
      UPSD_USER: "admin"
      UPSD_PASS: "test"
      LOG_LEVEL: "debug"
      BASE_PATH: "services/nut-web"
```

- Homepage -> `http://<host-name>/services/nut-web/`
- Health probe -> `http://<host-name>/services/nut-web/probes/health`
- JSON api -> `http://<host-name>/services/nut-web/api/ups`

## Caddy example config

```
:80 {
     reverse_proxy  /services/nut-web/* nutweb:9000
}
```

## Nginx example config

```
events {}

http {
    server {
        server_name   acme.com;
        listen        80;

        location /services/nut-web/ {
                proxy_pass         http://nutweb:9000;
        }
    }
}
```



================================================
FILE: docs/kubernetes_example.md
================================================
# Kubernetes with EndpointSlice

Example topology

```
 ┌──────┐                                   Kubernetes
 │ UPS1 ├──┐                                 Cluster       ┌─┐
 └──────┘  │                               ┌─────────┐     │C│
           │     ┌─────────────┐           │ NODE A  │◄───►│L│
 ┌──────┐  │     │ NUT Service │    TCP    ├─────────┤     │I│
 │ UPS2 ├──┼────►│             │◄─────────►│ NODE B  │◄───►│E│
 └──────┘  │     └─────────────┘           ├─────────┤     │N│
           │    192.168.1.12:3493          │ NODE C  │◄───►│T│
 ┌──────┐  │                               └─────────┘     │S│
 │ UPS3 ├──┘                                               └─┘
 └──────┘
```

**endpoint_slice.yaml**

```yaml
apiVersion: v1
kind: Service
metadata:
  name: nut-service
spec:
  ports:
    - name: nut
      protocol: TCP
      port: 3493
      targetPort: 3493

---
apiVersion: discovery.k8s.io/v1
kind: EndpointSlice
metadata:
  name: nut-service-1
  labels:
    kubernetes.io/service-name: nut-service
addressType: IPv4
ports:
  - name: "nut"
    protocol: TCP
    port: 3493
endpoints:
  - addresses:
      - "192.168.1.12"
```

**secret.yaml**

```yaml
apiVersion: v1
kind: Secret
metadata:
  name: nutweb-secret
type: Opaque
data:
  UPSD_USER: Zm9v  # base64 encoded "foo"
  UPSD_PASS: YmFy  # base64 encoded "bar"
```

**deployment.yaml**

```yaml
apiVersion: apps/v1
kind: Deployment
metadata:
  name: nutweb-deployment
spec:
  replicas: 1
  selector:
    matchLabels:
      app: nutweb-pod
  template:
    metadata:
      labels:
        app: nutweb-pod
    spec:
      containers:
        - name: nutweb
          image: ghcr.io/superioone/nut_webgui:latest
          envFrom:
            - secretRef:
                name: nutweb-secret
          env:
            - name: UPSD_ADDR
              value: nut-service
            - name: UPSD_PORT
              value: "3493"
            - name: POLL_FREQ
              value: "20"
          resources:
            limits:
              memory: "64Mi"
            requests:
              memory: "32Mi" # You can go low as 4Mi. As example, single pod uses 2Mi memory for a user with 12 UPS devices.
          ports:
            - containerPort: 9000
          startupProbe:
            httpGet:
              path: /probes/readiness
              port: 9000
            initialDelaySeconds: 5
            failureThreshold: 15
            periodSeconds: 10
          livenessProbe:
            httpGet:
              path: /probes/health
              port: 9000
            initialDelaySeconds: 5
            failureThreshold: 3
            periodSeconds: 30
          readinessProbe:
            httpGet:
              path: /probes/readiness
              port: 9000
            initialDelaySeconds: 5
            failureThreshold: 3
            periodSeconds: 30
```




================================================
FILE: docs/openapi3_spec.json
================================================
{"openapi":"3.1.0","info":{"title":"nut_webgui JSON API","version":"0.4.0","summary":"Simple JSON API for interfacing with nut_webgui.","license":{"name":"Apache 2.0","url":"https://raw.githubusercontent.com/SuperioOne/nut_webgui/refs/heads/master/LICENSE"},"contact":{"url":"https://github.com/SuperioOne/nut_webgui/issues","email":"pm@smdd.dev"}},"servers":[{"url":"{protocol}://{host}:{port}","description":"nut_webgui server","variables":{"host":{"default":"localhost"},"port":{"default":"9000"},"protocol":{"default":"http","enum":["http","https"]}}}],"paths":{"/api/ups":{"description":"Returns collection of all available UPS devices.","get":{"tags":["ups"],"operationId":"api_ups_collection_get","responses":{"200":{"description":"Collection of UPS devices.","content":{"application/json":{"examples":{"ups_list":{"$ref":"#/components/examples/ups_list_response"},"empty_list":{"$ref":"#/components/examples/empty_ups_list_response"}},"schema":{"$ref":"#/components/schemas/UpsList"}}}},"500":{"description":"Server or daemon errors.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}},"503":{"description":"Server is not ready to serve.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}}}}},"/api/ups/{ups_name}":{"description":"Returns a UPS devices.","get":{"parameters":[{"name":"ups_name","in":"path","description":"UPS name","required":true,"allowEmptyValue":false,"schema":{"type":"string"}}],"tags":["ups"],"operationId":"api_ups_get","responses":{"200":{"description":"UPS device response.","content":{"application/json":{"examples":{"ups":{"$ref":"#/components/examples/ups_response"}},"schema":{"$ref":"#/components/schemas/Ups"}}}},"404":{"description":"Ups does not exists.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}},"500":{"description":"Server or daemon errors.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}},"503":{"description":"Server is not ready to serve.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}}}}},"/api/ups/{ups_name}/command":{"description":"Instantiate a UPS command.","post":{"requestBody":{"description":"Command request body.","required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CommandRequest"}}}},"parameters":[{"name":"ups_name","in":"path","description":"UPS name","required":true,"allowEmptyValue":false,"schema":{"type":"string"}}],"tags":["ups"],"operationId":"api_ups_instcmd","responses":{"202":{"description":"Command is accepted."},"401":{"description":"Upsd user and password configs are not set.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}},"404":{"description":"Ups does not exists.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}},"500":{"description":"Server or daemon errors.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}},"503":{"description":"Server is not ready to serve.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}}}}},"/probes/health":{"description":"Server health check","get":{"tags":["probes"],"operationId":"probes_health","responses":{"200":{"description":"Command is accepted","content":{"application/json":{"examples":{"default":{"$ref":"#/components/examples/health_200"}},"schema":{"$ref":"#/components/schemas/HealthResponse"}}}},"500":{"description":"Upsd daemon failure","content":{"application/json":{"examples":{"default":{"$ref":"#/components/examples/health_500"}},"schema":{"$ref":"#/components/schemas/HealthResponse"}}}},"503":{"description":"Server is not ready to serve","content":{"application/json":{"examples":{"default":{"$ref":"#/components/examples/health_503"}},"schema":{"$ref":"#/components/schemas/HealthResponse"}}}}}}},"/probes/readiness":{"description":"Server readiness probe mainly intented for Kubernetes.","get":{"tags":["probes"],"operationId":"probes_readiness","responses":{"200":{"description":"Server is ready to response.","content":{"text/plain":{"schema":{"enum":["READY"]}}}},"503":{"description":"Server is not ready to response.","content":{"text/plain":{"schema":{"enum":["NOT READY"]}}}}}}}},"components":{"schemas":{"Ups":{"type":"object","required":["name","desc","vars","cmds"],"properties":{"name":{"type":"string"},"desc":{"type":"string"},"vars":{"type":"object","additionalProperties":{"oneOf":[{"type":"number"},{"type":"string"}]}},"cmds":{"type":"array","items":{"type":"string"}}}},"UpsList":{"type":"array","items":{"$ref":"#/components/schemas/Ups"}},"ProblemDetails":{"type":"object","required":["title","status"],"properties":{"title":{"type":"string"},"details":{"type":"string"},"status":{"type":"number","minimum":100,"exclusiveMaximum":1000},"instance":{"type":"string","format":"uri"}}},"CommandRequest":{"type":"object","required":["cmd"],"properties":{"cmd":{"type":"string"}}},"HealthResponse":{"type":"object","required":["upsd_status","upsd_server"],"properties":{"last_updated":{"type":"string","format":"date-time"},"upsd_server":{"type":"string","format":"hostname"},"upsd_status":{"type":"string","enum":["Online","Dead","NotReady"]}}}},"examples":{"health_200":{"summary":"Server Online","value":"{\n  \"upsd_status\": \"Online\",\n  \"last_modified\": \"2024-10-12T00:11:21.746872446Z\",\n  \"upsd_server\": \"localhost:3493\"\n}\n"},"health_500":{"summary":"Server Dead","value":"{\n  \"upsd_status\": \"Dead\",\n  \"last_modified\": null,\n  \"upsd_server\": \"localhost:3493\"\n}\n"},"health_503":{"summary":"Server NotReady","value":"{\n  \"upsd_status\": \"NotReady\",\n  \"last_modified\": null,\n  \"upsd_server\": \"localhost:3493\"\n}\n"},"ups_response":{"summary":"UPS device","value":"{\n  \"name\": \"apc_back-ups_cs_650\",\n  \"desc\": \"dummy-ups apc_back-ups_cs_650\",\n  \"vars\": {\n    \"battery.charge\": 100,\n    \"battery.charge.low\": 10,\n    \"battery.charge.warning\": \"50\",\n    \"battery.date\": \"2005/09/28\",\n    \"battery.mfr.date\": \"2005/09/28\",\n    \"battery.runtime\": 1312,\n    \"battery.runtime.low\": \"120\",\n    \"battery.temperature\": 29.2,\n    \"battery.type\": \"PbAc\",\n    \"battery.voltage\": 13.6,\n    \"battery.voltage.nominal\": 12,\n    \"device.mfr\": \"American Power Conversion\",\n    \"device.model\": \"Back-UPS CS 650\",\n    \"device.serial\": \"000000000000\",\n    \"device.type\": \"ups\",\n    \"driver.debug\": \"0\",\n    \"driver.flag.allow_killpower\": \"0\",\n    \"driver.name\": \"dummy-ups\",\n    \"driver.parameter.mode\": \"dummy-once\",\n    \"driver.parameter.pollinterval\": 2,\n    \"driver.parameter.port\": \"APC_Back-UPS_CS_650.dev\",\n    \"driver.parameter.synchronous\": \"auto\",\n    \"driver.state\": \"updateinfo\",\n    \"driver.version\": \"2.8.1\",\n    \"driver.version.internal\": \"0.18\",\n    \"input.sensitivity\": \"high\",\n    \"input.transfer.high\": 256,\n    \"input.transfer.low\": 196,\n    \"input.voltage\": 228,\n    \"input.voltage.nominal\": 230,\n    \"output.frequency\": \"50.0\",\n    \"output.voltage\": \"230.0\",\n    \"output.voltage.nominal\": \"230.0\",\n    \"ups.beeper.status\": \"disabled\",\n    \"ups.delay.shutdown\": 20,\n    \"ups.delay.start\": 30,\n    \"ups.firmware\": \"817.v2.I\",\n    \"ups.firmware.aux\": \"v2\",\n    \"ups.load\": 27,\n    \"ups.mfr\": \"American Power Conversion\",\n    \"ups.mfr.date\": \"2005/09/28\",\n    \"ups.model\": \"Back-UPS CS 650\",\n    \"ups.productid\": \"0002\",\n    \"ups.realpower.nominal\": 400,\n    \"ups.serial\": \"000000000000\",\n    \"ups.status\": \"OL\",\n    \"ups.test.result\": \"No test initiated\",\n    \"ups.timer.reboot\": \"0\",\n    \"ups.timer.shutdown\": -1,\n    \"ups.timer.start\": 0,\n    \"ups.vendorid\": \"051d\"\n  },\n  \"cmds\": [\n    \"driver.killpower\",\n    \"driver.reload\",\n    \"driver.reload-or-error\",\n    \"driver.reload-or-exit\",\n    \"load.off\"\n  ]\n}\n"},"empty_ups_list_response":{"summary":"Empty UPS list","value":"[]"},"ups_list_response":{"summary":"Populated UPS list","value":"[{\n  \"name\": \"apc_back-ups_cs_650\",\n  \"desc\": \"dummy-ups apc_back-ups_cs_650\",\n  \"vars\": {\n    \"battery.charge\": 100,\n    \"battery.charge.low\": 10,\n    \"battery.charge.warning\": \"50\",\n    \"battery.date\": \"2005/09/28\",\n    \"battery.mfr.date\": \"2005/09/28\",\n    \"battery.runtime\": 1312,\n    \"battery.runtime.low\": \"120\",\n    \"battery.temperature\": 29.2,\n    \"battery.type\": \"PbAc\",\n    \"battery.voltage\": 13.6,\n    \"battery.voltage.nominal\": 12,\n    \"device.mfr\": \"American Power Conversion\",\n    \"device.model\": \"Back-UPS CS 650\",\n    \"device.serial\": \"000000000000\",\n    \"device.type\": \"ups\",\n    \"driver.debug\": \"0\",\n    \"driver.flag.allow_killpower\": \"0\",\n    \"driver.name\": \"dummy-ups\",\n    \"driver.parameter.mode\": \"dummy-once\",\n    \"driver.parameter.pollinterval\": 2,\n    \"driver.parameter.port\": \"APC_Back-UPS_CS_650.dev\",\n    \"driver.parameter.synchronous\": \"auto\",\n    \"driver.state\": \"updateinfo\",\n    \"driver.version\": \"2.8.1\",\n    \"driver.version.internal\": \"0.18\",\n    \"input.sensitivity\": \"high\",\n    \"input.transfer.high\": 256,\n    \"input.transfer.low\": 196,\n    \"input.voltage\": 228,\n    \"input.voltage.nominal\": 230,\n    \"output.frequency\": \"50.0\",\n    \"output.voltage\": \"230.0\",\n    \"output.voltage.nominal\": \"230.0\",\n    \"ups.beeper.status\": \"disabled\",\n    \"ups.delay.shutdown\": 20,\n    \"ups.delay.start\": 30,\n    \"ups.firmware\": \"817.v2.I\",\n    \"ups.firmware.aux\": \"v2\",\n    \"ups.load\": 27,\n    \"ups.mfr\": \"American Power Conversion\",\n    \"ups.mfr.date\": \"2005/09/28\",\n    \"ups.model\": \"Back-UPS CS 650\",\n    \"ups.productid\": \"0002\",\n    \"ups.realpower.nominal\": 400,\n    \"ups.serial\": \"000000000000\",\n    \"ups.status\": \"OL\",\n    \"ups.test.result\": \"No test initiated\",\n    \"ups.timer.reboot\": \"0\",\n    \"ups.timer.shutdown\": -1,\n    \"ups.timer.start\": 0,\n    \"ups.vendorid\": \"051d\"\n  },\n  \"cmds\": [\n    \"driver.killpower\",\n    \"driver.reload\",\n    \"driver.reload-or-error\",\n    \"driver.reload-or-exit\",\n    \"load.off\"\n  ]\n},\n{\n  \"name\": \"apc_smart-ups_c1500\",\n  \"desc\": \"dummy-ups apc_smart-ups_c1500\",\n  \"vars\": {\n    \"battery.charge\": 100,\n    \"battery.charge.low\": 10,\n    \"battery.charge.warning\": \"50\",\n    \"battery.runtime\": 17820,\n    \"battery.runtime.low\": \"120\",\n    \"battery.type\": \"PbAc\",\n    \"battery.voltage\": 27.3,\n    \"battery.voltage.nominal\": 24,\n    \"device.mfr\": \"American Power Conversion\",\n    \"device.model\": \"Smart-UPS C 1500\",\n    \"device.serial\": \"000000000000\",\n    \"device.type\": \"ups\",\n    \"driver.debug\": \"0\",\n    \"driver.flag.allow_killpower\": \"0\",\n    \"driver.name\": \"dummy-ups\",\n    \"driver.parameter.mode\": \"dummy-once\",\n    \"driver.parameter.pollinterval\": 2,\n    \"driver.parameter.port\": \"APC_Smart-UPS_C1500.dev\",\n    \"driver.parameter.synchronous\": \"auto\",\n    \"driver.state\": \"quiet\",\n    \"driver.version\": \"2.8.1\",\n    \"driver.version.internal\": \"0.18\",\n    \"ups.beeper.status\": \"disabled\",\n    \"ups.delay.shutdown\": 20,\n    \"ups.firmware\": \"UPS 10.0 / ID = 1005\",\n    \"ups.mfr\": \"American Power Conversion\",\n    \"ups.mfr.date\": \"2016/08/17\",\n    \"ups.model\": \"Smart-UPS C 1500\",\n    \"ups.productid\": \"0003\",\n    \"ups.serial\": \"000000000000\",\n    \"ups.status\": \"OL\",\n    \"ups.timer.reboot\": \"-1\",\n    \"ups.timer.shutdown\": -1,\n    \"ups.vendorid\": \"051d\"\n  },\n  \"cmds\": [\n    \"driver.killpower\",\n    \"driver.reload\",\n    \"driver.reload-or-error\",\n    \"driver.reload-or-exit\",\n    \"load.off\"\n  ]}\n]\n"}}},"tags":[{"name":"ups","description":"UPS endpoints"},{"name":"probes","description":"Server health check endpoints"}]}



================================================
FILE: docs/openapi3_spec.yaml
================================================
openapi: "3.1.0"

info:
  title: "nut_webgui JSON API"
  version: "0.4.0"
  summary: "Simple JSON API for interfacing with nut_webgui."
  license:
    name: "Apache 2.0"
    url: "https://raw.githubusercontent.com/SuperioOne/nut_webgui/refs/heads/master/LICENSE"
  contact:
    url: "https://github.com/SuperioOne/nut_webgui/issues"
    email: "pm@smdd.dev"

servers:
- url: "{protocol}://{host}:{port}"
  description: "nut_webgui server"
  variables:
    host:
      default: localhost
    port:
      default: '9000'
    protocol:
      default: 'http'
      enum:
        - http
        - https
paths:
  /api/ups:
    description: "Returns collection of all available UPS devices."
    get:
      tags:
        - ups
      operationId: "api_ups_collection_get"
      responses:
        "200":
          description: "Collection of UPS devices."
          content:
            application/json:
              examples:
                ups_list:
                  $ref: "#/components/examples/ups_list_response"
                empty_list:
                  $ref: "#/components/examples/empty_ups_list_response"
              schema:
                $ref: "#/components/schemas/UpsList"
        "500":
          description: "Server or daemon errors."
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ProblemDetails"
        "503":
          description: "Server is not ready to serve."
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ProblemDetails"

  /api/ups/{ups_name}:
    description: "Returns a UPS devices."
    get:
      parameters:
        - name: ups_name
          in: path
          description: "UPS name"
          required: true
          allowEmptyValue: false
          schema:
            type: string
      tags:
        - ups
      operationId: "api_ups_get"
      responses:
        "200":
          description: "UPS device response."
          content:
            application/json:
              examples:
                ups:
                  $ref: "#/components/examples/ups_response"
              schema:
                $ref: "#/components/schemas/Ups"
        "404":
          description: "Ups does not exists."
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ProblemDetails"
        "500":
          description: "Server or daemon errors."
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ProblemDetails"
        "503":
          description: "Server is not ready to serve."
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ProblemDetails"

  /api/ups/{ups_name}/command:
    description: "Instantiate a UPS command."
    post:
      requestBody:
        description: "Command request body."
        required: true
        content:
          application/json:
            schema:
                $ref: "#/components/schemas/CommandRequest"
      parameters:
        - name: ups_name
          in: path
          description: "UPS name"
          required: true
          allowEmptyValue: false
          schema:
            type: string
      tags:
        - ups
      operationId: "api_ups_instcmd"
      responses:
        "202":
          description: "Command is accepted."
        "401":
          description: "Upsd user and password configs are not set."
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ProblemDetails"
        "404":
          description: "Ups does not exists."
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ProblemDetails"
        "500":
          description: "Server or daemon errors."
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ProblemDetails"
        "503":
          description: "Server is not ready to serve."
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ProblemDetails"
  /probes/health:
    description: "Server health check"
    get:
      tags:
        - probes
      operationId: "probes_health"
      responses:
        "200":
          description: "Command is accepted"
          content:
            application/json:
              examples:
                default:
                  $ref: "#/components/examples/health_200"
              schema:
                $ref: "#/components/schemas/HealthResponse"
        "500":
          description: "Upsd daemon failure"
          content:
            application/json:
              examples:
                default:
                  $ref: "#/components/examples/health_500"
              schema:
                $ref: "#/components/schemas/HealthResponse"
        "503":
          description: "Server is not ready to serve"
          content:
            application/json:
              examples:
                default:
                  $ref: "#/components/examples/health_503"
              schema:
                $ref: "#/components/schemas/HealthResponse"
  /probes/readiness:
    description: "Server readiness probe mainly intented for Kubernetes."
    get:
      tags:
        - probes
      operationId: "probes_readiness"
      responses:
        "200":
          description: "Server is ready to response."
          content:
            text/plain:
              schema:
                enum:
                  - "READY"
        "503":
          description: "Server is not ready to response."
          content:
            text/plain:
              schema:
                enum:
                  - "NOT READY"
components:
  schemas:
    Ups:
      type: object
      required:
        - name
        - desc
        - vars
        - cmds
      properties:
        name:
          type: string
        desc:
          type: string
        vars:
          type: object
          additionalProperties:
            oneOf:
              - type: "number"
              - type: "string"
        cmds:
          type: "array"
          items:
            type: "string"
    UpsList:
      type: array
      items:
        "$ref": "#/components/schemas/Ups"
    ProblemDetails:
      type: object
      required:
        - title
        - status
      properties:
        title:
          type: string
        details:
          type: string
        status:
          type: number
          minimum: 100
          exclusiveMaximum: 1000
        instance:
          type: string
          format: uri
    CommandRequest:
      type: object
      required: 
        - cmd
      properties:
        cmd:
         type: string
    HealthResponse:
      type: object
      required:
        - upsd_status
        - upsd_server
      properties:
        last_updated:
          type: string
          format: date-time
        upsd_server:
          type: string
          format: hostname
        upsd_status:
          type: string
          enum:
            - "Online"
            - "Dead"
            - "NotReady"
  examples:
    health_200:
      summary: "Server Online"
      value: |
        {
          "upsd_status": "Online",
          "last_modified": "2024-10-12T00:11:21.746872446Z",
          "upsd_server": "localhost:3493"
        }
    health_500:
      summary: "Server Dead"
      value: |
        {
          "upsd_status": "Dead",
          "last_modified": null,
          "upsd_server": "localhost:3493"
        }
    health_503:
      summary: "Server NotReady"
      value: |
        {
          "upsd_status": "NotReady",
          "last_modified": null,
          "upsd_server": "localhost:3493"
        }
    ups_response:
      summary: "UPS device"
      value: |
        {
          "name": "apc_back-ups_cs_650",
          "desc": "dummy-ups apc_back-ups_cs_650",
          "vars": {
            "battery.charge": 100,
            "battery.charge.low": 10,
            "battery.charge.warning": "50",
            "battery.date": "2005/09/28",
            "battery.mfr.date": "2005/09/28",
            "battery.runtime": 1312,
            "battery.runtime.low": "120",
            "battery.temperature": 29.2,
            "battery.type": "PbAc",
            "battery.voltage": 13.6,
            "battery.voltage.nominal": 12,
            "device.mfr": "American Power Conversion",
            "device.model": "Back-UPS CS 650",
            "device.serial": "000000000000",
            "device.type": "ups",
            "driver.debug": "0",
            "driver.flag.allow_killpower": "0",
            "driver.name": "dummy-ups",
            "driver.parameter.mode": "dummy-once",
            "driver.parameter.pollinterval": 2,
            "driver.parameter.port": "APC_Back-UPS_CS_650.dev",
            "driver.parameter.synchronous": "auto",
            "driver.state": "updateinfo",
            "driver.version": "2.8.1",
            "driver.version.internal": "0.18",
            "input.sensitivity": "high",
            "input.transfer.high": 256,
            "input.transfer.low": 196,
            "input.voltage": 228,
            "input.voltage.nominal": 230,
            "output.frequency": "50.0",
            "output.voltage": "230.0",
            "output.voltage.nominal": "230.0",
            "ups.beeper.status": "disabled",
            "ups.delay.shutdown": 20,
            "ups.delay.start": 30,
            "ups.firmware": "817.v2.I",
            "ups.firmware.aux": "v2",
            "ups.load": 27,
            "ups.mfr": "American Power Conversion",
            "ups.mfr.date": "2005/09/28",
            "ups.model": "Back-UPS CS 650",
            "ups.productid": "0002",
            "ups.realpower.nominal": 400,
            "ups.serial": "000000000000",
            "ups.status": "OL",
            "ups.test.result": "No test initiated",
            "ups.timer.reboot": "0",
            "ups.timer.shutdown": -1,
            "ups.timer.start": 0,
            "ups.vendorid": "051d"
          },
          "cmds": [
            "driver.killpower",
            "driver.reload",
            "driver.reload-or-error",
            "driver.reload-or-exit",
            "load.off"
          ]
        }
    empty_ups_list_response:
      summary: "Empty UPS list"
      value: "[]"
    ups_list_response:
      summary: "Populated UPS list"
      value: |
        [{
          "name": "apc_back-ups_cs_650",
          "desc": "dummy-ups apc_back-ups_cs_650",
          "vars": {
            "battery.charge": 100,
            "battery.charge.low": 10,
            "battery.charge.warning": "50",
            "battery.date": "2005/09/28",
            "battery.mfr.date": "2005/09/28",
            "battery.runtime": 1312,
            "battery.runtime.low": "120",
            "battery.temperature": 29.2,
            "battery.type": "PbAc",
            "battery.voltage": 13.6,
            "battery.voltage.nominal": 12,
            "device.mfr": "American Power Conversion",
            "device.model": "Back-UPS CS 650",
            "device.serial": "000000000000",
            "device.type": "ups",
            "driver.debug": "0",
            "driver.flag.allow_killpower": "0",
            "driver.name": "dummy-ups",
            "driver.parameter.mode": "dummy-once",
            "driver.parameter.pollinterval": 2,
            "driver.parameter.port": "APC_Back-UPS_CS_650.dev",
            "driver.parameter.synchronous": "auto",
            "driver.state": "updateinfo",
            "driver.version": "2.8.1",
            "driver.version.internal": "0.18",
            "input.sensitivity": "high",
            "input.transfer.high": 256,
            "input.transfer.low": 196,
            "input.voltage": 228,
            "input.voltage.nominal": 230,
            "output.frequency": "50.0",
            "output.voltage": "230.0",
            "output.voltage.nominal": "230.0",
            "ups.beeper.status": "disabled",
            "ups.delay.shutdown": 20,
            "ups.delay.start": 30,
            "ups.firmware": "817.v2.I",
            "ups.firmware.aux": "v2",
            "ups.load": 27,
            "ups.mfr": "American Power Conversion",
            "ups.mfr.date": "2005/09/28",
            "ups.model": "Back-UPS CS 650",
            "ups.productid": "0002",
            "ups.realpower.nominal": 400,
            "ups.serial": "000000000000",
            "ups.status": "OL",
            "ups.test.result": "No test initiated",
            "ups.timer.reboot": "0",
            "ups.timer.shutdown": -1,
            "ups.timer.start": 0,
            "ups.vendorid": "051d"
          },
          "cmds": [
            "driver.killpower",
            "driver.reload",
            "driver.reload-or-error",
            "driver.reload-or-exit",
            "load.off"
          ]
        },
        {
          "name": "apc_smart-ups_c1500",
          "desc": "dummy-ups apc_smart-ups_c1500",
          "vars": {
            "battery.charge": 100,
            "battery.charge.low": 10,
            "battery.charge.warning": "50",
            "battery.runtime": 17820,
            "battery.runtime.low": "120",
            "battery.type": "PbAc",
            "battery.voltage": 27.3,
            "battery.voltage.nominal": 24,
            "device.mfr": "American Power Conversion",
            "device.model": "Smart-UPS C 1500",
            "device.serial": "000000000000",
            "device.type": "ups",
            "driver.debug": "0",
            "driver.flag.allow_killpower": "0",
            "driver.name": "dummy-ups",
            "driver.parameter.mode": "dummy-once",
            "driver.parameter.pollinterval": 2,
            "driver.parameter.port": "APC_Smart-UPS_C1500.dev",
            "driver.parameter.synchronous": "auto",
            "driver.state": "quiet",
            "driver.version": "2.8.1",
            "driver.version.internal": "0.18",
            "ups.beeper.status": "disabled",
            "ups.delay.shutdown": 20,
            "ups.firmware": "UPS 10.0 / ID = 1005",
            "ups.mfr": "American Power Conversion",
            "ups.mfr.date": "2016/08/17",
            "ups.model": "Smart-UPS C 1500",
            "ups.productid": "0003",
            "ups.serial": "000000000000",
            "ups.status": "OL",
            "ups.timer.reboot": "-1",
            "ups.timer.shutdown": -1,
            "ups.vendorid": "051d"
          },
          "cmds": [
            "driver.killpower",
            "driver.reload",
            "driver.reload-or-error",
            "driver.reload-or-exit",
            "load.off"
          ]}
        ]
tags:
  - name: ups
    description: "UPS endpoints"
  - name: probes
    description: "Server health check endpoints"



================================================
FILE: docs/images/details.webp
================================================
[Non-text file]


================================================
FILE: docs/images/home.webp
================================================
[Non-text file]



================================================
FILE: server/askama.toml
================================================
[general]
dirs = ["./src/http_server/hypermedia/templates"]


================================================
FILE: server/Cargo.lock
================================================
# This file is automatically @generated by Cargo.
# It is not intended for manual editing.
version = 4

[[package]]
name = "addr2line"
version = "0.24.2"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "dfbe277e56a376000877090da837660b4427aad530e3028d44e0bffe4f89a1c1"
dependencies = [
 "gimli",
]

[[package]]
name = "adler2"
version = "2.0.0"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "512761e0bb2578dd7380c6baaa0f4ce03e84f95e960231d1dec8bf4d7d6e2627"

[[package]]
name = "algorithms_random"
version = "0.1.0"
source = "git+https://github.com/SuperioOne/algorithms.git#301c7e9c7382e177c4b17164e4a7497d0f714889"

[[package]]
name = "alloc-no-stdlib"
version = "2.0.4"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "cc7bb162ec39d46ab1ca8c77bf72e890535becd1751bb45f64c597edb4c8c6b3"

[[package]]
name = "alloc-stdlib"
version = "0.2.2"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "94fb8275041c72129eb51b7d0322c29b8387a0386127718b096429201a5d6ece"
dependencies = [
 "alloc-no-stdlib",
]

[[package]]
name = "android_system_properties"
version = "0.1.5"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "819e7219dbd41043ac279b19830f2efc897156490d7fd6ea916720117ee66311"
dependencies = [
 "libc",
]

[[package]]
name = "anstream"
version = "0.6.18"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "8acc5369981196006228e28809f761875c0327210a891e941f4c683b3a99529b"
dependencies = [
 "anstyle",
 "anstyle-parse",
 "anstyle-query",
 "anstyle-wincon",
 "colorchoice",
 "is_terminal_polyfill",
 "utf8parse",
]

[[package]]
name = "anstyle"
version = "1.0.10"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "55cc3b69f167a1ef2e161439aa98aed94e6028e5f9a59be9a6ffb47aef1651f9"

[[package]]
name = "anstyle-parse"
version = "0.2.6"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "3b2d16507662817a6a20a9ea92df6652ee4f94f914589377d69f3b21bc5798a9"
dependencies = [
 "utf8parse",
]

[[package]]
name = "anstyle-query"
version = "1.1.2"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "79947af37f4177cfead1110013d678905c37501914fba0efea834c3fe9a8d60c"
dependencies = [
 "windows-sys 0.59.0",
]

[[package]]
name = "anstyle-wincon"
version = "3.0.7"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "ca3534e77181a9cc07539ad51f2141fe32f6c3ffd4df76db8ad92346b003ae4e"
dependencies = [
 "anstyle",
 "once_cell",
 "windows-sys 0.59.0",
]

[[package]]
name = "askama"
version = "0.12.1"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "b79091df18a97caea757e28cd2d5fda49c6cd4bd01ddffd7ff01ace0c0ad2c28"
dependencies = [
 "askama_derive",
 "askama_escape",
 "humansize",
 "num-traits",
 "percent-encoding",
]

[[package]]
name = "askama_axum"
version = "0.4.0"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "a41603f7cdbf5ac4af60760f17253eb6adf6ec5b6f14a7ed830cf687d375f163"
dependencies = [
 "askama",
 "axum-core",
 "http",
]

[[package]]
name = "askama_derive"
version = "0.12.5"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "19fe8d6cb13c4714962c072ea496f3392015f0989b1a2847bb4b2d9effd71d83"
dependencies = [
 "askama_parser",
 "basic-toml",
 "mime",
 "mime_guess",
 "proc-macro2",
 "quote",
 "serde",
 "syn",
]

[[package]]
name = "askama_escape"
version = "0.10.3"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "619743e34b5ba4e9703bba34deac3427c72507c7159f5fd030aea8cac0cfe341"

[[package]]
name = "askama_parser"
version = "0.2.1"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "acb1161c6b64d1c3d83108213c2a2533a342ac225aabd0bda218278c2ddb00c0"
dependencies = [
 "nom",
]

[[package]]
name = "async-compression"
version = "0.4.22"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "59a194f9d963d8099596278594b3107448656ba73831c9d8c783e613ce86da64"
dependencies = [
 "brotli",
 "flate2",
 "futures-core",
 "memchr",
 "pin-project-lite",
 "tokio",
]

[[package]]
name = "async-trait"
version = "0.1.88"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "e539d3fca749fcee5236ab05e93a52867dd549cc157c8cb7f99595f3cedffdb5"
dependencies = [
 "proc-macro2",
 "quote",
 "syn",
]

[[package]]
name = "autocfg"
version = "1.4.0"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "ace50bade8e6234aa140d9a2f552bbee1db4d353f69b8217bc503490fc1a9f26"

[[package]]
name = "axum"
version = "0.7.9"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "edca88bc138befd0323b20752846e6587272d3b03b0343c8ea28a6f819e6e71f"
dependencies = [
 "async-trait",
 "axum-core",
 "bytes",
 "futures-util",
 "http",
 "http-body",
 "http-body-util",
 "hyper",
 "hyper-util",
 "itoa",
 "matchit",
 "memchr",
 "mime",
 "percent-encoding",
 "pin-project-lite",
 "rustversion",
 "serde",
 "serde_json",
 "serde_path_to_error",
 "serde_urlencoded",
 "sync_wrapper",
 "tokio",
 "tower 0.5.2",
 "tower-layer",
 "tower-service",
 "tracing",
]

[[package]]
name = "axum-core"
version = "0.4.5"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "09f2bd6146b97ae3359fa0cc6d6b376d9539582c7b4220f041a33ec24c226199"
dependencies = [
 "async-trait",
 "bytes",
 "futures-util",
 "http",
 "http-body",
 "http-body-util",
 "mime",
 "pin-project-lite",
 "rustversion",
 "sync_wrapper",
 "tower-layer",
 "tower-service",
 "tracing",
]

[[package]]
name = "backtrace"
version = "0.3.74"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "8d82cb332cdfaed17ae235a638438ac4d4839913cc2af585c3c6746e8f8bee1a"
dependencies = [
 "addr2line",
 "cfg-if",
 "libc",
 "miniz_oxide",
 "object",
 "rustc-demangle",
 "windows-targets",
]

[[package]]
name = "basic-toml"
version = "0.1.10"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "ba62675e8242a4c4e806d12f11d136e626e6c8361d6b829310732241652a178a"
dependencies = [
 "serde",
]

[[package]]
name = "bitflags"
version = "2.9.0"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "5c8214115b7bf84099f1309324e63141d4c5d7cc26862f97a0a857dbefe165bd"

[[package]]
name = "brotli"
version = "7.0.0"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "cc97b8f16f944bba54f0433f07e30be199b6dc2bd25937444bbad560bcea29bd"
dependencies = [
 "alloc-no-stdlib",
 "alloc-stdlib",
 "brotli-decompressor",
]

[[package]]
name = "brotli-decompressor"
version = "4.0.2"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "74fa05ad7d803d413eb8380983b092cbbaf9a85f151b871360e7b00cd7060b37"
dependencies = [
 "alloc-no-stdlib",
 "alloc-stdlib",
]

[[package]]
name = "bumpalo"
version = "3.17.0"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "1628fb46dfa0b37568d12e5edd512553eccf6a22a78e8bde00bb4aed84d5bdbf"

[[package]]
name = "bytes"
version = "1.10.1"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "d71b6127be86fdcfddb610f7182ac57211d4b18a3e9c82eb2d17662f2227ad6a"

[[package]]
name = "cc"
version = "1.2.19"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "8e3a13707ac958681c13b39b458c073d0d9bc8a22cb1b2f4c8e55eb72c13f362"
dependencies = [
 "shlex",
]

[[package]]
name = "cfg-if"
version = "1.0.0"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "baf1de4339761588bc0619e3cbc0120ee582ebb74b53b4efbf79117bd2da40fd"

[[package]]
name = "chrono"
version = "0.4.40"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "1a7964611d71df112cb1730f2ee67324fcf4d0fc6606acbbe9bfe06df124637c"
dependencies = [
 "iana-time-zone",
 "num-traits",
 "serde",
]

[[package]]
name = "clap"
version = "4.5.36"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "2df961d8c8a0d08aa9945718ccf584145eee3f3aa06cddbeac12933781102e04"
dependencies = [
 "clap_builder",
 "clap_derive",
]

[[package]]
name = "clap_builder"
version = "4.5.36"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "132dbda40fb6753878316a489d5a1242a8ef2f0d9e47ba01c951ea8aa7d013a5"
dependencies = [
 "anstream",
 "anstyle",
 "clap_lex",
 "strsim",
]

[[package]]
name = "clap_derive"
version = "4.5.32"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "09176aae279615badda0765c0c0b3f6ed53f4709118af73cf4655d85d1530cd7"
dependencies = [
 "heck",
 "proc-macro2",
 "quote",
 "syn",
]

[[package]]
name = "clap_lex"
version = "0.7.4"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "f46ad14479a25103f283c0f10005961cf086d8dc42205bb44c46ac563475dca6"

[[package]]
name = "colorchoice"
version = "1.0.3"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "5b63caa9aa9397e2d9480a9b13673856c78d8ac123288526c37d7839f2a86990"

[[package]]
name = "core-foundation-sys"
version = "0.8.7"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "773648b94d0e5d620f64f280777445740e61fe701025087ec8b57f45c791888b"

[[package]]
name = "crc32fast"
version = "1.4.2"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "a97769d94ddab943e4510d138150169a2758b5ef3eb191a9ee688de3e23ef7b3"
dependencies = [
 "cfg-if",
]

[[package]]
name = "flate2"
version = "1.1.1"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "7ced92e76e966ca2fd84c8f7aa01a4aea65b0eb6648d72f7c8f3e2764a67fece"
dependencies = [
 "crc32fast",
 "miniz_oxide",
]

[[package]]
name = "fnv"
version = "1.0.7"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "3f9eec918d3f24069decb9af1554cad7c880e2da24a9afd88aca000531ab82c1"

[[package]]
name = "form_urlencoded"
version = "1.2.1"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "e13624c2627564efccf4934284bdd98cbaa14e79b0b5a141218e507b3a823456"
dependencies = [
 "percent-encoding",
]

[[package]]
name = "futures-channel"
version = "0.3.31"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "2dff15bf788c671c1934e366d07e30c1814a8ef514e1af724a602e8a2fbe1b10"
dependencies = [
 "futures-core",
]

[[package]]
name = "futures-core"
version = "0.3.31"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "05f29059c0c2090612e8d742178b0580d2dc940c837851ad723096f87af6663e"

[[package]]
name = "futures-sink"
version = "0.3.31"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "e575fab7d1e0dcb8d0c7bcf9a63ee213816ab51902e6d244a95819acacf1d4f7"

[[package]]
name = "futures-task"
version = "0.3.31"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "f90f7dce0722e95104fcb095585910c0977252f286e354b5e3bd38902cd99988"

[[package]]
name = "futures-util"
version = "0.3.31"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "9fa08315bb612088cc391249efdc3bc77536f16c91f6cf495e6fbe85b20a4a81"
dependencies = [
 "futures-core",
 "futures-task",
 "pin-project-lite",
 "pin-utils",
]

[[package]]
name = "gimli"
version = "0.31.1"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "07e28edb80900c19c28f1072f2e8aeca7fa06b23cd4169cefe1af5aa3260783f"

[[package]]
name = "heck"
version = "0.5.0"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "2304e00983f87ffb38b55b444b5e3b60a884b5d30c0fca7d82fe33449bbe55ea"

[[package]]
name = "http"
version = "1.3.1"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "f4a85d31aea989eead29a3aaf9e1115a180df8282431156e533de47660892565"
dependencies = [
 "bytes",
 "fnv",
 "itoa",
]

[[package]]
name = "http-body"
version = "1.0.1"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "1efedce1fb8e6913f23e0c92de8e62cd5b772a67e7b3946df930a62566c93184"
dependencies = [
 "bytes",
 "http",
]

[[package]]
name = "http-body-util"
version = "0.1.3"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "b021d93e26becf5dc7e1b75b1bed1fd93124b374ceb73f43d4d4eafec896a64a"
dependencies = [
 "bytes",
 "futures-core",
 "http",
 "http-body",
 "pin-project-lite",
]

[[package]]
name = "http-range-header"
version = "0.4.2"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "9171a2ea8a68358193d15dd5d70c1c10a2afc3e7e4c5bc92bc9f025cebd7359c"

[[package]]
name = "httparse"
version = "1.10.1"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "6dbf3de79e51f3d586ab4cb9d5c3e2c14aa28ed23d180cf89b4df0454a69cc87"

[[package]]
name = "httpdate"
version = "1.0.3"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "df3b46402a9d5adb4c86a0cf463f42e19994e3ee891101b1841f30a545cb49a9"

[[package]]
name = "humansize"
version = "2.1.3"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "6cb51c9a029ddc91b07a787f1d86b53ccfa49b0e86688c946ebe8d3555685dd7"
dependencies = [
 "libm",
]

[[package]]
name = "hyper"
version = "1.6.0"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "cc2b571658e38e0c01b1fdca3bbbe93c00d3d71693ff2770043f8c29bc7d6f80"
dependencies = [
 "bytes",
 "futures-channel",
 "futures-util",
 "http",
 "http-body",
 "httparse",
 "httpdate",
 "itoa",
 "pin-project-lite",
 "smallvec",
 "tokio",
]

[[package]]
name = "hyper-util"
version = "0.1.11"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "497bbc33a26fdd4af9ed9c70d63f61cf56a938375fbb32df34db9b1cd6d643f2"
dependencies = [
 "bytes",
 "futures-util",
 "http",
 "http-body",
 "hyper",
 "pin-project-lite",
 "tokio",
 "tower-service",
]

[[package]]
name = "iana-time-zone"
version = "0.1.63"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "b0c919e5debc312ad217002b8048a17b7d83f80703865bbfcfebb0458b0b27d8"
dependencies = [
 "android_system_properties",
 "core-foundation-sys",
 "iana-time-zone-haiku",
 "js-sys",
 "log",
 "wasm-bindgen",
 "windows-core",
]

[[package]]
name = "iana-time-zone-haiku"
version = "0.1.2"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "f31827a206f56af32e590ba56d5d2d085f558508192593743f16b2306495269f"
dependencies = [
 "cc",
]

[[package]]
name = "is_terminal_polyfill"
version = "1.70.1"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "7943c866cc5cd64cbc25b2e01621d07fa8eb2a1a23160ee81ce38704e97b8ecf"

[[package]]
name = "itoa"
version = "1.0.15"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "4a5f13b858c8d314ee3e8f639011f7ccefe71f97f96e50151fb991f267928e2c"

[[package]]
name = "js-sys"
version = "0.3.77"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "1cfaf33c695fc6e08064efbc1f72ec937429614f25eef83af942d0e227c3a28f"
dependencies = [
 "once_cell",
 "wasm-bindgen",
]

[[package]]
name = "lazy_static"
version = "1.5.0"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "bbd2bcb4c963f2ddae06a2efc7e9f3591312473c50c6685e1f298068316e66fe"

[[package]]
name = "libc"
version = "0.2.171"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "c19937216e9d3aa9956d9bb8dfc0b0c8beb6058fc4f7a4dc4d850edf86a237d6"

[[package]]
name = "libm"
version = "0.2.11"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "8355be11b20d696c8f18f6cc018c4e372165b1fa8126cef092399c9951984ffa"

[[package]]
name = "log"
version = "0.4.27"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "13dc2df351e3202783a1fe0d44375f7295ffb4049267b0f3018346dc122a1d94"

[[package]]
name = "matchit"
version = "0.7.3"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "0e7465ac9959cc2b1404e8e2367b43684a6d13790fe23056cc8c6c5a6b7bcb94"

[[package]]
name = "memchr"
version = "2.7.4"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "78ca9ab1a0babb1e7d5695e3530886289c18cf2f87ec19a575a0abdce112e3a3"

[[package]]
name = "mime"
version = "0.3.17"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "6877bb514081ee2a7ff5ef9de3281f14a4dd4bceac4c09388074a6b5df8a139a"

[[package]]
name = "mime_guess"
version = "2.0.5"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "f7c44f8e672c00fe5308fa235f821cb4198414e1c77935c1ab6948d3fd78550e"
dependencies = [
 "mime",
 "unicase",
]

[[package]]
name = "minimal-lexical"
version = "0.2.1"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "68354c5c6bd36d73ff3feceb05efa59b6acb7626617f4962be322a825e61f79a"

[[package]]
name = "miniz_oxide"
version = "0.8.8"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "3be647b768db090acb35d5ec5db2b0e1f1de11133ca123b9eacf5137868f892a"
dependencies = [
 "adler2",
]

[[package]]
name = "mio"
version = "1.0.3"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "2886843bf800fba2e3377cff24abf6379b4c4d5c6681eaf9ea5b0d15090450bd"
dependencies = [
 "libc",
 "wasi",
 "windows-sys 0.52.0",
]

[[package]]
name = "nom"
version = "7.1.3"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "d273983c5a657a70a3e8f2a01329822f3b8c8172b73826411a55751e404a0a4a"
dependencies = [
 "memchr",
 "minimal-lexical",
]

[[package]]
name = "nu-ansi-term"
version = "0.46.0"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "77a8165726e8236064dbb45459242600304b42a5ea24ee2948e18e023bf7ba84"
dependencies = [
 "overload",
 "winapi",
]

[[package]]
name = "num-traits"
version = "0.2.19"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "071dfc062690e90b734c0b2273ce72ad0ffa95f0c74596bc250dcfd960262841"
dependencies = [
 "autocfg",
]

[[package]]
name = "nut_webgui"
version = "0.4.2"
dependencies = [
 "algorithms_random",
 "askama",
 "askama_axum",
 "axum",
 "axum-core",
 "chrono",
 "clap",
 "serde",
 "tokio",
 "tokio-util",
 "tower 0.4.13",
 "tower-http",
 "tracing",
 "tracing-subscriber",
]

[[package]]
name = "object"
version = "0.36.7"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "62948e14d923ea95ea2c7c86c71013138b66525b86bdc08d2dcc262bdb497b87"
dependencies = [
 "memchr",
]

[[package]]
name = "once_cell"
version = "1.21.3"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "42f5e15c9953c5e4ccceeb2e7382a716482c34515315f7b03532b8b4e8393d2d"

[[package]]
name = "overload"
version = "0.1.1"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "b15813163c1d831bf4a13c3610c05c0d03b39feb07f7e09fa234dac9b15aaf39"

[[package]]
name = "percent-encoding"
version = "2.3.1"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "e3148f5046208a5d56bcfc03053e3ca6334e51da8dfb19b6cdc8b306fae3283e"

[[package]]
name = "pin-project-lite"
version = "0.2.16"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "3b3cff922bd51709b605d9ead9aa71031d81447142d828eb4a6eba76fe619f9b"

[[package]]
name = "pin-utils"
version = "0.1.0"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "8b870d8c151b6f2fb93e84a13146138f05d02ed11c7e7c54f8826aaaf7c9f184"

[[package]]
name = "proc-macro2"
version = "1.0.94"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "a31971752e70b8b2686d7e46ec17fb38dad4051d94024c88df49b667caea9c84"
dependencies = [
 "unicode-ident",
]

[[package]]
name = "quote"
version = "1.0.40"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "1885c039570dc00dcb4ff087a89e185fd56bae234ddc7f056a945bf36467248d"
dependencies = [
 "proc-macro2",
]

[[package]]
name = "rustc-demangle"
version = "0.1.24"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "719b953e2095829ee67db738b3bfa9fa368c94900df327b3f07fe6e794d2fe1f"

[[package]]
name = "rustversion"
version = "1.0.20"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "eded382c5f5f786b989652c49544c4877d9f015cc22e145a5ea8ea66c2921cd2"

[[package]]
name = "ryu"
version = "1.0.20"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "28d3b2b1366ec20994f1fd18c3c594f05c5dd4bc44d8bb0c1c632c8d6829481f"

[[package]]
name = "serde"
version = "1.0.219"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "5f0e2c6ed6606019b4e29e69dbaba95b11854410e5347d525002456dbbb786b6"
dependencies = [
 "serde_derive",
]

[[package]]
name = "serde_derive"
version = "1.0.219"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "5b0276cf7f2c73365f7157c8123c21cd9a50fbbd844757af28ca1f5925fc2a00"
dependencies = [
 "proc-macro2",
 "quote",
 "syn",
]

[[package]]
name = "serde_json"
version = "1.0.140"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "20068b6e96dc6c9bd23e01df8827e6c7e1f2fddd43c21810382803c136b99373"
dependencies = [
 "itoa",
 "memchr",
 "ryu",
 "serde",
]

[[package]]
name = "serde_path_to_error"
version = "0.1.17"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "59fab13f937fa393d08645bf3a84bdfe86e296747b506ada67bb15f10f218b2a"
dependencies = [
 "itoa",
 "serde",
]

[[package]]
name = "serde_urlencoded"
version = "0.7.1"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "d3491c14715ca2294c4d6a88f15e84739788c1d030eed8c110436aafdaa2f3fd"
dependencies = [
 "form_urlencoded",
 "itoa",
 "ryu",
 "serde",
]

[[package]]
name = "sharded-slab"
version = "0.1.7"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "f40ca3c46823713e0d4209592e8d6e826aa57e928f09752619fc696c499637f6"
dependencies = [
 "lazy_static",
]

[[package]]
name = "shlex"
version = "1.3.0"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "0fda2ff0d084019ba4d7c6f371c95d8fd75ce3524c3cb8fb653a3023f6323e64"

[[package]]
name = "signal-hook-registry"
version = "1.4.2"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "a9e9e0b4211b72e7b8b6e85c807d36c212bdb33ea8587f7569562a84df5465b1"
dependencies = [
 "libc",
]

[[package]]
name = "smallvec"
version = "1.15.0"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "8917285742e9f3e1683f0a9c4e6b57960b7314d0b08d30d1ecd426713ee2eee9"

[[package]]
name = "socket2"
version = "0.5.9"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "4f5fd57c80058a56cf5c777ab8a126398ece8e442983605d280a44ce79d0edef"
dependencies = [
 "libc",
 "windows-sys 0.52.0",
]

[[package]]
name = "strsim"
version = "0.11.1"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "7da8b5736845d9f2fcb837ea5d9e2628564b3b043a70948a3f0b778838c5fb4f"

[[package]]
name = "syn"
version = "2.0.100"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "b09a44accad81e1ba1cd74a32461ba89dee89095ba17b32f5d03683b1b1fc2a0"
dependencies = [
 "proc-macro2",
 "quote",
 "unicode-ident",
]

[[package]]
name = "sync_wrapper"
version = "1.0.2"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "0bf256ce5efdfa370213c1dabab5935a12e49f2c58d15e9eac2870d3b4f27263"

[[package]]
name = "thread_local"
version = "1.1.8"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "8b9ef9bad013ada3808854ceac7b46812a6465ba368859a37e2100283d2d719c"
dependencies = [
 "cfg-if",
 "once_cell",
]

[[package]]
name = "tokio"
version = "1.44.2"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "e6b88822cbe49de4185e3a4cbf8321dd487cf5fe0c5c65695fef6346371e9c48"
dependencies = [
 "backtrace",
 "bytes",
 "libc",
 "mio",
 "pin-project-lite",
 "signal-hook-registry",
 "socket2",
 "tokio-macros",
 "windows-sys 0.52.0",
]

[[package]]
name = "tokio-macros"
version = "2.5.0"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "6e06d43f1345a3bcd39f6a56dbb7dcab2ba47e68e8ac134855e7e2bdbaf8cab8"
dependencies = [
 "proc-macro2",
 "quote",
 "syn",
]

[[package]]
name = "tokio-util"
version = "0.7.14"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "6b9590b93e6fcc1739458317cccd391ad3955e2bde8913edf6f95f9e65a8f034"
dependencies = [
 "bytes",
 "futures-core",
 "futures-sink",
 "pin-project-lite",
 "tokio",
]

[[package]]
name = "tower"
version = "0.4.13"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "b8fa9be0de6cf49e536ce1851f987bd21a43b771b09473c3549a6c853db37c1c"
dependencies = [
 "tower-layer",
 "tower-service",
 "tracing",
]

[[package]]
name = "tower"
version = "0.5.2"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "d039ad9159c98b70ecfd540b2573b97f7f52c3e8d9f8ad57a24b916a536975f9"
dependencies = [
 "futures-core",
 "futures-util",
 "pin-project-lite",
 "sync_wrapper",
 "tokio",
 "tower-layer",
 "tower-service",
 "tracing",
]

[[package]]
name = "tower-http"
version = "0.5.2"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "1e9cd434a998747dd2c4276bc96ee2e0c7a2eadf3cae88e52be55a05fa9053f5"
dependencies = [
 "async-compression",
 "bitflags",
 "bytes",
 "futures-core",
 "futures-util",
 "http",
 "http-body",
 "http-body-util",
 "http-range-header",
 "httpdate",
 "mime",
 "mime_guess",
 "percent-encoding",
 "pin-project-lite",
 "tokio",
 "tokio-util",
 "tower 0.4.13",
 "tower-layer",
 "tower-service",
 "tracing",
]

[[package]]
name = "tower-layer"
version = "0.3.3"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "121c2a6cda46980bb0fcd1647ffaf6cd3fc79a013de288782836f6df9c48780e"

[[package]]
name = "tower-service"
version = "0.3.3"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "8df9b6e13f2d32c91b9bd719c00d1958837bc7dec474d94952798cc8e69eeec3"

[[package]]
name = "tracing"
version = "0.1.41"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "784e0ac535deb450455cbfa28a6f0df145ea1bb7ae51b821cf5e7927fdcfbdd0"
dependencies = [
 "log",
 "pin-project-lite",
 "tracing-attributes",
 "tracing-core",
]

[[package]]
name = "tracing-attributes"
version = "0.1.28"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "395ae124c09f9e6918a2310af6038fba074bcf474ac352496d5910dd59a2226d"
dependencies = [
 "proc-macro2",
 "quote",
 "syn",
]

[[package]]
name = "tracing-core"
version = "0.1.33"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "e672c95779cf947c5311f83787af4fa8fffd12fb27e4993211a84bdfd9610f9c"
dependencies = [
 "once_cell",
 "valuable",
]

[[package]]
name = "tracing-log"
version = "0.2.0"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "ee855f1f400bd0e5c02d150ae5de3840039a3f54b025156404e34c23c03f47c3"
dependencies = [
 "log",
 "once_cell",
 "tracing-core",
]

[[package]]
name = "tracing-subscriber"
version = "0.3.19"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "e8189decb5ac0fa7bc8b96b7cb9b2701d60d48805aca84a238004d665fcc4008"
dependencies = [
 "nu-ansi-term",
 "sharded-slab",
 "smallvec",
 "thread_local",
 "tracing-core",
 "tracing-log",
]

[[package]]
name = "unicase"
version = "2.8.1"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "75b844d17643ee918803943289730bec8aac480150456169e647ed0b576ba539"

[[package]]
name = "unicode-ident"
version = "1.0.18"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "5a5f39404a5da50712a4c1eecf25e90dd62b613502b7e925fd4e4d19b5c96512"

[[package]]
name = "utf8parse"
version = "0.2.2"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "06abde3611657adf66d383f00b093d7faecc7fa57071cce2578660c9f1010821"

[[package]]
name = "valuable"
version = "0.1.1"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "ba73ea9cf16a25df0c8caa16c51acb937d5712a8429db78a3ee29d5dcacd3a65"

[[package]]
name = "wasi"
version = "0.11.0+wasi-snapshot-preview1"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "9c8d87e72b64a3b4db28d11ce29237c246188f4f51057d65a7eab63b7987e423"

[[package]]
name = "wasm-bindgen"
version = "0.2.100"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "1edc8929d7499fc4e8f0be2262a241556cfc54a0bea223790e71446f2aab1ef5"
dependencies = [
 "cfg-if",
 "once_cell",
 "rustversion",
 "wasm-bindgen-macro",
]

[[package]]
name = "wasm-bindgen-backend"
version = "0.2.100"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "2f0a0651a5c2bc21487bde11ee802ccaf4c51935d0d3d42a6101f98161700bc6"
dependencies = [
 "bumpalo",
 "log",
 "proc-macro2",
 "quote",
 "syn",
 "wasm-bindgen-shared",
]

[[package]]
name = "wasm-bindgen-macro"
version = "0.2.100"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "7fe63fc6d09ed3792bd0897b314f53de8e16568c2b3f7982f468c0bf9bd0b407"
dependencies = [
 "quote",
 "wasm-bindgen-macro-support",
]

[[package]]
name = "wasm-bindgen-macro-support"
version = "0.2.100"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "8ae87ea40c9f689fc23f209965b6fb8a99ad69aeeb0231408be24920604395de"
dependencies = [
 "proc-macro2",
 "quote",
 "syn",
 "wasm-bindgen-backend",
 "wasm-bindgen-shared",
]

[[package]]
name = "wasm-bindgen-shared"
version = "0.2.100"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "1a05d73b933a847d6cccdda8f838a22ff101ad9bf93e33684f39c1f5f0eece3d"
dependencies = [
 "unicode-ident",
]

[[package]]
name = "winapi"
version = "0.3.9"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "5c839a674fcd7a98952e593242ea400abe93992746761e38641405d28b00f419"
dependencies = [
 "winapi-i686-pc-windows-gnu",
 "winapi-x86_64-pc-windows-gnu",
]

[[package]]
name = "winapi-i686-pc-windows-gnu"
version = "0.4.0"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "ac3b87c63620426dd9b991e5ce0329eff545bccbbb34f3be09ff6fb6ab51b7b6"

[[package]]
name = "winapi-x86_64-pc-windows-gnu"
version = "0.4.0"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "712e227841d057c1ee1cd2fb22fa7e5a5461ae8e48fa2ca79ec42cfc1931183f"

[[package]]
name = "windows-core"
version = "0.61.0"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "4763c1de310c86d75a878046489e2e5ba02c649d185f21c67d4cf8a56d098980"
dependencies = [
 "windows-implement",
 "windows-interface",
 "windows-link",
 "windows-result",
 "windows-strings",
]

[[package]]
name = "windows-implement"
version = "0.60.0"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "a47fddd13af08290e67f4acabf4b459f647552718f683a7b415d290ac744a836"
dependencies = [
 "proc-macro2",
 "quote",
 "syn",
]

[[package]]
name = "windows-interface"
version = "0.59.1"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "bd9211b69f8dcdfa817bfd14bf1c97c9188afa36f4750130fcdf3f400eca9fa8"
dependencies = [
 "proc-macro2",
 "quote",
 "syn",
]

[[package]]
name = "windows-link"
version = "0.1.1"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "76840935b766e1b0a05c0066835fb9ec80071d4c09a16f6bd5f7e655e3c14c38"

[[package]]
name = "windows-result"
version = "0.3.2"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "c64fd11a4fd95df68efcfee5f44a294fe71b8bc6a91993e2791938abcc712252"
dependencies = [
 "windows-link",
]

[[package]]
name = "windows-strings"
version = "0.4.0"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "7a2ba9642430ee452d5a7aa78d72907ebe8cfda358e8cb7918a2050581322f97"
dependencies = [
 "windows-link",
]

[[package]]
name = "windows-sys"
version = "0.52.0"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "282be5f36a8ce781fad8c8ae18fa3f9beff57ec1b52cb3de0789201425d9a33d"
dependencies = [
 "windows-targets",
]

[[package]]
name = "windows-sys"
version = "0.59.0"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "1e38bc4d79ed67fd075bcc251a1c39b32a1776bbe92e5bef1f0bf1f8c531853b"
dependencies = [
 "windows-targets",
]

[[package]]
name = "windows-targets"
version = "0.52.6"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "9b724f72796e036ab90c1021d4780d4d3d648aca59e491e6b98e725b84e99973"
dependencies = [
 "windows_aarch64_gnullvm",
 "windows_aarch64_msvc",
 "windows_i686_gnu",
 "windows_i686_gnullvm",
 "windows_i686_msvc",
 "windows_x86_64_gnu",
 "windows_x86_64_gnullvm",
 "windows_x86_64_msvc",
]

[[package]]
name = "windows_aarch64_gnullvm"
version = "0.52.6"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "32a4622180e7a0ec044bb555404c800bc9fd9ec262ec147edd5989ccd0c02cd3"

[[package]]
name = "windows_aarch64_msvc"
version = "0.52.6"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "09ec2a7bb152e2252b53fa7803150007879548bc709c039df7627cabbd05d469"

[[package]]
name = "windows_i686_gnu"
version = "0.52.6"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "8e9b5ad5ab802e97eb8e295ac6720e509ee4c243f69d781394014ebfe8bbfa0b"

[[package]]
name = "windows_i686_gnullvm"
version = "0.52.6"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "0eee52d38c090b3caa76c563b86c3a4bd71ef1a819287c19d586d7334ae8ed66"

[[package]]
name = "windows_i686_msvc"
version = "0.52.6"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "240948bc05c5e7c6dabba28bf89d89ffce3e303022809e73deaefe4f6ec56c66"

[[package]]
name = "windows_x86_64_gnu"
version = "0.52.6"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "147a5c80aabfbf0c7d901cb5895d1de30ef2907eb21fbbab29ca94c5b08b1a78"

[[package]]
name = "windows_x86_64_gnullvm"
version = "0.52.6"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "24d5b23dc417412679681396f2b49f3de8c1473deb516bd34410872eff51ed0d"

[[package]]
name = "windows_x86_64_msvc"
version = "0.52.6"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "589f6da84c646204747d1270a2a5661ea66ed1cced2631d546fdfb155959f9ec"



================================================
FILE: server/Cargo.toml
================================================
[package]
name = "nut_webgui"
version = "0.4.2"
edition = "2021"
license = "Apache-2.0"
keywords = ["nut", "ups", "network-ups-tools", "self-hosted", "management"]
repository = "https://github.com/SuperioOne/nut_webgui"
homepage = "https://github.com/SuperioOne/nut_webgui"
documentation = "https://github.com/SuperioOne/nut_webgui"
authors = ["Timur Olur <pm@smdd.dev>"]
description = "Light weight web interface for Network UPS Tools."

# See more keys and their definitions at https://doc.rust-lang.org/cargo/reference/manifest.html

[profile.release]
strip = "debuginfo"
lto = true

[dependencies]
algorithms_random = { git = "https://github.com/SuperioOne/algorithms.git" }
askama = { version = "0.12.1", default-features = false, features = ["with-axum", "mime", "mime_guess"] }
askama_axum = { version = "0.4.0" }
axum = { version = "0.7.5", features = ["original-uri"] }
axum-core = "0.4.3"
chrono = { version = "0.4.38", default-features = false ,features = ["now", "serde", "iana-time-zone"]}
clap = { version = "4.5.4", features = ["derive", "default"] }
serde = { version = "1.0.197", features = ["default", "serde_derive"] }
tokio = { version = "1.37.0", features = ["default", "net", "macros", "rt-multi-thread", "signal"] }
tokio-util = { version = "0.7.10", features = ["default"] }
tower = { version = "0.4.13" }
tower-http = { version = "0.5.2", features = ["compression-br", "compression-deflate", "compression-gzip", "cors", "default", "fs", "normalize-path", "set-header", "timeout", "tower", "trace", "util"] }
tracing = "0.1.40"
tracing-subscriber = "0.3.18"



================================================
FILE: server/src/base_path.rs
================================================
/// Checks path for both URI path and Axum 0.7 route syntax.
/// See also: [RFC 3986](https://www.rfc-editor.org/rfc/rfc3986#section-3.3)
fn is_valid_path(path: &str) -> bool {
  let mut prev_chr: char = '\0';

  for chr in path.chars() {
    if chr == '/' && prev_chr == '/' {
      return false;
    }

    match chr {
      // sub-delims
       '!'
      | '$'
      | '&'
      | '('
      | ')'
      | '+'
      | ','
      | ';'
      | '='
      // unreserved
      | '-'
      | '.'
      | '_'
      | '~'
      // Alpha numeric
      | 'a'..='z'
      | 'A'..='Z'
      | '0'..='9'
      // special terminals
      | '@'
      | '/'
      => {
        prev_chr = chr;
        continue;
      }
      // Anything else
      _ => return false,
    }
  }

  true
}

#[derive(Debug)]
pub struct InvalidBasePathError;

impl std::fmt::Display for InvalidBasePathError {
  fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
    f.write_str("incorrect base path format")
  }
}

pub fn get_base_path(input: Option<String>) -> Result<String, InvalidBasePathError> {
  match input {
    Some(path) => {
      let normalized = path
        .trim()
        .trim_end_matches(|char: char| char.is_whitespace() || char == '/');

      if is_valid_path(&normalized) {
        if normalized.is_empty() {
          Ok(String::new())
        } else if normalized.starts_with('/') {
          Ok(normalized.into())
        } else {
          Ok(format!("/{}", normalized))
        }
      } else {
        Err(InvalidBasePathError)
      }
    }
    None => Ok(String::new()),
  }
}



================================================
FILE: server/src/http_server.rs
================================================
use crate::ups_daemon_state::UpsDaemonState;
use axum::{
  http::{header::CACHE_CONTROL, HeaderValue, StatusCode},
  routing::{get, post},
  Router, ServiceExt,
};
use std::{net::SocketAddr, sync::Arc, time::Duration};
use tokio::{spawn, sync::RwLock, task::JoinHandle};
use tower::{Layer, ServiceBuilder};
use tower_http::{
  compression::CompressionLayer, cors::CorsLayer, normalize_path::NormalizePathLayer,
  services::ServeDir, set_header::SetResponseHeaderLayer, timeout::TimeoutLayer, trace::TraceLayer,
};

use self::middlewares::DaemonStateLayer;

mod common;
mod hypermedia;
mod json;
mod middlewares;
mod probes;

pub struct HttpServerConfig {
  pub listen: SocketAddr,
  pub upsd_state: Arc<RwLock<UpsDaemonState>>,
  pub config: ServerConfig,
  pub static_dir: String,
}

pub(crate) struct ServerConfig {
  pub pass: Option<String>,
  pub user: Option<String>,
  pub addr: String,
  pub poll_freq: Duration,
  pub poll_interval: Duration,
  pub base_path: String,
}

#[derive(Clone)]
pub(crate) struct ServerState {
  pub upsd_state: Arc<RwLock<UpsDaemonState>>,
  pub configs: Arc<ServerConfig>,
}

pub fn start_http_server(config: HttpServerConfig) -> JoinHandle<()> {
  spawn(async move {
    let HttpServerConfig {
      upsd_state,
      listen,
      config,
      static_dir,
    } = config;

    let middleware = ServiceBuilder::new()
      .layer(CompressionLayer::new().br(true).gzip(true).deflate(true))
      .layer(TraceLayer::new_for_http())
      .layer(TimeoutLayer::new(Duration::from_secs(10)))
      .layer(SetResponseHeaderLayer::if_not_present(
        CACHE_CONTROL,
        HeaderValue::from_static("no-cache, max-age=0"),
      ));

    let probes = Router::new()
      .route("/health", get(probes::get_health))
      .route("/readiness", get(probes::get_readiness))
      .fallback(|| async { StatusCode::NOT_FOUND })
      .layer(CorsLayer::permissive());

    let data_api = Router::new()
      .route("/ups/:ups_name", get(json::get_ups_by_name))
      .route("/ups", get(json::get_ups_list))
      .route("/ups/:ups_name/command", post(json::post_command))
      .fallback(|| async { StatusCode::NOT_FOUND })
      .layer(DaemonStateLayer::new(upsd_state.clone()))
      .layer(CorsLayer::permissive());

    let hypermedia_api = Router::new()
      .route("/ups/:ups_name", get(hypermedia::routes::ups::get))
      .route(
        "/ups/:ups_name/command",
        post(hypermedia::routes::ups::post_command),
      )
      .route("/", get(hypermedia::routes::home::get))
      .route("/not-found", get(hypermedia::routes::not_found::get))
      .fallback(hypermedia::routes::not_found::get);

    let base_path = config.base_path.clone();
    let state = ServerState {
      upsd_state,
      configs: Arc::new(config),
    };

    let router = Router::new()
      .nest_service("/static", ServeDir::new(static_dir))
      .nest("/api", data_api)
      .nest("/probes", probes)
      .merge(hypermedia_api)
      .layer(middleware)
      .with_state(state);

    let router = if base_path.is_empty() {
      router.into_service()
    } else {
      Router::new().nest(&base_path, router).into_service()
    };

    let app = NormalizePathLayer::trim_trailing_slash().layer(router);
    let listener = tokio::net::TcpListener::bind(listen).await.unwrap();

    axum::serve(listener, app.into_make_service())
      .await
      .unwrap();
  })
}



================================================
FILE: server/src/main.rs
================================================
pub mod ups_daemon_state;

mod base_path;
mod http_server;
mod ups_services;
mod upsd_client;

use crate::{
  http_server::{start_http_server, HttpServerConfig, ServerConfig},
  ups_services::{
    upsd_poll_service, upsd_state_service, UpsPollerConfig, UpsStorageConfig, UpsUpdateMessage,
  },
};
use base_path::get_base_path;
use clap::Parser;
use std::{
  net::{IpAddr, Ipv4Addr, SocketAddr},
  panic,
  process::exit,
  sync::Arc,
};
use tokio::{
  select,
  signal::{self, unix::SignalKind},
  sync::{
    mpsc::{self, Receiver, Sender},
    RwLock,
  },
  time::Duration,
};
use tokio_util::sync::CancellationToken;
use tracing::{debug, error, info, warn};
use tracing_subscriber::fmt;
use ups_daemon_state::UpsDaemonState;

#[derive(Parser, Debug)]
#[command(author, version, about, long_about = None)]
struct ServerArgs {
  /// Non-critical ups variables update frequency in seconds.
  #[arg(long, default_value_t = 30)]
  poll_freq: u64,

  /// Critical ups variables update interval in seconds.
  #[arg(long, default_value_t = 2)]
  poll_interval: u64,

  /// NUT server address
  #[arg(long, default_value_t = String::from("localhost"))]
  upsd_addr: String,

  /// NUT server port
  #[arg(long, default_value_t = 3493)]
  upsd_port: u16,

  /// NUT username
  #[arg(long)]
  upsd_user: Option<String>,

  /// NUT password
  #[arg(long)]
  upsd_pass: Option<String>,

  /// Listen address for HTTP server
  #[arg(short, long, default_value_t = IpAddr::V4(Ipv4Addr::new(0, 0, 0, 0)))]
  listen: IpAddr,

  /// HTTP server port
  #[arg(short, long, default_value_t = 9000)]
  port: u16,

  /// Log level
  #[arg(long, default_value_t = tracing::Level::INFO)]
  log_level: tracing::Level,

  /// Static file directory
  #[arg(long, default_value_t = String::from("static"))]
  static_dir: String,

  /// Overrides base path
  #[arg(long)]
  base_path: Option<String>,
}

#[tokio::main]
async fn main() {
  let args = ServerArgs::parse();
  fmt().with_max_level(args.log_level).init();

  let base_path = match get_base_path(args.base_path) {
    Ok(path) => path,
    Err(err) => {
      error!(message = "server start failed", err=%err);
      exit(-1)
    }
  };

  debug!(
    message = "Server initialized.",
    poll_interval = &args.poll_interval,
    poll_freq = &args.poll_freq,
    upsd_addr = &args.upsd_addr,
    upsd_port = &args.upsd_port,
    upsd_user = &args.upsd_user,
    upsd_pass = args.upsd_pass.as_deref().map(|_| "[REDACTED]"),
    listen = &args.listen.to_string(),
    port = &args.port,
    log_level = args.log_level.as_str(),
    base_path = &base_path,
    static_dir = &args.static_dir
  );

  let cancellation = CancellationToken::new();
  let (tx, rx): (Sender<UpsUpdateMessage>, Receiver<UpsUpdateMessage>) = mpsc::channel(256);
  let state_arc = Arc::new(RwLock::new(UpsDaemonState::new()));
  let upsd_address = format!("{}:{}", args.upsd_addr, args.upsd_port);
  let (poll_interval, poll_freq) = {
    if args.poll_freq < args.poll_interval {
      warn!("Poll interval is set greater than or equal to poll frequency.");
      (args.poll_interval, args.poll_interval)
    } else {
      (args.poll_interval, args.poll_freq)
    }
  };

  panic::set_hook(Box::new(|info| {
    error!(message = "App thread panicked. Aborting process.", details = %info);
    std::process::abort();
  }));

  // Spawns background services
  let poll_srv_handle = upsd_poll_service(UpsPollerConfig {
    address: upsd_address.clone(),
    poll_freq: Duration::from_secs(poll_freq),
    poll_interval: Duration::from_secs(poll_interval),
    write_channel: tx,
    cancellation: cancellation.clone(),
  });

  let state_srv_handle = upsd_state_service(UpsStorageConfig {
    read_channel: rx,
    cancellation: cancellation.clone(),
    upsd_state: state_arc.clone(),
  });

  // http server
  let server_handle = start_http_server(HttpServerConfig {
    upsd_state: state_arc,
    listen: SocketAddr::new(args.listen, args.port),
    static_dir: args.static_dir,
    config: ServerConfig {
      addr: upsd_address,
      pass: args.upsd_pass,
      user: args.upsd_user,
      poll_freq: Duration::from_secs(poll_freq),
      poll_interval: Duration::from_secs(poll_interval),
      base_path: base_path,
    },
  });

  let mut sigterm = signal::unix::signal(SignalKind::terminate()).expect("SIGTERM stream failed");
  let mut sigint = signal::unix::signal(SignalKind::interrupt()).expect("SIGINT stream failed");
  let mut sigquit = signal::unix::signal(SignalKind::interrupt()).expect("SIGQUIT stream failed");

  select! {
    _ = sigterm.recv() => { info!("SIGTERM signal received.");}
    _ = sigquit.recv() => { info!("SIGQUIT signal received.");}
    _ = sigint.recv() => { info!("SIGINT signal received.");}
  }

  cancellation.cancel();

  info!("Shutting down services");
  _ = poll_srv_handle.await;
  _ = state_srv_handle.await;
  info!("Shutting http server");
  server_handle.abort();
}



================================================
FILE: server/src/ups_daemon_state.rs
================================================
use crate::upsd_client::ups_variables::UpsVariable;
use chrono::{DateTime, Utc};
use serde::Serialize;
use std::collections::{hash_map::Iter, HashMap};
use std::fmt::Display;

#[derive(Debug, PartialEq, Eq, Clone, Copy, Serialize)]
pub enum DaemonStatus {
  Dead,
  Online,
  NotReady,
}

#[derive(Debug)]
pub struct UpsEntry {
  pub name: Box<str>,
  pub desc: Box<str>,
  pub variables: Vec<UpsVariable>,
  pub commands: Vec<Box<str>>,
}

#[derive(Debug)]
pub struct UpsDaemonState {
  pub ups_list: HashMap<Box<str>, UpsEntry>,
  pub last_full_sync: Option<DateTime<Utc>>,
  pub last_modified: Option<DateTime<Utc>>,
  pub status: DaemonStatus,
}

pub struct UpsDaemonIterator<'a> {
  iterator: Iter<'a, Box<str>, UpsEntry>,
}

impl<'a> Iterator for UpsDaemonIterator<'a> {
  type Item = (&'a Box<str>, &'a UpsEntry);

  fn next(&mut self) -> Option<Self::Item> {
    self.iterator.next()
  }
}

impl Display for DaemonStatus {
  fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
    match self {
      DaemonStatus::Dead => f.write_str("Dead"),
      DaemonStatus::Online => f.write_str("Online"),
      DaemonStatus::NotReady => f.write_str("Not Ready"),
    }
  }
}

impl UpsDaemonState {
  pub fn new() -> UpsDaemonState {
    UpsDaemonState {
      ups_list: HashMap::new(),
      last_full_sync: None,
      last_modified: None,
      status: DaemonStatus::NotReady,
    }
  }

  pub fn put_ups(&mut self, entry: UpsEntry) {
    let key = entry.name.clone();
    self.ups_list.insert(key, entry);
  }

  pub fn get_ups(&self, ups_name: &str) -> Option<&UpsEntry> {
    self.ups_list.get(ups_name)
  }

  pub fn get_ups_mut(&mut self, ups_name: &str) -> Option<&mut UpsEntry> {
    self.ups_list.get_mut(ups_name)
  }

  pub fn iter(&self) -> UpsDaemonIterator<'_> {
    UpsDaemonIterator {
      iterator: self.ups_list.iter(),
    }
  }

  pub fn reset(&mut self) {
    self.ups_list.clear();
    self.last_modified = None;
    self.last_full_sync = None;
    self.status = DaemonStatus::NotReady;
  }

  pub fn reset_with_status(&mut self, status: DaemonStatus) {
    self.ups_list.clear();
    self.last_modified = None;
    self.last_full_sync = None;
    self.status = status;
  }
}



================================================
FILE: server/src/ups_services.rs
================================================
use crate::upsd_client::ups_variables::UpsVariable;

mod upsd_poll_service;
mod upsd_state_service;

pub use upsd_poll_service::*;
pub use upsd_state_service::*;

#[derive(Debug)]
pub struct UpsDetails {
  pub name: Box<str>,
  pub desc: Box<str>,
  pub commands: Vec<Box<str>>,
  pub variables: Vec<UpsVariable>,
}

#[derive(Debug)]
pub struct UpsVarDetail {
  pub name: Box<str>,
  pub variable: UpsVariable,
}

#[derive(Debug)]
pub enum UpsUpdateMessage {
  /// Updates all variables.
  FullUpdate { data: Vec<UpsDetails> },

  /// Updates a single variable.
  PartialUpdate { data: Vec<UpsVarDetail> },

  /// Marks daemon as dead
  MarkAsDead,
}



================================================
FILE: server/src/upsd_client.rs
================================================
pub mod client;
pub mod errors;
pub mod parser;
pub mod ups_variables;

#[derive(Debug)]
pub struct Ups {
  pub name: Box<str>,
  pub desc: Box<str>,
}



================================================
FILE: server/src/http_server/common.rs
================================================
use crate::upsd_client::errors::NutClientErrors;
use axum::{
  http::StatusCode,
  response::{IntoResponse, Response},
  Json,
};
use serde::{ser::SerializeStruct, Serialize};

/// Generalized Http problem details response. It's based on RFC9457, but it doesn't
/// contain `type` field.
#[derive(Debug)]
pub struct ProblemDetailsResponse {
  pub title: &'static str,
  pub detail: Option<String>,
  pub instance: Option<String>,
  pub status: StatusCode,
}

impl Serialize for ProblemDetailsResponse {
  fn serialize<S>(&self, serializer: S) -> Result<S::Ok, S::Error>
  where
    S: serde::Serializer,
  {
    let mut obj = serializer.serialize_struct("ProblemDetailsResponse", 4)?;
    obj.serialize_field("title", self.title)?;
    obj.serialize_field("detail", &self.detail)?;
    obj.serialize_field("instance", &self.instance)?;
    obj.serialize_field("status", &self.status.as_u16())?;
    obj.end()
  }
}

impl IntoResponse for ProblemDetailsResponse {
  fn into_response(self) -> Response {
    let status_code = self.status;
    let mut response = Json(self).into_response();
    let response_status = response.status_mut();

    *response_status = status_code;

    response
  }
}

impl From<NutClientErrors> for ProblemDetailsResponse {
  fn from(value: NutClientErrors) -> Self {
    match value {
      NutClientErrors::EmptyResponse => ProblemDetailsResponse {
        title: "UPS daemon empty response",
        instance: None,
        status: StatusCode::INTERNAL_SERVER_ERROR,
        detail: Some(
          "Server is able to connect daemon, but daemon isn't responding to any commands for now."
            .to_string(),
        ),
      },
      NutClientErrors::IOError { kind } => ProblemDetailsResponse {
        title: "UPS daemon IO error",
        instance: None,
        status: StatusCode::INTERNAL_SERVER_ERROR,
        detail: Some(kind.to_string()),
      },
      NutClientErrors::ParseError { kind } => ProblemDetailsResponse {
        title: "Invalid UPS daemon response",
        instance: None,
        status: StatusCode::INTERNAL_SERVER_ERROR,
        detail: Some(kind.to_string()),
      },
      NutClientErrors::ProtocolError { kind } => ProblemDetailsResponse {
        title: "UPS daemon protocol error",
        instance: None,
        status: StatusCode::INTERNAL_SERVER_ERROR,
        detail: Some(kind.to_string()),
      },
    }
  }
}



================================================
FILE: server/src/http_server/hypermedia.rs
================================================
pub mod notifications;
pub mod routes;
pub mod utils;



================================================
FILE: server/src/http_server/json.rs
================================================
use super::common::ProblemDetailsResponse;
use crate::{
  http_server::{ServerConfig, ServerState},
  ups_daemon_state::UpsEntry,
  upsd_client::{client::UpsAuthClient, errors::NutClientErrors, ups_variables::UpsVariable},
};
use axum::{
  extract::{OriginalUri, Path, State},
  http::StatusCode,
  Json,
};
use axum_core::response::{IntoResponse, Response};
use serde::{ser::SerializeStruct, Deserialize, Serialize, Serializer};
use std::{collections::BTreeMap, ops::Deref};
use tracing::info;

impl Serialize for UpsEntry {
  fn serialize<S>(&self, serializer: S) -> Result<S::Ok, S::Error>
  where
    S: Serializer,
  {
    let mut obj = serializer.serialize_struct("UpsEntry", 4)?;
    let mut vars: BTreeMap<&str, &UpsVariable> = BTreeMap::new();

    for variable in self.variables.iter() {
      vars.insert(variable.name(), variable);
    }

    obj.serialize_field("name", &self.name)?;
    obj.serialize_field("desc", &self.desc)?;
    obj.serialize_field("vars", &vars)?;
    obj.serialize_field("cmds", &self.commands)?;

    obj.end()
  }
}

#[derive(Debug, Deserialize)]
pub struct CommandBody {
  cmd: String,
}

pub async fn get_ups_by_name(
  State(state): State<ServerState>,
  uri: OriginalUri,
  Path(ups_name): Path<String>,
) -> Response {
  let upsd_state = state.upsd_state.read().await;

  if let Some(ups) = upsd_state.get_ups(&ups_name) {
    Json(ups).into_response()
  } else {
    ProblemDetailsResponse {
      status: StatusCode::NOT_FOUND,
      instance: Some(uri.to_string()),
      title: "UPS not found",
      detail: None,
    }
    .into_response()
  }
}

pub async fn get_ups_list(State(state): State<ServerState>) -> Response {
  let upsd_state = state.upsd_state.read().await;
  let mut ups_list: Vec<&UpsEntry> = upsd_state.iter().map(|(_, entry)| entry).collect();
  ups_list.sort_unstable_by_key(|v| &v.name);

  Json(ups_list).into_response()
}

pub async fn post_command(
  State(state): State<ServerState>,
  uri: OriginalUri,
  Path(ups_name): Path<String>,
  Json(body): Json<CommandBody>,
) -> Response {
  let upsd_state = state.upsd_state.read().await;

  match upsd_state.get_ups(&ups_name) {
    Some(_) => match state.configs.deref() {
      ServerConfig {
        addr,
        pass: Some(password),
        user: Some(username),
        ..
      } => {
        let command_result: Result<(), NutClientErrors> = async {
          let mut client = UpsAuthClient::create(addr, username, password).await?;
          client.send_instcmd(&ups_name, &body.cmd).await?;
          Ok(())
        }
        .await;

        info!("INSTCMD '{0}' called for UPS '{1}'", &body.cmd, ups_name);

        match command_result {
          Ok(()) => StatusCode::ACCEPTED.into_response(),
          Err(err) => {
            let mut problem = ProblemDetailsResponse::from(err);
            problem.instance = Some(uri.to_string());

            problem.into_response()
          }
        }
      }
      _ => ProblemDetailsResponse {
        status: StatusCode::UNAUTHORIZED,
        instance: Some(uri.to_string()),
        title: "Insufficient Upsd configuration",
        detail: Some(String::from(
          "CMD command requires valid username and password to be configured.",
        )),
      }
      .into_response(),
    },
    None => ProblemDetailsResponse {
      status: StatusCode::NOT_FOUND,
      instance: Some(uri.to_string()),
      title: "UPS not found",
      detail: None,
    }
    .into_response(),
  }
}



================================================
FILE: server/src/http_server/middlewares.rs
================================================
use crate::ups_daemon_state::{DaemonStatus, UpsDaemonState};
use axum::{
  http::{Request, StatusCode},
  response::{IntoResponse, Response},
};
use std::{future::Future, pin::Pin, sync::Arc};
use tokio::sync::RwLock;
use tower::{Layer, Service};

use super::common::ProblemDetailsResponse;

/// Checks daemon state and overrides http response if daemon is not `Online`.
#[derive(Clone)]
pub struct DaemonStateLayer {
  upsd_state: Arc<RwLock<UpsDaemonState>>,
}

impl DaemonStateLayer {
  pub fn new(upsd_state: Arc<RwLock<UpsDaemonState>>) -> Self {
    Self { upsd_state }
  }
}

#[derive(Clone)]
pub struct DaemonStateService<S> {
  inner: S,
  upsd_state: Arc<RwLock<UpsDaemonState>>,
}

impl<S> Layer<S> for DaemonStateLayer {
  type Service = DaemonStateService<S>;

  fn layer(&self, inner: S) -> Self::Service {
    Self::Service {
      inner,
      upsd_state: self.upsd_state.clone(),
    }
  }
}

impl<S, B> Service<Request<B>> for DaemonStateService<S>
where
  S: Service<Request<B>, Response = Response>,
  S::Future: Send + 'static,
{
  type Response = Response;
  type Error = S::Error;
  type Future = Pin<Box<dyn Send + Future<Output = Result<S::Response, S::Error>>>>;

  fn poll_ready(
    &mut self,
    cx: &mut std::task::Context<'_>,
  ) -> std::task::Poll<Result<(), Self::Error>> {
    self.inner.poll_ready(cx)
  }

  fn call(&mut self, req: Request<B>) -> Self::Future {
    let state = self.upsd_state.clone();
    let inner_future = self.inner.call(req);

    Box::pin(async move {
      let response = match state.read().await.status {
        DaemonStatus::Online => inner_future.await?,
        DaemonStatus::Dead => ProblemDetailsResponse {
          status: StatusCode::INTERNAL_SERVER_ERROR,
          title: "Ups daemon no connection",
          detail: Some(
            "Server is unable to connect upsd. See application logs for more details.".to_owned(),
          ),
          instance: None,
        }
        .into_response(),
        DaemonStatus::NotReady => ProblemDetailsResponse {
          status: StatusCode::SERVICE_UNAVAILABLE,
          title: "Server is not ready",
          detail: None,
          instance: None,
        }
        .into_response(),
      };

      Ok(response)
    })
  }
}



================================================
FILE: server/src/http_server/probes.rs
================================================
use super::ServerState;
use crate::ups_daemon_state::DaemonStatus;
use axum::{
  extract::State,
  http::StatusCode,
  response::{IntoResponse, Response},
  Json,
};
use chrono::{DateTime, Utc};
use serde::Serialize;

#[derive(Serialize)]
pub struct HealthResponse<'a> {
  upsd_status: DaemonStatus,
  last_modified: Option<&'a DateTime<Utc>>,
  upsd_server: &'a str,
}

pub async fn get_health(State(state): State<ServerState>) -> Response {
  let upsd_state = state.upsd_state.read().await;

  let response = Json(HealthResponse {
    last_modified: upsd_state.last_modified.as_ref(),
    upsd_server: &state.configs.addr,
    upsd_status: upsd_state.status,
  });

  if response.upsd_status != DaemonStatus::Dead {
    (StatusCode::OK, response).into_response()
  } else {
    (StatusCode::INTERNAL_SERVER_ERROR, response).into_response()
  }
}

pub async fn get_readiness(State(state): State<ServerState>) -> Response {
  let upsd_state = state.upsd_state.read().await;

  if upsd_state.status == DaemonStatus::Online {
    (StatusCode::OK, "READY").into_response()
  } else {
    (StatusCode::SERVICE_UNAVAILABLE, "NOT READY").into_response()
  }
}



================================================
FILE: server/src/http_server/hypermedia/notifications.rs
================================================
#![allow(dead_code)]

use askama::Template;
use std::{
  fmt::{Display, Formatter},
  time::Duration,
};

#[derive(Debug)]
pub enum Notification {
  Success,
  Warning,
  Error,
  Info,
}

impl Display for Notification {
  fn fmt(&self, f: &mut Formatter<'_>) -> std::fmt::Result {
    match self {
      Notification::Error => f.write_str("error"),
      Notification::Info => f.write_str("info"),
      Notification::Success => f.write_str("success"),
      Notification::Warning => f.write_str("warning"),
    }
  }
}

#[derive(Template)]
#[template(path = "notification.html", ext = "html")]
pub struct NotificationTemplate {
  message: String,
  ttl: u128,
  notification_type: Notification,
}

const DEFAULT_DURATION: Duration = Duration::from_millis(3000);

impl NotificationTemplate {
  /// Creates notification template with hx-swap-oob
  /// # Arguments
  ///
  /// * `message`: Notification body
  /// * `notification_type`: Notification level
  /// * `ttl`: Optional Time to live as milliseconds, Default is 3000ms.
  ///
  /// returns: NotificationTemplate
  pub fn new(
    message: String,
    notification_type: Notification,
    ttl: Option<Duration>,
  ) -> NotificationTemplate {
    NotificationTemplate {
      message,
      notification_type,
      ttl: ttl.unwrap_or(DEFAULT_DURATION).as_millis(),
    }
  }
}



================================================
FILE: server/src/http_server/hypermedia/routes.rs
================================================
pub mod home;
pub mod not_found;
pub mod ups;



================================================
FILE: server/src/http_server/hypermedia/utils.rs
================================================
#![allow(dead_code)]

const ERROR_CLASS: &str = "error";
const SUCCESS_CLASS: &str = "success";
const WARNING_CLASS: &str = "warning";
const INFO_CLASS: &str = "info";

#[macro_export]
macro_rules! htmx_redirect {
  ($c:expr, $u:expr) => {{
    let code: axum::http::StatusCode = $c;
    let headers = axum::http::HeaderMap::new();

    (code, [("HX-Redirect", $u)], headers)
  }};
}

#[derive(Debug)]
pub struct AppDetails {
  pub version: &'static str,
}

pub const fn get_app_info() -> AppDetails {
  AppDetails {
    version: env!("CARGO_PKG_VERSION"),
  }
}

pub fn get_range_class(value: &f64, from: f64, to: f64) -> &'static str {
  if from > to {
    if *value >= from {
      SUCCESS_CLASS
    } else if *value < from && *value > to {
      WARNING_CLASS
    } else {
      ERROR_CLASS
    }
  } else if *value <= from {
    SUCCESS_CLASS
  } else if *value >= from && *value < to {
    WARNING_CLASS
  } else {
    ERROR_CLASS
  }
}

#[derive(Debug)]
pub struct StatusIcon {
  pub name: &'static str,
  pub class: &'static str,
  pub desc: &'static str,
}

pub fn get_status_icons(value: &str) -> Vec<StatusIcon> {
  value
    .split_ascii_whitespace()
    .flat_map(|e| match e {
      "OL" => Some(StatusIcon {
        name: "activity",
        class: SUCCESS_CLASS,
        desc: "UPS Online",
      }),
      "BOOST" => Some(StatusIcon {
        name: "zap-off",
        class: ERROR_CLASS,
        desc: "Input voltage is too low",
      }),
      "CAL" => Some(StatusIcon {
        name: "loader",
        class: INFO_CLASS,
        desc: "UPS is calibrating",
      }),
      "CHRG" => Some(StatusIcon {
        name: "battery-charging",
        class: SUCCESS_CLASS,
        desc: "Battery is charging",
      }),
      "DISCHRG" => Some(StatusIcon {
        name: "battery",
        class: INFO_CLASS,
        desc: "Battery is discharging",
      }),
      "ALARM" => Some(StatusIcon {
        name: "alert-circle",
        class: ERROR_CLASS,
        desc: "UPS requires intervention",
      }),
      "FSD" => Some(StatusIcon {
        name: "power",
        class: ERROR_CLASS,
        desc: "FORCED SHUTDOWN has begun",
      }),
      "LB" => Some(StatusIcon {
        name: "battery",
        class: WARNING_CLASS,
        desc: "Low battery",
      }),
      "OB" => Some(StatusIcon {
        name: "battery-charging",
        class: WARNING_CLASS,
        desc: "UPS on battery",
      }),
      "OVER" => Some(StatusIcon {
        name: "alert-circle",
        class: ERROR_CLASS,
        desc: "UPS is overloaded",
      }),
      "NOCOMM" => Some(StatusIcon {
        name: "wifi-off",
        class: ERROR_CLASS,
        desc: "Daemon has no connection with UPS",
      }),
      "RB" => Some(StatusIcon {
        name: "tool",
        class: ERROR_CLASS,
        desc: "Replace battery",
      }),
      "TEST" => Some(StatusIcon {
        name: "activity",
        class: INFO_CLASS,
        desc: "Under test",
      }),
      "TRIM" => Some(StatusIcon {
        name: "zap",
        class: ERROR_CLASS,
        desc: "Input voltage is too high",
      }),
      "BYPASS" => Some(StatusIcon {
        name: "tool",
        class: INFO_CLASS,
        desc: "Battery is disconnected for maintenance",
      }),
      _ => None,
    })
    .collect()
}

pub fn get_status_text(value: &str) -> &str {
  match value {
    "OL" => "ONLINE",
    "BOOST" => "LOW VOLTAGE",
    "CAL" => "CALIBRATING",
    "CHRG" => "CHARGING",
    "DISCHRG" => "DISCHARGING",
    "FSD" => "FORCED SHUTDOWN",
    "LB" => "LOW BATTERY",
    "OB" => "ON BATTERY",
    "OFF" => "OFFLINE",
    "OVER" => "OVERLOADED",
    "RB" => "REPLACE BATTERY",
    "TEST" => "TESTING",
    "TRIM" => "HIGH VOLTAGE",
    val => val,
  }
}

pub fn get_status_class(value: &str) -> Option<&'static str> {
  match value {
    "OL" => Some(SUCCESS_CLASS),
    "BOOST" => Some(ERROR_CLASS),
    "CAL" => Some(INFO_CLASS),
    "CHRG" => Some(INFO_CLASS),
    "DISCHRG" => Some(WARNING_CLASS),
    "ALARM" => Some(ERROR_CLASS),
    "FSD" => Some(ERROR_CLASS),
    "LB" => Some(ERROR_CLASS),
    "OB" => Some(WARNING_CLASS),
    "OVER" => Some(ERROR_CLASS),
    "NOCOMM" => Some(ERROR_CLASS),
    "RB" => Some(ERROR_CLASS),
    "TEST" => Some(INFO_CLASS),
    "TRIM" => Some(ERROR_CLASS),
    "BYPASS" => Some(WARNING_CLASS),
    _ => None,
  }
}



================================================
FILE: server/src/http_server/hypermedia/routes/home.rs
================================================
use crate::{
  http_server::ServerState, ups_daemon_state::UpsEntry, upsd_client::ups_variables::UpsVariable,
};
use askama::Template;
use axum::{
  extract::{Query, State},
  response::Response,
};
use axum_core::response::IntoResponse;
use serde::Deserialize;

#[derive(Debug)]
pub struct UpsTableRow<'a> {
  charge: Option<f64>,
  desc: &'a str,
  load: Option<f64>,
  name: &'a str,
  status: Option<String>,
}

impl UpsTableRow<'_> {
  pub fn from_ups_entry(ups: &UpsEntry) -> UpsTableRow {
    let mut row = UpsTableRow {
      charge: None,
      desc: &ups.desc,
      load: None,
      name: &ups.name,
      status: None,
    };

    for variable in &ups.variables {
      match variable {
        UpsVariable::UpsLoad(val) => {
          row.load = Some(*val);
        }
        UpsVariable::BatteryCharge(val) => {
          row.charge = Some(*val);
        }
        UpsVariable::UpsStatus(val) => {
          row.status = Some(val.to_string());
        }
        _ => {}
      }
    }

    row
  }
}

impl<'a> From<&'a UpsEntry> for UpsTableRow<'a> {
  fn from(value: &'a UpsEntry) -> Self {
    Self::from_ups_entry(value)
  }
}

#[derive(Template)]
#[template(path = "ups_table.html", ext = "html")]
struct UpsTableTemplate<'a> {
  ups_list: Vec<UpsTableRow<'a>>,
  base_path: &'a str,
}

#[derive(Deserialize)]
pub struct HomeFragmentQuery {
  section: Option<String>,
}

#[derive(Template)]
#[template(path = "+page.html", escape = "none", ext = "html")]
struct HomeTemplate<'a> {
  title: &'a str,
  ups_table: UpsTableTemplate<'a>,
  base_path: &'a str,
}

pub async fn get(query: Query<HomeFragmentQuery>, State(state): State<ServerState>) -> Response {
  let upsd_state = &state.upsd_state.read().await;
  let mut ups_list: Vec<UpsTableRow> = upsd_state
    .iter()
    .map(|(_, ups)| UpsTableRow::from(ups))
    .collect();

  ups_list.sort_unstable_by_key(|v| v.name);

  let table_template = UpsTableTemplate {
    ups_list,
    base_path: &state.configs.base_path,
  };

  match query.section.as_deref() {
    Some("ups_table") => table_template.into_response(),
    _ => HomeTemplate {
      title: "Home",
      base_path: &state.configs.base_path,
      ups_table: table_template,
    }
    .into_response(),
  }
}



================================================
FILE: server/src/http_server/hypermedia/routes/not_found.rs
================================================
use askama::Template;
use axum::{extract::State, response::Response};
use axum_core::response::IntoResponse;

use crate::http_server::ServerState;

#[derive(Template)]
#[template(path = "not_found/+page.html")]
struct NotFound<'a> {
  title: &'a str,
  base_path: &'a str,
}

pub async fn get(State(state): State<ServerState>) -> Response {
  let template = NotFound {
    title: "Not Found",
    base_path: &state.configs.base_path,
  };
  template.into_response()
}



================================================
FILE: server/src/http_server/hypermedia/routes/ups.rs
================================================
use crate::{
  htmx_redirect,
  http_server::{
    hypermedia::notifications::{Notification, NotificationTemplate},
    ServerConfig, ServerState,
  },
  ups_daemon_state::UpsEntry,
  upsd_client::{client::UpsAuthClient, errors::NutClientErrors, ups_variables::UpsVariable},
};
use askama::Template;
use askama_axum::Response;
use axum::{
  extract::{Path, Query, State},
  http::StatusCode,
  response::Redirect,
  Form,
};
use axum_core::response::IntoResponse;
use serde::Deserialize;
use tracing::{error, info};

#[derive(Deserialize)]
pub struct UpsFragmentQuery {
  section: Option<String>,
}

#[derive(Deserialize)]
pub struct CommandRequest {
  command: String,
}

#[derive(Template)]
#[template(path = "ups/ups_status.html", ext = "html")]
struct UpsStatusTemplate {
  ups_status: Option<String>,
  beeper_status: Option<bool>,
}

impl Default for UpsStatusTemplate {
  fn default() -> Self {
    Self {
      beeper_status: None,
      ups_status: None,
    }
  }
}

impl From<&UpsEntry> for UpsStatusTemplate {
  fn from(entry: &UpsEntry) -> Self {
    let mut template = Self::default();

    for variable in entry.variables.iter() {
      match variable {
        UpsVariable::UpsBeeperStatus(beeper_status) => {
          template.beeper_status = match beeper_status.as_str() {
            "enabled" => Some(true),
            _ => Some(false),
          };
        }
        UpsVariable::UpsStatus(ups_status) => {
          template.ups_status = Some(ups_status.to_string());
        }
        _ => {}
      }
    }

    template
  }
}

#[derive(Template)]
#[template(path = "ups/ups_info.html", ext = "html", escape = "none")]
struct UpsInfoTemplate<'a> {
  title: &'a str,
  base_path: &'a str,
  battery_voltage: Option<f64>,
  charge: Option<f64>,
  charge_low: Option<f64>,
  desc: &'a str,
  input_voltage: Option<f64>,
  load: Option<f64>,
  name: &'a str,
  model: Option<&'a str>,
  mfr: Option<&'a str>,
  realpower: Option<f64>,
  realpower_nominal: Option<f64>,
  power: Option<f64>,
  power_nominal: Option<f64>,
  runtime: Option<f64>,
  variables: Vec<(&'a str, String)>,
  ups_status_template: UpsStatusTemplate,
  hx_status_interval: u64,
}

impl<'a> UpsInfoTemplate<'a> {
  pub fn from_ups_entry(ups: &'a UpsEntry, configs: &'a ServerConfig) -> Self {
    let variables: Vec<(&'a str, String)> = ups
      .variables
      .iter()
      .map(|e| (e.name(), e.value_as_string()))
      .collect();

    let mut template = Self {
      title: &ups.name,
      base_path: &configs.base_path,
      battery_voltage: None,
      charge: None,
      charge_low: None,
      desc: &ups.desc,
      input_voltage: None,
      load: None,
      name: &ups.name,
      model: None,
      mfr: None,
      realpower: None,
      realpower_nominal: None,
      power: None,
      power_nominal: None,
      runtime: None,
      variables,
      ups_status_template: UpsStatusTemplate::default(),
      hx_status_interval: configs.poll_interval.as_secs(),
    };

    for variable in ups.variables.iter() {
      match variable {
        UpsVariable::UpsLoad(val) => {
          template.load = Some(*val);
        }
        UpsVariable::UpsRealPowerNominal(val) => {
          template.realpower_nominal = Some(*val);
        }
        UpsVariable::UpsRealPower(val) => {
          template.realpower = Some(*val);
        }
        UpsVariable::UpsPower(val) => {
          template.power = Some(*val);
        }
        UpsVariable::UpsPowerNominal(val) => {
          template.power_nominal = Some(*val);
        }
        UpsVariable::BatteryCharge(val) => {
          template.charge = Some(*val);
        }
        UpsVariable::BatteryChargeLow(val) => {
          template.charge_low = Some(*val);
        }
        UpsVariable::BatteryRuntime(val) => {
          template.runtime = Some(*val);
        }
        UpsVariable::UpsStatus(val) => {
          template.ups_status_template.ups_status = Some(val.to_string());
        }
        UpsVariable::BatteryVoltage(val) => {
          template.battery_voltage = Some(*val);
        }
        UpsVariable::InputVoltage(val) => {
          template.input_voltage = Some(*val);
        }
        UpsVariable::UpsMfr(val) => {
          template.mfr = Some(val);
        }
        UpsVariable::UpsModel(val) => {
          template.model = Some(val);
        }
        UpsVariable::UpsBeeperStatus(val) => {
          template.ups_status_template.beeper_status = match val.as_str() {
            "enabled" => Some(true),
            _ => Some(false),
          };
        }
        _ => {}
      }
    }

    // If power is none, calculate power by using power_nominal and load values.
    if let Self {
      power_nominal: Some(pw),
      load: Some(ld),
      power: None,
      ..
    } = template
    {
      template.power = Some((pw * ld) / 100.0_f64);
    };

    if let Self {
      realpower_nominal: Some(pw),
      load: Some(ld),
      realpower: None,
      ..
    } = template
    {
      template.realpower = Some((pw * ld) / 100.0_f64);
    };

    template
  }
}

// TODO: Switch to block fragments when askama v0.13 released
#[derive(Template)]
#[template(path = "ups/+page.html", ext = "html", escape = "none")]
struct UpsPageTemplate<'a> {
  title: &'a str,
  base_path: &'a str,
  ups_info: UpsInfoTemplate<'a>,
  commands: &'a [Box<str>],
  hx_info_interval: u64,
}

#[inline]
fn page_response(entry: Option<&UpsEntry>, configs: &ServerConfig) -> Response {
  if let Some(ups) = entry {
    UpsPageTemplate {
      base_path: &configs.base_path,
      commands: &ups.commands,
      hx_info_interval: configs.poll_freq.as_secs(),
      title: &ups.name,
      ups_info: UpsInfoTemplate::from_ups_entry(ups, configs),
    }
    .into_response()
  } else {
    Redirect::permanent(&format!("{}/not-found", configs.base_path)).into_response()
  }
}

#[inline]
fn partial_ups_info(entry: Option<&UpsEntry>, configs: &ServerConfig) -> Response {
  if let Some(ups) = entry {
    UpsInfoTemplate::from_ups_entry(ups, configs).into_response()
  } else {
    htmx_redirect!(
      StatusCode::NOT_FOUND,
      format!("{}/not-found", configs.base_path)
    )
    .into_response()
  }
}

#[inline]
fn partial_ups_status(entry: Option<&UpsEntry>, configs: &ServerConfig) -> Response {
  if let Some(ups) = entry {
    UpsStatusTemplate::from(ups).into_response()
  } else {
    htmx_redirect!(
      StatusCode::NOT_FOUND,
      format!("{}/not-found", configs.base_path)
    )
    .into_response()
  }
}

pub async fn get(
  Path(ups_name): Path<String>,
  query: Query<UpsFragmentQuery>,
  state: State<ServerState>,
) -> Response {
  let upsd_state = state.upsd_state.read().await;
  let ups_entry = upsd_state.get_ups(&ups_name);

  match query.section.as_deref() {
    Some("info") => partial_ups_info(ups_entry, &state.configs),
    Some("status") => partial_ups_status(ups_entry, &state.configs),
    _ => page_response(ups_entry, &state.configs),
  }
}

pub async fn post_command(
  State(state): State<ServerState>,
  Path(ups_name): Path<String>,
  Form(request): Form<CommandRequest>,
) -> Response {
  let template: NotificationTemplate = {
    if let (Some(user), Some(pass)) = (&state.configs.user, &state.configs.pass) {
      match {
        let addr: &str = &state.configs.addr;
        let ups_name: &str = &ups_name;
        let cmd: &str = &request.command;

        async move {
          let mut client = UpsAuthClient::create(addr, user, pass).await?;
          client.send_instcmd(ups_name, cmd).await?;
          info!("INSTCMD '{0}' called for UPS '{1}'", cmd, ups_name);
          Ok::<(), NutClientErrors>(())
        }
      }
      .await
      {
        Ok(_) => NotificationTemplate::new(
          format!(
            "Command '{0}' successfully executed for UPS '{1}'.",
            &request.command, &ups_name
          ),
          Notification::Success,
          None,
        ),
        Err(err) => {
          error!(message = "INSTCMD call failed.", ups_name = ups_name, reason = %err);

          NotificationTemplate::new(
            format!("INSTCMD call failed, {:?}", err),
            Notification::Error,
            None,
          )
        }
      }
    } else {
      NotificationTemplate::new(
        "No username or password configured for UPS daemon. Server is in read-only mode.".into(),
        Notification::Info,
        None,
      )
    }
  };

  template.into_response()
}



================================================
FILE: server/src/http_server/hypermedia/templates/+layout.html
================================================
{%- import "icons.html" as icons -%}
<!doctype html>
<html lang="en" data-theme="dark">
  <head>
    <meta charset="UTF-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
    <title>NUT Web - {{ title }}</title>
    <link href="{{base_path}}/static/style.css" rel="preload" as="style" />
    <link href="{{base_path}}/static/index.js" rel="preload" as="script" />
    <link href="{{base_path}}/static/style.css" rel="stylesheet" />
    <link rel="icon" href="{{base_path}}/static/icon.svg" />
    <script>
      "use strict";
      var o=window.matchMedia("(prefers-color-scheme: dark)");
      var t=localStorage.getItem("app_theme")||(o&&o.matches&&"dark")||"light";
      if(t){document.documentElement.setAttribute("data-theme",t)}
    </script>
  <script src="{{base_path}}/static/index.js" defer></script>
    {% block head %}{% endblock head %}
  </head>

  <body class="min-h-screen flex flex-col justify-between">
    <header>
      <div class="navbar bg-base-100">
        <div class="flex-1">
          <a class="btn btn-ghost text-xl drop-shadow" href="{{base_path}}/">
            <img width="32" height="32" src="{{base_path}}/static/icon.svg" alt="icon" />
            <span class="hidden sm:inline-block"> NUT Web Monitor </span>
          </a>
        </div>
        <div class="flex-none gap-2">
          <div id="indicator" class="cursor-default htmx-indicator">
            <div
              class="tooltip tooltip-bottom text-success"
              data-tip="Updating page"
            >
              <span
                class="text-info loading loading-spinner loading-md cursor-default"
              ></span>
            </div>
          </div>
          <div class="dropdown dropdown-end">
            <div tabindex="0" role="button" class="btn m-1">
              {% call icons::get_svg("menu", 24) %}
              <span>Themes</span>
            </div>
            <ul
              tabindex="0"
              class="dropdown-content z-[1] p-2 shadow-2xl bg-base-300 rounded-box w-52"
            >
              <li>
                <theme-selector
                  theme-key="light"
                  class="btn btn-sm btn-block btn-ghost justify-start"
                  aria-label="Light">Light</theme-selector>
              </li>
              <li>
                <theme-selector
                  theme-key="dark"
                  class="btn btn-sm btn-block btn-ghost justify-start"
                  aria-label="Dark">Dark</theme-selector>
              </li>
              <li><div class="divider mb-0.5 mt-0.5"></div></li>
              <li>
                <theme-selector
                  theme-key="autumn"
                  class="btn btn-sm btn-block btn-ghost justify-start"
                  aria-label="Autumn">Autumn</theme-selector>
              </li>
              <li>
                <theme-selector
                  theme-key="business"
                  class="btn btn-sm btn-block btn-ghost justify-start"
                  aria-label="Business">Business</theme-selector>
              </li>
              <li>
                <theme-selector
                  theme-key="cmyk"
                  class="btn btn-sm btn-block btn-ghost justify-start"
                  aria-label="Cmyk">Cmyk</theme-selector>
              </li>
              <li>
                <theme-selector
                  theme-key="corporate"
                  class="btn btn-sm btn-block btn-ghost justify-start"
                  aria-label="Corporate">Corporate</theme-selector>
              </li>
              <li>
                <theme-selector
                  theme-key="cupcake"
                  class="btn btn-sm btn-block btn-ghost justify-start"
                  aria-label="Cupcake">Cupcake</theme-selector>
              </li>
              <li>
                <theme-selector
                  theme-key="dim"
                  class="btn btn-sm btn-block btn-ghost justify-start"
                  aria-label="Dim">Dim</theme-selector>
              </li>
              <li>
                <theme-selector
                  theme-key="dracula"
                  class="btn btn-sm btn-block btn-ghost justify-start"
                  aria-label="Dracula">Dracula</theme-selector>
              </li>
              <li>
                <theme-selector
                  theme-key="emerald"
                  class="btn btn-sm btn-block btn-ghost justify-start"
                  aria-label="Emerald">Emerald</theme-selector>
              </li>
              <li>
                <theme-selector
                  theme-key="fantasy"
                  class="btn btn-sm btn-block btn-ghost justify-start"
                  aria-label="Fantasy">Fantasy</theme-selector>
              </li>
              <li>
                <theme-selector
                  theme-key="forest"
                  class="btn btn-sm btn-block btn-ghost justify-start"
                  aria-label="Forest">Forest</theme-selector>
              </li>
              <li>
                <theme-selector
                  theme-key="halloween"
                  class="btn btn-sm btn-block btn-ghost justify-start"
                  aria-label="Halloween">Halloween</theme-selector>
              </li>
              <li>
                <theme-selector
                  theme-key="night"
                  class="btn btn-sm btn-block btn-ghost justify-start"
                  aria-label="Night">Night</theme-selector>
              </li>
              <li>
                <theme-selector
                  theme-key="nord"
                  class="btn btn-sm btn-block btn-ghost justify-start"
                  aria-label="Nord">Nord</theme-selector>
              </li>
              <li>
                <theme-selector
                  theme-key="sunset"
                  class="btn btn-sm btn-block btn-ghost justify-start"
                  aria-label="Sunset">Sunset</theme-selector>
              </li>
              <li>
                <theme-selector
                  theme-key="synthwave"
                  class="btn btn-sm btn-block btn-ghost justify-start"
                  aria-label="Synthwave">Synthwave</theme-selector>
              </li>
              <li>
                <theme-selector
                  theme-key="winter"
                  class="btn btn-sm btn-block btn-ghost justify-start"
                  aria-label="Winter">Winter</theme-selector>
              </li>
            </ul>
          </div>
        </div>
      </div>
    </header>
    <div
      id="notifications"
      class="toast toast-end toast-bottom z-50 w-[200px] max-w-[200px]"
    ></div>
    <div id="page_content" class="flex-grow">
      {% block content %} {% endblock content %}
    </div>
    <footer
      class="flex flex-row justify-between footer footer-center bg-base-300 text-base-content p-3 text-xs font-light"
    >
      {% let app_info = crate::http_server::hypermedia::utils::get_app_info() %}
      <a
        class="link"
        href="https://github.com/SuperioOne/nut_webgui/releases/tag/v{{app_info.version}}"
      >
        <span>Version: {{app_info.version}}</span>
      </a>
      <div>
      <div class="htmx-send-error-indicator">
        <p class="flex flex-row gap-2">
          <span> {% call icons::get_svg("wifi-off", 16) %}</span>
          <span> Server connection lost </span>
        </p>
      </div>
    </footer>
  </body>
</html>



================================================
FILE: server/src/http_server/hypermedia/templates/+page.html
================================================
{% extends "+layout.html" %}
{% block content %}
  <div class="w-full flex flex-row justify-center p-1 sm:p-10 md:p-16">
    <div  class="card bg-base-200 text-neutral-content w-full max-w-7xl p-3">
      <div
        hx-ext="morph"
        hx-get="{{base_path}}/?section=ups_table"
        hx-trigger="every 15s"
        hx-swap="morph:innerHTML"
        hx-indicator="#indicator"
        class="overflow-x-auto"
      >
        {{ups_table}}
      </div>
    </div>
  </div>
{% endblock content %}



================================================
FILE: server/src/http_server/hypermedia/templates/icons.html
================================================
{# Macro for inserting Feather Icons: https://feathericons.com/ #}

{% macro get_svg(name, size) %}

{% if name == "menu" %}
<svg xmlns="http://www.w3.org/2000/svg" width="{{size}}" height="{{size}}"viewBox="0 0 24 24" fill="none" stroke="currentColor"
  stroke-width="2" stroke-linecap="round" stroke-linejoin="round" >
  <line x1="3" y1="12" x2="21" y2="12"></line>
  <line x1="3" y1="6" x2="21" y2="6"></line>
  <line x1="3" y1="18" x2="21" y2="18"></line>
</svg>

{% else if name == "alert-circle" %}
<svg xmlns="http://www.w3.org/2000/svg" width="{{size}}" height="{{size}}" viewBox="0 0 24 24" fill="none" stroke="currentColor"
  stroke-width="2" stroke-linecap="round" stroke-linejoin="round" >
  <circle cx="12" cy="12" r="10">
  </circle>
  <line x1="12" y1="8" x2="12" y2="12">
  </line>
  <line x1="12" y1="16" x2="12.01" y2="16">
  </line>
</svg>

{% else if name == "activity" %}
<svg xmlns="http://www.w3.org/2000/svg" width="{{size}}" height="{{size}}" viewBox="0 0 24 24" fill="none" stroke="currentColor"
  stroke-width="2" stroke-linecap="round" stroke-linejoin="round" >
  <polyline points="22 12 18 12 15 21 9 3 6 12 2 12"></polyline>
</svg>

{% else if name == "battery-charging" %}
<svg xmlns="http://www.w3.org/2000/svg" width="{{size}}" height="{{size}}" viewBox="0 0 24 24" fill="none" stroke="currentColor"
  stroke-width="2" stroke-linecap="round" stroke-linejoin="round" >
  <path d="M5 18H3a2 2 0 0 1-2-2V8a2 2 0 0 1 2-2h3.19M15 6h2a2 2 0 0 1 2 2v8a2 2 0 0 1-2 2h-3.19"></path>
  <line x1="23" y1="13" x2="23" y2="11"></line>
  <polyline points="11 6 7 12 13 12 9 18"></polyline>
</svg>

{% else if name == "battery" %}
<svg viewBox="0 0 24 24" width="{{size}}" height="{{size}}" stroke="currentColor" stroke-width="2" fill="none" stroke-linecap="round" stroke-linejoin="round">
  <rect x="1" y="6" width="18" height="12" rx="2" ry="2"> </rect>
  <line x1="23" y1="13" x2="23" y2="11"></line>
</svg>

{% else if name == "check-circle" %}
<svg xmlns="http://www.w3.org/2000/svg" width="{{size}}" height="{{size}}" viewBox="0 0 24 24" fill="none" stroke="currentColor"
  stroke-width="2" stroke-linecap="round" stroke-linejoin="round" >
  <path d="M22 11.08V12a10 10 0 1 1-5.93-9.14"></path>
  <polyline points="22 4 12 14.01 9 11.01"></polyline>
</svg>

{% else if name == "info" %}
<svg xmlns="http://www.w3.org/2000/svg" width="{{size}}" height="{{size}}" viewBox="0 0 24 24" fill="none" stroke="currentColor"
  stroke-width="2" stroke-linecap="round" stroke-linejoin="round" >
  <circle cx="12" cy="12" r="10"></circle>
  <line x1="12" y1="16" x2="12" y2="12"></line>
  <line x1="12" y1="8" x2="12.01" y2="8"></line>
</svg>

{% else if name == "loader" %}
<svg xmlns="http://www.w3.org/2000/svg" width="{{size}}" height="{{size}}" viewBox="0 0 24 24" fill="none" stroke="currentColor"
  stroke-width="2" stroke-linecap="round" stroke-linejoin="round" >
  <line x1="12" y1="2" x2="12" y2="6"></line>
  <line x1="12" y1="18" x2="12" y2="22"></line>
  <line x1="4.93" y1="4.93" x2="7.76" y2="7.76"></line>
  <line x1="16.24" y1="16.24" x2="19.07" y2="19.07"></line>
  <line x1="2" y1="12" x2="6" y2="12"></line>
  <line x1="18" y1="12" x2="22" y2="12"></line>
  <line x1="4.93" y1="19.07" x2="7.76" y2="16.24"></line>
  <line x1="16.24" y1="7.76" x2="19.07" y2="4.93"></line>
</svg>

{% else if name == "minimize-2" %}
<svg xmlns="http://www.w3.org/2000/svg" width="{{size}}" height="{{size}}" viewBox="0 0 24 24" fill="none" stroke="currentColor"
  stroke-width="2" stroke-linecap="round" stroke-linejoin="round" >
  <polyline points="4 14 10 14 10 20"></polyline>
  <polyline points="20 10 14 10 14 4"></polyline>
  <line x1="14" y1="10" x2="21" y2="3"></line>
  <line x1="3" y1="21" x2="10" y2="14"></line>
</svg>

{% else if name == "maximize-2" %}
<svg xmlns="http://www.w3.org/2000/svg" width="{{size}}" height="{{size}}" viewBox="0 0 24 24" fill="none" stroke="currentColor"
  stroke-width="2" stroke-linecap="round" stroke-linejoin="round" >
  <polyline points="15 3 21 3 21 9"></polyline>
  <polyline points="9 21 3 21 3 15"></polyline>
  <line x1="21" y1="3" x2="14" y2="10"></line>
  <line x1="3" y1="21" x2="10" y2="14"></line>
</svg>

{% else if name == "play" %}
<svg xmlns="http://www.w3.org/2000/svg" width="{{size}}" height="{{size}}" viewBox="0 0 24 24" fill="none" stroke="currentColor"
  stroke-width="2" stroke-linecap="round" stroke-linejoin="round" >
  <polygon points="5 3 19 12 5 21 5 3"></polygon>
</svg>

{% else if name == "volume-2" %}
<svg xmlns="http://www.w3.org/2000/svg" width="{{size}}" height="{{size}}" viewBox="0 0 24 24" fill="none" stroke="currentColor"
  stroke-width="2" stroke-linecap="round" stroke-linejoin="round" >
  <polygon points="11 5 6 9 2 9 2 15 6 15 11 19 11 5"></polygon>
  <path d="M19.07 4.93a10 10 0 0 1 0 14.14M15.54 8.46a5 5 0 0 1 0 7.07"></path>
</svg>

{% else if name == "volume-x" %}
<svg xmlns="http://www.w3.org/2000/svg" width="{{size}}" height="{{size}}" viewBox="0 0 24 24" fill="none" stroke="currentColor"
  stroke-width="2" stroke-linecap="round" stroke-linejoin="round" >
  <polygon points="11 5 6 9 2 9 2 15 6 15 11 19 11 5"></polygon>
  <line x1="23" y1="9" x2="17" y2="15"></line>
  <line x1="17" y1="9" x2="23" y2="15"></line>
</svg>

{% else if name == "power" %}
<svg viewBox="0 0 24 24" width="{{size}}" height="{{size}}" stroke="currentColor" stroke-width="2" fill="none" stroke-linecap="round" stroke-linejoin="round" >
  <path d="M18.36 6.64a9 9 0 1 1-12.73 0"></path>
  <line x1="12" y1="2" x2="12" y2="12"></line>
</svg>

{% else if name == "tool" %}
<svg viewBox="0 0 24 24" width="{{size}}" height="{{size}}" stroke="currentColor" stroke-width="2" fill="none" stroke-linecap="round" stroke-linejoin="round">
  <path d="M14.7 6.3a1 1 0 0 0 0 1.4l1.6 1.6a1 1 0 0 0 1.4 0l3.77-3.77a6 6 0 0 1-7.94 7.94l-6.91 6.91a2.12 2.12 0 0 1-3-3l6.91-6.91a6 6 0 0 1 7.94-7.94l-3.76 3.76z"></path>
</svg>

{% else if name == "zap" %}
<svg xmlns="http://www.w3.org/2000/svg" width="{{size}}" height="{{size}}" viewBox="0 0 24 24" fill="none" stroke="currentColor"
  stroke-width="2" stroke-linecap="round" stroke-linejoin="round" >
  <polygon points="13 2 3 14 12 14 11 22 21 10 12 10 13 2"></polygon>
</svg>

{% else if name == "zap-off" %}
<svg xmlns="http://www.w3.org/2000/svg" width="{{size}}" height="{{size}}" viewBox="0 0 24 24" fill="none" stroke="currentColor"
  stroke-width="2" stroke-linecap="round" stroke-linejoin="round" >
  <polyline points="12.41 6.75 13 2 10.57 4.92"></polyline>
  <polyline points="18.57 12.91 21 10 15.66 10"></polyline>
  <polyline points="8 8 3 14 12 14 11 22 16 16"></polyline>
  <line x1="1" y1="1" x2="23" y2="23"></line>
</svg>

{% else if name == "wifi-off" %}
<svg viewBox="0 0 24 24" width="{{size}}" height="{{size}}" stroke="currentColor" stroke-width="2" fill="none" stroke-linecap="round" stroke-linejoin="round">
  <line x1="1" y1="1" x2="23" y2="23"></line>
  <path d="M16.72 11.06A10.94 10.94 0 0 1 19 12.55"></path>
  <path d="M5 12.55a10.94 10.94 0 0 1 5.17-2.39"></path>
  <path d="M10.71 5.05A16 16 0 0 1 22.58 9"></path>
  <path d="M1.42 9a15.91 15.91 0 0 1 4.7-2.88"></path>
  <path d="M8.53 16.11a6 6 0 0 1 6.95 0"></path>
  <line x1="12" y1="20" x2="12.01" y2="20"></line>
</svg>

{% else %}
<span></span>

{% endif %}
{% endmacro %}



================================================
FILE: server/src/http_server/hypermedia/templates/notification.html
================================================
<div id="notifications" hx-swap-oob="afterbegin">
  <nut-notification class="!grid-cols-none drop-shadow-lg" type="{{notification_type}}" ttl="{{ttl}}">
    <div class="flex flex-col gap-3 px-2 text-{{notification_type}}-content w-full">
      <div class="flex flex-row justify-between items-center w-full">
        <span class="font-bold uppercase">
          {{notification_type}}
        </span>
        <div class="nut-notification-trigger">
          <button class="btn btn-xs btn-ghost btn-circle">
            x
          </button>
        </div>
      </div>
      <div class="w-full">
        {{message}}
      </div>
    </div>
  </nut-notification>
</div>



================================================
FILE: server/src/http_server/hypermedia/templates/ups_table.html
================================================
<table id="ups_table" class="table table-fixed text-base-content">
  <thead>
    <tr>
      <th class="font-black">Name</th>
      <th class="hidden sm:table-cell font-black">Description</th>
      <th class="font-black w-auto sm:w-36">Status</th>
      <th class="font-black">Battery</th>
      <th class="hidden sm:table-cell font-black">Load</th>
      <th class="hidden sm:table-cell font-black w-32"></th>
    </tr>
  </thead>
  <tbody>
    {% if ups_list.len() < 1 %}
      <tr>
        <td class="text-center py-6" colspan="6">
          No UPS available.
        </td>
      </tr>
    {% else %}

      {% for row in ups_list %}
        <tr class="break-all">
          <td>
            <a class="link font-bold text-primary" href="{{base_path}}/ups/{{row.name}}">
              {{row.name}}
            </a>
          </td>
          <td class="hidden sm:table-cell">
            <span class="font-light text-base-content">{{row.desc}}</span>
          </td>
          <td class="w-auto sm:w-36">
            {% if let Some(status) = row.status %}
              {% if let Some(status_class) = crate::http_server::hypermedia::utils::get_status_class(status) %}
                  <span class="text-{{status_class}} uppercase font-black">{{status}}</span>
              {% else %}
                  <span class="uppercase font-black">{{status}}</span>
              {% endif %}
            {% endif %}
          </td>
          <td>
            {% if let Some(charge) = row.charge %}
              {% let battery_level_class = crate::http_server::hypermedia::utils::get_range_class(charge, 60.0, 10.0) %}
              <div>
                <progress class="progress progress-{{battery_level_class}} w-full" value="{{charge}}" max="100"></progress>
              </div>
              <div class="text-center w-full text-primary">{{charge}}%</div>
            {% else %}
              <p class="text-center font-bold">
                N/A
              </p>
            {% endif %}
          </td>
          <td class="hidden sm:table-cell">
            {% if let Some(load) = row.load %}
              {% let load_level_class = crate::http_server::hypermedia::utils::get_range_class(load, 50.0, 75.0) %}
              <div>
                <progress class="progress progress-{{load_level_class}} w-full" value="{{load}}" max="100"></progress>
              </div>
              <div class="text-center w-full text-primary">{{load}}%</div>
            {% else %}
              <p class="text-center font-bold">
                N/A
              </p>
            {% endif %}
          </td>
          <td class="hidden sm:table-cell w-32">
            <a role="button" href="{{base_path}}/ups/{{row.name}}" class="btn btn-sm btn-outline">Details</a>
          </td>
        </tr>
      {% endfor %}
    {% endif %}
  </tbody>
</table>



================================================
FILE: server/src/http_server/hypermedia/templates/not_found/+page.html
================================================
{% extends "../+layout.html" %}
{% block content %}
<div class="flex flex-row w-full h-[600px] justify-center items-center">
  <div class="text-3xl">
    <span class="font-black">404</span> Content not found.
  </div>
</div>
{% endblock %}


================================================
FILE: server/src/http_server/hypermedia/templates/ups/+page.html
================================================
{% extends "../+layout.html" %}
{%- import "icons.html" as icons -%}

{% block content %}
  <div class="w-full flex flex-row justify-center sm:p-10 md:p-12">
    <div class="text-base-content w-full max-w-7xl p-3 flex flex-col gap-6">
      <div
        class="flex flex-col gap-6"
        hx-ext="morph"
        hx-get="{{base_path}}/ups/{{title}}?section=info"
        hx-indicator="#indicator"
        hx-swap="morph:innerHTML"
        hx-trigger="every {{hx_info_interval}}s"
      >
        {{ups_info}}
      </div>

      {% if commands.len() > 0 %}
        <details class="collapse collapse-arrow bg-base-200">
          <summary class="collapse-title text-xl font-black">UPS Commands</summary>
          <div class="collapse-content p-3">
            <ul class="flex flex-col [&>li]:border-b-2 [&>li]:border-neutral-content/10 [&>li]:p-3 last:border-none">
              {% for row in commands %}
                <li class="last:border-none hover:bg-base-100 box-border">
                  <div class="flex flex-row justify-between">
                    <div class="break-all">
                      {{row}}
                    </div>
                    <button
                      class="btn btn-outline btn-primary"
                      hx-post="{{base_path}}/ups/{{title}}/command"
                      hx-swap="none"
                      hx-trigger="command-confirmed"
                      name="command"
                      value="{{row}}"
                      onClick="ConfirmationModal.create({
                        cancelText: 'Cancel',
                        confirmText: 'Run',
                        message: 'Are you sure about the run the \'' + '{{row}}' + '\' command?',
                        title: 'Command Confirmation'
                      }).then((is_confirmed) => {
                        if (is_confirmed) {this.dispatchEvent(new CustomEvent('command-confirmed'));}
                      });"
                    >
                      {% call icons::get_svg("play", 24) %}
                      <span>Run</span>
                    </button>
                  </div>
                </li>
              {% endfor %}
            </ul>
          </div>
        </details>
      {% endif %}
    </div>
  </div>
{% endblock content %}



================================================
FILE: server/src/http_server/hypermedia/templates/ups/ups_info.html
================================================
{%- import "icons.html" as icons -%}

<div id="ups_info" class="flex flex-col gap-6">
  <div class="grid grid-cols-1 sm:grid-cols-2 gap-2 gap-y-2">
    <div
      class="flex flex-row flex-wrap gap-5 justify-between col-span-full bg-base-200 rounded-lg p-6"
      >
      <div>
        <h1 class="font-bold text-xl text-primary leading-8">{{name}}</h1>
        <p class="font-light text-secondary leading-6">
          {% if let Some(mfr) = mfr %}
              {{mfr}}
          {% endif %}
          {% if let Some(model) = model %}
             - {{model}}
          {% endif %}
        </p>
        <p class="font-light text-xs mt-2">{{desc}}</p>
      </div>
      <div
        id="ups_status"
        hx-ext="morph"
        hx-get="{{base_path}}/ups/{{title}}?section=status"
        hx-indicator="#indicator"
        hx-swap="morph:innerHTML"
        hx-trigger="every {{hx_status_interval}}s"
        >
          {{ups_status_template}}
      </div>
    </div>

    {% if let Some(load) = load %}
      <div class="flex flex-col gap-3 shadow bg-base-200 rounded-lg p-6">
        <div class="font-bold">Load</div>
        <div class="flex flex-row justify-center items-center">
          {% let load_level_class = crate::http_server::hypermedia::utils::get_range_class(load, 50.0, 75.0) %}
          <nut-gauge class="w-full fill-{{load_level_class}}" value="{{load}}"></nut-gauge>
        </div>

        <div class="flex-grow flex flex-col gap-3 justify-end">
          {% if let Some(realpower) = realpower %}
            <div class="font-bold text-sm">
              Estimated real power 
              <span class="text-primary">{{realpower}} Watt</span>
            </div>
          {% endif %}

          {% if let Some(realpower_nominal) = realpower_nominal %}
            <div class="font-bold text-sm">
              Nominal real power 
              <span class="text-primary">{{realpower_nominal}} Watt</span>
            </div>
          {% endif %}

          {% if let Some(power) = power %}
            <div class="font-bold text-sm">
              Estimated power 
              <span class="text-primary">{{power}} VA</span>
            </div>
          {% endif %}

          {% if let Some(power_nominal) = power_nominal %}
            <div class="font-bold text-sm">
              Nominal power 
              <span class="text-primary">
                {{power_nominal}} VA 
              </span>
            </div>
          {% endif %}

       </div>
      </div>
    {% endif %}

    {% if let Some(charge) = charge %}
      <div class="flex flex-col gap-3 shadow bg-base-200 rounded-lg p-6">
        <div class="font-bold">Battery</div>
        <div class="flex flex-row justify-center items-center">
          {% let battery_level_class = crate::http_server::hypermedia::utils::get_range_class(charge, 60.0, 10.0) %}
          <nut-gauge class="w-full fill-{{battery_level_class}}" value="{{charge}}"></nut-gauge>
        </div>
        <div class="flex-grow flex flex-col gap-3 justify-end">
          {% if let Some(runtime) = runtime %}
            <div class="font-bold text-sm">
              Remaining run time 
              <div class="tooltip tooltip-bottom" data-tip="{{runtime}} seconds">
                <nut-time-display class="text-primary" value="{{runtime}}"></nut-time-display>
              </div>
            </div>
          {% endif %}
          {% if let Some(charge_low) = charge_low %}
            <div class="font-bold text-sm">
              Shutdown threshold <span class="text-error">{{charge_low}}%</span>
            </div>
          {% endif %}
        </div>
      </div>
    {% endif %}

    {% if let Some(input_voltage) = input_voltage %}
      <div class="flex flex-col gap-3 shadow bg-base-200 rounded-lg p-6">
        <div class="font-bold">Input Voltage</div>
        <div class="flex-grow flex flex-row justify-center items-center">
          <p class="text-center text-7xl p-6">
            <span class="text-primary">{{input_voltage}}V</span>
          </p>
        </div>
      </div>
    {% endif %}

    {% if let Some(battery_voltage) = battery_voltage %}
      <div class="flex flex-col gap-3 shadow bg-base-200 rounded-lg p-6">
        <div class="font-bold">Battery Voltage</div>
        <div class="flex-grow flex flex-row justify-center items-center">
          <p class="text-center text-7xl p-6">
            <span class="text-primary">{{battery_voltage}}V</span>
          </p>
        </div>
      </div>
    {% endif %}
  </div>

  <details morph-preserve-attr="open" class="collapse collapse-arrow bg-base-200">
    <summary class="collapse-title text-xl font-black">UPS Variables</summary>
    <div class="collapse-content p-3">
      <table class="table">
        <tbody class="[&>tr]:border-b-2 [&>tr]:border-neutral-content/10 [&>tr:hover]:bg-base-100 last:border-none break-all">
          {% for row in variables %}
            <tr>
              <td>{{row.0}}</td>
              <td class="text-primary">{{row.1}}</td>
            </tr>
          {% endfor %}
        </tbody>
      </table>
    </div>
  </details>
</div>



================================================
FILE: server/src/http_server/hypermedia/templates/ups/ups_status.html
================================================
{%- import "icons.html" as icons -%}

{% if let Some(status) = ups_status %}
  <div class="font-bold text-xl text-center">
    <h1 class="leading-8">UPS Status</h1>
    {% let status_text = crate::http_server::hypermedia::utils::get_status_text(status) %}

    {% if let Some(status_class) = crate::http_server::hypermedia::utils::get_status_class(status) %}
      <p>
        <span class="text-{{status_class}}">{{status_text}}</span>
      </p>
    {% else %}
      <p class="text-primary leading-6">{{status_text}}</p>
    {% endif %}
  </div>

  <div class="mt-2 flex flex-row flex-wrap gap-2 justify-center w-full">
    {% match beeper_status %}
      {% when Some with (true) %}
        <div class="tooltip tooltip-bottom text-success" data-tip="Beeper enabled">
          {% call icons::get_svg("volume-2",20) %}
        </div>
      {% when Some with (false) %}
        <div class="tooltip tooltip-bottom text-warning" data-tip="Beeper disabled">
          {% call icons::get_svg("volume-x", 20) %}
        </div>
      {% when None %}
    {% endmatch %}

    {% for status_icon in crate::http_server::hypermedia::utils::get_status_icons(status) %}
      <div class="tooltip tooltip-bottom text-{{status_icon.class}}" data-tip="{{status_icon.desc}}">
        {% call icons::get_svg(status_icon.name, 20) %}
      </div>
    {% endfor %}
  </div>
{% endif %}



================================================
FILE: server/src/ups_services/upsd_poll_service.rs
================================================
use super::UpsVarDetail;
use crate::{
  ups_services::{UpsDetails, UpsUpdateMessage},
  upsd_client::{
    client::{Client, UpsClient},
    errors::NutClientErrors,
    ups_variables::{UpsVariable, VAR_UPS_STATUS},
  },
};
use std::{fmt::Display, io::ErrorKind, time::Duration};
use tokio::{
  net::ToSocketAddrs,
  select, spawn,
  sync::mpsc::Sender,
  task::JoinHandle,
  time::{interval, Instant, Interval, MissedTickBehavior},
};
use tokio_util::sync::CancellationToken;
use tracing::{debug, error, info, instrument, warn};

#[derive(Debug)]
pub struct UpsPollerConfig {
  pub address: String,
  pub write_channel: Sender<UpsUpdateMessage>,
  pub poll_freq: Duration,
  pub poll_interval: Duration,
  pub cancellation: CancellationToken,
}

#[derive(Debug)]
enum PollServiceError {
  ClientError(NutClientErrors),
  ChannelError,
}

impl Display for PollServiceError {
  fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
    let message = match self {
      PollServiceError::ClientError(nut_client_errors) => &nut_client_errors.to_string(),
      PollServiceError::ChannelError => "Internal mpsc channel failed.",
    };

    f.write_str(message)
  }
}

impl From<NutClientErrors> for PollServiceError {
  fn from(value: NutClientErrors) -> Self {
    PollServiceError::ClientError(value)
  }
}

struct UpsPollInterval {
  interval: Interval,
  last_full_sync: Option<Instant>,
  full_sync_period: Duration,
}

#[derive(Debug, Clone, Copy)]
enum UpsPollType {
  Full,
  Partial,
}

impl Display for UpsPollType {
  fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
    match self {
      UpsPollType::Full => f.write_str("Full"),
      UpsPollType::Partial => f.write_str("Partial"),
    }
  }
}

impl UpsPollInterval {
  pub fn new(poll_interval: Duration, poll_freq: Duration) -> Self {
    let mut interval = interval(poll_interval);
    interval.set_missed_tick_behavior(MissedTickBehavior::Skip);

    Self {
      interval,
      last_full_sync: None,
      full_sync_period: poll_freq,
    }
  }

  #[inline]
  pub async fn tick(&mut self) -> UpsPollType {
    let instant = self.interval.tick().await;

    match self.last_full_sync {
      Some(last_sync) => {
        if instant.duration_since(last_sync) >= self.full_sync_period {
          self.last_full_sync = Some(instant);
          UpsPollType::Full
        } else {
          UpsPollType::Partial
        }
      }
      None => {
        self.last_full_sync = Some(instant);
        UpsPollType::Full
      }
    }
  }

  /// Resets internal tracker for full sync
  pub fn schedule_full_sync(&mut self) {
    self.last_full_sync = None;
  }
}

#[instrument(name = "upsd_poll_service")]
pub fn upsd_poll_service(config: UpsPollerConfig) -> JoinHandle<()> {
  spawn(async move {
    let UpsPollerConfig {
      address,
      poll_freq,
      poll_interval,
      write_channel,
      cancellation,
    } = config;

    // Thread local, lock free working device name list to orchestrate `poll_ups_partial`.
    let mut devices: Vec<Box<str>> = Vec::new();
    let mut should_reconnect = false;
    let mut client = UpsClient::create(&address)
      .await
      .expect("Cannot connect to the UPS daemon service.");

    info!(
      message = "Connected to UPS daemon service.",
      address = &address
    );

    let mut poll_scheduler = UpsPollInterval::new(poll_interval, poll_freq);

    'MAIN_LOOP: while !cancellation.is_cancelled() {
      // wait for next tick or cancellation (SIGINT)
      let poll_type = select! {
        _ = cancellation.cancelled() => {
          break 'MAIN_LOOP;
        }
        poll_type = poll_scheduler.tick() => {
          poll_type
        }
      };

      let update_result = match poll_type {
        UpsPollType::Full => poll_ups_full(&mut devices, &mut client, &write_channel).await,
        UpsPollType::Partial => poll_ups_partial(&mut devices, &mut client, &write_channel).await,
      };

      match update_result {
        Err(PollServiceError::ClientError(NutClientErrors::IOError { kind })) => match kind {
          ErrorKind::WouldBlock => {}
          ErrorKind::PermissionDenied => {
            error!("TCP connection permission denied.");
            panic!("Client cannot create TCP stream.");
          }
          ErrorKind::AddrNotAvailable => {
            error!(
              message = "Configured address does not exists or unreachable.",
              address = address
            );

            panic!("Client cannot create TCP stream.");
          }
          error_kind => {
            warn!(
              message = "Client connection failed with an error.",
              error_kind = %error_kind
            );

            mark_as_dead(&write_channel).await;
            should_reconnect = true;
            poll_scheduler.schedule_full_sync();
          }
        },
        Err(PollServiceError::ChannelError) => {
          info!("Sending updates to channel failed, receiver channel is disconnected.");
        }
        Err(err) => {
          error!(
            message = "Poll service error occurred.",
            reason = %err
          );

          mark_as_dead(&write_channel).await;
          poll_scheduler.schedule_full_sync();
        }
        Ok(()) => {
          debug!(
            message = "Poll interval completed.",
            poll_type = %poll_type
          );
        }
      };

      if should_reconnect && !cancellation.is_cancelled() {
        should_reconnect = false;
        poll_scheduler.schedule_full_sync();

        if let Err(err) = client.reconnect().await {
          // Log connection issue without panicking since it might be temporary connection issue.
          error!(message = "UPS daemon re-connection attempt failed.", reason = %err);
        } else {
          info!("Reconnected to the UPS daemon service.");
        }
      }
    }

    if let Err(err) = client.close().await {
      error!(message = "NUT Client shutdown failed.", reason = %err);
    }

    drop(write_channel);
    info!("Upsd poll service shutdown.");
  })
}

#[inline]
async fn poll_ups_full<A>(
  devices: &mut Vec<Box<str>>,
  client: &mut UpsClient<A>,
  channel: &Sender<UpsUpdateMessage>,
) -> Result<(), PollServiceError>
where
  A: ToSocketAddrs,
{
  debug!("Refreshing the all available Ups devices.");
  let ups_list = client.get_ups_list().await?;
  let mut data: Vec<UpsDetails> = Vec::with_capacity(ups_list.len());
  let mut override_devices = false;

  for ups in ups_list.into_iter() {
    let ups_details: Result<(Vec<Box<str>>, Vec<UpsVariable>), NutClientErrors> = {
      async {
        let commands = client.get_cmd_list(&ups.name).await?;
        let variables = client.get_var_list(&ups.name).await?;

        Ok((commands, variables))
      }
    }
    .await;

    match ups_details {
      Ok((commands, variables)) => {
        let details = UpsDetails {
          commands,
          desc: ups.desc,
          name: ups.name,
          variables,
        };

        debug!(message = "UPS info received.", ups_name = &details.name);

        data.push(details);
      }
      Err(err) => {
        override_devices = true;

        error!(
          message = "UPS is listed by daemon, but unable to get UPS details.",
          ups_name = &ups.name,
          reason = %err
        );
      }
    };
  }

  if override_devices || devices.is_empty() {
    *devices = data.iter().map(|ups| ups.name.clone()).collect();
  }

  channel
    .send(UpsUpdateMessage::FullUpdate { data })
    .await
    .map_err(|_| PollServiceError::ChannelError)?;

  debug!(message = "UPS full update queued.");

  Ok(())
}

#[inline]
async fn poll_ups_partial<A>(
  devices: &mut Vec<Box<str>>,
  client: &mut UpsClient<A>,
  channel: &Sender<UpsUpdateMessage>,
) -> Result<(), PollServiceError>
where
  A: ToSocketAddrs,
{
  let mut data: Vec<UpsVarDetail> = Vec::new();
  let mut override_devices = false;

  for ups in devices.iter() {
    match client.get_var(ups, VAR_UPS_STATUS).await {
      Ok(ups_status) => {
        let detail = UpsVarDetail {
          name: ups.clone(),
          variable: ups_status,
        };

        data.push(detail);

        debug!(message = "Ups status update queued.", ups_name = &ups);
      }
      Err(err) => {
        override_devices = true;

        error!(
          message =
            "Unable to get UPS status info. Deferring status update until the next full sync.",
          ups_name = &ups,
          reason = %err
        );
      }
    };
  }

  if override_devices {
    *devices = data.iter().map(|ups| ups.name.clone()).collect();
  }

  channel
    .send(UpsUpdateMessage::PartialUpdate { data })
    .await
    .map_err(|_| PollServiceError::ChannelError)?;

  Ok(())
}

#[inline]
async fn mark_as_dead(channel: &Sender<UpsUpdateMessage>) {
  if let Err(_) = channel.send(UpsUpdateMessage::MarkAsDead).await {
    warn!("Unable to mark daemon state as dead. Message channel is closed.");
  }
}



================================================
FILE: server/src/ups_services/upsd_state_service.rs
================================================
use crate::{
  ups_daemon_state::{DaemonStatus, UpsDaemonState, UpsEntry},
  ups_services::UpsUpdateMessage,
  upsd_client::ups_variables::UpsVariable,
};
use chrono::Utc;
use std::{collections::HashMap, sync::Arc};
use tokio::{
  spawn,
  sync::{mpsc::Receiver, RwLock},
  task::JoinHandle,
};
use tokio_util::sync::CancellationToken;
use tracing::{info, instrument, warn};

#[derive(Debug)]
pub struct UpsStorageConfig {
  pub read_channel: Receiver<UpsUpdateMessage>,
  pub cancellation: CancellationToken,
  pub upsd_state: Arc<RwLock<UpsDaemonState>>,
}

#[instrument(name = "upsd_state_service")]
pub fn upsd_state_service(config: UpsStorageConfig) -> JoinHandle<()> {
  spawn(async move {
    let UpsStorageConfig {
      upsd_state,
      mut read_channel,
      cancellation,
    } = config;

    while !cancellation.is_cancelled() {
      match read_channel.recv().await {
        Some(UpsUpdateMessage::PartialUpdate { data }) => {
          let mut state = upsd_state.write().await;

          for item in data.into_iter() {
            match state.get_ups_mut(&item.name) {
              Some(ups_entry) => {
                let old_var = {
                  let mut e: Option<&mut UpsVariable> = None;

                  for var in ups_entry.variables.iter_mut() {
                    // TODO: Check UpsVariable enum marker byte instead of whole name
                    if var.name() == item.variable.name() {
                      e = Some(var);
                      break;
                    }
                  }

                  e
                };

                if let Some(old_var) = old_var {
                  *old_var = item.variable;
                } else {
                  ups_entry.variables.push(item.variable);
                }

                state.last_modified = Some(Utc::now());
              }
              None => warn!(
                "Partial update ignored. Ups {} does not exists anymore.",
                item.name
              ),
            }
          }
        }
        Some(UpsUpdateMessage::FullUpdate { data }) => {
          let mut new_map: HashMap<Box<str>, UpsEntry> = HashMap::new();

          for item in data.into_iter() {
            let key = item.name.clone();
            let entry = UpsEntry {
              commands: item.commands,
              variables: item.variables,
              name: item.name,
              desc: item.desc,
            };

            new_map.insert(key, entry);
          }

          let mut state = upsd_state.write().await;
          let now = Utc::now();

          state.ups_list = new_map;
          state.last_full_sync = Some(now);
          state.last_modified = Some(now);
          state.status = DaemonStatus::Online;
        }
        Some(UpsUpdateMessage::MarkAsDead) => {
          let mut state = upsd_state.write().await;
          state.reset_with_status(DaemonStatus::Dead);
        }

        None => {}
      };
    }

    info!("Upsd state service is shutdown.");
  })
}



================================================
FILE: server/src/upsd_client/client.rs
================================================
#![allow(dead_code)]

use super::{parser::parse_variable, ups_variables::UpsVariable};
use crate::{
  extract_error, is_error_response, is_list_end, is_ok_response,
  upsd_client::{
    errors::NutClientErrors,
    parser::{parse_cmd_list, parse_ups_list, parse_var_list},
    Ups,
  },
};
use tokio::{
  io::{self, AsyncBufReadExt, AsyncWriteExt, BufReader},
  net::{TcpStream, ToSocketAddrs},
};
use tracing::trace;

#[derive(Debug)]
pub struct UpsClient<A>
where
  A: ToSocketAddrs,
{
  address: A,
  connection: TcpStream,
}

#[derive(Debug)]
pub struct UpsAuthClient<A>
where
  A: ToSocketAddrs,
{
  base_client: UpsClient<A>,
  password: Box<str>,
  username: Box<str>,
}

pub trait Client {
  async fn close(&mut self) -> Result<(), NutClientErrors>;
  async fn reconnect(&mut self) -> Result<(), NutClientErrors>;
  async fn get_ups_list(&mut self) -> Result<Vec<Ups>, NutClientErrors>;
  async fn get_cmd_list(&mut self, ups_name: &str) -> Result<Vec<Box<str>>, NutClientErrors>;
  async fn get_var_list(&mut self, ups_name: &str) -> Result<Vec<UpsVariable>, NutClientErrors>;
  async fn get_var(
    &mut self,
    ups_name: &str,
    var_name: &str,
  ) -> Result<UpsVariable, NutClientErrors>;
}

impl<A> UpsClient<A>
where
  A: ToSocketAddrs,
{
  pub async fn create(address: A) -> Result<UpsClient<A>, NutClientErrors> {
    let connection = TcpStream::connect(&address).await?;
    connection.set_nodelay(true)?;

    Ok(UpsClient {
      connection,
      address,
    })
  }

  async fn send(
    &mut self,
    raw_command: &str,
  ) -> Result<BufReader<&mut TcpStream>, NutClientErrors> {
    self.connection.writable().await?;
    self.connection.write_all(raw_command.as_bytes()).await?;
    self.connection.flush().await?;
    self.connection.readable().await?;

    Ok(BufReader::new(&mut self.connection))
  }

  pub async fn with_auth(
    self,
    username: &str,
    password: &str,
  ) -> Result<UpsAuthClient<A>, NutClientErrors> {
    let auth_client = UpsAuthClient {
      base_client: self,
      username: Box::from(username),
      password: Box::from(password),
    };

    Ok(auth_client)
  }
}

impl<A> Client for UpsClient<A>
where
  A: ToSocketAddrs,
{
  async fn close(&mut self) -> Result<(), NutClientErrors> {
    self.connection.shutdown().await?;
    Ok(())
  }

  async fn reconnect(&mut self) -> Result<(), NutClientErrors> {
    _ = self.connection.shutdown().await;
    let connection = TcpStream::connect(&self.address).await?;
    connection.set_nodelay(true)?;

    self.connection = connection;
    Ok(())
  }

  async fn get_ups_list(&mut self) -> Result<Vec<Ups>, NutClientErrors> {
    let mut reader = self.send("LIST UPS\n").await?;
    let mut message_buffer = String::new();
    let mut line_buffer = String::new();

    loop {
      match reader.read_line(&mut line_buffer).await {
        Ok(0) => {
          break;
        }
        Ok(_) => {
          message_buffer.push_str(line_buffer.as_str());

          if is_error_response!(&line_buffer)
            || is_list_end!(&line_buffer)
            || is_ok_response!(&line_buffer)
          {
            break;
          }

          line_buffer.clear();
        }
        Err(ref e) if e.kind() == io::ErrorKind::WouldBlock => continue,
        Err(err) => return Err(NutClientErrors::IOError { kind: err.kind() }),
      }
    }

    trace!(message = "UPS list received.", content = &message_buffer);
    parse_ups_list(&message_buffer)
  }

  async fn get_cmd_list(&mut self, ups_name: &str) -> Result<Vec<Box<str>>, NutClientErrors> {
    let command = format!("LIST CMD {0}\n", &ups_name);
    let mut reader = self.send(&command).await?;
    let mut message_buffer = String::new();
    let mut line_buffer = String::new();

    loop {
      match reader.read_line(&mut line_buffer).await {
        Ok(0) => {
          break;
        }
        Ok(_) => {
          message_buffer.push_str(line_buffer.as_str());

          if is_error_response!(&line_buffer)
            || is_list_end!(&line_buffer)
            || is_ok_response!(&line_buffer)
          {
            break;
          }

          line_buffer.clear();
        }
        Err(ref e) if e.kind() == io::ErrorKind::WouldBlock => continue,
        Err(err) => return Err(err.into()),
      }
    }

    trace!(
      message = "CMD list received.",
      content = &message_buffer,
      ups = &ups_name
    );

    parse_cmd_list(&message_buffer)
  }

  async fn get_var_list(&mut self, ups_name: &str) -> Result<Vec<UpsVariable>, NutClientErrors> {
    let command = format!("LIST VAR {0}\n", &ups_name);
    let mut reader = self.send(&command).await?;
    let mut message_buffer = String::new();

    loop {
      let mut line_buffer = String::new();

      match reader.read_line(&mut line_buffer).await {
        Ok(0) => {
          break;
        }
        Ok(_) => {
          message_buffer.push_str(line_buffer.as_str());

          if is_error_response!(&line_buffer)
            || is_list_end!(&line_buffer)
            || is_ok_response!(&line_buffer)
          {
            break;
          }
        }
        Err(ref e) if e.kind() == io::ErrorKind::WouldBlock => continue,
        Err(err) => return Err(err.into()),
      }
    }

    trace!(
      message = "UPS VAR list received.",
      content = &message_buffer,
      ups = &ups_name
    );

    parse_var_list(&message_buffer)
  }

  async fn get_var(
    &mut self,
    ups_name: &str,
    var_name: &str,
  ) -> Result<UpsVariable, NutClientErrors> {
    let command = format!("GET VAR {0} {1}\n", ups_name, var_name);
    let mut reader = self.send(&command).await?;
    let mut message_buffer = String::new();
    let mut line_buffer = String::new();

    loop {
      match reader.read_line(&mut line_buffer).await {
        Ok(0) => {
          break;
        }
        Ok(_) => {
          message_buffer.push_str(line_buffer.as_str());
          break;
        }
        Err(ref e) if e.kind() == io::ErrorKind::WouldBlock => continue,
        Err(err) => return Err(err.into()),
      }
    }

    if is_error_response!(&message_buffer) {
      let error = extract_error!(&message_buffer);
      Err(NutClientErrors::ProtocolError { kind: error })
    } else {
      trace!(
        message = "UPS var received.",
        content = &message_buffer,
        ups = &ups_name,
        var_name = &var_name
      );

      parse_variable(&message_buffer)
    }
  }
}

impl<A> UpsAuthClient<A>
where
  A: ToSocketAddrs,
{
  pub async fn create(
    address: A,
    username: &str,
    password: &str,
  ) -> Result<UpsAuthClient<A>, NutClientErrors> {
    let connection = TcpStream::connect(&address).await?;
    connection.set_nodelay(true)?;

    let mut auth_client = UpsAuthClient {
      password: Box::from(password),
      username: Box::from(username),
      base_client: UpsClient {
        connection,
        address,
      },
    };

    auth_client.send_user().await?;
    auth_client.send_pass().await?;

    Ok(auth_client)
  }

  pub async fn send_instcmd(&mut self, ups_name: &str, cmd: &str) -> Result<(), NutClientErrors> {
    let command = format!("INSTCMD {0} {1}\n", ups_name, cmd);
    let mut cmd_result = self.base_client.send(&command).await?;

    Self::is_ok(&mut cmd_result).await
  }

  async fn send_user(&mut self) -> Result<(), NutClientErrors> {
    let user_cmd: &str = &format!("USERNAME {}\n", &self.username);
    let mut user_result = self.base_client.send(user_cmd).await?;

    Self::is_ok(&mut user_result).await
  }

  async fn send_pass(&mut self) -> Result<(), NutClientErrors> {
    let pass_cmd: &str = &format!("PASSWORD {}\n", &self.password);
    let mut password_result = self.base_client.send(pass_cmd).await?;

    Self::is_ok(&mut password_result).await
  }

  async fn is_ok(result: &mut BufReader<&mut TcpStream>) -> Result<(), NutClientErrors> {
    let mut line = String::new();
    _ = result.read_line(&mut line).await;

    if is_error_response!(&line) {
      let error = extract_error!(&line);
      Err(NutClientErrors::ProtocolError { kind: error })
    } else if is_ok_response!(&line) {
      Ok(())
    } else {
      Err(NutClientErrors::EmptyResponse)
    }
  }
}

impl<A> Client for UpsAuthClient<A>
where
  A: ToSocketAddrs,
{
  async fn close(&mut self) -> Result<(), NutClientErrors> {
    self.base_client.close().await
  }

  async fn reconnect(&mut self) -> Result<(), NutClientErrors> {
    self.base_client.reconnect().await?;
    self.send_user().await?;
    self.send_pass().await?;

    Ok(())
  }

  async fn get_ups_list(&mut self) -> Result<Vec<Ups>, NutClientErrors> {
    self.base_client.get_ups_list().await
  }

  async fn get_cmd_list(&mut self, ups_name: &str) -> Result<Vec<Box<str>>, NutClientErrors> {
    self.base_client.get_cmd_list(ups_name).await
  }

  async fn get_var_list(&mut self, ups_name: &str) -> Result<Vec<UpsVariable>, NutClientErrors> {
    self.base_client.get_var_list(ups_name).await
  }

  async fn get_var(
    &mut self,
    ups_name: &str,
    var_name: &str,
  ) -> Result<UpsVariable, NutClientErrors> {
    self.base_client.get_var(ups_name, var_name).await
  }
}



================================================
FILE: server/src/upsd_client/errors.rs
================================================
use crate::upsd_client::ups_variables::UpsError;
use std::fmt::Display;
use std::num::{ParseFloatError, ParseIntError};

#[derive(Debug)]
pub enum NutClientErrors {
  EmptyResponse,
  IOError { kind: std::io::ErrorKind },
  ParseError { kind: ParseErrorKind },
  ProtocolError { kind: UpsError },
}

#[derive(Debug)]
pub enum ParseErrorKind {
  InvalidCmdFormat,
  InvalidListEnd,
  InvalidListStart,
  InvalidUpsFormat,
  InvalidVarFloatFormat { inner: ParseFloatError },
  InvalidVarFormat,
  InvalidVarIntFormat { inner: ParseIntError },
}

impl From<UpsError> for NutClientErrors {
  fn from(kind: UpsError) -> Self {
    Self::ProtocolError { kind }
  }
}

impl From<ParseErrorKind> for NutClientErrors {
  fn from(kind: ParseErrorKind) -> Self {
    Self::ParseError { kind }
  }
}

impl From<std::io::Error> for NutClientErrors {
  fn from(value: std::io::Error) -> Self {
    NutClientErrors::IOError { kind: value.kind() }
  }
}

impl From<ParseIntError> for NutClientErrors {
  #[inline]
  fn from(value: ParseIntError) -> Self {
    Self::ParseError {
      kind: ParseErrorKind::InvalidVarIntFormat { inner: value },
    }
  }
}

impl From<ParseFloatError> for NutClientErrors {
  #[inline]
  fn from(value: ParseFloatError) -> Self {
    Self::ParseError {
      kind: ParseErrorKind::InvalidVarFloatFormat { inner: value },
    }
  }
}

impl Display for NutClientErrors {
  fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
    match self {
      NutClientErrors::EmptyResponse => f.write_str("Empty response received"),
      NutClientErrors::IOError { kind } => f.write_fmt(format_args!("IO error: {}", kind)),
      NutClientErrors::ParseError { kind } => f.write_fmt(format_args!("Parse error: {}", kind)),
      NutClientErrors::ProtocolError { kind } => {
        f.write_fmt(format_args!("NUT protocol error: {}", kind))
      }
    }
  }
}

impl Display for ParseErrorKind {
  fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
    let message = match self {
      ParseErrorKind::InvalidCmdFormat => "Malformed CMD line format",
      ParseErrorKind::InvalidUpsFormat => "Malformed UPS line format",
      ParseErrorKind::InvalidVarFloatFormat { inner } => {
        &format!("Invalid float variable: {}", inner)
      }
      ParseErrorKind::InvalidVarFormat => "Malformed VAR line",
      ParseErrorKind::InvalidVarIntFormat { inner } => &format!("Invalid int variable: {}", inner),
      ParseErrorKind::InvalidListEnd => "Invalid list response ending",
      ParseErrorKind::InvalidListStart => "Invalid list response beginning",
    };

    f.write_str(message)
  }
}



================================================
FILE: server/src/upsd_client/parser.rs
================================================
use super::errors::ParseErrorKind;
use crate::upsd_client::{errors::NutClientErrors, ups_variables::UpsVariable, Ups};
use std::borrow::Cow;

#[cfg(test)]
mod unit_tests;

#[macro_export]
macro_rules! is_error_response {
  ( $x:expr ) => {{
    let value: &str = $x;
    value.starts_with("ERR ")
  }};
}

#[macro_export]
macro_rules! is_ok_response {
  ( $x:expr ) => {
    "OK\n" == $x
  };
}

#[macro_export]
macro_rules! is_list_end {
  ( $x:expr ) => {{
    let line: &str = $x;
    line.starts_with("END LIST")
  }};
  ( $x:expr, $t:literal ) => {{
    let line: &str = $x;
    line.starts_with(concat!("END LIST ", $t))
  }};
}

#[macro_export]
macro_rules! extract_error {
  ($x:expr) => {{
    let line: &str = $x;
    $crate::upsd_client::ups_variables::UpsError::from(&line[4..])
  }};
}

macro_rules! check_list_start {
  ( $x:expr, $t:literal) => {{
    match $x {
      Some(line) if is_error_response!(line) => {
        let error = extract_error!(&line);
        Err(NutClientErrors::from(error))
      }
      Some(line) if !line.starts_with(concat!("BEGIN LIST ", $t)) => {
        Err(NutClientErrors::from(ParseErrorKind::InvalidListStart))
      }
      None => Err(NutClientErrors::EmptyResponse),
      _ => Ok(()),
    }
  }};
}

const ESCAPE_BYTE: u8 = b'\\';
const ESCAPE_CHAR: char = '\\';
const QUOTE_BYTE: u8 = b'"';

struct AsciiWords<'a> {
  inner: Vec<Cow<'a, str>>,
}

// NOTE: Insert `Must Not` meme to limit the urge for creating SIMD version.

/// Splits US-ASCII text into words based on notation defined in RFC 9271 with minimal allocations.
impl<'a> AsciiWords<'a> {
  /// Internal only
  /// If necessary, allocates new String without escape characters.
  fn into_escaped(word: &'a str) -> Cow<'a, str> {
    if let Some(first_idx) = word.find(ESCAPE_CHAR) {
      let mut escaped_word = String::from(&word[..first_idx]);
      let mut slice_start: usize = 0;
      let remaining = &word[first_idx + 1..];

      for (idx, character) in remaining.as_bytes().iter().enumerate() {
        if *character == ESCAPE_BYTE {
          if slice_start < idx {
            escaped_word.push_str(&remaining[slice_start..idx]);
            slice_start = idx + 1;
          }
        }
      }

      if slice_start < remaining.len() {
        escaped_word.push_str(&remaining[slice_start..]);
      }

      Cow::Owned(escaped_word)
    } else {
      Cow::Borrowed(word)
    }
  }

  pub fn split(input: &'a str) -> Self {
    let mut words: Vec<Cow<'a, str>> = Vec::new();
    let mut slice_start: Option<usize> = None;
    let mut escape: bool = false;
    let mut slice_char: Option<u8> = None;

    for (idx, char_byte) in input.as_bytes().iter().enumerate() {
      if escape {
        escape = false;
      } else if *char_byte == QUOTE_BYTE && slice_char != Some(QUOTE_BYTE) {
        slice_char = Some(QUOTE_BYTE);
        slice_start = Some(idx + 1);
      } else if slice_char.is_some_and(|sc| sc == *char_byte)
        || (slice_char.is_none() && char_byte.is_ascii_whitespace())
      {
        if let Some(start) = slice_start {
          words.push(Self::into_escaped(&input[start..idx]));
        }

        slice_start = None;
        slice_char = None;
      } else if *char_byte == ESCAPE_BYTE {
        escape = true;

        if slice_start.is_none() {
          slice_start = Some(idx);
        }
      } else if slice_start.is_none() {
        slice_start = Some(idx);
      }
    }

    if let Some(start) = slice_start {
      words.push(Self::into_escaped(&input[start..]));
    }

    Self { inner: words }
  }

  /// Returns splitted words as slice.
  #[inline]
  pub fn as_slice(&self) -> &[Cow<'a, str>] {
    &self.inner
  }
}

#[inline]
pub fn parse_cmd_list(buffer: &str) -> Result<Vec<Box<str>>, NutClientErrors> {
  let mut line_iter = buffer.lines();
  let mut commands: Vec<Box<str>> = Vec::new();

  check_list_start!(line_iter.next(), "CMD")?;

  for line in line_iter {
    if is_list_end!(line, "CMD") {
      return Ok(commands);
    } else {
      let cmd = parse_cmd(line)?;
      commands.push(cmd);
    }
  }

  Err(NutClientErrors::from(ParseErrorKind::InvalidListEnd))
}

#[inline]
pub fn parse_ups_list(buffer: &str) -> Result<Vec<Ups>, NutClientErrors> {
  let mut line_iter = buffer.lines();
  let mut commands: Vec<Ups> = Vec::new();

  check_list_start!(line_iter.next(), "UPS")?;

  for line in line_iter {
    if is_list_end!(line, "UPS") {
      return Ok(commands);
    } else {
      let cmd = parse_ups(line)?;
      commands.push(cmd);
    }
  }

  Err(NutClientErrors::from(ParseErrorKind::InvalidListEnd))
}

#[inline]
pub fn parse_var_list(buffer: &str) -> Result<Vec<UpsVariable>, NutClientErrors> {
  let mut line_iter = buffer.lines();
  let mut variables: Vec<UpsVariable> = Vec::new();

  check_list_start!(line_iter.next(), "VAR")?;

  for line in line_iter {
    if is_list_end!(line, "VAR") {
      return Ok(variables);
    } else {
      let variable = parse_variable(line)?;
      variables.push(variable);
    }
  }

  Err(NutClientErrors::from(ParseErrorKind::InvalidListEnd))
}

#[inline]
pub fn parse_variable(line: &str) -> Result<UpsVariable, NutClientErrors> {
  let words = AsciiWords::split(line);

  match words.as_slice() {
    [op, _ups_name, var_name, value_slice] if op == "VAR" => {
      let var = UpsVariable::try_from((var_name.as_ref(), value_slice.as_ref()))?;

      Ok(var)
    }
    _ => Err(NutClientErrors::from(ParseErrorKind::InvalidVarFormat)),
  }
}

#[inline]
pub fn parse_cmd(line: &str) -> Result<Box<str>, NutClientErrors> {
  let words = AsciiWords::split(line);

  match words.as_slice() {
    [op, _ups_name, cmd_name] if op == "CMD" => {
      let cmd = Box::from(cmd_name.as_ref());

      Ok(cmd)
    }
    _ => Err(NutClientErrors::from(ParseErrorKind::InvalidCmdFormat)),
  }
}

#[inline]
pub fn parse_ups(line: &str) -> Result<Ups, NutClientErrors> {
  let words = AsciiWords::split(line);

  match words.as_slice() {
    [op, ups_name, ups_desc] if op == "UPS" => {
      let name = Box::from(ups_name.as_ref());
      let desc = Box::from(ups_desc.as_ref());

      Ok(Ups { name, desc })
    }
    _ => Err(NutClientErrors::from(ParseErrorKind::InvalidUpsFormat)),
  }
}



================================================
FILE: server/src/upsd_client/ups_variables.rs
================================================
#![allow(dead_code)]

use super::errors::NutClientErrors;
use serde::{Serialize, Serializer};
use std::fmt::{Display, Formatter};

pub(crate) const VAR_AMBIENT_HUMIDITY: &str = "ambient.humidity";
pub(crate) const VAR_AMBIENT_HUMIDITY_ALARM: &str = "ambient.humidity.alarm";
pub(crate) const VAR_AMBIENT_HUMIDITY_ALARM_ENABLE: &str = "ambient.humidity.alarm.enable";
pub(crate) const VAR_AMBIENT_HUMIDITY_ALARM_MAXIMUM: &str = "ambient.humidity.alarm.maximum";
pub(crate) const VAR_AMBIENT_HUMIDITY_ALARM_MINIMUM: &str = "ambient.humidity.alarm.minimum";
pub(crate) const VAR_AMBIENT_HUMIDITY_HIGH: &str = "ambient.humidity.high";
pub(crate) const VAR_AMBIENT_HUMIDITY_HIGH_CRITICAL: &str = "ambient.humidity.high.critical";
pub(crate) const VAR_AMBIENT_HUMIDITY_HIGH_WARNING: &str = "ambient.humidity.high.warning";
pub(crate) const VAR_AMBIENT_HUMIDITY_LOW: &str = "ambient.humidity.low";
pub(crate) const VAR_AMBIENT_HUMIDITY_LOW_CRITICAL: &str = "ambient.humidity.low.critical";
pub(crate) const VAR_AMBIENT_HUMIDITY_LOW_WARNING: &str = "ambient.humidity.low.warning";
pub(crate) const VAR_AMBIENT_HUMIDITY_STATUS: &str = "ambient.humidity.status";
pub(crate) const VAR_AMBIENT_PRESENT: &str = "ambient.present";
pub(crate) const VAR_AMBIENT_TEMPERATURE: &str = "ambient.temperature";
pub(crate) const VAR_AMBIENT_TEMPERATURE_ALARM: &str = "ambient.temperature.alarm";
pub(crate) const VAR_AMBIENT_TEMPERATURE_ALARM_ENABLE: &str = "ambient.temperature.alarm.enable";
pub(crate) const VAR_AMBIENT_TEMPERATURE_ALARM_MAXIMUM: &str = "ambient.temperature.alarm.maximum";
pub(crate) const VAR_AMBIENT_TEMPERATURE_ALARM_MINIMUM: &str = "ambient.temperature.alarm.minimum";
pub(crate) const VAR_AMBIENT_TEMPERATURE_HIGH: &str = "ambient.temperature.high";
pub(crate) const VAR_AMBIENT_TEMPERATURE_HIGH_CRITICAL: &str = "ambient.temperature.high.critical";
pub(crate) const VAR_AMBIENT_TEMPERATURE_HIGH_WARNING: &str = "ambient.temperature.high.warning";
pub(crate) const VAR_AMBIENT_TEMPERATURE_LOW: &str = "ambient.temperature.low";
pub(crate) const VAR_AMBIENT_TEMPERATURE_LOW_CRITICAL: &str = "ambient.temperature.low.critical";
pub(crate) const VAR_AMBIENT_TEMPERATURE_LOW_WARNING: &str = "ambient.temperature.low.warning";
pub(crate) const VAR_AMBIENT_TEMPERATURE_STATUS: &str = "ambient.temperature.status";
pub(crate) const VAR_BATTERY_CAPACITY: &str = "battery.capacity";
pub(crate) const VAR_BATTERY_CHARGE: &str = "battery.charge";
pub(crate) const VAR_BATTERY_CHARGE_APPROX: &str = "battery.charge.approx";
pub(crate) const VAR_BATTERY_CHARGE_LOW: &str = "battery.charge.low";
pub(crate) const VAR_BATTERY_CHARGE_RESTART: &str = "battery.charge.restart";
pub(crate) const VAR_BATTERY_CHARGE_WARNING: &str = "battery.charge.warning";
pub(crate) const VAR_BATTERY_CURRENT: &str = "battery.current";
pub(crate) const VAR_BATTERY_ENERGYSAVE: &str = "battery.energysave";
pub(crate) const VAR_BATTERY_ENERGYSAVE_DELAY: &str = "battery.energysave.delay";
pub(crate) const VAR_BATTERY_ENERGYSAVE_LOAD: &str = "battery.energysave.load";
pub(crate) const VAR_BATTERY_ENERGYSAVE_REALPOWER: &str = "battery.energysave.realpower";
pub(crate) const VAR_BATTERY_PROTECTION: &str = "battery.protection";
pub(crate) const VAR_BATTERY_RUNTIME: &str = "battery.runtime";
pub(crate) const VAR_BATTERY_RUNTIME_LOW: &str = "battery.runtime.low";
pub(crate) const VAR_BATTERY_TEMPERATURE: &str = "battery.temperature";
pub(crate) const VAR_BATTERY_TYPE: &str = "battery.type";
pub(crate) const VAR_BATTERY_VOLTAGE: &str = "battery.voltage";
pub(crate) const VAR_BATTERY_VOLTAGE_NOMINAL: &str = "battery.voltage.nominal";
pub(crate) const VAR_DEVICE_MFR: &str = "device.mfr";
pub(crate) const VAR_DEVICE_MODEL: &str = "device.model";
pub(crate) const VAR_DEVICE_SERIAL: &str = "device.serial";
pub(crate) const VAR_DEVICE_TYPE: &str = "device.type";
pub(crate) const VAR_DRIVER_NAME: &str = "driver.name";
pub(crate) const VAR_DRIVER_PARAMETER_LOWBATT: &str = "driver.parameter.lowbatt";
pub(crate) const VAR_DRIVER_PARAMETER_OFFDELAY: &str = "driver.parameter.offdelay";
pub(crate) const VAR_DRIVER_PARAMETER_ONDELAY: &str = "driver.parameter.ondelay";
pub(crate) const VAR_DRIVER_PARAMETER_POLLFREQ: &str = "driver.parameter.pollfreq";
pub(crate) const VAR_DRIVER_PARAMETER_POLLINTERVAL: &str = "driver.parameter.pollinterval";
pub(crate) const VAR_DRIVER_PARAMETER_PORT: &str = "driver.parameter.port";
pub(crate) const VAR_DRIVER_PARAMETER_SYNCHRONOUS: &str = "driver.parameter.synchronous";
pub(crate) const VAR_DRIVER_PARAMETER_VENDORID: &str = "driver.parameter.vendorid";
pub(crate) const VAR_DRIVER_VERSION: &str = "driver.version";
pub(crate) const VAR_DRIVER_VERSION_DATA: &str = "driver.version.data";
pub(crate) const VAR_DRIVER_VERSION_INTERNAL: &str = "driver.version.internal";
pub(crate) const VAR_INPUT_CURRENT: &str = "input.current";
pub(crate) const VAR_INPUT_CURRENT_NOMINAL: &str = "input.current.nominal";
pub(crate) const VAR_INPUT_CURRENT_STATUS: &str = "input.current.status";
pub(crate) const VAR_INPUT_FREQUENCY: &str = "input.frequency";
pub(crate) const VAR_INPUT_FREQUENCY_EXTENDED: &str = "input.frequency.extended";
pub(crate) const VAR_INPUT_FREQUENCY_HIGH: &str = "input.frequency.high";
pub(crate) const VAR_INPUT_FREQUENCY_LOW: &str = "input.frequency.low";
pub(crate) const VAR_INPUT_FREQUENCY_NOMINAL: &str = "input.frequency.nominal";
pub(crate) const VAR_INPUT_FREQUENCY_STATUS: &str = "input.frequency.status";
pub(crate) const VAR_INPUT_LOAD: &str = "input.load";
pub(crate) const VAR_INPUT_POWER: &str = "input.power";
pub(crate) const VAR_INPUT_QUALITY: &str = "input.quality";
pub(crate) const VAR_INPUT_REALPOWER: &str = "input.realpower";
pub(crate) const VAR_INPUT_SENSITIVITY: &str = "input.sensitivity";
pub(crate) const VAR_INPUT_SOURCE: &str = "input.source";
pub(crate) const VAR_INPUT_SOURCE_PREFERRED: &str = "input.source.preferred";
pub(crate) const VAR_INPUT_TRANSFER_BOOST_HIGH: &str = "input.transfer.boost.high";
pub(crate) const VAR_INPUT_TRANSFER_BOOST_LOW: &str = "input.transfer.boost.low";
pub(crate) const VAR_INPUT_TRANSFER_DELAY: &str = "input.transfer.delay";
pub(crate) const VAR_INPUT_TRANSFER_HIGH: &str = "input.transfer.high";
pub(crate) const VAR_INPUT_TRANSFER_LOW: &str = "input.transfer.low";
pub(crate) const VAR_INPUT_TRANSFER_TRIM_HIGH: &str = "input.transfer.trim.high";
pub(crate) const VAR_INPUT_TRANSFER_TRIM_LOW: &str = "input.transfer.trim.low";
pub(crate) const VAR_INPUT_VOLTAGE: &str = "input.voltage";
pub(crate) const VAR_INPUT_VOLTAGE_NOMINAL: &str = "input.voltage.nominal";
pub(crate) const VAR_OUTPUT_CURRENT: &str = "output.current";
pub(crate) const VAR_OUTPUT_CURRENT_NOMINAL: &str = "output.current.nominal";
pub(crate) const VAR_OUTPUT_FREQUENCY: &str = "output.frequency";
pub(crate) const VAR_OUTPUT_FREQUENCY_NOMINAL: &str = "output.frequency.nominal";
pub(crate) const VAR_OUTPUT_VOLTAGE: &str = "output.voltage";
pub(crate) const VAR_OUTPUT_VOLTAGE_NOMINAL: &str = "output.voltage.nominal";
pub(crate) const VAR_UPS_BEEPER_STATUS: &str = "ups.beeper.status";
pub(crate) const VAR_UPS_CONTACTS: &str = "ups.contacts";
pub(crate) const VAR_UPS_DELAY_SHUTDOWN: &str = "ups.delay.shutdown";
pub(crate) const VAR_UPS_DELAY_START: &str = "ups.delay.start";
pub(crate) const VAR_UPS_FIRMWARE: &str = "ups.firmware";
pub(crate) const VAR_UPS_LOAD: &str = "ups.load";
pub(crate) const VAR_UPS_MFR: &str = "ups.mfr";
pub(crate) const VAR_UPS_MODEL: &str = "ups.model";
pub(crate) const VAR_UPS_POWER: &str = "ups.power";
pub(crate) const VAR_UPS_POWER_NOMINAL: &str = "ups.power.nominal";
pub(crate) const VAR_UPS_PRODUCTID: &str = "ups.productid";
pub(crate) const VAR_UPS_REALPOWER: &str = "ups.realpower";
pub(crate) const VAR_UPS_REALPOWER_NOMINAL: &str = "ups.realpower.nominal";
pub(crate) const VAR_UPS_SERIAL: &str = "ups.serial";
pub(crate) const VAR_UPS_STATUS: &str = "ups.status";
pub(crate) const VAR_UPS_TEMPERATURE: &str = "ups.temperature";
pub(crate) const VAR_UPS_TEST_INTERVAL: &str = "ups.test.interval";
pub(crate) const VAR_UPS_TEST_RESULT: &str = "ups.test.result";
pub(crate) const VAR_UPS_TIMER_SHUTDOWN: &str = "ups.timer.shutdown";
pub(crate) const VAR_UPS_TIMER_START: &str = "ups.timer.start";
pub(crate) const VAR_UPS_VENDORID: &str = "ups.vendorid";

// https://raw.githubusercontent.com/networkupstools/nut/7b225f5291da7fb98003932ffda4e99deb7f23d3/data/cmdvartab

pub(crate) const STATUS_ALARM: &str = "ALARM";
pub(crate) const STATUS_BOOST: &str = "BOOST";
pub(crate) const STATUS_BYPASS: &str = "BYPASS";
pub(crate) const STATUS_CAL: &str = "CAL";
pub(crate) const STATUS_CHRG: &str = "CHRG";
pub(crate) const STATUS_COMM: &str = "COMM";
pub(crate) const STATUS_DISCHRG: &str = "DISCHRG";
pub(crate) const STATUS_FSD: &str = "FSD";
pub(crate) const STATUS_LB: &str = "LB";
pub(crate) const STATUS_NOCOMM: &str = "NOCOMM";
pub(crate) const STATUS_OB: &str = "OB";
pub(crate) const STATUS_OFF: &str = "OFF";
pub(crate) const STATUS_OL: &str = "OL";
pub(crate) const STATUS_OVER: &str = "OVER";
pub(crate) const STATUS_RB: &str = "RB";
pub(crate) const STATUS_TEST: &str = "TEST";
pub(crate) const STATUS_TICK: &str = "TICK";
pub(crate) const STATUS_TOCK: &str = "TOCK";
pub(crate) const STATUS_TRIM: &str = "TRIM";

pub(crate) const ERR_ACCESS_DENIED: &str = "ACCESS-DENIED";
pub(crate) const ERR_ALREADY_ATTACHED: &str = "ALREADY-ATTACHED";
pub(crate) const ERR_ALREADY_SET_PASSWORD: &str = "ALREADY-SET-PASSWORD";
pub(crate) const ERR_ALREADY_SET_USERNAME: &str = "ALREADY-SET-USERNAME";
pub(crate) const ERR_CMD_NOT_SUPPORTED: &str = "CMD-NOT-SUPPORTED";
pub(crate) const ERR_DATE_STALE: &str = "DATA-STALE";
pub(crate) const ERR_DRIVER_NOT_CONNECTED: &str = "DRIVER-NOT-CONNECTED";
pub(crate) const ERR_FEATURE_NOT_CONFIGURED: &str = "FEATURE-NOT-CONFIGURED";
pub(crate) const ERR_FEATURE_NOT_SUPPORTED: &str = "FEATURE-NOT-SUPPORTED";
pub(crate) const ERR_INSTCMD_FAILED: &str = "INSTCMD-FAILED";
pub(crate) const ERR_INVALID_ARGUMENT: &str = "INVALID-ARGUMENT";
pub(crate) const ERR_INVALID_PASSWORD: &str = "INVALID-PASSWORD";
pub(crate) const ERR_INVALID_USERNAME: &str = "INVALID-USERNAME";
pub(crate) const ERR_INVALID_VALUE: &str = "INVALID-VALUE";
pub(crate) const ERR_PASSWORD_REQUIRED: &str = "PASSWORD-REQUIRED";
pub(crate) const ERR_READONLY: &str = "READONLY";
pub(crate) const ERR_SET_FAILED: &str = "SET-FAILED";
pub(crate) const ERR_TLS_ALREADY_ENABLED: &str = "TLS-ALREADY-ENABLED";
pub(crate) const ERR_TLS_NOT_ENABLED: &str = "TLS-NOT-ENABLED";
pub(crate) const ERR_TOO_LONG: &str = "TOO-LONG";
pub(crate) const ERR_UNKNOWN_COMMAND: &str = "UNKNOWN-COMMAND";
pub(crate) const ERR_UNKNOWN_UPS: &str = "UNKNOWN-UPS";
pub(crate) const ERR_USERNAME_REQUIRED: &str = "USERNAME-REQUIRED";
pub(crate) const ERR_VAR_NOT_SUPPORTED: &str = "VAR-NOT-SUPPORTED";

#[derive(Debug, Clone, PartialEq)]
pub enum UpsVariable {
  BatteryCharge(f64),
  BatteryChargeLow(f64),
  BatteryRuntime(f64),
  BatteryTemperature(f64),
  BatteryType(String),
  BatteryVoltage(f64),
  BatteryVoltageNominal(f64),
  DeviceMfr(String),
  DeviceModel(String),
  DeviceSerial(String),
  DeviceType(String),
  DriverName(String),
  DriverParameterLowBatt(i32),
  DriverParameterOffDelay(i32),
  DriverParameterOnDelay(i32),
  DriverParameterPollFreq(i32),
  DriverParameterPollInterval(i32),
  DriverParameterPort(String),
  DriverParameterSynchronous(String),
  DriverParameterVendorId(String),
  DriverVersion(String),
  DriverVersionData(String),
  DriverVersionInternal(String),
  Generic(String, String),
  InputTransferHigh(f64),
  InputTransferLow(f64),
  InputVoltage(f64),
  InputVoltageNominal(f64),
  OutputFrequencyNominal(String),
  OutputVoltage(String),
  OutputVoltageNominal(String),
  UpsBeeperStatus(String),
  UpsDelayShutdown(i32),
  UpsDelayStart(i32),
  UpsFirmware(String),
  UpsLoad(f64),
  UpsMfr(String),
  UpsModel(String),
  UpsPower(f64),
  UpsPowerNominal(f64),
  UpsProductId(String),
  UpsRealPower(f64),
  UpsRealPowerNominal(f64),
  UpsSerial(String),
  UpsStatus(UpsStatus),
  UpsTemperature(f64),
  UpsTimerShutdown(f64),
  UpsTimerStart(f64),
  UpsVendorId(String),
}

impl Serialize for UpsVariable {
  fn serialize<S>(&self, serializer: S) -> Result<S::Ok, S::Error>
  where
    S: Serializer,
  {
    match self {
      UpsVariable::BatteryCharge(value) => serializer.serialize_f64(*value),
      UpsVariable::BatteryChargeLow(value) => serializer.serialize_f64(*value),
      UpsVariable::BatteryRuntime(value) => serializer.serialize_f64(*value),
      UpsVariable::BatteryTemperature(value) => serializer.serialize_f64(*value),
      UpsVariable::BatteryType(value) => serializer.serialize_str(value),
      UpsVariable::BatteryVoltage(value) => serializer.serialize_f64(*value),
      UpsVariable::BatteryVoltageNominal(value) => serializer.serialize_f64(*value),
      UpsVariable::DeviceMfr(value) => serializer.serialize_str(value),
      UpsVariable::DeviceModel(value) => serializer.serialize_str(value),
      UpsVariable::DeviceSerial(value) => serializer.serialize_str(value),
      UpsVariable::DeviceType(value) => serializer.serialize_str(value),
      UpsVariable::DriverName(value) => serializer.serialize_str(value),
      UpsVariable::DriverParameterLowBatt(value) => serializer.serialize_i32(*value),
      UpsVariable::DriverParameterOffDelay(value) => serializer.serialize_i32(*value),
      UpsVariable::DriverParameterOnDelay(value) => serializer.serialize_i32(*value),
      UpsVariable::DriverParameterPollFreq(value) => serializer.serialize_i32(*value),
      UpsVariable::DriverParameterPollInterval(value) => serializer.serialize_i32(*value),
      UpsVariable::DriverParameterPort(value) => serializer.serialize_str(value),
      UpsVariable::DriverParameterSynchronous(value) => serializer.serialize_str(value),
      UpsVariable::DriverParameterVendorId(value) => serializer.serialize_str(value),
      UpsVariable::DriverVersion(value) => serializer.serialize_str(value),
      UpsVariable::DriverVersionData(value) => serializer.serialize_str(value),
      UpsVariable::DriverVersionInternal(value) => serializer.serialize_str(value),
      UpsVariable::Generic(_, value) => serializer.serialize_str(value),
      UpsVariable::InputTransferHigh(value) => serializer.serialize_f64(*value),
      UpsVariable::InputTransferLow(value) => serializer.serialize_f64(*value),
      UpsVariable::InputVoltage(value) => serializer.serialize_f64(*value),
      UpsVariable::InputVoltageNominal(value) => serializer.serialize_f64(*value),
      UpsVariable::OutputFrequencyNominal(value) => serializer.serialize_str(value),
      UpsVariable::OutputVoltage(value) => serializer.serialize_str(value),
      UpsVariable::OutputVoltageNominal(value) => serializer.serialize_str(value),
      UpsVariable::UpsBeeperStatus(value) => serializer.serialize_str(value),
      UpsVariable::UpsDelayShutdown(value) => serializer.serialize_i32(*value),
      UpsVariable::UpsDelayStart(value) => serializer.serialize_i32(*value),
      UpsVariable::UpsFirmware(value) => serializer.serialize_str(value),
      UpsVariable::UpsLoad(value) => serializer.serialize_f64(*value),
      UpsVariable::UpsMfr(value) => serializer.serialize_str(value),
      UpsVariable::UpsModel(value) => serializer.serialize_str(value),
      UpsVariable::UpsPower(value) => serializer.serialize_f64(*value),
      UpsVariable::UpsPowerNominal(value) => serializer.serialize_f64(*value),
      UpsVariable::UpsProductId(value) => serializer.serialize_str(value),
      UpsVariable::UpsRealPower(value) => serializer.serialize_f64(*value),
      UpsVariable::UpsRealPowerNominal(value) => serializer.serialize_f64(*value),
      UpsVariable::UpsSerial(value) => serializer.serialize_str(value),
      UpsVariable::UpsStatus(value) => serializer.serialize_str(value.as_str()),
      UpsVariable::UpsTemperature(value) => serializer.serialize_f64(*value),
      UpsVariable::UpsTimerShutdown(value) => serializer.serialize_f64(*value),
      UpsVariable::UpsTimerStart(value) => serializer.serialize_f64(*value),
      UpsVariable::UpsVendorId(value) => serializer.serialize_str(value),
    }
  }
}

impl UpsVariable {
  pub fn name(&self) -> &str {
    match self {
      UpsVariable::BatteryCharge(_) => VAR_BATTERY_CHARGE,
      UpsVariable::BatteryChargeLow(_) => VAR_BATTERY_CHARGE_LOW,
      UpsVariable::BatteryRuntime(_) => VAR_BATTERY_RUNTIME,
      UpsVariable::BatteryTemperature(_) => VAR_BATTERY_TEMPERATURE,
      UpsVariable::BatteryType(_) => VAR_BATTERY_TYPE,
      UpsVariable::BatteryVoltage(_) => VAR_BATTERY_VOLTAGE,
      UpsVariable::BatteryVoltageNominal(_) => VAR_BATTERY_VOLTAGE_NOMINAL,
      UpsVariable::DeviceMfr(_) => VAR_DEVICE_MFR,
      UpsVariable::DeviceModel(_) => VAR_DEVICE_MODEL,
      UpsVariable::DeviceSerial(_) => VAR_DEVICE_SERIAL,
      UpsVariable::DeviceType(_) => VAR_DEVICE_TYPE,
      UpsVariable::DriverName(_) => VAR_DRIVER_NAME,
      UpsVariable::DriverParameterLowBatt(_) => VAR_DRIVER_PARAMETER_LOWBATT,
      UpsVariable::DriverParameterOffDelay(_) => VAR_DRIVER_PARAMETER_OFFDELAY,
      UpsVariable::DriverParameterOnDelay(_) => VAR_DRIVER_PARAMETER_ONDELAY,
      UpsVariable::DriverParameterPollFreq(_) => VAR_DRIVER_PARAMETER_POLLFREQ,
      UpsVariable::DriverParameterPollInterval(_) => VAR_DRIVER_PARAMETER_POLLINTERVAL,
      UpsVariable::DriverParameterPort(_) => VAR_DRIVER_PARAMETER_PORT,
      UpsVariable::DriverParameterSynchronous(_) => VAR_DRIVER_PARAMETER_SYNCHRONOUS,
      UpsVariable::DriverParameterVendorId(_) => VAR_DRIVER_PARAMETER_VENDORID,