@formmy.app/cli 0.1.0 → 0.3.0

package/README.md

@@ -9,3 +9,20 @@ npx @formmy.app/cli forms list
 ```
 
 `create` imprime el `<iframe>`; pégalo en tu HTML (p. ej. el `index.html` de GitHub Pages). `--json` para salida máquina.
+
+```bash
+npx @formmy.app/cli forms update <formId> --message "¡Listo! Descarga la guía: https://…"
+npx @formmy.app/cli forms answers <formId>        # quién llenó el formulario
+```
+
+### Entregar un archivo (lead magnet)
+
+El archivo llega **sólo por correo** a quien llena el formulario; el clic en el botón valida su correo.
+
+```bash
+npx @formmy.app/cli forms update <formId> --asset ./guia.pdf \
+  --message "Te mandamos la guía a tu correo." \
+  --email-subject "Tu guía: {formulario}" --email-body "Hola {nombre}, aquí está tu guía."
+npx @formmy.app/cli forms answers <formId>   # [✓ validado · 1 clic · abrió] ← página de origen
+npx @formmy.app/cli forms update <formId> --no-asset
+```

package/index.mjs

@@ -1,15 +1,46 @@
 #!/usr/bin/env node
+import { readFile } from "node:fs/promises";
+import { basename, extname } from "node:path";
 // CLI de Formmy: sin dependencias, pega a /api/v2/sdk con la secret key del dueño
 const API = process.env.FORMMY_API_URL || "https://formmy.app/api/v2/sdk";
 const KEY = process.env.FORMMY_SECRET_KEY;
+const MIME = { ".pdf": "application/pdf", ".zip": "application/zip", ".png": "image/png", ".jpg": "image/jpeg", ".jpeg": "image/jpeg", ".webp": "image/webp" };
+
+// --asset acepta una URL o un archivo local; el local se sube a Formmy con una URL prefirmada
+async function resolveAsset(formId, asset) {
+  if (/^https?:\/\//.test(asset)) return asset;
+  const contentType = MIME[extname(asset).toLowerCase()];
+  if (!contentType) {
+    console.error(`Tipo no soportado: ${asset} (pdf, zip, png, jpg, webp)`);
+    process.exit(1);
+  }
+  const bytes = await readFile(asset).catch(() => {
+    console.error(`No se pudo leer ${asset}`);
+    process.exit(1);
+  });
+  const { uploadUrl, publicUrl } = await call("forms.uploadAsset", "POST", { filename: basename(asset), contentType }, { formId });
+  const put = await fetch(uploadUrl, { method: "PUT", headers: { "Content-Type": contentType }, body: bytes });
+  if (!put.ok) {
+    console.error(`Falló la subida (${put.status})`);
+    process.exit(1);
+  }
+  return publicUrl;
+}
 
 const HELP = `Uso:
   formmy forms create --name <nombre> [--type contact|subscription] [--inputs name,email,message]
                       [--theme dark|light] [--color #9b9aea] [--message "Gracias"] [--json]
   formmy forms list [--json]
+  formmy forms update <formId> [--name <nombre>] [--inputs name,email] [--theme dark|light]
+                      [--color #9b9aea] [--message "Gracias"] [--json]
+                      [--asset ./guia.pdf|https://…] [--no-asset] [--asset-button "Descargar"]
+                      [--email-subject "Tu guía"] [--email-body "Hola {nombre}, …"]
+  formmy forms answers <formId> [--limit 50] [--json]
 
 Requiere FORMMY_SECRET_KEY (formmy_sk_live_…, en formmy.app/dashboard/api-keys).
-Inputs válidos: name, email, message, phone, company.`;
+Inputs válidos: name, email, message, phone, company.
+Archivo (lead magnet): se entrega SÓLO por correo; el clic en el botón valida el correo.
+Variables en asunto y texto: {nombre}, {formulario}.`;
 
 function parseFlags(args) {
   const flags = {};
@@ -22,8 +53,9 @@ function parseFlags(args) {
   return flags;
 }
 
-async function call(intent, method, body) {
-  const res = await fetch(`${API}?intent=${intent}`, {
+async function call(intent, method, body, params = {}) {
+  const qs = new URLSearchParams({ intent, ...params });
+  const res = await fetch(`${API}?${qs}`, {
     method,
     headers: { Authorization: `Bearer ${KEY}`, "Content-Type": "application/json" },
     body: body ? JSON.stringify(body) : undefined,
@@ -38,8 +70,10 @@ async function call(intent, method, body) {
 
 const [resource, action, ...rest] = process.argv.slice(2);
 const flags = parseFlags(rest);
+// update/answers llevan el id como primer argumento posicional
+const formId = rest[0] && !rest[0].startsWith("--") ? rest[0] : null;
 
-if (resource !== "forms" || !["create", "list"].includes(action)) {
+if (resource !== "forms" || !["create", "list", "update", "answers"].includes(action)) {
   console.log(HELP);
   process.exit(resource ? 1 : 0);
 }
@@ -63,6 +97,47 @@ if (action === "create") {
   });
   if (flags.json) console.log(JSON.stringify(form, null, 2));
   else console.log(`✓ ${form.name} (${form.id})\nEditar: ${form.editUrl}\n\n${form.embed.iframe}`);
+} else if (action === "update" || action === "answers") {
+  if (!formId) {
+    console.error("Falta el <formId> (sale en `formmy forms list`).\n\n" + HELP);
+    process.exit(1);
+  }
+  if (action === "update") {
+    const body = {
+      ...(flags.name && { name: flags.name }),
+      ...(flags.inputs && { inputs: String(flags.inputs).split(",").map((s) => s.trim()) }),
+      ...(flags.theme && { theme: flags.theme }),
+      ...(flags.color && { ctaColor: flags.color }),
+      ...(flags.message && { message: flags.message }),
+      ...(flags["asset-button"] && { assetButton: flags["asset-button"] }),
+      ...(flags["email-subject"] && { assetEmailSubject: flags["email-subject"] }),
+      ...(flags["email-body"] && { assetEmailBody: String(flags["email-body"]).replace(/\\n/g, "\n") }),
+      ...(flags["no-asset"] && { assetUrl: null }),
+    };
+    if (flags.asset && flags.asset !== true) body.assetUrl = await resolveAsset(formId, flags.asset);
+    if (!Object.keys(body).length) {
+      console.error("Nada que cambiar: pasa al menos un flag.\n\n" + HELP);
+      process.exit(1);
+    }
+    const { form } = await call("forms.update", "POST", body, { formId });
+    if (flags.json) console.log(JSON.stringify(form, null, 2));
+    else {
+      const c = form.config;
+      console.log(`✓ ${form.name} (${form.id}) actualizado\nMensaje: ${c.message}`);
+      if (c.assetUrl) console.log(`Archivo: ${c.assetUrl}\nCorreo: «${c.assetEmailSubject || "Aquí está tu archivo: {formulario}"}» · botón «${c.assetButton || "Descargar"}»`);
+    }
+  } else {
+    const { answers } = await call("forms.answers", "GET", null, { formId, ...(flags.limit && { limit: flags.limit }) });
+    if (flags.json) console.log(JSON.stringify(answers, null, 2));
+    else if (!answers.length) console.log("Sin respuestas todavía.");
+    else
+      for (const a of answers) {
+        const m = a.meta || {};
+        const marks = [a.verifiedAt && "✓ validado", m.clicks && `${m.clicks} clic${m.clicks > 1 ? "s" : ""}`, m.openedAt && "abrió"].filter(Boolean).join(" · ");
+        const src = m.source ? `  ← ${m.source.replace(/^https?:\/\//, "")}` : "";
+        console.log(`${a.createdAt.slice(0, 16).replace("T", " ")}  ${Object.entries(a.data || {}).map(([k, v]) => `${k}=${v}`).join("  ")}${marks ? `  [${marks}]` : ""}${src}`);
+      }
+  }
 } else {
   const { forms } = await call("forms.list", "GET");
   if (flags.json) console.log(JSON.stringify(forms, null, 2));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@formmy.app/cli",
-  "version": "0.1.0",
+  "version": "0.3.0",
   "description": "Formmy desde la terminal: crea formularios y obtén su iframe para embeber",
   "type": "module",
   "bin": { "formmy": "index.mjs" },