@holdyapp/install 0.2.0 → 0.4.0

package/dist/cli.js

@@ -2,9 +2,9 @@
 "use strict";
 
 // src/cli.ts
-var import_node_fs3 = require("node:fs");
-var import_node_readline = require("node:readline");
-var import_node_path3 = require("node:path");
+var import_node_fs5 = require("node:fs");
+var import_node_readline2 = require("node:readline");
+var import_node_path5 = require("node:path");
 
 // src/detect.ts
 var import_node_fs = require("node:fs");
@@ -235,7 +235,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 @holdyapp/sdk` };
+  return { ok: true, modified: true, file, message: `Patched ${displayPath(file)} \xB7 rode npm install https://holdy.chat/sdk/holdyapp-sdk-1.5.0.tgz` };
 }
 function injectViteReact(file, opts) {
   if (!file || !(0, import_node_fs2.existsSync)(file)) {
@@ -256,7 +256,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 @holdyapp/sdk` };
+  return { ok: true, modified: true, file, message: `Patched ${displayPath(file)} \xB7 rode npm install https://holdy.chat/sdk/holdyapp-sdk-1.5.0.tgz` };
 }
 function injectViteVue(file, opts) {
   return injectViteReact(file, opts);
@@ -278,7 +278,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 @holdyapp/sdk` };
+  return { ok: true, modified: true, file, message: `Criado ${displayPath(file)} \xB7 rode npm install https://holdy.chat/sdk/holdyapp-sdk-1.5.0.tgz` };
 }
 function injectRemix(file, opts) {
   if (!file || !(0, import_node_fs2.existsSync)(file)) {
@@ -381,8 +381,362 @@ function displayPath(p) {
   return p.replace(process.cwd() + "/", "");
 }
 
+// src/instrument.ts
+var import_node_fs4 = require("node:fs");
+var import_node_path4 = require("node:path");
+var import_node_readline = require("node:readline");
+
+// src/scan.ts
+var import_node_fs3 = require("node:fs");
+var import_node_path3 = require("node:path");
+var SKIP_DIRS = /* @__PURE__ */ new Set([
+  "node_modules",
+  ".git",
+  ".next",
+  ".nuxt",
+  ".svelte-kit",
+  ".turbo",
+  ".vercel",
+  "dist",
+  "build",
+  "out",
+  "coverage",
+  "public",
+  "static",
+  "vendor",
+  ".cache",
+  "storybook-static",
+  "__snapshots__",
+  ".venv",
+  "target"
+]);
+var EXTENSIONS = [".ts", ".tsx", ".js", ".jsx", ".mjs", ".vue", ".svelte", ".astro"];
+var SKIP_FILE = /\.(test|spec|stories|d)\.[tj]sx?$/;
+var SKIP_CONFIG = /(^|\/)(next|vite|tailwind|postcss|eslint|jest|vitest|rollup|webpack|astro|nuxt|svelte)\.config\./;
+var MAX_FILE_BYTES = 2e5;
+function scanProject(cwd, options = {}) {
+  const maxFiles = options.maxFiles ?? 140;
+  const maxCharsPerFile = options.maxCharsPerFile ?? 2400;
+  const maxTotalChars = options.maxTotalChars ?? 22e4;
+  const candidates = [];
+  walk(cwd, cwd, candidates, 0);
+  candidates.sort((a, b) => b.score - a.score);
+  const files = [];
+  let total = 0;
+  for (const candidate of balanceByKind(candidates)) {
+    if (files.length >= maxFiles || total >= maxTotalChars) break;
+    let source;
+    try {
+      source = (0, import_node_fs3.readFileSync)(candidate.abs, "utf8");
+    } catch {
+      continue;
+    }
+    const excerpt = source.length > maxCharsPerFile ? `${source.slice(0, maxCharsPerFile)}
+\u2026 (arquivo truncado)` : source;
+    if (excerpt.trim().length < 40) continue;
+    files.push({ path: candidate.rel, kind: classify(candidate.rel), excerpt });
+    total += excerpt.length;
+  }
+  return files;
+}
+function balanceByKind(candidates) {
+  const buckets = /* @__PURE__ */ new Map();
+  for (const candidate of candidates) {
+    const kind = classify(candidate.rel);
+    const bucket = buckets.get(kind) ?? [];
+    bucket.push(candidate);
+    buckets.set(kind, bucket);
+  }
+  const order = ["page", "component", "api", "server", "route", "other"];
+  const lists = order.map((kind) => buckets.get(kind) ?? []).filter((l) => l.length > 0);
+  const out = [];
+  let index = 0;
+  let remaining = candidates.length;
+  while (remaining > 0) {
+    let took = 0;
+    for (const list of lists) {
+      if (index < list.length) {
+        out.push(list[index]);
+        took++;
+      }
+    }
+    if (took === 0) break;
+    remaining -= took;
+    index++;
+  }
+  return out;
+}
+function walk(dir, root, out, depth) {
+  if (depth > 8) return;
+  let entries;
+  try {
+    entries = (0, import_node_fs3.readdirSync)(dir);
+  } catch {
+    return;
+  }
+  for (const entry of entries) {
+    if (entry.startsWith(".") && entry !== ".") continue;
+    const abs = (0, import_node_path3.join)(dir, entry);
+    let stats;
+    try {
+      stats = (0, import_node_fs3.statSync)(abs);
+    } catch {
+      continue;
+    }
+    if (stats.isDirectory()) {
+      if (SKIP_DIRS.has(entry)) continue;
+      walk(abs, root, out, depth + 1);
+      continue;
+    }
+    if (!EXTENSIONS.some((ext) => entry.endsWith(ext))) continue;
+    if (SKIP_FILE.test(entry)) continue;
+    if (stats.size > MAX_FILE_BYTES) continue;
+    const rel = (0, import_node_path3.relative)(root, abs).split(import_node_path3.sep).join("/");
+    if (SKIP_CONFIG.test(rel)) continue;
+    out.push({ abs, rel, score: score(rel, stats.size) });
+  }
+}
+function score(rel, size) {
+  let value = 0;
+  const lower = rel.toLowerCase();
+  if (/(^|\/)(app|pages|routes|src\/app|src\/pages)\//.test(lower)) value += 40;
+  if (/(^|\/)(actions|api|server|handlers|controllers|services|mutations)\//.test(lower)) value += 35;
+  if (/(^|\/)(components|features|views|screens|modules)\//.test(lower)) value += 20;
+  if (/(^|\/)(lib|utils|helpers|hooks|types|styles|constants)\//.test(lower)) value -= 15;
+  if (/(page|route|layout|form|checkout|billing|signup|onboard|invite|create|new|edit|settings)/.test(lower)) value += 18;
+  if (/(icon|logo|svg|theme|i18n|locale|messages|fixture|mock|seed)/.test(lower)) value -= 25;
+  const depth = lower.split("/").length;
+  value -= depth * 2;
+  if (size < 300) value -= 10;
+  return value;
+}
+function classify(rel) {
+  const lower = rel.toLowerCase();
+  if (/page\.[tj]sx?$/.test(lower)) return "page";
+  if (/route\.[tj]s$/.test(lower)) return "api";
+  if (/(^|\/)api\//.test(lower)) return "api";
+  if (/(^|\/)(actions|server|handlers|controllers|services|mutations)\//.test(lower)) return "server";
+  if (/(^|\/)(pages|views|screens)\//.test(lower)) return "page";
+  if (/(^|\/)routes\//.test(lower)) return "route";
+  if (/(^|\/)(components|features|modules)\//.test(lower)) return "component";
+  return "other";
+}
+
+// src/instrument.ts
+async function runInstrument(opts) {
+  const { ui } = opts;
+  ui.step("i", "Lendo o c\xF3digo do projeto\u2026");
+  const files = scanProject(opts.cwd);
+  if (files.length === 0) {
+    ui.error("Nenhum arquivo de produto encontrado pra analisar.");
+    return 3;
+  }
+  ui.info(`${files.length} arquivos enviados pra an\xE1lise`);
+  ui.step("ii", "Pedindo o plano de instrumenta\xE7\xE3o \xE0 Holdy\u2026");
+  let plan;
+  try {
+    plan = await requestPlan(opts, files);
+  } catch (err) {
+    ui.error(err instanceof Error ? err.message : "Falha ao falar com a Holdy");
+    return 4;
+  }
+  if (plan.events.length === 0) {
+    ui.warn("O planner n\xE3o encontrou ponto de funil claro neste c\xF3digo.");
+    if (plan.summary) ui.info(plan.summary);
+    return 0;
+  }
+  console.log();
+  console.log(`  ${ui.bold(`${plan.events.length} eventos propostos`)}`);
+  console.log(`  ${ui.dim(plan.summary)}`);
+  console.log();
+  for (const event of plan.events) {
+    const props = event.properties.map((p) => p.name).join(", ");
+    console.log(`  ${ui.cyan(event.event)} ${ui.dim(`\xB7 ${event.lifecycle_phase} \xB7 confian\xE7a ${event.confidence}`)}`);
+    console.log(`     ${event.purpose}`);
+    console.log(`     ${ui.dim(event.file)}${props ? ui.dim(` \xB7 props: ${props}`) : ""}`);
+  }
+  console.log();
+  const { patches, skipped } = resolvePatches(opts.cwd, plan.events);
+  for (const skip of skipped) {
+    ui.warn(`${skip.event.event} \xB7 ${skip.reason}`);
+    console.log(`     ${ui.dim("insira manualmente em")} ${skip.event.file}:`);
+    console.log(`     ${skip.event.snippet}`);
+  }
+  if (opts.dryRun) {
+    console.log();
+    ui.info("--dry-run: nada foi escrito.");
+    return 0;
+  }
+  if (patches.length === 0) {
+    ui.warn("Nenhuma inser\xE7\xE3o autom\xE1tica poss\xEDvel \u2014 s\xF3 os snippets manuais acima.");
+    return 0;
+  }
+  console.log();
+  console.log(`  ${ui.bold("Diff proposto")}`);
+  console.log();
+  for (const patch of patches) {
+    printDiff(patch, ui);
+  }
+  if (!opts.yes) {
+    const answer = await confirm(
+      `  Aplicar ${patches.length} ${patches.length === 1 ? "inser\xE7\xE3o" : "inser\xE7\xF5es"}? [y/N] `
+    );
+    if (!answer) {
+      ui.info("Cancelado \xB7 nada foi escrito.");
+      return 0;
+    }
+  }
+  const written = applyPatches(patches);
+  console.log();
+  ui.success(
+    `${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 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, {
+    method: "POST",
+    headers: {
+      "Content-Type": "application/json",
+      Authorization: `Bearer ${opts.apiKey}`
+    },
+    body: JSON.stringify({
+      framework: opts.framework,
+      sdk_style: opts.sdkStyle,
+      max_events: opts.maxEvents,
+      files
+    })
+  });
+  if (!response.ok) {
+    const problem = await response.json().catch(() => null);
+    const reason = problem?.detail ?? problem?.title ?? `HTTP ${response.status}`;
+    if (response.status === 403) {
+      throw new Error(`${reason} \xB7 gere uma key secreta em holdy.chat/settings/api`);
+    }
+    throw new Error(reason);
+  }
+  return await response.json();
+}
+function resolvePatches(cwd, events) {
+  const patches = [];
+  const skipped = [];
+  const cache = /* @__PURE__ */ new Map();
+  for (const event of events) {
+    const absolute = (0, import_node_path4.join)(cwd, event.file);
+    let source = cache.get(absolute);
+    if (source === void 0) {
+      try {
+        source = (0, import_node_fs4.readFileSync)(absolute, "utf8");
+      } catch {
+        skipped.push({ event, reason: "arquivo n\xE3o encontrado no disco" });
+        continue;
+      }
+      cache.set(absolute, source);
+    }
+    const first = source.indexOf(event.anchor);
+    if (first === -1) {
+      skipped.push({ event, reason: "\xE2ncora n\xE3o encontrada no arquivo" });
+      continue;
+    }
+    if (source.indexOf(event.anchor, first + 1) !== -1) {
+      skipped.push({ event, reason: "\xE2ncora aparece mais de uma vez \xB7 amb\xEDguo" });
+      continue;
+    }
+    if (source.includes(`'${event.event}'`) || source.includes(`"${event.event}"`)) {
+      skipped.push({ event, reason: "evento j\xE1 instrumentado neste arquivo" });
+      continue;
+    }
+    const lines = source.split("\n");
+    const anchorLine = lineOf(source, first);
+    const anchorEndLine = lineOf(source, first + event.anchor.length - 1);
+    const targetLine = event.position === "after" ? anchorEndLine + 1 : anchorLine;
+    const indent = indentOf(lines[event.position === "after" ? anchorEndLine : anchorLine] ?? "");
+    const insertion = event.snippet.split("\n").map((line) => line.trim() ? indent + line.trim() : line).join("\n");
+    patches.push({
+      event,
+      file: event.file,
+      absolute,
+      index: targetLine,
+      insertion,
+      previewLine: targetLine,
+      context: lines.slice(Math.max(0, targetLine - 3), targetLine + 2)
+    });
+  }
+  return { patches, skipped };
+}
+function applyPatches(patches) {
+  const byFile = /* @__PURE__ */ new Map();
+  for (const patch of patches) {
+    const list = byFile.get(patch.absolute) ?? [];
+    list.push(patch);
+    byFile.set(patch.absolute, list);
+  }
+  const written = [];
+  for (const [absolute, filePatches] of byFile) {
+    const lines = (0, import_node_fs4.readFileSync)(absolute, "utf8").split("\n");
+    filePatches.sort((a, b) => b.index - a.index);
+    for (const patch of filePatches) {
+      lines.splice(patch.index, 0, patch.insertion);
+    }
+    (0, import_node_fs4.writeFileSync)(absolute, lines.join("\n"), "utf8");
+    written.push(filePatches[0].file);
+  }
+  return written;
+}
+function printDiff(patch, ui) {
+  console.log(`  ${ui.dim(`${patch.file}:${patch.previewLine + 1}`)} ${ui.cyan(patch.event.event)}`);
+  const before = patch.context.slice(0, 3);
+  const after = patch.context.slice(3);
+  for (const line of before) console.log(`    ${ui.dim(`  ${line}`)}`);
+  console.log(`    ${ui.green(`+ ${patch.insertion.trim()}`)}`);
+  for (const line of after) console.log(`    ${ui.dim(`  ${line}`)}`);
+  console.log();
+}
+function lineOf(source, index) {
+  let line = 0;
+  for (let i = 0; i < index; i++) {
+    if (source.charCodeAt(i) === 10) line++;
+  }
+  return line;
+}
+function indentOf(line) {
+  const match = line.match(/^[ \t]*/);
+  return match ? match[0] : "";
+}
+function confirm(question) {
+  return new Promise((resolve) => {
+    const rl = (0, import_node_readline.createInterface)({ input: process.stdin, output: process.stdout });
+    rl.question(question, (answer) => {
+      rl.close();
+      resolve(/^(s|sim|y|yes)$/i.test(answer.trim()));
+    });
+  });
+}
+
 // src/cli.ts
-var VERSION = "0.1.0";
+var VERSION = "0.4.0";
+var DEFAULT_API_URL = "https://holdy.chat/api/v1";
 async function main() {
   const argv = process.argv.slice(2);
   const cwd = process.cwd();
@@ -431,19 +785,47 @@ async function main() {
     }
     process.exit(2);
   }
-  if (detection.usePackage) {
+  if (detection.usePackage && detection.framework !== "next-app") {
     log.step("3", "Falta instalar o pacote npm:");
     console.log();
-    console.log("   npm install @holdyapp/sdk");
+    console.log("   npm install https://holdy.chat/sdk/holdyapp-sdk-1.5.0.tgz");
     console.log();
   } else {
     log.step("3", "Sem npm install necess\xE1rio \xB7 script tag via CDN.");
   }
-  log.step("4", 'Pronto! Inicie o app e abra o widget de status em holdy.chat \xB7 voc\xEA deve ver "conectado" em segundos.');
+  if (args.instrument) {
+    console.log();
+    log.step("4", "Instrumentando eventos de produto\u2026");
+    const code = await runInstrument({
+      cwd,
+      apiKey,
+      baseUrl: args.apiUrl,
+      framework: detection.framework,
+      sdkStyle: detection.usePackage ? "npm" : "script",
+      maxEvents: args.maxEvents,
+      dryRun: args.dryRun,
+      yes: args.yes,
+      ui: { ...log, bold, dim, green, yellow, cyan }
+    });
+    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.");
+    process.exit(0);
+  }
+  log.step("4", "Pronto! Inicie o app e abra holdy.chat/onboarding \xB7 o primeiro evento aparece em segundos.");
   process.exit(0);
 }
 function parseArgs(argv) {
-  const out = { apiKey: null, accountId: void 0, autoCapture: true };
+  const out = {
+    apiKey: null,
+    accountId: void 0,
+    autoCapture: true,
+    instrument: false,
+    dryRun: false,
+    yes: false,
+    maxEvents: 12,
+    apiUrl: process.env.HOLDY_API_URL ?? DEFAULT_API_URL
+  };
   for (let i = 0; i < argv.length; i++) {
     const a = argv[i];
     if (a === "--account" || a === "--account-id") {
@@ -452,6 +834,18 @@ function parseArgs(argv) {
       out.autoCapture = false;
     } else if (a === "--auto-capture") {
       out.autoCapture = true;
+    } else if (a === "--instrument") {
+      out.instrument = true;
+    } else if (a === "--dry-run") {
+      out.instrument = true;
+      out.dryRun = true;
+    } else if (a === "--yes" || a === "-y") {
+      out.yes = true;
+    } 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 === "--api-url") {
+      out.apiUrl = argv[++i] ?? out.apiUrl;
     } else if (!a.startsWith("--") && !out.apiKey) {
       out.apiKey = a;
     }
@@ -463,7 +857,7 @@ function parseArgs(argv) {
 }
 function promptApiKey() {
   return new Promise((resolve) => {
-    const rl = (0, import_node_readline.createInterface)({ input: process.stdin, output: process.stdout });
+    const rl = (0, import_node_readline2.createInterface)({ input: process.stdin, output: process.stdout });
     rl.question(`${dim("API key")} (hol_live_\u2026 ou hol_test_\u2026): `, (answer) => {
       rl.close();
       resolve(answer.trim());
@@ -486,6 +880,11 @@ ${bold("Argumentos:")}
 ${bold("Op\xE7\xF5es:")}
   --account <id>        Chave da account padr\xE3o (vira context.account_external_id)
   --no-auto-capture     Desabilita captura autom\xE1tica de page views
+  --instrument          L\xEA seu c\xF3digo, prop\xF5e eventos de funil e insere os track()
+  --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
+  --api-url <url>       Override da API (default https://holdy.chat/api/v1)
   --version, -v         Mostra vers\xE3o
   --help, -h            Mostra esta mensagem
 
@@ -496,11 +895,19 @@ ${bold("Frameworks suportados:")}
 ${bold("Exemplos:")}
   npx @holdyapp/install hol_live_abc123 --account acme-corp
   npx @holdyapp/install hol_test_xyz789 --no-auto-capture
+  npx @holdyapp/install hol_live_abc123 --instrument
+  npx @holdyapp/install hol_live_abc123 --dry-run --max-events 15
+
+${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,
+  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.
 `);
 }
 function readPackageName() {
   try {
-    const pkg = JSON.parse((0, import_node_fs3.readFileSync)((0, import_node_path3.join)(__dirname, "..", "package.json"), "utf8"));
+    const pkg = JSON.parse((0, import_node_fs5.readFileSync)((0, import_node_path5.join)(__dirname, "..", "package.json"), "utf8"));
     return pkg.description ?? null;
   } catch {
     return null;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@holdyapp/install",
-  "version": "0.2.0",
-  "description": "Holdy install CLI \u00b7 detects your framework and wires the SDK in 1 step",
+  "version": "0.4.0",
+  "description": "Holdy install CLI · detects your framework, wires the SDK and instruments product events",
   "license": "MIT",
   "homepage": "https://holdy.chat",
   "repository": {