{% extends "baseTemplate/index.html" %}

{% comment %}
==============================================================================
CloudPanel — version management
------------------------------------------------------------------------------
Served at /versionManagement (baseTemplate, admin/versionManagement ACL).

Context variables (all optional, safe defaults):

  currentVersion   str   e.g. "1.0.0"
  buildNumber      str   e.g. "2026.09.18.1"
  branch           str   e.g. "stable"
  installedAt      str   human timestamp of the last install/upgrade
  latestVersion    str   newest version published upstream
  upgradeAvailable bool
  installPrefix    str   defaults to CLOUDPANEL.INSTALL_PREFIX
  changelog        list of {version, date, notes (list[str])}

  archiveDir       str   defaults to /usr/local/src
  localArchives    list of {file, version}, newest first
  newestArchive    dict {file, version} or empty
  upgradeCommand   str   e.g. "sudo cloudpanel upgrade --archive cloudpanel-1.1.0.tar.gz"

AJAX contract used by this page (implemented by the baseTemplate views):

  POST /versionManagement/checkForUpdates {}
       -> {status: 1, latestVersion: "1.1.0", upgradeAvailable: true}

Upgrading is a root-only CLI action now, never something this page triggers:
a web-triggered upgrade (running a root script on behalf of an HTTP request)
is exactly the shape docs/DAEMON-INTENTS.md declines. When a newer release
archive is staged under {{ archiveDir }}, this page shows the operator the
exact `sudo cloudpanel upgrade --archive …` command to run at the console.
==============================================================================
{% endcomment %}

{% block title %}Version Management{% endblock %}

{% block content %}

<div class="cp-page-head">
    <div>
        <h1 class="cp-page-head__title">
            <i class="fa-solid fa-code-branch" aria-hidden="true"></i>
            Version Management
        </h1>
        <p class="cp-page-head__sub">
            Inspect the installed {{ CLOUDPANEL.PANEL_NAME|default:"CloudPanel" }} build and
            apply upstream upgrades.
        </p>
    </div>
    <div class="cp-page-head__actions">
        <button type="button" class="cp-btn cp-btn--ghost" id="cpCheckUpdates">
            <i class="fa-solid fa-magnifying-glass" aria-hidden="true"></i> Check for Updates
        </button>
    </div>
</div>

<div class="cp-dash-split">

    <div class="cp-card">
        <div class="cp-card__head">
            <h2 class="cp-card__title">
                <i class="fa-solid fa-circle-info" aria-hidden="true"></i> Installed Build
            </h2>
        </div>
        <div class="cp-card__body cp-card__body--flush">
            <div class="cp-table-wrap">
                <table class="cp-table cp-table--compact">
                    <tbody>
                        <tr>
                            <td class="cp-muted" style="width:190px">Panel version</td>
                            <td>
                                <strong class="cp-mono" id="cpCurrentVersion">{{ currentVersion|default:CLOUDPANEL.VERSION|default:"1.0.0" }}</strong>
                            </td>
                        </tr>
                        <tr>
                            <td class="cp-muted">Build</td>
                            <td class="cp-mono">{{ buildNumber|default:"—" }}</td>
                        </tr>
                        <tr>
                            <td class="cp-muted">Release channel</td>
                            <td><span class="cp-badge cp-badge--primary">{{ branch|default:"stable" }}</span></td>
                        </tr>
                        <tr>
                            <td class="cp-muted">Installed / upgraded</td>
                            <td>{{ installedAt|default:"—" }}</td>
                        </tr>
                        <tr>
                            <td class="cp-muted">Install prefix</td>
                            <td class="cp-mono cp-truncate">{{ installPrefix|default:CLOUDPANEL.INSTALL_PREFIX|default:"/usr/local/CloudPanel" }}</td>
                        </tr>
                        <tr>
                            <td class="cp-muted">Panel hostname</td>
                            <td class="cp-mono">{{ CLOUDPANEL.PANEL_DOMAIN|default:"cp.a1hosting.net" }}:{{ CLOUDPANEL.PANEL_PORT|default:"8090" }}</td>
                        </tr>
                    </tbody>
                </table>
            </div>
        </div>
    </div>

    <div class="cp-card">
        <div class="cp-card__head">
            <h2 class="cp-card__title">
                <i class="fa-solid fa-cloud-arrow-down" aria-hidden="true"></i> Upgrade
            </h2>
            <span class="cp-pill {% if upgradeAvailable %}cp-pill--warn{% else %}cp-pill--up{% endif %}"
                  id="cpUpgradePill">
                {% if upgradeAvailable %}Update available{% else %}Up to date{% endif %}
            </span>
        </div>
        <div class="cp-card__body">

            <div class="cp-alert cp-alert--info">
                <i class="fa-solid fa-circle-info" aria-hidden="true"></i>
                <p>
                    Upgrading is a console-only action, run as root. This page cannot start
                    one — it can only tell you what to type.
                </p>
            </div>

            <div class="cp-field">
                <span class="cp-label">Latest published version</span>
                <p class="cp-mono" style="font-size:18px;font-weight:600;margin:0"
                   id="cpLatestVersion">{{ latestVersion|default:"unknown" }}</p>
            </div>

            {% if newestArchive %}
            <div class="cp-field">
                <span class="cp-label">Newest archive staged in {{ archiveDir }}</span>
                <p class="cp-mono" style="font-size:16px;font-weight:600;margin:0">
                    {{ newestArchive.file }}
                    <span class="cp-badge cp-badge--primary">v{{ newestArchive.version }}</span>
                </p>
            </div>

            <div class="cp-field">
                <span class="cp-label">Run this at the server console</span>
                <div style="display:flex;align-items:center;gap:8px;flex-wrap:wrap">
                    <code class="cp-mono" id="cpUpgradeCommand">{{ upgradeCommand }}</code>
                    <button type="button" class="cp-btn cp-btn--ghost cp-btn--sm" id="cpCopyUpgradeCommand">
                        <i class="fa-regular fa-copy" aria-hidden="true"></i> Copy
                    </button>
                </div>
                <p class="cp-help">
                    Take a configuration backup first. The command restarts the panel
                    service when it finishes; hosted websites, mail and DNS keep running.
                </p>
            </div>
            {% else %}
            <div class="cp-empty">
                <i class="fa-regular fa-folder-open" aria-hidden="true"></i>
                <h4>No release archive staged</h4>
                <p>
                    Download <span class="cp-mono">cloudpanel-X.Y.Z.tar.gz</span> to
                    <span class="cp-mono">{{ archiveDir }}</span> on the server, then run
                    <span class="cp-mono">sudo cloudpanel upgrade --archive cloudpanel-X.Y.Z.tar.gz</span>
                    at the console.
                </p>
            </div>
            {% endif %}

            {% if localArchives|length > 1 %}
            <div class="cp-field">
                <span class="cp-label">Other archives found</span>
                <ul style="margin:0;padding-left:18px">
                    {% for archive in localArchives %}
                        {% if not forloop.first %}
                        <li class="cp-mono">{{ archive.file }}</li>
                        {% endif %}
                    {% endfor %}
                </ul>
            </div>
            {% endif %}

        </div>
    </div>

</div>

<div class="cp-card">
    <div class="cp-card__head">
        <h2 class="cp-card__title">
            <i class="fa-solid fa-list-check" aria-hidden="true"></i> Changelog
        </h2>
    </div>
    <div class="cp-card__body cp-card__body--flush">
        <div class="cp-table-wrap">
            <table class="cp-table">
                <thead>
                    <tr>
                        <th scope="col" style="width:130px">Version</th>
                        <th scope="col" style="width:150px">Date</th>
                        <th scope="col">Changes</th>
                    </tr>
                </thead>
                <tbody>
                    {% for release in changelog %}
                    <tr>
                        <td><span class="cp-badge cp-badge--primary cp-mono">{{ release.version }}</span></td>
                        <td class="cp-muted cp-nowrap">{{ release.date }}</td>
                        <td>
                            <ul style="margin:0;padding-left:18px">
                                {% for note in release.notes %}<li>{{ note }}</li>{% endfor %}
                            </ul>
                        </td>
                    </tr>
                    {% empty %}
                    <tr data-cp-empty-row>
                        <td colspan="3">
                            <div class="cp-empty">
                                <i class="fa-regular fa-file-lines" aria-hidden="true"></i>
                                <h4>No changelog available</h4>
                                <p>Release notes appear here once the panel has checked upstream.</p>
                            </div>
                        </td>
                    </tr>
                    {% endfor %}
                </tbody>
            </table>
        </div>
    </div>
</div>

{% endblock %}


{% block scripts %}
<script>
(function ($) {
    "use strict";

    var ENDPOINTS = {
        check: "/versionManagement/checkForUpdates"
    };

    $("#cpCheckUpdates").on("click", function () {
        var restore = CP.busy(this, "Checking…");
        CP.post(ENDPOINTS.check, {}, { silent: true })
            .done(function (data) {
                restore();
                if (!CP.notify.fromResponse(data)) { return; }

                if (data.latestVersion) {
                    $("#cpLatestVersion").text(data.latestVersion);
                }
                var $pill = $("#cpUpgradePill");
                if (data.upgradeAvailable) {
                    $pill.attr("class", "cp-pill cp-pill--warn").text("Update available");
                    CP.notify.info("Version " + (data.latestVersion || "newer") +
                                   " is available to install.");
                } else {
                    $pill.attr("class", "cp-pill cp-pill--up").text("Up to date");
                    CP.notify.success("This panel is running the newest published build.");
                }
            })
            .fail(function (xhr) {
                restore();
                CP.handleAjaxFailure(xhr);
            });
    });

    $("#cpCopyUpgradeCommand").on("click", function () {
        var text = $("#cpUpgradeCommand").text();
        var button = this;

        function done() {
            var $button = $(button);
            var original = $button.html();
            $button.html('<i class="fa-solid fa-check" aria-hidden="true"></i> Copied');
            window.setTimeout(function () { $button.html(original); }, 1500);
        }

        if (navigator.clipboard && navigator.clipboard.writeText) {
            navigator.clipboard.writeText(text).then(done, function () {
                CP.notify.error("Could not copy to the clipboard. Select the text and copy it by hand.");
            });
        } else {
            CP.notify.info("Select the command and copy it by hand.");
        }
    });

}(jQuery));
</script>
{% endblock %}