@develemail/cli 0.1.1

package/dist/index.js

@@ -0,0 +1,433 @@
+#!/usr/bin/env node
+
+// src/index.ts
+import { Command as Command8 } from "commander";
+
+// src/commands/send.ts
+import { Command } from "commander";
+import { DevelEmail, DevelEmailError } from "@develemail/sdk";
+
+// src/config.ts
+import { config } from "dotenv";
+import { homedir } from "os";
+import { join } from "path";
+import { readFileSync, writeFileSync, unlinkSync, mkdirSync } from "fs";
+config();
+function loadConfig() {
+  const apiUrl = process.env.DEVELEMAIL_BASE_URL ?? process.env.DEVELEMAIL_API_URL;
+  const apiKey = process.env.DEVELEMAIL_API_KEY;
+  if (!apiUrl) {
+    console.error("Error: DEVELEMAIL_BASE_URL is not set.");
+    console.error(
+      "Set it in your environment or a .env file in the current directory."
+    );
+    process.exit(1);
+  }
+  if (!apiKey) {
+    console.error("Error: DEVELEMAIL_API_KEY is not set.");
+    console.error(
+      "Set it in your environment or a .env file in the current directory."
+    );
+    process.exit(1);
+  }
+  return { apiUrl, apiKey };
+}
+var AUTH_DIR = join(homedir(), ".config", "develemail");
+var AUTH_FILE = join(AUTH_DIR, "auth.json");
+function loadOwnerSession() {
+  try {
+    const raw = readFileSync(AUTH_FILE, "utf-8");
+    return JSON.parse(raw);
+  } catch {
+    console.error("Not logged in. Run `devel login --url <url>` first.");
+    process.exit(1);
+  }
+}
+function saveOwnerSession(session) {
+  mkdirSync(AUTH_DIR, { recursive: true });
+  writeFileSync(AUTH_FILE, JSON.stringify(session, null, 2), { mode: 384 });
+}
+function clearOwnerSession() {
+  try {
+    unlinkSync(AUTH_FILE);
+  } catch {
+  }
+}
+
+// src/commands/send.ts
+var sendCommand = new Command("send").description("Send a test email").requiredOption("--to <email>", "Recipient email address").requiredOption("--subject <subject>", "Email subject").option(
+  "--from <from>",
+  "Sender address",
+  process.env["DEVELEMAIL_FROM"] ?? "test@develemail.local"
+).option("--html <html>", "HTML body").action(
+  async (opts) => {
+    const cfg = loadConfig();
+    const client = new DevelEmail({
+      apiKey: cfg.apiKey,
+      baseUrl: cfg.apiUrl
+    });
+    try {
+      const result = await client.emails.send({
+        to: opts.to,
+        subject: opts.subject,
+        from: opts.from,
+        html: opts.html ?? `<p>${opts.subject}</p>`
+      });
+      console.log(result.id);
+    } catch (err) {
+      const msg = err instanceof DevelEmailError ? err.message : err instanceof Error ? err.message : String(err);
+      console.error(`Error: ${msg}`);
+      process.exit(1);
+    }
+  }
+);
+
+// src/commands/logs.ts
+import { Command as Command2 } from "commander";
+var COL_ID = 36;
+var COL_FROM = 28;
+var COL_SUBJECT = 38;
+var COL_STATUS = 10;
+function col(s, w) {
+  return s.slice(0, w).padEnd(w);
+}
+var logsCommand = new Command2("logs").description("List recent emails").option("--limit <n>", "Number of emails to show", "20").option("--status <status>", "Filter by status (sent, queued, failed, \u2026)").action(async (opts) => {
+  const cfg = loadConfig();
+  const params = new URLSearchParams({ limit: opts.limit });
+  if (opts.status) params.set("status", opts.status);
+  let res;
+  try {
+    res = await fetch(`${cfg.apiUrl}/emails?${params.toString()}`, {
+      headers: { Authorization: `Bearer ${cfg.apiKey}` }
+    });
+  } catch (err) {
+    console.error(
+      `Error: ${err instanceof Error ? err.message : String(err)}`
+    );
+    process.exit(1);
+  }
+  if (!res.ok) {
+    const body = await res.json().catch(() => ({}));
+    console.error(`Error: ${body.message ?? res.statusText}`);
+    process.exit(1);
+  }
+  const result = await res.json();
+  const rows = result.data ?? [];
+  if (rows.length === 0) {
+    console.log("No emails found.");
+    return;
+  }
+  const header = `${col("ID", COL_ID)} ${col("FROM", COL_FROM)} ${col("SUBJECT", COL_SUBJECT)} ${col("STATUS", COL_STATUS)} CREATED`;
+  console.log(header);
+  console.log("-".repeat(header.length));
+  for (const row of rows) {
+    console.log(
+      `${col(row.id, COL_ID)} ${col(row.fromAddress, COL_FROM)} ${col(row.subject ?? "", COL_SUBJECT)} ${col(row.status, COL_STATUS)} ${new Date(row.createdAt).toLocaleString()}`
+    );
+  }
+  console.log(`
+${rows.length} of ${result.total} emails`);
+});
+
+// src/commands/tail.ts
+import { Command as Command3 } from "commander";
+var POLL_INTERVAL_MS = 5e3;
+var tailCommand = new Command3("tail").description("Poll and print new email events (Ctrl-C to stop)").option(
+  "--since <timestamp>",
+  "Skip events before this ISO timestamp (default: now)"
+).action(async (opts) => {
+  const cfg = loadConfig();
+  const seen = /* @__PURE__ */ new Set();
+  const startedAt = opts.since ? new Date(opts.since) : /* @__PURE__ */ new Date();
+  console.log("Tailing email events\u2026 (Ctrl-C to stop)");
+  const poll = async () => {
+    try {
+      const res = await fetch(
+        `${cfg.apiUrl}/emails/recent-activity?limit=20`,
+        { headers: { Authorization: `Bearer ${cfg.apiKey}` } }
+      );
+      if (!res.ok) {
+        console.error(`Poll error: ${res.statusText}`);
+        return;
+      }
+      const items = await res.json();
+      for (const item of items) {
+        if (!seen.has(item.id)) {
+          seen.add(item.id);
+          if (new Date(item.createdAt) < startedAt) continue;
+          const ts = new Date(item.createdAt).toLocaleTimeString();
+          console.log(
+            `[${ts}] ${item.type.padEnd(12)} ${item.subject}  (${item.fromAddress})`
+          );
+        }
+      }
+    } catch {
+    }
+  };
+  await poll();
+  setInterval(() => void poll(), POLL_INTERVAL_MS);
+});
+
+// src/commands/login.ts
+import { Command as Command4 } from "commander";
+import { createInterface } from "readline/promises";
+import { stdin, stdout } from "process";
+async function prompt(question) {
+  const rl = createInterface({ input: stdin, output: stdout });
+  const answer = await rl.question(question);
+  rl.close();
+  return answer.trim();
+}
+var loginCommand = new Command4("login").description("Authenticate with your DevelEmail instance as owner").requiredOption(
+  "--url <url>",
+  "Base URL of your DevelEmail API (e.g. https://mail.example.com)"
+).option("--email <email>", "Owner email").option("--password <password>", "Owner password").action(async (opts) => {
+  const url = opts.url.replace(/\/$/, "");
+  const email = opts.email ?? await prompt("Email: ");
+  const password = opts.password ?? await prompt("Password: ");
+  let res;
+  try {
+    res = await fetch(`${url}/auth/login`, {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify({ email, password })
+    });
+  } catch (err) {
+    console.error(
+      `Error: ${err instanceof Error ? err.message : String(err)}`
+    );
+    process.exit(1);
+  }
+  if (!res.ok) {
+    const body = await res.json().catch(() => ({}));
+    console.error(`Error: ${body.message ?? res.statusText}`);
+    process.exit(1);
+  }
+  const setCookie = res.headers.get("set-cookie");
+  const token = setCookie?.match(/session=([^;]+)/)?.[1];
+  if (!token) {
+    console.error("Error: No session cookie returned from server.");
+    process.exit(1);
+  }
+  saveOwnerSession({ url, token });
+  const data = await res.json();
+  console.log(`Logged in as ${data.owner?.email ?? email}`);
+  console.log(`Session saved to ~/.config/develemail/auth.json`);
+});
+var logoutCommand = new Command4("logout").description("Clear the stored owner session").action(() => {
+  clearOwnerSession();
+  console.log("Logged out.");
+});
+
+// src/commands/project.ts
+import { Command as Command5 } from "commander";
+function ownerHeaders(token) {
+  return { Cookie: `session=${token}`, "Content-Type": "application/json" };
+}
+async function apiRequest(url, token, init) {
+  const res = await fetch(url, {
+    ...init,
+    headers: { ...ownerHeaders(token), ...init?.headers ?? {} }
+  });
+  if (!res.ok) {
+    const body = await res.json().catch(() => ({}));
+    console.error(`Error: ${body.message ?? res.statusText}`);
+    process.exit(1);
+  }
+  return res.json();
+}
+var COL_ID2 = 36;
+var COL_NAME = 24;
+var COL_ENV = 12;
+function col2(s, w) {
+  return (s ?? "").slice(0, w).padEnd(w);
+}
+var listCommand = new Command5("list").description("List all projects").action(async () => {
+  const { url, token } = loadOwnerSession();
+  const projects = await apiRequest(`${url}/projects`, token);
+  if (projects.length === 0) {
+    console.log("No projects found.");
+    return;
+  }
+  const header = `${col2("ID", COL_ID2)} ${col2("NAME", COL_NAME)} ${col2("ENV", COL_ENV)} FROM`;
+  console.log(header);
+  console.log("-".repeat(header.length + 30));
+  for (const p of projects) {
+    console.log(
+      `${col2(p.id, COL_ID2)} ${col2(p.name, COL_NAME)} ${col2(p.environment, COL_ENV)} ${p.defaultFromAddress ?? "\u2014"}`
+    );
+  }
+});
+var createCommand = new Command5("create").description("Create a new project").requiredOption("--name <name>", "Project name (slug, e.g. my-app)").option(
+  "--env <env>",
+  "Environment: development | staging | production",
+  "production"
+).option("--from <address>", "Default from address (e.g. noreply@example.com)").option("--rate-limit <n>", "Max emails per day (omit for unlimited)").option("--webhook <url>", "Webhook URL for delivery events").action(
+  async (opts) => {
+    const { url, token } = loadOwnerSession();
+    const project = await apiRequest(`${url}/projects`, token, {
+      method: "POST",
+      body: JSON.stringify({
+        name: opts.name,
+        environment: opts.env,
+        defaultFromAddress: opts.from,
+        rateLimitPerDay: opts.rateLimit ? Number(opts.rateLimit) : void 0,
+        webhookUrl: opts.webhook
+      })
+    });
+    console.log(`Created project: ${project.name} (${project.id})`);
+  }
+);
+var projectCommand = new Command5("project").description("Manage projects").addCommand(listCommand).addCommand(createCommand);
+
+// src/commands/key.ts
+import { Command as Command6 } from "commander";
+function ownerHeaders2(token) {
+  return { Cookie: `session=${token}`, "Content-Type": "application/json" };
+}
+async function apiRequest2(url, token, init) {
+  const res = await fetch(url, {
+    ...init,
+    headers: { ...ownerHeaders2(token), ...init?.headers ?? {} }
+  });
+  if (!res.ok) {
+    const body = await res.json().catch(() => ({}));
+    console.error(`Error: ${body.message ?? res.statusText}`);
+    process.exit(1);
+  }
+  return res.json();
+}
+var listCommand2 = new Command6("list").description("List API keys for a project").requiredOption("--project <id>", "Project ID").action(async (opts) => {
+  const { url, token } = loadOwnerSession();
+  const keys = await apiRequest2(
+    `${url}/projects/${opts.project}/api-keys`,
+    token
+  );
+  if (keys.length === 0) {
+    console.log("No API keys found.");
+    return;
+  }
+  for (const k of keys) {
+    const status = k.revokedAt ? "[revoked]" : "[active]";
+    console.log(`${status} ${k.keyPrefix}\u2026  ${k.name}  (${k.id})`);
+  }
+});
+var createCommand2 = new Command6("create").description("Create a new API key for a project").requiredOption("--project <id>", "Project ID").requiredOption("--name <name>", "Key name (e.g. production, ci)").option("--expires <date>", "Expiry date (ISO-8601, e.g. 2027-01-01)").option("--rate-limit <n>", "Max requests per minute").action(
+  async (opts) => {
+    const { url, token } = loadOwnerSession();
+    const result = await apiRequest2(
+      `${url}/projects/${opts.project}/api-keys`,
+      token,
+      {
+        method: "POST",
+        body: JSON.stringify({
+          name: opts.name,
+          expiresAt: opts.expires,
+          rateLimitPerMinute: opts.rateLimit ? Number(opts.rateLimit) : void 0
+        })
+      }
+    );
+    console.log(`Key name:   ${result.name}`);
+    console.log(`Key prefix: ${result.keyPrefix}\u2026`);
+    console.log(`Secret:     ${result.secret}`);
+    console.log("");
+    console.log("Store the secret now \u2014 it will not be shown again.");
+  }
+);
+var keyCommand = new Command6("key").description("Manage API keys").addCommand(listCommand2).addCommand(createCommand2);
+
+// src/commands/init.ts
+import { Command as Command7 } from "commander";
+import { readFileSync as readFileSync2, writeFileSync as writeFileSync2 } from "fs";
+import { resolve } from "path";
+function ownerHeaders3(token) {
+  return { Cookie: `session=${token}`, "Content-Type": "application/json" };
+}
+async function apiRequest3(url, token, init) {
+  const res = await fetch(url, {
+    ...init,
+    headers: { ...ownerHeaders3(token), ...init?.headers ?? {} }
+  });
+  if (!res.ok) {
+    const body = await res.json().catch(() => ({}));
+    console.error(`Error ${res.status}: ${body.message ?? res.statusText}`);
+    process.exit(1);
+  }
+  return res.json();
+}
+function upsertEnvFile(filePath, vars) {
+  let existing = "";
+  try {
+    existing = readFileSync2(filePath, "utf-8");
+  } catch {
+  }
+  const keys = Object.keys(vars);
+  const lines = existing.split("\n").filter((line) => !keys.some((k) => line.startsWith(`${k}=`)));
+  const appended = keys.map((k) => `${k}=${vars[k]}`).join("\n");
+  const content = lines.join("\n").trimEnd() + (lines.some((l) => l.trim()) ? "\n" : "") + appended + "\n";
+  writeFileSync2(filePath, content, "utf-8");
+}
+var initCommand = new Command7("init").description(
+  "Provision a project + API key and write credentials to an env file"
+).requiredOption(
+  "--project <name>",
+  "Project name (created if it does not exist)"
+).option(
+  "--env-file <paths>",
+  "Comma-separated env files to write credentials to",
+  ".env,.env.prod"
+).option("--key-name <name>", "Name for the new API key", "cli").option("--env <env>", "Environment for new projects", "production").option("--from <address>", "Default from address for new projects").action(
+  async (opts) => {
+    const { url, token } = loadOwnerSession();
+    const envFilePaths = opts.envFile.split(",").map((p) => resolve(process.cwd(), p.trim()));
+    const projects = await apiRequest3(`${url}/projects`, token);
+    let project = projects.find((p) => p.name === opts.project);
+    if (project) {
+      console.log(`Using existing project: ${project.name} (${project.id})`);
+    } else {
+      console.log(`Creating project: ${opts.project} \u2026`);
+      project = await apiRequest3(`${url}/projects`, token, {
+        method: "POST",
+        body: JSON.stringify({
+          name: opts.project,
+          environment: opts.env,
+          defaultFromAddress: opts.from
+        })
+      });
+      console.log(`Created: ${project.name} (${project.id})`);
+    }
+    console.log(`Creating API key "${opts.keyName}" \u2026`);
+    const result = await apiRequest3(
+      `${url}/projects/${project.id}/api-keys`,
+      token,
+      {
+        method: "POST",
+        body: JSON.stringify({ name: opts.keyName })
+      }
+    );
+    console.log(`Key created: ${result.keyPrefix}\u2026`);
+    const vars = {
+      DEVELEMAIL_BASE_URL: url,
+      DEVELEMAIL_API_KEY: result.secret
+    };
+    for (const envFilePath of envFilePaths) {
+      upsertEnvFile(envFilePath, vars);
+      console.log(`Written to ${envFilePath}`);
+    }
+    console.log("");
+    console.log(`  DEVELEMAIL_BASE_URL=${url}`);
+    console.log(`  DEVELEMAIL_API_KEY=${result.keyPrefix}\u2026`);
+  }
+);
+
+// src/index.ts
+var program = new Command8().name("devel").description("DevelEmail CLI \u2014 interact with your DevelEmail instance").version("0.1.0");
+program.addCommand(loginCommand);
+program.addCommand(logoutCommand);
+program.addCommand(projectCommand);
+program.addCommand(keyCommand);
+program.addCommand(initCommand);
+program.addCommand(sendCommand);
+program.addCommand(logsCommand);
+program.addCommand(tailCommand);
+program.parse(process.argv);

package/package.json

@@ -0,0 +1,28 @@
+{
+  "name": "@develemail/cli",
+  "version": "0.1.1",
+  "type": "module",
+  "bin": {
+    "devel": "./dist/index.js"
+  },
+  "exports": {
+    ".": {
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsup"
+  },
+  "dependencies": {
+    "@develemail/sdk": "workspace:*",
+    "commander": "^12.1.0",
+    "dotenv": "^16.4.5"
+  },
+  "devDependencies": {
+    "tsup": "^8.3.5",
+    "typescript": "~5.7.2"
+  }
+}