@danhachuel/thunderbolt 0.3.89 → 0.3.91

package/app/main.py

@@ -5066,6 +5066,22 @@ def render_google_accounts():
                             key=f"batch_session_info_{account_id}",
                             help="Token sessionInfo usado pelo Upload directo. É guardado por conta e sincronizado no credentials.json; os cookies e restantes valores continuam exclusivamente no documento.",
                         )
+                        captured_at_value = str(
+                            session_health.captured_at
+                            or batch_account.get("sessionInfoCapturedAt")
+                            or batch_account.get("session_info_captured_at")
+                            or ""
+                        ).strip()
+                        try:
+                            account_session_info_captured_at = datetime.fromisoformat(captured_at_value.replace("Z", "+00:00")).date() if captured_at_value else None
+                        except ValueError:
+                            account_session_info_captured_at = None
+                        account_session_info_captured_at = st.date_input(
+                            "Data de Captura",
+                            value=account_session_info_captured_at,
+                            key=f"batch_session_info_captured_at_{account_id}",
+                            help="Data em que o sessionInfo token foi capturado. É usada para calcular o alerta de expiração e não revela o token.",
+                        )
                     save_account = st.form_submit_button("Guardar dados da conta Google", type="primary", use_container_width=True)
 
                 st.markdown("**Documento de cookies/credenciais desta conta Google**")
@@ -5119,8 +5135,14 @@ def render_google_accounts():
                                 credentials_changed = any(existing.get(field, "") != value for field, value in (("email", account_email.strip()), ("client_id", account_client_id.strip()), ("client_secret", account_client_secret.strip())))
                                 if credentials_changed:
                                     delete_youtube_batch_token(existing, STORAGE)
-                                existing.update({"label": account_label.strip() or "Canais YouTube", "email": account_email.strip(), "client_id": account_client_id.strip(), "client_secret": account_client_secret.strip(), "sessionInfo": account_session_info.strip()})
-                                update_credentials_document_session_info(STORAGE, existing, account_session_info.strip())
+                                captured_at_iso = account_session_info_captured_at.isoformat() if isinstance(account_session_info_captured_at, date) else ""
+                                existing.update({"label": account_label.strip() or "Canais YouTube", "email": account_email.strip(), "client_id": account_client_id.strip(), "client_secret": account_client_secret.strip(), "sessionInfo": account_session_info.strip(), "sessionInfoCapturedAt": captured_at_iso})
+                                update_credentials_document_session_info(
+                                    STORAGE,
+                                    existing,
+                                    account_session_info.strip(),
+                                    captured_at=captured_at_iso,
+                                )
                                 ensure_credentials_document(STORAGE, existing, settings, channel_state)
                         settings["youtube_batch_accounts"] = batch_accounts
                         write_json("settings.json", settings)
@@ -6403,6 +6425,22 @@ def render_supabase_tutorial():
     st.markdown(tutorial_content, unsafe_allow_html=True)
 
 
+def render_youtube_frontend_upload_tutorial():
+    """Render the safe operational guide for the YouTube direct-upload workflow."""
+    tutorial_path = ROOT / "seed" / "references" / "youtube-video-upload-frontend.md"
+    st.title("Tutorial YouTube Video-Upload Frontend")
+    st.caption("Guia prático e seguro para rever metadados, sessão e envio directo de vídeos concluídos.")
+    st.markdown("[Abrir referência técnica no GitHub](https://github.com/Nojus10/YouTube-Video-Upload-Frontend-Api)")
+    try:
+        tutorial_content = tutorial_path.read_text(encoding="utf-8").strip()
+    except OSError:
+        tutorial_content = ""
+    if not tutorial_content:
+        st.error("O conteúdo local do tutorial não está disponível. Consulte a referência técnica no GitHub.")
+        return
+    st.markdown(tutorial_content, unsafe_allow_html=False)
+
+
 def render_mcp():
     st.title("MCP")
     st.caption("Clientes externos, servidor MCP do Thunderbolt e a skill local ficam separados para evitar confundir funções diferentes.")
@@ -6708,6 +6746,7 @@ def main():
         ("Tutorial Supabase", ":material/storage:", "Tutorial Supabase"),
         ("Tutorial Kaggle", ":material/menu_book:", "Tutorial Kaggle"),
         ("Tutorial Apify", ":material/menu_book:", "Tutorial Apify"),
+        ("Tutorial YouTube Video-Upload Frontend", ":material/video_library:", "Tutorial YouTube Video-Upload Frontend"),
     ]
     settings_items = [
         ("MCP", ":material/hub:", "MCP"),
@@ -6846,6 +6885,7 @@ def main():
         "Documentação": lambda: render_edit_placeholder("Documentação", "Seleccione um tutorial no menu expansível."),
         "Tutorial Meta": render_models_ai_tutorial,
         "Tutorial Supabase": render_supabase_tutorial,
+        "Tutorial YouTube Video-Upload Frontend": render_youtube_frontend_upload_tutorial,
         "Configurações": lambda: render_edit_placeholder("Configurações", "Seleccione uma opção no menu expansível."),
         "MCP": render_mcp,
         "Contas Google": render_google_accounts,

package/integrations/youtube_direct_credentials.py

@@ -242,8 +242,14 @@ def save_credentials_document(storage_root: Path, account: dict[str, Any], docum
     return destination
 
 
-def update_credentials_document_session_info(storage_root: Path, account: dict[str, Any], session_info: str) -> Path | None:
-    """Save sessionInfo and its UTC capture time without exposing the token."""
+def update_credentials_document_session_info(
+    storage_root: Path,
+    account: dict[str, Any],
+    session_info: str,
+    *,
+    captured_at: str | None = None,
+) -> Path | None:
+    """Save sessionInfo and an optional user-confirmed capture date without exposing the token."""
     path = credentials_document_path(storage_root, account)
     if path.exists():
         raw = _read_json_document(path) or {}
@@ -251,7 +257,12 @@ def update_credentials_document_session_info(storage_root: Path, account: dict[s
         raw = load_credentials_document(storage_root, {**account, "sessionInfo": session_info}, create=True)
     document = _normalise_document(raw, {**account, "sessionInfo": session_info})
     document["sessionInfo"] = str(session_info or "").strip()
-    document["sessionInfoCapturedAt"] = _session_info_now() if document["sessionInfo"] else ""
+    if not document["sessionInfo"]:
+        document["sessionInfoCapturedAt"] = ""
+    elif captured_at is None:
+        document["sessionInfoCapturedAt"] = _session_info_now()
+    else:
+        document["sessionInfoCapturedAt"] = str(captured_at).strip()
     return save_credentials_document(storage_root, account, document)
 
 

package/package.json

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

package/seed/references/youtube-video-upload-frontend.md

@@ -0,0 +1,48 @@
+# Tutorial YouTube Video-Upload Frontend
+
+Este tutorial explica como utilizar, de forma responsável, o fluxo **Direct upload** do Thunderbolt para vídeos já concluídos. A rota é uma integração técnica baseada em comportamentos do frontend do YouTube e pode mudar sem aviso. Use-a somente em contas e canais que controla e respeite as políticas aplicáveis do YouTube.
+
+> **Segurança primeiro:** dados de sessão, cookies de autenticação, identificadores de canal e material de credencial são confidenciais. Nunca os copie para conversas, capturas de ecrã, issues, ficheiros versionados ou campos de texto comuns. Configure-os exclusivamente nos campos protegidos da aplicação local.
+
+## 1. Antes de começar
+
+Confirme que o vídeo foi concluído no **Video Backlog** e que o respectivo canal YouTube está seleccionado no Thunderbolt. No formulário de Upload, confirme título, descrição, tags, privacidade, categoria e idioma antes de autorizar qualquer envio.
+
+O Thunderbolt oferece dois percursos distintos: o fluxo oficial, que utiliza a integração de API autorizada, e o fluxo directo, destinado a uma sessão válida e a uma conta controlada pelo utilizador. Estes percursos não devem ser usados para contornar políticas, limites da plataforma ou permissões de canal.
+
+| Elemento | Finalidade | Boa prática |
+| --- | --- | --- |
+| Vídeo | Ficheiro final da tarefa concluída | Verifique duração, áudio, miniatura e legendas antes do envio. |
+| Metadados | Título, descrição, tags, idioma e privacidade | Reveja manualmente antes de publicar. A descrição por IA pode ser editada. |
+| Canal | Destino associado à conta autorizada | Confirme que é o canal correcto, sobretudo em contas com vários canais. |
+| Sessão | Autorização temporária de upload directo | Mantenha-a apenas em armazenamento local protegido e actualize-a quando expirar. |
+
+## 2. Preparar a autenticação de forma segura
+
+No Thunderbolt, abra **Upload > Direct upload** e utilize os controlos de autorização fornecidos pela interface. Complete o procedimento somente no seu navegador e conta YouTube. Não partilhe dados de sessão, cookies, tokens temporários, IDs de canal ou chaves de integração com terceiros.
+
+Se a verificação de saúde indicar sessão expirada, interrompa o envio e renove a autorização pela interface. O sistema deve apresentar o diagnóstico sem mostrar os valores protegidos. Nunca use valores de exemplo ou chaves encontradas em documentos públicos.
+
+## 3. Envio em partes e memória
+
+O envio directo pode transferir o ficheiro em partes, em vez de carregar todo o vídeo para a memória de uma só vez. Esta estratégia é adequada para ficheiros grandes e reduz a pressão de memória no computador. O Thunderbolt mantém o vídeo no armazenamento local e regista apenas o estado e o resultado do processo.
+
+## 4. Executar o envio
+
+Abra **Upload > Conventional upload** para rever os metadados. Utilize **Gerar descrição com IA** apenas quando quiser uma sugestão editorial; o resultado permanece editável. O campo **Idioma** é detectado da tarefa ou canal e é mostrado numa lista suspensa para evitar códigos escritos incorrectamente.
+
+Depois de confirmar o canal, a privacidade e os metadados, seleccione o fluxo de envio apropriado. Um envio publica ou cria conteúdo numa plataforma externa; por isso, o Thunderbolt deve exigir a confirmação explícita do utilizador antes da acção.
+
+## 5. Diagnóstico e manutenção
+
+| Situação | Acção recomendada |
+| --- | --- |
+| Sessão expirada ou não autorizada | Renove a autorização na interface e volte a executar a verificação de saúde. |
+| Canal incorrecto | Cancele antes do envio e seleccione o canal certo. |
+| Falha de rede | Não repita automaticamente sem confirmar se o vídeo foi criado no YouTube Studio. |
+| Metadados incompletos | Corrija título, descrição, tags, idioma ou privacidade no formulário antes de enviar. |
+| Limite ou política da plataforma | Pare o processo e siga as políticas e limites actualmente aplicáveis do YouTube. |
+
+## Referência técnica
+
+O material fornecido pelo utilizador cita o repositório [Nojus10/YouTube-Video-Upload-Frontend-Api](https://github.com/Nojus10/YouTube-Video-Upload-Frontend-Api). O Thunderbolt apresenta este tutorial como orientação de integração segura; não replica segredos, valores de autenticação nem instruções de extracção de credenciais.