@praeko/cli 0.0.0-stage → 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,9 @@
+# Changelog
+
+Segue [Keep a Changelog](https://keepachangelog.com/pt-BR/1.1.0/) e [SemVer](https://semver.org/lang/pt-BR/).
+
+## [0.1.0] - não publicado
+
+Primeira versão preparada para o npm.
+- Pacote `@praeko/cli`: comandos `praeko` e `arauto`, empacotado em `dist/` com o core e o SDK embutidos (sem dependências); `--version`; `praeko studio` avisa quando o Studio não está instalado.
+- Licença MIT (arquivo `LICENSE` no pacote) e repositório público de código-cliente (`Praeko/praeko-js`).

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Marcone Santos
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,59 @@
-# Temporary Holding Version
+# @praeko/cli
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Linha de comando do [Praeko](https://praeko.app): publica e agenda vídeos curtos no YouTube, Instagram e TikTok, e fala com a API do serviço (posts, fila, canais, chaves, insights). Comando `praeko` (o antigo `arauto` continua como apelido). Node 22 ou superior; `ffmpeg`/`ffprobe` só para os comandos que mexem em capa e vídeo.
+
+## Instalação
+
+```sh
+npm install -g @praeko/cli
+yarn global add @praeko/cli
+pnpm add -g @praeko/cli
+bun add -g @praeko/cli
+```
+
+Sem instalar:
+
+```sh
+npx @praeko/cli --help
+pnpm dlx @praeko/cli --help
+bunx @praeko/cli --help
+yarn dlx @praeko/cli --help   # yarn 2+
+```
+
+## Começando
+
+```sh
+praeko --version
+praeko --help
+export PRAEKO_SERVER=https://praeko.app
+export PRAEKO_KEY=praeko_…            # chave criada no painel (ou: echo $CHAVE | praeko key store)
+praeko posts                          # lista os posts do serviço
+praeko post ./meu-pacote --when "30/12 17:30" --networks yt,ig,tt   # SIMULA (nada é enviado)
+praeko post ./meu-pacote --when "30/12 17:30" --networks yt,ig,tt --send
+```
+
+Nada é enviado, hospedado ou agendado sem `--send`.
+
+## Autenticação
+
+A chave vem de `PRAEKO_KEY`. Sem ela, a CLI procura no Chaveiro do macOS (só no Mac, item `praeko/chave`) e no arquivo `~/.config/praeko/segredos.json` (modo 600; mude com `PRAEKO_SEGREDOS`). No Linux e no Windows valem a variável e o arquivo. `PRAEKO_SEM_CHAVEIRO=1` ignora o Chaveiro. O endereço do serviço vem de `--server` ou `PRAEKO_SERVER`.
+
+## Erros e códigos de saída
+
+`0` sucesso; `1` erro (mensagem em português no stderr); `2` comando ou argumento inválido (mostra a ajuda).
+
+## Praeko Studio
+
+`praeko studio …` (gerador de vídeos) ainda não é distribuído pelo npm; fora do repositório o comando avisa e sai com `1`. Os demais comandos não dependem dele.
+
+## Versionamento
+
+[SemVer](https://semver.org/lang/pt-BR/); em `0.x` mudanças incompatíveis podem sair em versões menores, sempre no [CHANGELOG](./CHANGELOG.md). A CLI é publicada com o SDK embutido: não há dependências a instalar.
+
+## Links
+
+Documentação: <https://praeko.app/docs> · Código e issues: <https://github.com/Praeko/praeko-js> · SDK: [`@praeko/sdk`](https://www.npmjs.com/package/@praeko/sdk)
+
+## Licença
+
+[MIT](./LICENSE) © 2026 Marcone Santos.

package/dist/arauto.mjs

@@ -0,0 +1,11 @@
+#!/usr/bin/env node
+import { createRequire as __cr } from 'node:module'; const require = __cr(import.meta.url);
+import "./chunks/chunk-XQO6MI7C.mjs";
+import "./chunks/chunk-LLXYUCTT.mjs";
+import "./chunks/chunk-UK3UKRPR.mjs";
+import "./chunks/chunk-SAHLBARV.mjs";
+import "./chunks/chunk-IZEX746E.mjs";
+import "./chunks/chunk-6YARHJZ2.mjs";
+import "./chunks/chunk-QDZLRBTP.mjs";
+import "./chunks/chunk-Z325UM27.mjs";
+import "./chunks/chunk-LCFK6X55.mjs";

package/dist/chunks/adaptadores-X3NUBMLT.mjs

@@ -0,0 +1,18 @@
+import { createRequire as __cr } from 'node:module'; const require = __cr(import.meta.url);
+import {
+  buffer_exports
+} from "./chunk-SAHLBARV.mjs";
+import {
+  local_exports
+} from "./chunk-IZEX746E.mjs";
+import "./chunk-6YARHJZ2.mjs";
+import {
+  remoto_exports
+} from "./chunk-QDZLRBTP.mjs";
+import "./chunk-Z325UM27.mjs";
+import "./chunk-LCFK6X55.mjs";
+export {
+  buffer_exports as buffer,
+  local_exports as local,
+  remoto_exports as remoto
+};

package/dist/chunks/buffer-5TUDOBVN.mjs

@@ -0,0 +1,14 @@
+import { createRequire as __cr } from 'node:module'; const require = __cr(import.meta.url);
+import {
+  REF_CHAVE,
+  criar
+} from "./chunk-SAHLBARV.mjs";
+import "./chunk-IZEX746E.mjs";
+import "./chunk-6YARHJZ2.mjs";
+import "./chunk-QDZLRBTP.mjs";
+import "./chunk-Z325UM27.mjs";
+import "./chunk-LCFK6X55.mjs";
+export {
+  REF_CHAVE,
+  criar
+};

package/dist/chunks/chunk-6YARHJZ2.mjs

@@ -0,0 +1,56 @@
+import { createRequire as __cr } from 'node:module'; const require = __cr(import.meta.url);
+import {
+  __export,
+  __glob
+} from "./chunk-LCFK6X55.mjs";
+
+// ../core/src/provedores/registro.mjs
+var registro_exports = {};
+__export(registro_exports, {
+  NOMES: () => NOMES,
+  carregar: () => carregar,
+  carregarTodos: () => carregarTodos
+});
+
+// import("./**/*.mjs") in ../core/src/provedores/registro.mjs
+var globImport_mjs = __glob({
+  "./instagram-meta.mjs": () => import("./instagram-meta-COY6BTNX.mjs"),
+  "./instagram.mjs": () => import("./instagram-GNY73ESY.mjs"),
+  "./registro.mjs": () => import("./registro-FL2CVMYM.mjs"),
+  "./tiktok-api.mjs": () => import("./tiktok-api-36DV2H43.mjs"),
+  "./tiktok.mjs": () => import("./tiktok-QOUHOWDU.mjs"),
+  "./youtube-analytics.mjs": () => import("./youtube-analytics-3KIW2ZIW.mjs"),
+  "./youtube-api.mjs": () => import("./youtube-api-Z2RP5D2V.mjs"),
+  "./youtube-comunidade.mjs": () => import("./youtube-comunidade-OAK5GGK4.mjs"),
+  "./youtube.mjs": () => import("./youtube-RZ4XTUZW.mjs")
+});
+
+// ../core/src/provedores/registro.mjs
+var NOMES = ["youtube", "instagram", "tiktok"];
+async function carregar(nome) {
+  if (!NOMES.includes(nome)) throw new Error(`provedor desconhecido: ${nome}`);
+  try {
+    return await globImport_mjs(`./${nome}.mjs`);
+  } catch (e) {
+    if (e.code === "ERR_MODULE_NOT_FOUND" && String(e.message).includes(`${nome}.mjs`)) throw new Error(`provedor "${nome}" ainda n\xE3o foi escrito`);
+    throw e;
+  }
+}
+async function carregarTodos() {
+  const o = {};
+  for (const n of NOMES) {
+    try {
+      o[n] = await carregar(n);
+    } catch (e) {
+      if (!/ainda não foi escrito/.test(e.message)) throw e;
+    }
+  }
+  return o;
+}
+
+export {
+  NOMES,
+  carregar,
+  carregarTodos,
+  registro_exports
+};

package/dist/chunks/chunk-IZEX746E.mjs

@@ -0,0 +1,238 @@
+import { createRequire as __cr } from 'node:module'; const require = __cr(import.meta.url);
+import {
+  carregarTodos
+} from "./chunk-6YARHJZ2.mjs";
+import {
+  PROVEDORES,
+  validarPedido
+} from "./chunk-Z325UM27.mjs";
+import {
+  __export,
+  __glob
+} from "./chunk-LCFK6X55.mjs";
+
+// ../core/src/adaptadores/local.mjs
+var local_exports = {};
+__export(local_exports, {
+  MODO_PADRAO: () => MODO_PADRAO,
+  criar: () => criar,
+  estadoDe: () => estadoDe
+});
+
+// ../core/src/fila.mjs
+import { existsSync as existsSync2, mkdirSync, readFileSync, renameSync, writeFileSync } from "node:fs";
+import { dirname } from "node:path";
+import { randomBytes } from "node:crypto";
+
+// ../core/src/estado.mjs
+import { existsSync } from "node:fs";
+import { join } from "node:path";
+var PASTA_ESTADO = ".praeko";
+var PASTA_ESTADO_ANTIGA = ".arauto";
+var pastaEstado = (raiz) => join(raiz, PASTA_ESTADO);
+var caminhoEstado = (raiz, ...nome) => join(raiz, PASTA_ESTADO, ...nome);
+function caminhoLeitura(raiz, ...nome) {
+  const novo = caminhoEstado(raiz, ...nome);
+  if (existsSync(novo)) return novo;
+  const velho = join(raiz, PASTA_ESTADO_ANTIGA, ...nome);
+  return existsSync(velho) ? velho : novo;
+}
+
+// ../core/src/fila.mjs
+var MAX_TENTATIVAS = 3;
+var arquivoFila = (raiz) => caminhoEstado(raiz, "fila.json");
+function lerFila(raiz) {
+  const f = caminhoLeitura(raiz, "fila.json");
+  return existsSync2(f) ? JSON.parse(readFileSync(f, "utf8")) : { itens: [] };
+}
+function salvarFila(raiz, fila) {
+  const f = arquivoFila(raiz);
+  mkdirSync(dirname(f), { recursive: true });
+  writeFileSync(f + ".tmp", JSON.stringify(fila, null, 2) + "\n");
+  renameSync(f + ".tmp", f);
+}
+function enfileirar(raiz, item) {
+  const fila = lerFila(raiz);
+  const it = { id: randomBytes(4).toString("hex"), estado: "pendente", tentativas: 0, criadoEm: (/* @__PURE__ */ new Date()).toISOString(), ...item };
+  fila.itens.push(it);
+  salvarFila(raiz, fila);
+  return it;
+}
+function liberarItem(raiz, id) {
+  const fila = lerFila(raiz), it = fila.itens.find((x) => x.id === id || x.id.startsWith(id));
+  if (!it) throw new Error(`item ${id} n\xE3o existe na fila`);
+  if (!it.manual) throw new Error(`item ${it.id} n\xE3o \xE9 manual`);
+  it.manual = false;
+  it.quando = (/* @__PURE__ */ new Date()).toISOString();
+  it.tentativas = 0;
+  it.estado = "pendente";
+  salvarFila(raiz, fila);
+  return it;
+}
+function cancelarItem(raiz, id) {
+  const fila = lerFila(raiz), it = fila.itens.find((x) => x.id === id || x.id.startsWith(id));
+  if (!it) throw new Error(`item ${id} n\xE3o existe na fila`);
+  if (it.estado === "enviado") throw new Error(`item ${it.id} j\xE1 foi enviado; desfa\xE7a pela pr\xF3pria rede`);
+  it.estado = "cancelado";
+  it.canceladoEm = (/* @__PURE__ */ new Date()).toISOString();
+  salvarFila(raiz, fila);
+  return it;
+}
+function proximaAcao(it, prov, agora) {
+  if (it.manual) return null;
+  if (!["pendente", "preparado"].includes(it.estado) || it.tentativas >= MAX_TENTATIVAS) return null;
+  const t = Date.parse(it.quando), ant = it.acao ? 0 : prov.antecedenciaMs ?? 0;
+  if (prov.imediato && !it.acao) return it.estado === "pendente" ? "publicar" : null;
+  if (it.estado === "pendente" && prov.preparar && +agora >= t - ant && +agora < t) return "preparar";
+  if (+agora >= t) return "publicar";
+  return null;
+}
+async function executar({ raiz, provedores, ctx, agora = /* @__PURE__ */ new Date(), simular = false, soIds = null, log = console.log }) {
+  const fila = lerFila(raiz), feitos = [];
+  for (const it of fila.itens) {
+    if (soIds && !soIds.includes(it.id)) continue;
+    const prov = provedores[it.provedor];
+    if (!prov) {
+      if (["pendente", "preparado"].includes(it.estado)) log(`\u26A0 ${it.id}: provedor "${it.provedor}" n\xE3o instalado`);
+      continue;
+    }
+    let acao = proximaAcao(it, prov, agora);
+    while (acao) {
+      if (simular) {
+        log(`\u2022 ${it.id} ${it.rede} (${it.slug}): ${acao}`);
+        break;
+      }
+      try {
+        if (acao === "preparar") {
+          it.prep = await prov.preparar({ item: it, ctx });
+          it.estado = "preparado";
+          log(`\u2713 ${it.id} ${it.rede}: preparado`);
+        } else {
+          it.resultado = await prov.publicar({ item: it, ctx });
+          it.estado = "enviado";
+          it.enviadoEm = (/* @__PURE__ */ new Date()).toISOString();
+          log(`\u2713 ${it.id} ${it.rede}${it.acao ? " (" + it.acao + ")" : ""}: enviado${it.resultado?.url ? " " + it.resultado.url : ""}`);
+          for (const s of it.resultado?.seguinte || []) fila.itens.push({ id: randomBytes(4).toString("hex"), estado: "pendente", tentativas: 0, criadoEm: (/* @__PURE__ */ new Date()).toISOString(), origem: it.id, ...s });
+          delete it.resultado.seguinte;
+        }
+        feitos.push(it.id);
+      } catch (e) {
+        it.tentativas++;
+        it.erro = String(e.message || e).slice(0, 500);
+        if (it.tentativas >= MAX_TENTATIVAS) it.estado = "erro";
+        log(`\u2717 ${it.id} ${it.rede}: ${it.erro}${it.estado === "erro" ? " (desisti)" : ` (tentativa ${it.tentativas}/${MAX_TENTATIVAS})`}`);
+      }
+      salvarFila(raiz, fila);
+      acao = it.estado === "enviado" ? null : acao === "preparar" && it.estado === "preparado" ? proximaAcao(it, prov, agora) : null;
+    }
+  }
+  return { feitos, fila };
+}
+function plistLaunchd({ rotulo = "br.praeko.fila", node, praeko, arauto, cwd, minutos = 5, log }) {
+  return `<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0"><dict>
+<key>Label</key><string>${rotulo}</string>
+<key>ProgramArguments</key><array><string>${node}</string><string>${praeko ?? arauto}</string><string>fila</string><string>executar</string></array>
+<key>WorkingDirectory</key><string>${cwd}</string>
+<key>StartInterval</key><integer>${minutos * 60}</integer>
+<key>RunAtLoad</key><true/>
+<key>StandardOutPath</key><string>${log}</string><key>StandardErrorPath</key><string>${log}</string>
+</dict></plist>
+`;
+}
+
+// import("./adaptadores/**/*.mjs") in ../core/src/publicador.mjs
+var globImport_adaptadores_mjs = __glob({
+  "./adaptadores/buffer.mjs": () => import("./buffer-5TUDOBVN.mjs"),
+  "./adaptadores/index.mjs": () => import("./adaptadores-X3NUBMLT.mjs"),
+  "./adaptadores/local.mjs": () => import("./local-EUJHQ76T.mjs"),
+  "./adaptadores/remoto.mjs": () => import("./remoto-OAB5Y2MS.mjs")
+});
+
+// ../core/src/publicador.mjs
+async function criarPublicador({ config, provedor, ctx } = {}) {
+  const nome = provedor || config?.provedor || "buffer";
+  if (!PROVEDORES.includes(nome)) throw new Error(`provedor "${nome}" desconhecido (use ${PROVEDORES.join(", ")})`);
+  const mod = await globImport_adaptadores_mjs(`./adaptadores/${nome}.mjs`);
+  return mod.criar({ config, ctx });
+}
+
+// ../core/src/adaptadores/local.mjs
+import { randomBytes as randomBytes2 } from "node:crypto";
+var MODO_PADRAO = { youtube: "privado", tiktok: "rascunho", instagram: "agora" };
+function estadoDe(it) {
+  if (it.estado === "cancelado") return "cancelado";
+  if (it.estado === "erro") return "erro";
+  if (it.estado === "enviado") {
+    if (it.acao) return "enviado";
+    if (it.rede === "youtube" && it.resultado?.privacidade === "private" && !it.resultado?.publishAt) return "privado";
+    if (it.rede === "tiktok" && it.resultado?.modo === "rascunho") return "rascunho";
+    return it.rede === "youtube" && it.resultado?.publishAt ? "agendado" : "enviado";
+  }
+  return "agendado";
+}
+var itemDoContrato = (it) => ({ rede: it.rede, id: it.id, estado: estadoDe(it), quando: it.quando, ...it.acao ? { acao: it.acao } : {}, ...it.manual ? { manual: true } : {}, ...it.resultado?.url ? { url: it.resultado.url } : {}, ...it.resultado?.studio ? { studio: it.resultado.studio } : {}, ...it.erro ? { aviso: it.erro } : {} });
+function criar({ config, ctx, provedores }) {
+  const todos = async () => provedores || carregarTodos();
+  const agora = () => ctx.agora ? ctx.agora() : /* @__PURE__ */ new Date();
+  const doPedido = (id) => lerFila(ctx.raiz).itens.filter((x) => x.pedido === id);
+  return {
+    nome: "local",
+    async publicar(pedido) {
+      const erros = validarPedido(pedido);
+      if (erros.length) throw new Error(`pedido inv\xE1lido: ${erros.join("; ")}`);
+      const id = pedido.id || `p${randomBytes2(3).toString("hex")}`, provs = await todos();
+      const faltam = pedido.destinos.filter((d) => !provs[d.rede]).map((d) => d.rede);
+      if (faltam.length) throw new Error(`provedor n\xE3o instalado: ${faltam.join(", ")}`);
+      const novos = pedido.destinos.map((d) => {
+        const op = { ...config[d.rede] || {}, ...pedido.opcoes?.[d.rede] || {} };
+        op.modo = d.modo || op.modo || MODO_PADRAO[d.rede];
+        return enfileirar(ctx.raiz, { pedido: id, slug: id, rede: d.rede, provedor: d.rede, quando: d.quando || agora().toISOString(), video: pedido.midia.video, capa: pedido.midia.capa || null, textos: pedido.textos[d.rede], opcoes: op, formato: pedido.opcoes?.formato || "short", titulo: pedido.titulo });
+      });
+      await executar({ raiz: ctx.raiz, provedores: provs, ctx, agora: agora(), soIds: novos.map((n) => n.id), log: ctx.log });
+      return { id, itens: doPedido(id).map(itemDoContrato) };
+    },
+    async status(id) {
+      const it = doPedido(id);
+      if (!it.length) throw new Error(`pedido ${id} n\xE3o existe na fila`);
+      return { id, itens: it.map(itemDoContrato) };
+    },
+    async cancelar(id) {
+      const cancelados = [], mantidos = [];
+      for (const it of doPedido(id)) {
+        if (["enviado", "cancelado"].includes(it.estado)) {
+          if (it.estado === "enviado") mantidos.push(itemDoContrato(it));
+        } else {
+          cancelarItem(ctx.raiz, it.id);
+          cancelados.push(it.id);
+        }
+      }
+      return { cancelados, mantidos };
+    },
+    async canais() {
+      const provs = await todos(), out = [];
+      for (const [rede, p] of Object.entries(provs)) {
+        const s = await p.status({ ctx });
+        out.push({ rede, conectado: s.conectado, detalhe: s.detalhe });
+      }
+      return out;
+    }
+  };
+}
+
+export {
+  pastaEstado,
+  caminhoEstado,
+  caminhoLeitura,
+  lerFila,
+  liberarItem,
+  cancelarItem,
+  executar,
+  plistLaunchd,
+  MODO_PADRAO,
+  estadoDe,
+  criar,
+  local_exports,
+  criarPublicador
+};

package/dist/chunks/chunk-LCFK6X55.mjs

@@ -0,0 +1,16 @@
+import { createRequire as __cr } from 'node:module'; const require = __cr(import.meta.url);
+var __defProp = Object.defineProperty;
+var __glob = (map) => (path) => {
+  var fn = map[path];
+  if (fn) return fn();
+  throw new Error("Module not found in bundle: " + path);
+};
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+
+export {
+  __glob,
+  __export
+};

package/dist/chunks/chunk-LLXYUCTT.mjs

@@ -0,0 +1,184 @@
+import { createRequire as __cr } from 'node:module'; const require = __cr(import.meta.url);
+import {
+  API,
+  api,
+  canalId,
+  falha
+} from "./chunk-UK3UKRPR.mjs";
+
+// ../core/src/provedores/youtube-comunidade.mjs
+var lerJson = async (r) => {
+  const t = await r.text();
+  if (!r.ok) throw falha(r.status, t);
+  return t ? JSON.parse(t) : {};
+};
+var ate = (n, max) => Math.max(1, Math.min(max, Math.floor(+n) || 20));
+var resumoVideo = (v) => ({
+  id: v.id,
+  titulo: v.snippet?.title,
+  descricao: v.snippet?.description,
+  publicadoEm: v.snippet?.publishedAt,
+  privacidade: v.status?.privacyStatus,
+  publishAt: v.status?.publishAt || null,
+  duracao: v.contentDetails?.duration,
+  tags: v.snippet?.tags || [],
+  visualizacoes: v.statistics?.viewCount != null ? +v.statistics.viewCount : null,
+  curtidas: v.statistics?.likeCount != null ? +v.statistics.likeCount : null,
+  comentarios: v.statistics?.commentCount != null ? +v.statistics.commentCount : null,
+  url: `https://youtu.be/${v.id}`
+});
+async function listarVideos({ ctx, max = 20, pagina }) {
+  const cid = await canalId(ctx);
+  const c = await lerJson(await api(ctx, `${API}/channels?part=contentDetails&id=${cid}`));
+  const uploads = c.items?.[0]?.contentDetails?.relatedPlaylists?.uploads;
+  if (!uploads) throw new Error("o canal n\xE3o tem playlist de uploads");
+  const p = await lerJson(await api(ctx, `${API}/playlistItems?part=contentDetails&playlistId=${uploads}&maxResults=${ate(max, 50)}${pagina ? `&pageToken=${encodeURIComponent(pagina)}` : ""}`));
+  const ids = (p.items || []).map((i) => i.contentDetails?.videoId).filter(Boolean);
+  if (!ids.length) return { videos: [], proxima: p.nextPageToken || null };
+  const d = await lerJson(await api(ctx, `${API}/videos?part=snippet,status,statistics,contentDetails&id=${ids.join(",")}&maxResults=50`));
+  const porId = new Map((d.items || []).map((v) => [v.id, v]));
+  return { videos: ids.map((id) => porId.get(id)).filter(Boolean).map(resumoVideo), proxima: p.nextPageToken || null };
+}
+async function lerVideo({ ctx, videoId }) {
+  const d = await lerJson(await api(ctx, `${API}/videos?part=snippet,status,statistics,contentDetails&id=${encodeURIComponent(videoId)}`));
+  const v = d.items?.[0];
+  if (!v) throw Object.assign(new Error(`o v\xEDdeo ${videoId} n\xE3o existe neste canal`), { status: 404 });
+  return resumoVideo(v);
+}
+var CAMPOS_SNIPPET = ["title", "description", "tags", "categoryId", "defaultLanguage", "defaultAudioLanguage"];
+var semAngulos = (s) => !/[<>]/.test(s);
+async function apagarVideo({ ctx, videoId }) {
+  const r = await api(ctx, `${API}/videos?id=${encodeURIComponent(videoId)}`, { method: "DELETE" });
+  if (r.status === 404) return { id: videoId, apagado: false, jaNaoExistia: true };
+  if (r.status < 200 || r.status > 299) throw Object.assign(new Error(`o YouTube recusou apagar o v\xEDdeo (HTTP ${r.status})`), { status: r.status });
+  return { id: videoId, apagado: true };
+}
+async function editarVideo({ ctx, videoId, titulo, descricao, tags, simular = false }) {
+  if (titulo === void 0 && descricao === void 0 && tags === void 0) throw new Error("nada para mudar: informe titulo, descricao ou tags");
+  if (titulo !== void 0 && (!titulo.trim() || titulo.length > 100 || !semAngulos(titulo))) throw new Error("t\xEDtulo inv\xE1lido: de 1 a 100 caracteres e sem < ou >");
+  if (descricao !== void 0 && (descricao.length > 5e3 || !semAngulos(descricao))) throw new Error("descri\xE7\xE3o inv\xE1lida: at\xE9 5000 caracteres e sem < ou >");
+  if (tags !== void 0 && (!Array.isArray(tags) || tags.join(",").length > 500)) throw new Error("tags inv\xE1lidas: lista de at\xE9 500 caracteres no total");
+  const d = await lerJson(await api(ctx, `${API}/videos?part=snippet&id=${encodeURIComponent(videoId)}`));
+  const v = d.items?.[0];
+  if (!v) throw Object.assign(new Error(`o v\xEDdeo ${videoId} n\xE3o existe neste canal`), { status: 404 });
+  const atual = {};
+  for (const k of CAMPOS_SNIPPET) if (v.snippet?.[k] !== void 0) atual[k] = v.snippet[k];
+  const novo = { ...atual, ...titulo !== void 0 ? { title: titulo } : {}, ...descricao !== void 0 ? { description: descricao } : {}, ...tags !== void 0 ? { tags } : {} };
+  const antes = { titulo: atual.title, descricao: atual.description, tags: atual.tags || [] };
+  const depois = { titulo: novo.title, descricao: novo.description, tags: novo.tags || [] };
+  const mudou = JSON.stringify(antes) !== JSON.stringify(depois);
+  if (simular || !mudou) return { id: videoId, antes, depois, mudou, escrito: false };
+  await lerJson(await api(ctx, `${API}/videos?part=snippet`, { method: "PUT", headers: { "content-type": "application/json" }, body: JSON.stringify({ id: videoId, snippet: novo }) }));
+  return { id: videoId, antes, depois, mudou, escrito: true, url: `https://youtu.be/${videoId}` };
+}
+var comentarioDe = (c) => ({
+  id: c.id,
+  autor: c.snippet?.authorDisplayName,
+  autorCanal: c.snippet?.authorChannelId?.value || null,
+  texto: c.snippet?.textOriginal ?? c.snippet?.textDisplay,
+  publicadoEm: c.snippet?.publishedAt,
+  curtidas: c.snippet?.likeCount ?? 0
+});
+async function donoRespondeu(ctx, thread, cid) {
+  const total = thread.snippet?.totalReplyCount ?? 0;
+  if (!total) return false;
+  const vindas = (thread.replies?.comments || []).map(comentarioDe);
+  if (vindas.some((c) => c.autorCanal === cid)) return true;
+  if (vindas.length >= total) return false;
+  let pagina;
+  do {
+    const r = await lerJson(await api(ctx, `${API}/comments?part=snippet&parentId=${encodeURIComponent(thread.id)}&maxResults=100&textFormat=plainText${pagina ? `&pageToken=${encodeURIComponent(pagina)}` : ""}`));
+    if ((r.items || []).some((c) => c.snippet?.authorChannelId?.value === cid)) return true;
+    pagina = r.nextPageToken;
+  } while (pagina);
+  return false;
+}
+async function listarComentarios({ ctx, videoId, semResposta = false, max = 20, pagina }) {
+  const cid = await canalId(ctx);
+  const alvo = videoId ? `videoId=${encodeURIComponent(videoId)}` : `allThreadsRelatedToChannelId=${cid}`;
+  const saida = [];
+  let prox = pagina || null, paginas = 0;
+  do {
+    const r = await lerJson(await api(ctx, `${API}/commentThreads?part=snippet,replies&${alvo}&maxResults=${ate(semResposta ? 100 : max, 100)}&order=time&textFormat=plainText${prox ? `&pageToken=${encodeURIComponent(prox)}` : ""}`));
+    paginas++;
+    prox = r.nextPageToken || null;
+    for (const t of r.items || []) {
+      const topo = comentarioDe(t.snippet?.topLevelComment || {});
+      const doDono = topo.autorCanal === cid;
+      const respondido = doDono ? false : await donoRespondeu(ctx, t, cid);
+      if (semResposta && (doDono || respondido)) continue;
+      saida.push({
+        id: t.id,
+        videoId: t.snippet?.videoId || videoId || null,
+        ...topo,
+        doDono,
+        totalRespostas: t.snippet?.totalReplyCount ?? 0,
+        respondido,
+        respostas: (t.replies?.comments || []).map(comentarioDe)
+      });
+      if (saida.length >= max) return { comentarios: saida, proxima: prox };
+    }
+  } while (prox && semResposta && paginas < 10);
+  return { comentarios: saida, proxima: prox };
+}
+async function responderComentario({ ctx, parentId, texto }) {
+  if (!parentId) throw new Error("falta o id do coment\xE1rio (thread)");
+  if (!texto || !texto.trim() || texto.length > 1e4) throw new Error("texto inv\xE1lido: de 1 a 10000 caracteres");
+  const j = await lerJson(await api(ctx, `${API}/comments?part=snippet`, { method: "POST", headers: { "content-type": "application/json" }, body: JSON.stringify({ snippet: { parentId, textOriginal: texto } }) }));
+  return { id: j.id, parentId, texto: j.snippet?.textOriginal ?? texto };
+}
+function trocarHashtags(descricao, novas) {
+  const nv = String(novas).trim().split(/\s+/).filter(Boolean).map((h) => h.startsWith("#") ? h : `#${h}`).join(" ");
+  if (!nv) throw new Error("informe ao menos uma hashtag");
+  const linhas = String(descricao || "").replace(/\s+$/, "").split("\n");
+  for (let i = linhas.length - 1; i >= 0; i--) {
+    if (!linhas[i].trim()) continue;
+    if (/^\s*(#\S+\s*)+$/.test(linhas[i])) {
+      linhas[i] = nv;
+      return linhas.join("\n");
+    }
+    break;
+  }
+  return `${linhas.join("\n")}
+
+${nv}`.replace(/^\n+/, "");
+}
+var num = (x) => x != null && x !== "" && !Number.isNaN(+x) ? +x : null;
+async function estatisticasVideos({ ctx, ids }) {
+  const saida = /* @__PURE__ */ new Map(), unicos = [...new Set(ids)];
+  for (let i = 0; i < unicos.length; i += 50) {
+    const lote = unicos.slice(i, i + 50);
+    const d = await lerJson(await api(ctx, `${API}/videos?part=snippet,status,statistics&id=${lote.map(encodeURIComponent).join(",")}&maxResults=50`));
+    for (const v of d.items || []) {
+      saida.set(v.id, {
+        views: num(v.statistics?.viewCount),
+        curtidas: num(v.statistics?.likeCount),
+        comentarios: num(v.statistics?.commentCount),
+        privacidade: v.status?.privacyStatus || null,
+        publishAt: v.status?.publishAt || null,
+        publicadoEm: v.snippet?.publishedAt || null,
+        titulo: v.snippet?.title || null
+      });
+    }
+  }
+  return saida;
+}
+async function estatisticasCanal({ ctx }) {
+  const d = await lerJson(await api(ctx, `${API}/channels?part=statistics&mine=true`));
+  const c = d.items?.[0];
+  if (!c) throw new Error("a conta autorizada n\xE3o tem canal do YouTube");
+  const s = c.statistics || {};
+  return { seguidores: s.hiddenSubscriberCount ? null : num(s.subscriberCount), totalViews: num(s.viewCount), totalVideos: num(s.videoCount) };
+}
+
+export {
+  listarVideos,
+  lerVideo,
+  apagarVideo,
+  editarVideo,
+  listarComentarios,
+  responderComentario,
+  trocarHashtags,
+  estatisticasVideos,
+  estatisticasCanal
+};