@holdyapp/install 0.4.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
     }
   }
 }
@@ -235,7 +238,7 @@ function injectNextPages(file, opts) {
   if (typeof window !== 'undefined' && !window.__holdyInit) { initHoldy({ apiKey: '${opts.apiKey}', ${opts.accountId ? `accountKey: '${opts.accountId}', ` : ""}autoCapture: ${opts.autoCapture} }); (window as unknown as { __holdyInit?: boolean }).__holdyInit = true }`
   );
   (0, import_node_fs2.writeFileSync)(file, patched);
-  return { ok: true, modified: true, file, message: `Patched ${displayPath(file)} \xB7 rode npm install https://holdy.chat/sdk/holdyapp-sdk-1.5.0.tgz` };
+  return { ok: true, modified: true, file, message: `Patched ${displayPath(file)} \xB7 rode npm install @holdyapp/sdk` };
 }
 function injectViteReact(file, opts) {
   if (!file || !(0, import_node_fs2.existsSync)(file)) {
@@ -256,7 +259,7 @@ initHoldy({ apiKey: '${opts.apiKey}', ${opts.accountId ? `accountKey: '${opts.ac
 
 ${original}`;
   (0, import_node_fs2.writeFileSync)(file, patched);
-  return { ok: true, modified: true, file, message: `Patched ${displayPath(file)} \xB7 rode npm install https://holdy.chat/sdk/holdyapp-sdk-1.5.0.tgz` };
+  return { ok: true, modified: true, file, message: `Patched ${displayPath(file)} \xB7 rode npm install @holdyapp/sdk` };
 }
 function injectViteVue(file, opts) {
   return injectViteReact(file, opts);
@@ -278,7 +281,7 @@ export default defineNuxtPlugin(() => {
 })
 `;
   (0, import_node_fs2.writeFileSync)(file, content);
-  return { ok: true, modified: true, file, message: `Criado ${displayPath(file)} \xB7 rode npm install https://holdy.chat/sdk/holdyapp-sdk-1.5.0.tgz` };
+  return { ok: true, modified: true, file, message: `Criado ${displayPath(file)} \xB7 rode npm install @holdyapp/sdk` };
 }
 function injectRemix(file, opts) {
   if (!file || !(0, import_node_fs2.existsSync)(file)) {
@@ -734,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.4.0";
+var VERSION = "0.5.0";
 var DEFAULT_API_URL = "https://holdy.chat/api/v1";
 async function main() {
   const argv = process.argv.slice(2);
@@ -757,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,
@@ -786,19 +883,19 @@ async function main() {
     process.exit(2);
   }
   if (detection.usePackage && detection.framework !== "next-app") {
-    log.step("3", "Falta instalar o pacote npm:");
+    log.step("4", "Falta instalar o pacote npm:");
     console.log();
-    console.log("   npm install https://holdy.chat/sdk/holdyapp-sdk-1.5.0.tgz");
+    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",
@@ -809,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 holdy.chat/onboarding \xB7 o primeiro evento aparece 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) {
@@ -824,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];
@@ -844,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) {
@@ -855,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 });
@@ -870,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:")}
@@ -884,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
@@ -900,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.4.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",