@holdyapp/install 0.3.0 → 0.5.0

package/README.md

@@ -5,13 +5,16 @@ CLI de instalação do Holdy SDK. Detecta seu framework e wira o SDK em 1 passo.
 ## Uso
 
 ```bash
-npx @holdyapp/install <SUA_API_KEY>
+npx @holdyapp/install
 ```
 
-Sem argumentos? Roda em modo interativo:
+Abre o navegador pra você entrar na Holdy (ou criar a conta), conferir o código e autorizar. A chave chega sozinha no terminal, sem copiar nada. Com `--instrument`, a Holdy também lê seu código e propõe os eventos do produto, usando uma chave secreta que vale 1 hora.
+
+Prefere colar a chave?
 
 ```bash
-npx @holdyapp/install
+npx @holdyapp/install <SUA_API_KEY>
+npx @holdyapp/install --paste-key
 ```
 
 ## Opções
@@ -19,6 +22,8 @@ npx @holdyapp/install
 ```
 npx @holdyapp/install <apiKey> [opções]
 
+  --instrument          Lê o código e propõe os eventos do produto
+  --paste-key           Pede a chave no terminal em vez de abrir o navegador
   --account <id>        Account ID padrão pro Holdy.init
   --no-auto-capture     Desabilita captura automática de page views
   --version, -v         Mostra versão

package/dist/cli.js

@@ -174,8 +174,11 @@ declare global {
   interface Window {
     Holdy?: {
       init: (opts: Record<string, unknown>) => void
-      identify: (opts: Record<string, unknown>) => void
-      track: (primitive: string, payload?: Record<string, unknown>) => void
+      identify: (userId: string, traits?: Record<string, unknown>) => void
+      group: (accountKey: string, traits?: Record<string, unknown>) => void
+      track: (event: string, properties?: Record<string, unknown>) => void
+      page: (name?: string, properties?: Record<string, unknown>) => void
+      reset: () => void
     }
   }
 }
@@ -592,11 +595,27 @@ async function runInstrument(opts) {
     `${patches.length} ${patches.length === 1 ? "evento inserido" : "eventos inseridos"} em ${written.length} ${written.length === 1 ? "arquivo" : "arquivos"}`
   );
   for (const file of written) ui.info(file);
+  printMetrics(plan.metrics, ui);
   console.log();
   ui.info("Os eventos se registram sozinhos na taxonomia no primeiro emit \u2014 n\xE3o precisa declarar nada na Holdy.");
-  ui.info("Rode o app, use o produto e acompanhe em /setup/captura.");
+  ui.info("Rode o app, use o produto e acompanhe em holdy.chat/onboarding.");
   return 0;
 }
+function printMetrics(metrics, ui) {
+  if (!metrics || metrics.length === 0) return;
+  const prontas = metrics.filter((m) => m.ready);
+  const faltando = metrics.filter((m) => !m.ready);
+  console.log();
+  console.log(`  ${ui.bold("O que voc\xEA passa a medir")}`);
+  console.log();
+  for (const m of prontas) {
+    const extra = m.needs_choice ? ui.dim(` \xB7 ${m.needs_choice}`) : "";
+    console.log(`  ${ui.green("\u2713")} ${m.label}${extra}`);
+  }
+  for (const m of faltando) {
+    console.log(`  ${ui.dim("\xB7")} ${ui.dim(`${m.label} \u2014 falta evento de fase ${m.missing.join(" e ")}`)}`);
+  }
+}
 async function requestPlan(opts, files) {
   const url = `${opts.baseUrl.replace(/\/$/, "")}/instrumentation/plan`;
   const response = await fetch(url, {
@@ -718,8 +737,86 @@ function confirm(question) {
   });
 }
 
+// src/login.ts
+var import_node_child_process = require("node:child_process");
+var sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
+function openBrowser(url) {
+  if (process.env.CI || process.env.HOLDY_NO_BROWSER) return false;
+  try {
+    const child = process.platform === "darwin" ? (0, import_node_child_process.spawn)("open", [url], { stdio: "ignore", detached: true }) : process.platform === "win32" ? (0, import_node_child_process.spawn)("cmd", ["/c", "start", '""', url], { stdio: "ignore", detached: true }) : (0, import_node_child_process.spawn)("xdg-open", [url], { stdio: "ignore", detached: true });
+    child.on("error", () => void 0);
+    child.unref();
+    return true;
+  } catch {
+    return false;
+  }
+}
+async function loginWithBrowser(opts) {
+  const { ui } = opts;
+  let session;
+  try {
+    const res = await fetch(`${opts.apiUrl}/cli/sessions`, {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify({ instrument: opts.instrument, client: opts.client })
+    });
+    if (!res.ok) {
+      ui.error(`A Holdy n\xE3o abriu a sess\xE3o de login (HTTP ${res.status}).`);
+      return null;
+    }
+    session = await res.json();
+  } catch (err) {
+    ui.error(`N\xE3o consegui falar com a Holdy: ${err instanceof Error ? err.message : String(err)}`);
+    return null;
+  }
+  console.log();
+  console.log(`      Seu c\xF3digo: ${ui.bold(session.user_code)}`);
+  const opened = openBrowser(session.verification_url);
+  console.log(
+    `      ${opened ? "Abri o navegador. Se n\xE3o abriu, acesse:" : "Abra no navegador:"} ${ui.cyan(session.verification_url)}`
+  );
+  console.log(`      ${ui.dim("Entre ou crie sua conta, confira o c\xF3digo e clique em Autorizar.")}`);
+  console.log();
+  const deadline = Date.now() + session.expires_in * 1e3;
+  let interval = Math.max(1, session.interval) * 1e3;
+  while (Date.now() < deadline) {
+    await sleep(interval);
+    let res;
+    try {
+      res = await fetch(`${opts.apiUrl}/cli/sessions/poll`, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({ device_code: session.device_code })
+      });
+    } catch {
+      continue;
+    }
+    if (res.status === 202) continue;
+    if (res.status === 429) {
+      interval = Math.min(interval * 2, 1e4);
+      continue;
+    }
+    if (res.status === 403) {
+      ui.error("Autoriza\xE7\xE3o cancelada no navegador.");
+      return null;
+    }
+    if (res.status === 410) break;
+    if (res.ok) {
+      const body = await res.json();
+      if (!body.public_key) break;
+      return {
+        publicKey: body.public_key,
+        secretKey: body.secret_key ?? null,
+        organizationName: body.organization_name ?? null
+      };
+    }
+  }
+  ui.error("O c\xF3digo expirou antes da autoriza\xE7\xE3o. Rode o comando de novo.");
+  return null;
+}
+
 // src/cli.ts
-var VERSION = "0.3.0";
+var VERSION = "0.5.0";
 var DEFAULT_API_URL = "https://holdy.chat/api/v1";
 async function main() {
   const argv = process.argv.slice(2);
@@ -741,14 +838,30 @@ async function main() {
     log.warn('N\xE3o consegui identificar o framework. Sigo no modo "vanilla" (script tag).');
   }
   let apiKey = args.apiKey;
-  if (!apiKey) {
+  let instrumentKey = null;
+  if (!apiKey && args.pasteKey) {
     apiKey = await promptApiKey();
+  } else if (!apiKey) {
+    log.step("2", "Entrando na Holdy pelo navegador\u2026");
+    const login = await loginWithBrowser({
+      apiUrl: args.apiUrl,
+      instrument: args.instrument,
+      client: { framework: detection.framework, project: projectName(cwd), cli_version: VERSION },
+      ui: { ...log, bold, dim, cyan }
+    });
+    if (!login) {
+      log.info(`Prefere colar a chave? ${bold("npx @holdyapp/install --paste-key")}`);
+      process.exit(1);
+    }
+    log.success(login.organizationName ? `Autorizado em ${bold(login.organizationName)}` : "Autorizado");
+    apiKey = login.publicKey;
+    instrumentKey = login.secretKey;
   }
   if (!apiKey || !apiKey.startsWith("hol_")) {
     log.error("API key inv\xE1lida. Use formato hol_live_\u2026 ou hol_test_\u2026 \xB7 gere em holdy.chat/settings.");
     process.exit(1);
   }
-  log.step("2", "Aplicando snippet no(s) arquivo(s)\u2026");
+  log.step("3", "Aplicando snippet no(s) arquivo(s)\u2026");
   const result = inject(detection, {
     apiKey,
     accountId: args.accountId,
@@ -769,20 +882,20 @@ async function main() {
     }
     process.exit(2);
   }
-  if (detection.usePackage) {
-    log.step("3", "Falta instalar o pacote npm:");
+  if (detection.usePackage && detection.framework !== "next-app") {
+    log.step("4", "Falta instalar o pacote npm:");
     console.log();
     console.log("   npm install @holdyapp/sdk");
     console.log();
   } else {
-    log.step("3", "Sem npm install necess\xE1rio \xB7 script tag via CDN.");
+    log.step("4", "Sem npm install necess\xE1rio \xB7 script tag via CDN.");
   }
   if (args.instrument) {
     console.log();
-    log.step("4", "Instrumentando eventos de produto\u2026");
+    log.step("5", "Instrumentando eventos de produto\u2026");
     const code = await runInstrument({
       cwd,
-      apiKey,
+      apiKey: instrumentKey ?? apiKey,
       baseUrl: args.apiUrl,
       framework: detection.framework,
       sdkStyle: detection.usePackage ? "npm" : "script",
@@ -793,10 +906,10 @@ async function main() {
     });
     if (code !== 0) process.exit(code);
     console.log();
-    log.step("5", "Pronto! Suba o app, use o produto e veja os eventos chegando em holdy.chat.");
+    log.step("6", "Pronto! Suba o app, use o produto e veja os eventos chegando em holdy.chat.");
     process.exit(0);
   }
-  log.step("4", 'Pronto! Inicie o app e abra o widget de status em holdy.chat \xB7 voc\xEA deve ver "conectado" em segundos.');
+  log.step("5", "Pronto! Inicie o app e abra holdy.chat/overview \xB7 o primeiro evento aparece em segundos.");
   process.exit(0);
 }
 function parseArgs(argv) {
@@ -808,7 +921,8 @@ function parseArgs(argv) {
     dryRun: false,
     yes: false,
     maxEvents: 12,
-    apiUrl: process.env.HOLDY_API_URL ?? DEFAULT_API_URL
+    apiUrl: process.env.HOLDY_API_URL ?? DEFAULT_API_URL,
+    pasteKey: false
   };
   for (let i = 0; i < argv.length; i++) {
     const a = argv[i];
@@ -828,6 +942,8 @@ function parseArgs(argv) {
     } else if (a === "--max-events") {
       const parsed = Number(argv[++i]);
       if (Number.isFinite(parsed)) out.maxEvents = Math.min(20, Math.max(3, Math.trunc(parsed)));
+    } else if (a === "--paste-key") {
+      out.pasteKey = true;
     } else if (a === "--api-url") {
       out.apiUrl = argv[++i] ?? out.apiUrl;
     } else if (!a.startsWith("--") && !out.apiKey) {
@@ -839,6 +955,14 @@ function parseArgs(argv) {
   }
   return out;
 }
+function projectName(cwd) {
+  try {
+    const pkg = JSON.parse((0, import_node_fs5.readFileSync)((0, import_node_path5.join)(cwd, "package.json"), "utf8"));
+    if (pkg.name) return pkg.name;
+  } catch {
+  }
+  return (0, import_node_path5.basename)(cwd);
+}
 function promptApiKey() {
   return new Promise((resolve) => {
     const rl = (0, import_node_readline2.createInterface)({ input: process.stdin, output: process.stdout });
@@ -854,8 +978,9 @@ function printHelp() {
 ${bold("@holdyapp/install")} v${VERSION} \xB7 ${isLive ?? "Holdy SDK installer"}
 
 ${bold("Uso:")}
+  npx @holdyapp/install                          # entra pelo navegador, sem colar chave
+  npx @holdyapp/install --instrument             # idem, e j\xE1 prop\xF5e os eventos do seu produto
   npx @holdyapp/install <apiKey> [op\xE7\xF5es]
-  npx @holdyapp/install                          # modo interativo
   HOLDY_API_KEY=hol_live_\u2026 npx @holdyapp/install # via env var
 
 ${bold("Argumentos:")}
@@ -868,6 +993,7 @@ ${bold("Op\xE7\xF5es:")}
   --dry-run             S\xF3 lista os eventos propostos \xB7 n\xE3o escreve nada (implica --instrument)
   --max-events <n>      Teto de eventos propostos \xB7 3 a 20 \xB7 default 12
   --yes, -y             Aplica o diff sem perguntar
+  --paste-key           Pede a chave no terminal em vez de abrir o navegador
   --api-url <url>       Override da API (default https://holdy.chat/api/v1)
   --version, -v         Mostra vers\xE3o
   --help, -h            Mostra esta mensagem
@@ -884,7 +1010,8 @@ ${bold("Exemplos:")}
 
 ${bold("Sobre --instrument:")}
   Manda trechos do seu c\xF3digo pra Holdy, que devolve onde inserir cada track().
-  Exige key SECRETA (n\xE3o a p\xFAblica do browser). Voc\xEA v\xEA o diff antes de aplicar,
+  Pelo navegador, a Holdy entrega uma chave secreta que vale 1 hora s\xF3 pra isso.
+  Com chave colada, exige key SECRETA (n\xE3o a p\xFAblica do browser). Voc\xEA v\xEA o diff antes de aplicar,
   e nada \xE9 escrito sem confirma\xE7\xE3o. Pageview e rota j\xE1 s\xE3o autom\xE1ticos \u2014 o
   planner s\xF3 prop\xF5e momentos em que a conta avan\xE7a no produto.
 `);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@holdyapp/install",
-  "version": "0.3.0",
+  "version": "0.5.0",
   "description": "Holdy install CLI · detects your framework, wires the SDK and instruments product events",
   "license": "MIT",
   "homepage": "https://holdy.chat",