"""``aps.*`` — auto-generated ISPConfig remote-API wrappers.

This module is produced by ``tools/gen_methods.py`` from the
``tools/method_inventory.json`` catalog. Hand-edits go below the
``---- HAND-EDIT ONLY BELOW ----`` marker — they survive regeneration.
"""

from __future__ import annotations

from typing import TYPE_CHECKING, Any

if TYPE_CHECKING:
    from .client import ISPConfigClient


class ApsModule:
    """Auto-generated module: Aps.

    All methods below the ``AUTO-GENERATED START`` marker are produced
    by ``tools/gen_methods.py``. Do not hand-edit that block — changes
    will be overwritten on the next regeneration. Add helpers and
    overrides below the ``HAND-EDIT ONLY BELOW`` marker instead.
    """

    def __init__(self, client: ISPConfigClient) -> None:
        self._c = client

    # ---- AUTO-GENERATED START (do not hand-edit above this line) ----
    # Regenerate with: python3 tools/gen_methods.py

    def sites_aps_available_packages_list(self, params: Any = None) -> Any:
        """
        Auto-generated wrapper for ``sites_aps_available_packages_list``.

        Source: ``aps.inc.php`` line 56.
        PHP signature: ``sites_aps_available_packages_list($session_id, $params = array())``.

        AUTO-GENERATED - param shapes may need verification against your
        ISPConfig version. File issues at Sulkta-Coop/ispconfig-py.
        """
        return self._c._call("sites_aps_available_packages_list", ("params", params))

    def sites_aps_change_package_status(self, primary_id: Any, params: Any) -> Any:
        """
        Auto-generated wrapper for ``sites_aps_change_package_status``.

        Source: ``aps.inc.php`` line 201.
        PHP signature: ``sites_aps_change_package_status($session_id, $primary_id, $params)``.

        AUTO-GENERATED - param shapes may need verification against your
        ISPConfig version. File issues at Sulkta-Coop/ispconfig-py.
        """
        return self._c._call(
            "sites_aps_change_package_status", ("primary_id", primary_id), ("params", params)
        )

    def sites_aps_get_package_details(self, primary_id: Any) -> Any:
        """
        Auto-generated wrapper for ``sites_aps_get_package_details``.

        Source: ``aps.inc.php`` line 78.
        PHP signature: ``sites_aps_get_package_details($session_id, $primary_id)``.

        AUTO-GENERATED - param shapes may need verification against your
        ISPConfig version. File issues at Sulkta-Coop/ispconfig-py.
        """
        return self._c._call("sites_aps_get_package_details", ("primary_id", primary_id))

    def sites_aps_get_package_file(self, primary_id: Any, filename: Any) -> Any:
        """
        Auto-generated wrapper for ``sites_aps_get_package_file``.

        Source: ``aps.inc.php`` line 118.
        PHP signature: ``sites_aps_get_package_file($session_id, $primary_id, $filename)``.

        AUTO-GENERATED - param shapes may need verification against your
        ISPConfig version. File issues at Sulkta-Coop/ispconfig-py.
        """
        return self._c._call("sites_aps_get_package_file", ("primary_id", primary_id), ("filename", filename))

    def sites_aps_get_package_settings(self, primary_id: Any) -> Any:
        """
        Auto-generated wrapper for ``sites_aps_get_package_settings``.

        Source: ``aps.inc.php`` line 163.
        PHP signature: ``sites_aps_get_package_settings($session_id, $primary_id)``.

        AUTO-GENERATED - param shapes may need verification against your
        ISPConfig version. File issues at Sulkta-Coop/ispconfig-py.
        """
        return self._c._call("sites_aps_get_package_settings", ("primary_id", primary_id))

    def sites_aps_install_package(self, primary_id: Any, params: Any) -> Any:
        """
        Auto-generated wrapper for ``sites_aps_install_package``.

        Source: ``aps.inc.php`` line 231.
        PHP signature: ``sites_aps_install_package($session_id, $primary_id, $params)``.

        AUTO-GENERATED - param shapes may need verification against your
        ISPConfig version. File issues at Sulkta-Coop/ispconfig-py.
        """
        return self._c._call("sites_aps_install_package", ("primary_id", primary_id), ("params", params))

    def sites_aps_instance_delete(self, primary_id: Any, params: Any = None) -> Any:
        """
        Auto-generated wrapper for ``sites_aps_instance_delete``.

        Source: ``aps.inc.php`` line 331.
        PHP signature: ``sites_aps_instance_delete($session_id, $primary_id, $params = array())``.

        AUTO-GENERATED - param shapes may need verification against your
        ISPConfig version. File issues at Sulkta-Coop/ispconfig-py.
        """
        return self._c._call("sites_aps_instance_delete", ("primary_id", primary_id), ("params", params))

    def sites_aps_instance_get(self, primary_id: Any) -> Any:
        """
        Auto-generated wrapper for ``sites_aps_instance_get``.

        Source: ``aps.inc.php`` line 303.
        PHP signature: ``sites_aps_instance_get($session_id, $primary_id)``.

        AUTO-GENERATED - param shapes may need verification against your
        ISPConfig version. File issues at Sulkta-Coop/ispconfig-py.
        """
        return self._c._call("sites_aps_instance_get", ("primary_id", primary_id))

    def sites_aps_instance_settings_get(self, primary_id: Any) -> Any:
        """
        Auto-generated wrapper for ``sites_aps_instance_settings_get``.

        Source: ``aps.inc.php`` line 317.
        PHP signature: ``sites_aps_instance_settings_get($session_id, $primary_id)``.

        AUTO-GENERATED - param shapes may need verification against your
        ISPConfig version. File issues at Sulkta-Coop/ispconfig-py.
        """
        return self._c._call("sites_aps_instance_settings_get", ("primary_id", primary_id))

    def sites_aps_update_package_list(self) -> Any:
        """
        Auto-generated wrapper for ``sites_aps_update_package_list``.

        Source: ``aps.inc.php`` line 38.

        AUTO-GENERATED - param shapes may need verification against your
        ISPConfig version. File issues at Sulkta-Coop/ispconfig-py.
        """
        return self._c._call("sites_aps_update_package_list")

    # ---- AUTO-GENERATED END ----

    # ---- HAND-EDIT ONLY BELOW ----