@formmy.app/cli 0.0.0-stage → 0.2.0

package/README.md

@@ -1,3 +1,16 @@
-# Temporary Holding Version
+# @formmy.app/cli
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Crea formularios de [Formmy](https://formmy.app) desde la terminal y obtén el iframe para embeberlos.
+
+```bash
+export FORMMY_SECRET_KEY=formmy_sk_live_...   # formmy.app/dashboard/api-keys
+npx @formmy.app/cli forms create --name "Landing" --inputs name,email,message
+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
+```

package/index.mjs

@@ -0,0 +1,102 @@
+#!/usr/bin/env node
+// 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 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]
+  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.`;
+
+function parseFlags(args) {
+  const flags = {};
+  for (let i = 0; i < args.length; i++) {
+    if (!args[i].startsWith("--")) continue;
+    const key = args[i].slice(2);
+    const next = args[i + 1];
+    flags[key] = next && !next.startsWith("--") ? (i++, next) : true;
+  }
+  return flags;
+}
+
+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,
+  });
+  const data = await res.json().catch(() => ({}));
+  if (!res.ok) {
+    console.error(`Error ${res.status}: ${data.error || res.statusText}`);
+    process.exit(1);
+  }
+  return data;
+}
+
+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", "update", "answers"].includes(action)) {
+  console.log(HELP);
+  process.exit(resource ? 1 : 0);
+}
+if (!KEY) {
+  console.error("Falta FORMMY_SECRET_KEY en el entorno.");
+  process.exit(1);
+}
+
+if (action === "create") {
+  if (!flags.name || flags.name === true) {
+    console.error("Falta --name.\n\n" + HELP);
+    process.exit(1);
+  }
+  const { form } = await call("forms.create", "POST", {
+    name: flags.name,
+    ...(flags.type && { type: flags.type }),
+    ...(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 }),
+  });
+  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 }),
+    };
+    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 { 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 {
+  const { forms } = await call("forms.list", "GET");
+  if (flags.json) console.log(JSON.stringify(forms, null, 2));
+  else for (const f of forms) console.log(`${f.id}  ${f.name}  ${f.embed.url}`);
+}

package/package.json

@@ -1,6 +1,11 @@
 {
   "name": "@formmy.app/cli",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.2.0",
+  "description": "Formmy desde la terminal: crea formularios y obtén su iframe para embeber",
+  "type": "module",
+  "bin": { "formmy": "index.mjs" },
+  "files": ["index.mjs", "README.md"],
+  "engines": { "node": ">=18" },
+  "license": "MIT",
+  "homepage": "https://formmy.app"
+}