@danhachuel/thunderbolt 0.3.96 → 0.3.97

package/app/main.py

@@ -4,6 +4,7 @@ import hashlib
 import json
 import mimetypes
 import re
+import time
 from contextlib import nullcontext
 from datetime import date, datetime, timezone
 import sys
@@ -49,6 +50,7 @@ from hermes_ui.logs import list_logs, logs_to_rows
 from hermes_ui.languages import LANGUAGE_CODES, VIDEO_LANGUAGE_CODES, LANGUAGE_FLAG_DATA_URIS, language_code, language_label, ui_language_menu_label, ui_text, video_language_label, video_language_options
 from hermes_ui.api_key_tests import test_apify_credentials, test_influencer_database, test_innertube_api_key, test_kaggle_credentials, test_material_source_credentials, test_media_provider_card, test_nano_banana_credentials, test_postiz_credentials, test_telegram_credentials, test_tiktok_credentials, test_upload_post_credentials, test_voice_provider
 from hermes_ui.tutorials import tutorial_body, tutorial_caption, tutorial_title
+from hermes_ui.update_manager import check_version, update_to_latest
 
 from hermes_ui.script_documents import list_script_documents, read_script_document, save_script_document, script_storage_path
 from hermes_ui.script_generation import generate_script_document
@@ -1269,6 +1271,48 @@ def render_channel_edit_form(channel: dict, youtube_account_ids: list[str], yout
 
 def render_dashboard():
     ui_language = current_ui_language()
+    update_area, version_area = st.columns([1.45, 4.55])
+    with update_area:
+        st.markdown(
+            """
+            <style>
+            div[data-testid="stButton"] button[kind="primary"] {
+                background: linear-gradient(135deg, #2563eb 0%, #7c3aed 100%);
+                color: #ffffff;
+                border: 1px solid #8b5cf6;
+                font-weight: 700;
+                box-shadow: 0 8px 20px rgba(79, 70, 229, 0.28);
+            }
+            div[data-testid="stButton"] button[kind="primary"]:hover {
+                border-color: #c4b5fd;
+                filter: brightness(1.08);
+            }
+            </style>
+            """,
+            unsafe_allow_html=True,
+        )
+        if st.button("Atualizar Versão", key="home_update_version", use_container_width=True, type="primary", icon=":material/system_update:"):
+            with st.spinner("A instalar a versão mais recente…"):
+                st.session_state["home_update_result"] = update_to_latest(APP_VERSION)
+    with version_area:
+        cache_key = "home_update_version_check"
+        checked_at_key = "home_update_version_checked_at"
+        if not st.session_state.get(cache_key) or time.monotonic() - float(st.session_state.get(checked_at_key, 0)) > 300:
+            st.session_state[cache_key] = check_version(APP_VERSION)
+            st.session_state[checked_at_key] = time.monotonic()
+        version_status = st.session_state[cache_key]
+        if version_status.update_available:
+            st.info(f"Nova versão disponível: {version_status.latest_version}. A versão actual é {APP_VERSION or 'desconhecida'}.")
+        elif version_status.error:
+            st.caption(f"Versão actual: {APP_VERSION or 'desconhecida'} · verificação de actualização indisponível.")
+        else:
+            st.caption(f"Versão actual: {APP_VERSION or 'desconhecida'} · já está actualizada ({version_status.latest_version}).")
+    update_result = st.session_state.get("home_update_result")
+    if update_result is not None:
+        if update_result.ok:
+            st.success(update_result.message)
+        else:
+            st.error(update_result.message)
     st.title("Thunderbolt")
     st.caption(ui_text("Interface local para operação e automação de conteúdo faceless", ui_language))
     summary = pipeline_summary()

package/hermes_ui/update_manager.py

@@ -0,0 +1,108 @@
+"""Verificação e actualização local da versão distribuída pelo NPM.
+
+O módulo não recebe nem manipula credenciais. A instalação só é iniciada após o
+clique explícito do utilizador na interface local.
+"""
+
+from __future__ import annotations
+
+import os
+import subprocess
+from dataclasses import dataclass
+from typing import Any, Callable
+
+import requests
+
+
+PACKAGE_NAME = "@danhachuel/thunderbolt"
+REGISTRY_URL = "https://registry.npmjs.org/@danhachuel/thunderbolt/latest"
+UPDATE_TIMEOUT_SECONDS = 20 * 60
+
+
+@dataclass(frozen=True)
+class VersionCheck:
+    """Version information displayed on the local home page."""
+
+    current_version: str
+    latest_version: str = ""
+    error: str = ""
+
+    @property
+    def update_available(self) -> bool:
+        return bool(self.latest_version and self.current_version and self.latest_version != self.current_version)
+
+
+@dataclass(frozen=True)
+class UpdateResult:
+    """Sanitised result of an explicit local package update request."""
+
+    ok: bool
+    latest_version: str = ""
+    message: str = ""
+
+
+def latest_package_version(*, timeout: int = 8, get: Callable[..., Any] = requests.get) -> str:
+    """Return the latest public package version without sending local configuration."""
+    response = get(REGISTRY_URL, timeout=timeout)
+    response.raise_for_status()
+    payload = response.json()
+    version = str(payload.get("version") or "").strip() if isinstance(payload, dict) else ""
+    if not version:
+        raise ValueError("O registry NPM não devolveu uma versão válida.")
+    return version
+
+
+def check_version(current_version: str, *, timeout: int = 8, get: Callable[..., Any] = requests.get) -> VersionCheck:
+    """Fetch only the package metadata needed for the version badge."""
+    current = str(current_version or "").strip()
+    try:
+        return VersionCheck(current_version=current, latest_version=latest_package_version(timeout=timeout, get=get))
+    except (requests.RequestException, ValueError) as exc:
+        return VersionCheck(current_version=current, error=f"Não foi possível verificar actualizações agora ({type(exc).__name__}).")
+
+
+def update_command() -> list[str]:
+    """Build the same cross-platform install command documented for Thunderbolt."""
+    executable = "npx.cmd" if os.name == "nt" else "npx"
+    return [executable, "--yes", "--prefer-online", PACKAGE_NAME, "install"]
+
+
+def update_to_latest(
+    current_version: str,
+    *,
+    timeout: int = UPDATE_TIMEOUT_SECONDS,
+    get: Callable[..., Any] = requests.get,
+    run: Callable[..., Any] = subprocess.run,
+) -> UpdateResult:
+    """Install the latest package only after an explicit UI action.
+
+    The running local process keeps its current code until it is restarted. No
+    subprocess output is returned to the UI, preventing accidental display of
+    environment values from third-party installers.
+    """
+    status = check_version(current_version, get=get)
+    if status.error:
+        return UpdateResult(False, message=status.error)
+    if not status.update_available:
+        return UpdateResult(True, latest_version=status.latest_version, message="O Thunderbolt já está na versão mais recente.")
+    try:
+        completed = run(
+            update_command(),
+            stdin=subprocess.DEVNULL,
+            stdout=subprocess.DEVNULL,
+            stderr=subprocess.DEVNULL,
+            timeout=timeout,
+            check=False,
+        )
+    except (OSError, subprocess.TimeoutExpired) as exc:
+        return UpdateResult(False, latest_version=status.latest_version, message=f"Não foi possível concluir a actualização ({type(exc).__name__}).")
+    if int(getattr(completed, "returncode", 1)) != 0:
+        return UpdateResult(False, latest_version=status.latest_version, message="A actualização não foi concluída. Feche processos Thunderbolt em execução e tente novamente.")
+    return UpdateResult(
+        True,
+        latest_version=status.latest_version,
+        message=(
+            f"A versão {status.latest_version} foi instalada. Reinicie o Thunderbolt para abrir a versão nova; "
+            "os dados e configurações locais foram preservados."
+        ),
+    )

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@danhachuel/thunderbolt",
-  "version": "0.3.96",
+  "version": "0.3.97",
   "description": "Thunderbolt — interface local para operação de canais faceless e motor MoneyPrinterTurbo",
   "license": "MIT",
   "main": "scripts/cli.mjs",