npm - emailr-cli - Versions diffs - 1.4.1 → 1.5.0 - Mend

emailr-cli 1.4.1 → 1.5.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (2) hide show

package/dist/index.js +152 -12
package/package.json +1 -1

package/dist/index.js CHANGED Viewed

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 // src/index.ts
-import { Command as Command10 } from "commander";
+import { Command as Command11 } from "commander";
 // src/commands/send.ts
 import { Command } from "commander";
@@ -839,7 +839,10 @@ Total: ${result.length}`);
       process.exit(1);
     }
   });
-  cmd.command("create").description("Create a new template").requiredOption("--name <name>", "Template name").requiredOption("--subject <subject>", "Email subject").option("--html <html>", "HTML content").option("--text <text>", "Plain text content").option("--html-file <path>", "Read HTML content from file").option("--text-file <path>", "Read text content from file").option("--from <email>", "Default from email").option("--reply-to <email>", "Default reply-to email").option("--preview-text <text>", "Preview text").option("--format <format>", "Output format (json|table)", "table").action(async (options) => {
+  cmd.command("create").description(`Create a new template
+TIP: For live preview while building, use "emailr templates draft" first.
+It creates a local file with hot-reload preview, then use this command to save.`).requiredOption("--name <name>", "Template name").requiredOption("--subject <subject>", "Email subject").option("--html <html>", "HTML content").option("--text <text>", "Plain text content").option("--html-file <path>", "Read HTML content from file").option("--text-file <path>", "Read text content from file").option("--from <email>", "Default from email").option("--reply-to <email>", "Default reply-to email").option("--preview-text <text>", "Preview text").option("--format <format>", "Output format (json|table)", "table").action(async (options) => {
     try {
       const config = loadConfig();
       const client = new Emailr3({
@@ -851,14 +854,14 @@ Total: ${result.length}`);
         subject: options.subject
       };
       if (options.htmlFile) {
-        const fs5 = await import("fs");
-        request.html_content = fs5.readFileSync(options.htmlFile, "utf-8");
+        const fs6 = await import("fs");
+        request.html_content = fs6.readFileSync(options.htmlFile, "utf-8");
       } else if (options.html) {
         request.html_content = options.html;
       }
       if (options.textFile) {
-        const fs5 = await import("fs");
-        request.text_content = fs5.readFileSync(options.textFile, "utf-8");
+        const fs6 = await import("fs");
+        request.text_content = fs6.readFileSync(options.textFile, "utf-8");
       } else if (options.text) {
         request.text_content = options.text;
       }
@@ -897,7 +900,10 @@ Open the Preview URL in your browser to view the rendered template.`);
       process.exit(1);
     }
   });
-  cmd.command("update <id>").description("Update a template").option("--name <name>", "Template name").option("--subject <subject>", "Email subject").option("--html <html>", "HTML content").option("--text <text>", "Plain text content").option("--html-file <path>", "Read HTML content from file").option("--text-file <path>", "Read text content from file").option("--from <email>", "Default from email").option("--reply-to <email>", "Default reply-to email").option("--preview-text <text>", "Preview text").option("--format <format>", "Output format (json|table)", "table").action(async (id, options) => {
+  cmd.command("update <id>").description(`Update a template
+TIP: For live preview while editing, use "emailr templates edit <id>" first.
+It downloads the template with hot-reload preview, then use this command to save.`).option("--name <name>", "Template name").option("--subject <subject>", "Email subject").option("--html <html>", "HTML content").option("--text <text>", "Plain text content").option("--html-file <path>", "Read HTML content from file").option("--text-file <path>", "Read text content from file").option("--from <email>", "Default from email").option("--reply-to <email>", "Default reply-to email").option("--preview-text <text>", "Preview text").option("--format <format>", "Output format (json|table)", "table").action(async (id, options) => {
     try {
       const config = loadConfig();
       const client = new Emailr3({
@@ -908,14 +914,14 @@ Open the Preview URL in your browser to view the rendered template.`);
       if (options.name) request.name = options.name;
       if (options.subject) request.subject = options.subject;
       if (options.htmlFile) {
-        const fs5 = await import("fs");
-        request.html_content = fs5.readFileSync(options.htmlFile, "utf-8");
+        const fs6 = await import("fs");
+        request.html_content = fs6.readFileSync(options.htmlFile, "utf-8");
       } else if (options.html) {
         request.html_content = options.html;
       }
       if (options.textFile) {
-        const fs5 = await import("fs");
-        request.text_content = fs5.readFileSync(options.textFile, "utf-8");
+        const fs6 = await import("fs");
+        request.text_content = fs6.readFileSync(options.textFile, "utf-8");
       } else if (options.text) {
         request.text_content = options.text;
       }
@@ -2316,8 +2322,141 @@ async function executeLogin(options) {
   }
 }
+// src/commands/agent.ts
+import { Command as Command10 } from "commander";
+import { spawn, execSync } from "child_process";
+import fs5 from "fs";
+import path5 from "path";
+import os3 from "os";
+var OPENCODE_SKILL_DIR = path5.join(os3.homedir(), ".config", "opencode", "skills", "emailr-cli");
+var SKILL_MD = `---
+name: emailr-cli
+description: Operate the Emailr CLI to send emails, manage contacts, templates, domains, broadcasts, webhooks, and segments. Includes LIVE PREVIEW editing for templates with hot-reload.
+---
+# Emailr CLI
+## Quick start
+- Ensure auth: \`emailr login\` (browser-based) or \`emailr config set api-key <token>\`.
+- Prefer machine-readable output with \`--format json\` on listing/get commands.
+## LIVE TEMPLATE EDITING (Agentic Workflow)
+### Edit existing template with live preview
+1. Start live editing: \`emailr templates edit <template_id> --file ./template.html\`
+2. Edit the file - browser auto-refreshes on every save
+3. When satisfied: \`emailr templates update <template_id> --html-file ./template.html\`
+### Create new template with live preview
+1. Start drafting: \`emailr templates draft --file ./new-template.html\`
+2. Edit the file - browser auto-refreshes on every save
+3. When satisfied: \`emailr templates create --name "Template Name" --subject "Subject" --html-file ./new-template.html\`
+## Common commands
+### Sending emails
+- Plain text: \`emailr send --to user@example.com --from no-reply@example.com --subject "Hi" --text "Hello"\`
+- HTML: \`emailr send --to user@example.com --from no-reply@example.com --subject "Hi" --html "<h1>Hello</h1>"\`
+- With template: \`emailr send --to user@example.com --from no-reply@example.com --template tmpl_xxx --template-data '{"name":"Ada"}'\`
+### Templates
+- List: \`emailr templates list --format json\`
+- Get: \`emailr templates get <id> --format json\`
+- Preview: \`emailr templates preview <id>\`
+- Create: \`emailr templates create --name "Name" --subject "Subject" --html-file ./template.html\`
+- Update: \`emailr templates update <id> --html-file ./template.html\`
+- Delete: \`emailr templates delete <id>\`
+`;
+function isOpenCodeInstalled() {
+  try {
+    execSync("which opencode", { stdio: "ignore" });
+    return true;
+  } catch {
+    return false;
+  }
+}
+function installOpenCode() {
+  console.log("Installing OpenCode AI agent...");
+  try {
+    execSync("npm install -g opencode-ai@latest", { stdio: "inherit" });
+    return true;
+  } catch {
+    if (process.platform === "darwin") {
+      try {
+        execSync("brew install anomalyco/tap/opencode", { stdio: "inherit" });
+        return true;
+      } catch {
+        return false;
+      }
+    }
+    return false;
+  }
+}
+function ensureSkillInstalled() {
+  if (!fs5.existsSync(OPENCODE_SKILL_DIR)) {
+    fs5.mkdirSync(OPENCODE_SKILL_DIR, { recursive: true });
+  }
+  const skillPath = path5.join(OPENCODE_SKILL_DIR, "SKILL.md");
+  fs5.writeFileSync(skillPath, SKILL_MD, "utf-8");
+}
+function createAgentCommand() {
+  const cmd = new Command10("agent").description(`Launch an AI agent with Emailr CLI expertise
+This opens OpenCode (opencode.ai), an AI coding agent that knows how to use all Emailr CLI commands.
+The agent can help you:
+- Send emails and manage templates with live preview
+- Manage contacts, broadcasts, and segments
+- Configure domains and webhooks
+The agent runs in your terminal with full access to the emailr CLI.`).option("--install", "Install OpenCode if not already installed").option("--model <model>", "Model to use (e.g., anthropic/claude-sonnet-4)").action(async (options) => {
+    if (!isOpenCodeInstalled()) {
+      if (options.install) {
+        const installed = installOpenCode();
+        if (!installed) {
+          error("Failed to install OpenCode. Please install manually:");
+          console.log("  npm install -g opencode-ai@latest");
+          console.log("  # or");
+          console.log("  brew install anomalyco/tap/opencode");
+          process.exit(1);
+        }
+      } else {
+        error("OpenCode AI agent is not installed.");
+        console.log("\nInstall it with one of:");
+        console.log("  emailr agent --install");
+        console.log("  npm install -g opencode-ai@latest");
+        console.log("  brew install anomalyco/tap/opencode");
+        process.exit(1);
+      }
+    }
+    try {
+      ensureSkillInstalled();
+      success("Emailr CLI skill loaded");
+    } catch (err) {
+      warn(`Could not install skill: ${err instanceof Error ? err.message : String(err)}`);
+    }
+    const args = [];
+    if (options.model) {
+      args.push("--model", options.model);
+    }
+    console.log("\nStarting Emailr AI Agent...");
+    console.log("The agent has the emailr-cli skill loaded.");
+    console.log("Ask it to help with emails, templates, contacts, or broadcasts.\n");
+    const opencode = spawn("opencode", args, {
+      stdio: "inherit",
+      env: process.env
+    });
+    opencode.on("error", (err) => {
+      error(`Failed to start agent: ${err.message}`);
+      process.exit(1);
+    });
+    opencode.on("exit", (code) => {
+      process.exit(code ?? 0);
+    });
+  });
+  return cmd;
+}
 // src/index.ts
-var program = new Command10();
+var program = new Command11();
 program.name("emailr").description("Emailr CLI - Send emails and manage your email infrastructure").version("1.0.0");
 program.addCommand(createSendCommand());
 program.addCommand(createContactsCommand());
@@ -2328,4 +2467,5 @@ program.addCommand(createWebhooksCommand());
 program.addCommand(createSegmentsCommand());
 program.addCommand(createConfigCommand());
 program.addCommand(createLoginCommand());
+program.addCommand(createAgentCommand());
 program.parse();

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "emailr-cli",
-  "version": "1.4.1",
+  "version": "1.5.0",
   "description": "Command-line interface for the Emailr email API",
   "type": "module",
   "bin": {