@praeko/cli 0.0.0-stage → 0.1.1

package/CHANGELOG.md

@@ -0,0 +1,13 @@
+# Changelog
+
+Segue [Keep a Changelog](https://keepachangelog.com/pt-BR/1.1.0/) e [SemVer](https://semver.org/lang/pt-BR/).
+
+## [0.1.1] - 2026-11-07
+
+- Um só comando, `praeko` (o alias `arauto` saiu do pacote). Com dois comandos o `npx @praeko/cli` não sabia qual rodar e falhava com "could not determine executable to run"; agora `npx @praeko/cli --help` funciona. Quem usou a 0.1.0 pode rodar `npx -p @praeko/cli praeko`.
+
+## [0.1.0] - 2026-11-07
+
+Primeira versão preparada para o npm.
+- Pacote `@praeko/cli`: comando `praeko`, 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` (antes chamado `arauto`). 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/chunks/adaptadores-ESUZ36N2.mjs

@@ -0,0 +1,18 @@
+import { createRequire as __cr } from 'node:module'; const require = __cr(import.meta.url);
+import {
+  buffer_exports
+} from "./chunk-ZZKGFOPH.mjs";
+import {
+  local_exports
+} from "./chunk-TTGQU5CG.mjs";
+import "./chunk-VJRMAQCR.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-SP52FWTI.mjs

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

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
+};