@formmy.app/cli 0.2.0 → 0.3.0

package/README.md

@@ -14,3 +14,15 @@ npx @formmy.app/cli forms list
 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,7 +1,31 @@
 #!/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]
@@ -9,10 +33,14 @@ const HELP = `Uso:
   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 = {};
@@ -81,19 +109,34 @@ if (action === "create") {
       ...(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 console.log(`✓ ${form.name} (${form.id}) actualizado\nMensaje: ${form.config.message}`);
+    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) console.log(`${a.createdAt.slice(0, 16).replace("T", " ")}  ${Object.entries(a.data || {}).map(([k, v]) => `${k}=${v}`).join("  ")}`);
+    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");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@formmy.app/cli",
-  "version": "0.2.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" },