supersendtx-cli 0.3.0 → 0.6.0

package/dist/cli.js

@@ -6,13 +6,39 @@ function readFlag(args, flag) {
   if (index === -1) return void 0;
   return args[index + 1];
 }
+function readFlags(args, flag) {
+  const values = [];
+  for (let index = 0; index < args.length; index += 1) {
+    if (args[index] === flag && args[index + 1]) values.push(args[index + 1]);
+  }
+  return values;
+}
+function parseTags(values) {
+  const tags = values.map((value) => {
+    const separator = value.indexOf("=");
+    if (separator <= 0) {
+      return null;
+    }
+    const name = value.slice(0, separator).trim();
+    const tagValue = value.slice(separator + 1).trim();
+    if (!name || !tagValue) return null;
+    return { name, value: tagValue };
+  });
+  if (tags.some((tag) => tag == null)) {
+    return { error: "--tag must be in name=value format" };
+  }
+  return tags;
+}
 function parseSendCommandArgs(args) {
+  const parsedTags = parseTags(readFlags(args, "--tag"));
   return {
     from: readFlag(args, "--from"),
     to: readFlag(args, "--to"),
     subject: readFlag(args, "--subject"),
     html: readFlag(args, "--html"),
     text: readFlag(args, "--text"),
+    tags: Array.isArray(parsedTags) ? parsedTags : void 0,
+    scheduledAt: readFlag(args, "--schedule"),
     apiKey: readFlag(args, "--api-key"),
     baseUrl: readFlag(args, "--base-url")
   };
@@ -32,7 +58,9 @@ async function runSendCommand(args, deps) {
       to: options.to,
       subject: options.subject,
       html: options.html,
-      text: options.text
+      text: options.text,
+      tags: options.tags,
+      scheduledAt: options.scheduledAt
     });
     stdout(JSON.stringify(result));
     return 0;
@@ -44,9 +72,13 @@ async function runSendCommand(args, deps) {
 function parseSendCommandOptions(args, env) {
   const parsed = parseSendCommandArgs(args);
   const apiKey = parsed.apiKey || env.SUPERSENDTX_API_KEY || env.SUPERTX_API_KEY;
+  const parsedTags = parseTags(readFlags(args, "--tag"));
   if (!apiKey) {
     return { error: "Missing API key. Set SUPERSENDTX_API_KEY or pass --api-key." };
   }
+  if ("error" in parsedTags) {
+    return { error: parsedTags.error };
+  }
   if (!parsed.from || !parsed.to || !parsed.subject) {
     return { error: "Required flags: --from --to --subject (and --html or --text)" };
   }
@@ -59,6 +91,8 @@ function parseSendCommandOptions(args, env) {
     subject: parsed.subject,
     html: parsed.html,
     text: parsed.text,
+    tags: parsedTags.length ? parsedTags : void 0,
+    scheduledAt: parsed.scheduledAt,
     apiKey,
     baseUrl: parsed.baseUrl
   };
@@ -82,18 +116,148 @@ async function runSendCommandWithClient(args, env = process.env) {
   return { exitCode };
 }
 
-// src/commands/domains/shared.ts
+// src/commands/emails/cancel.ts
 function readFlag2(args, flag) {
   const index = args.indexOf(flag);
   if (index === -1) return void 0;
   return args[index + 1];
 }
+async function runCancelCommand(args, deps) {
+  const env = deps.env ?? process.env;
+  const stdout = deps.stdout ?? ((line) => console.log(line));
+  const stderr = deps.stderr ?? ((line) => console.error(line));
+  const apiKey = readFlag2(args, "--api-key") || env.SUPERSENDTX_API_KEY || env.SUPERTX_API_KEY;
+  const id = readFlag2(args, "--id") || args.find((arg) => !arg.startsWith("--"));
+  if (!apiKey) {
+    stderr("Missing API key. Set SUPERSENDTX_API_KEY or pass --api-key.");
+    return { exitCode: 1, error: "missing key" };
+  }
+  if (!id) {
+    stderr("Required: --id <msg_\u2026>");
+    return { exitCode: 1, error: "missing id" };
+  }
+  try {
+    const result = await deps.cancelEmail(id);
+    stdout(JSON.stringify(result));
+    return { exitCode: 0 };
+  } catch (error) {
+    stderr(error instanceof Error ? error.message : String(error));
+    return { exitCode: 1, error: String(error) };
+  }
+}
+async function runCancelCommandWithClient(args, env = process.env) {
+  const apiKey = readFlag2(args, "--api-key") || env.SUPERSENDTX_API_KEY || env.SUPERTX_API_KEY;
+  const baseUrl = readFlag2(args, "--base-url");
+  if (!apiKey) {
+    return { exitCode: 1, error: "Missing API key. Set SUPERSENDTX_API_KEY or pass --api-key." };
+  }
+  const { SuperSendTX } = await import("supersendtx");
+  const client = new SuperSendTX(apiKey, baseUrl ? { baseUrl } : void 0);
+  return runCancelCommand(args, {
+    env,
+    cancelEmail: (id) => client.emails.cancel(id)
+  });
+}
+
+// src/commands/emails/get.ts
+function readFlag3(args, flag) {
+  const index = args.indexOf(flag);
+  if (index === -1) return void 0;
+  return args[index + 1];
+}
+async function runGetCommand(args, deps) {
+  const env = deps.env ?? process.env;
+  const stdout = deps.stdout ?? ((line) => console.log(line));
+  const stderr = deps.stderr ?? ((line) => console.error(line));
+  const id = readFlag3(args, "--id") || args.find((a) => !a.startsWith("--"));
+  const apiKey = readFlag3(args, "--api-key") || env.SUPERSENDTX_API_KEY || env.SUPERTX_API_KEY;
+  if (!apiKey) {
+    stderr("Missing API key. Set SUPERSENDTX_API_KEY or pass --api-key.");
+    return { exitCode: 1, error: "missing key" };
+  }
+  if (!id) {
+    stderr("Required: --id <msg_\u2026>");
+    return { exitCode: 1, error: "missing id" };
+  }
+  try {
+    const result = await deps.getEmail(id);
+    stdout(JSON.stringify(result));
+    return { exitCode: 0 };
+  } catch (error) {
+    stderr(error instanceof Error ? error.message : String(error));
+    return { exitCode: 1, error: String(error) };
+  }
+}
+async function runGetCommandWithClient(args, env = process.env) {
+  const apiKey = readFlag3(args, "--api-key") || env.SUPERSENDTX_API_KEY || env.SUPERTX_API_KEY;
+  const baseUrl = readFlag3(args, "--base-url");
+  if (!apiKey) {
+    return { exitCode: 1, error: "Missing API key. Set SUPERSENDTX_API_KEY or pass --api-key." };
+  }
+  const { SuperSendTX } = await import("supersendtx");
+  const client = new SuperSendTX(apiKey, baseUrl ? { baseUrl } : void 0);
+  return runGetCommand(args, {
+    env,
+    getEmail: (id) => client.emails.get(id)
+  });
+}
+
+// src/commands/emails/list.ts
+function readFlag4(args, flag) {
+  const index = args.indexOf(flag);
+  if (index === -1) return void 0;
+  return args[index + 1];
+}
+async function runListCommand(args, deps) {
+  const env = deps.env ?? process.env;
+  const stdout = deps.stdout ?? ((line) => console.log(line));
+  const stderr = deps.stderr ?? ((line) => console.error(line));
+  const apiKey = readFlag4(args, "--api-key") || env.SUPERSENDTX_API_KEY || env.SUPERTX_API_KEY;
+  if (!apiKey) {
+    stderr("Missing API key. Set SUPERSENDTX_API_KEY or pass --api-key.");
+    return { exitCode: 1, error: "missing key" };
+  }
+  const limitRaw = readFlag4(args, "--limit");
+  const cursor = readFlag4(args, "--cursor");
+  const limit = limitRaw ? Number(limitRaw) : void 0;
+  try {
+    const result = await deps.listEmails({
+      ...limit != null && Number.isFinite(limit) ? { limit } : {},
+      ...cursor ? { cursor } : {}
+    });
+    stdout(JSON.stringify(result));
+    return { exitCode: 0 };
+  } catch (error) {
+    stderr(error instanceof Error ? error.message : String(error));
+    return { exitCode: 1, error: String(error) };
+  }
+}
+async function runListCommandWithClient(args, env = process.env) {
+  const apiKey = readFlag4(args, "--api-key") || env.SUPERSENDTX_API_KEY || env.SUPERTX_API_KEY;
+  const baseUrl = readFlag4(args, "--base-url");
+  if (!apiKey) {
+    return { exitCode: 1, error: "Missing API key. Set SUPERSENDTX_API_KEY or pass --api-key." };
+  }
+  const { SuperSendTX } = await import("supersendtx");
+  const client = new SuperSendTX(apiKey, baseUrl ? { baseUrl } : void 0);
+  return runListCommand(args, {
+    env,
+    listEmails: (params) => client.emails.list(params)
+  });
+}
+
+// src/commands/domains/shared.ts
+function readFlag5(args, flag) {
+  const index = args.indexOf(flag);
+  if (index === -1) return void 0;
+  return args[index + 1];
+}
 function parseDomainsCommonArgs(args) {
   return {
-    apiKey: readFlag2(args, "--api-key"),
-    baseUrl: readFlag2(args, "--base-url"),
-    name: readFlag2(args, "--name") || readFlag2(args, "--domain"),
-    id: readFlag2(args, "--id")
+    apiKey: readFlag5(args, "--api-key"),
+    baseUrl: readFlag5(args, "--base-url"),
+    name: readFlag5(args, "--name") || readFlag5(args, "--domain"),
+    id: readFlag5(args, "--id")
   };
 }
 function resolveApiKey(options, env) {
@@ -200,7 +364,7 @@ async function runApplyCommand(args, env = process.env) {
 }
 
 // src/commands/domains/list.ts
-async function runListCommand(args, env = process.env) {
+async function runListCommand2(args, env = process.env) {
   const options = parseDomainsCommonArgs(args);
   const apiKey = resolveApiKey(options, env);
   if (!apiKey) {
@@ -244,15 +408,15 @@ async function runVerifyCommand(args, env = process.env) {
 }
 
 // src/commands/webhooks/shared.ts
-function readFlag3(args, flag) {
+function readFlag6(args, flag) {
   const index = args.indexOf(flag);
   if (index === -1) return void 0;
   return args[index + 1];
 }
 function parseWebhooksCommonArgs(args) {
   return {
-    apiKey: readFlag3(args, "--api-key"),
-    baseUrl: readFlag3(args, "--base-url")
+    apiKey: readFlag6(args, "--api-key"),
+    baseUrl: readFlag6(args, "--base-url")
   };
 }
 function resolveApiKey2(options, env) {
@@ -270,7 +434,7 @@ async function runCreateCommand(args, env = process.env) {
   if (!apiKey) {
     return { exitCode: 1, error: "Missing API key. Set SUPERSENDTX_API_KEY or pass --api-key." };
   }
-  const url = readFlag3(args, "--url");
+  const url = readFlag6(args, "--url");
   if (!url) {
     return { exitCode: 1, error: "Required flag: --url" };
   }
@@ -291,7 +455,7 @@ async function runDeleteCommand(args, env = process.env) {
   if (!apiKey) {
     return { exitCode: 1, error: "Missing API key. Set SUPERSENDTX_API_KEY or pass --api-key." };
   }
-  const id = readFlag3(args, "--id");
+  const id = readFlag6(args, "--id");
   if (!id) {
     return { exitCode: 1, error: "Required flag: --id" };
   }
@@ -306,7 +470,7 @@ async function runDeleteCommand(args, env = process.env) {
 }
 
 // src/commands/webhooks/list.ts
-async function runListCommand2(args, env = process.env) {
+async function runListCommand3(args, env = process.env) {
   const options = parseWebhooksCommonArgs(args);
   const apiKey = resolveApiKey2(options, env);
   if (!apiKey) {
@@ -322,6 +486,188 @@ async function runListCommand2(args, env = process.env) {
   }
 }
 
+// src/commands/keys/list.ts
+function readFlag7(args, flag) {
+  const index = args.indexOf(flag);
+  if (index === -1) return void 0;
+  return args[index + 1];
+}
+async function runListKeysCommandWithClient(args, env = process.env) {
+  const apiKey = readFlag7(args, "--api-key") || env.SUPERSENDTX_API_KEY || env.SUPERTX_API_KEY;
+  const baseUrl = readFlag7(args, "--base-url");
+  if (!apiKey) {
+    return { exitCode: 1, error: "Missing API key. Set SUPERSENDTX_API_KEY or pass --api-key." };
+  }
+  const { SuperSendTX } = await import("supersendtx");
+  const client = new SuperSendTX(apiKey, baseUrl ? { baseUrl } : void 0);
+  try {
+    const limitRaw = readFlag7(args, "--limit");
+    const cursor = readFlag7(args, "--cursor");
+    const result = await client.apiKeys.list({
+      ...limitRaw ? { limit: Number(limitRaw) } : {},
+      ...cursor ? { cursor } : {}
+    });
+    console.log(JSON.stringify(result));
+    return { exitCode: 0 };
+  } catch (error) {
+    const message = error instanceof Error ? error.message : String(error);
+    console.error(message);
+    return { exitCode: 1, error: message };
+  }
+}
+
+// src/commands/keys/create.ts
+function readFlag8(args, flag) {
+  const index = args.indexOf(flag);
+  if (index === -1) return void 0;
+  return args[index + 1];
+}
+async function runCreateKeyCommandWithClient(args, env = process.env) {
+  const apiKey = readFlag8(args, "--api-key") || env.SUPERSENDTX_API_KEY || env.SUPERTX_API_KEY;
+  const baseUrl = readFlag8(args, "--base-url");
+  if (!apiKey) {
+    return { exitCode: 1, error: "Missing API key. Set SUPERSENDTX_API_KEY or pass --api-key." };
+  }
+  const name = readFlag8(args, "--name");
+  const scope = readFlag8(args, "--scope");
+  if (scope && scope !== "full" && scope !== "sending") {
+    return { exitCode: 1, error: "--scope must be full or sending" };
+  }
+  const { SuperSendTX } = await import("supersendtx");
+  const client = new SuperSendTX(apiKey, baseUrl ? { baseUrl } : void 0);
+  try {
+    const result = await client.apiKeys.create({
+      ...name ? { name } : {},
+      ...scope ? { scope } : {}
+    });
+    console.log(JSON.stringify(result));
+    return { exitCode: 0 };
+  } catch (error) {
+    const message = error instanceof Error ? error.message : String(error);
+    console.error(message);
+    return { exitCode: 1, error: message };
+  }
+}
+
+// src/commands/keys/delete.ts
+function readFlag9(args, flag) {
+  const index = args.indexOf(flag);
+  if (index === -1) return void 0;
+  return args[index + 1];
+}
+async function runDeleteKeyCommandWithClient(args, env = process.env) {
+  const apiKey = readFlag9(args, "--api-key") || env.SUPERSENDTX_API_KEY || env.SUPERTX_API_KEY;
+  const baseUrl = readFlag9(args, "--base-url");
+  const id = readFlag9(args, "--id");
+  if (!apiKey) {
+    return { exitCode: 1, error: "Missing API key. Set SUPERSENDTX_API_KEY or pass --api-key." };
+  }
+  if (!id) {
+    return { exitCode: 1, error: "Required: --id <api-key-id>" };
+  }
+  const { SuperSendTX } = await import("supersendtx");
+  const client = new SuperSendTX(apiKey, baseUrl ? { baseUrl } : void 0);
+  try {
+    const result = await client.apiKeys.remove(id);
+    console.log(JSON.stringify(result));
+    return { exitCode: 0 };
+  } catch (error) {
+    const message = error instanceof Error ? error.message : String(error);
+    console.error(message);
+    return { exitCode: 1, error: message };
+  }
+}
+
+// src/commands/suppressions/shared.ts
+function readFlag10(args, flag) {
+  const index = args.indexOf(flag);
+  if (index === -1) return void 0;
+  return args[index + 1];
+}
+function parseSuppressionsCommonArgs(args) {
+  return {
+    apiKey: readFlag10(args, "--api-key"),
+    baseUrl: readFlag10(args, "--base-url")
+  };
+}
+function resolveApiKey3(options, env) {
+  return options.apiKey || env.SUPERSENDTX_API_KEY || env.SUPERTX_API_KEY || null;
+}
+async function createSuppressionsClient(apiKey, baseUrl) {
+  const { SuperSendTX } = await import("supersendtx");
+  return new SuperSendTX(apiKey, baseUrl ? { baseUrl } : void 0);
+}
+
+// src/commands/suppressions/list.ts
+async function runListCommand4(args, env = process.env) {
+  const options = parseSuppressionsCommonArgs(args);
+  const apiKey = resolveApiKey3(options, env);
+  if (!apiKey) {
+    return { exitCode: 1, error: "Missing API key. Set SUPERSENDTX_API_KEY or pass --api-key." };
+  }
+  try {
+    const client = await createSuppressionsClient(apiKey, options.baseUrl);
+    const limitRaw = readFlag10(args, "--limit");
+    const cursor = readFlag10(args, "--cursor");
+    const email = readFlag10(args, "--email");
+    const result = await client.suppressions.list({
+      ...limitRaw ? { limit: Number(limitRaw) } : {},
+      ...cursor ? { cursor } : {},
+      ...email ? { email } : {}
+    });
+    console.log(JSON.stringify(result));
+    return { exitCode: 0 };
+  } catch (error) {
+    return { exitCode: 1, error: error instanceof Error ? error.message : String(error) };
+  }
+}
+
+// src/commands/suppressions/add.ts
+async function runAddCommand2(args, env = process.env) {
+  const options = parseSuppressionsCommonArgs(args);
+  const apiKey = resolveApiKey3(options, env);
+  if (!apiKey) {
+    return { exitCode: 1, error: "Missing API key. Set SUPERSENDTX_API_KEY or pass --api-key." };
+  }
+  const email = readFlag10(args, "--email") || args.find((a) => a.includes("@") && !a.startsWith("-"));
+  if (!email) {
+    return { exitCode: 1, error: "Missing email. Pass --email user@example.com" };
+  }
+  try {
+    const client = await createSuppressionsClient(apiKey, options.baseUrl);
+    const reason = readFlag10(args, "--reason");
+    const result = await client.suppressions.create({
+      email,
+      ...reason ? { reason } : {}
+    });
+    console.log(JSON.stringify(result));
+    return { exitCode: 0 };
+  } catch (error) {
+    return { exitCode: 1, error: error instanceof Error ? error.message : String(error) };
+  }
+}
+
+// src/commands/suppressions/remove.ts
+async function runRemoveCommand(args, env = process.env) {
+  const options = parseSuppressionsCommonArgs(args);
+  const apiKey = resolveApiKey3(options, env);
+  if (!apiKey) {
+    return { exitCode: 1, error: "Missing API key. Set SUPERSENDTX_API_KEY or pass --api-key." };
+  }
+  const idOrEmail = readFlag10(args, "--id") || readFlag10(args, "--email") || args.find((a) => !a.startsWith("-") && a !== "remove" && a !== "delete");
+  if (!idOrEmail) {
+    return { exitCode: 1, error: "Missing id or email. Pass --id <uuid> or --email user@example.com" };
+  }
+  try {
+    const client = await createSuppressionsClient(apiKey, options.baseUrl);
+    const result = await client.suppressions.remove(idOrEmail);
+    console.log(JSON.stringify(result));
+    return { exitCode: 0 };
+  } catch (error) {
+    return { exitCode: 1, error: error instanceof Error ? error.message : String(error) };
+  }
+}
+
 // src/cli.ts
 function printUsage() {
   console.error("Usage:");
@@ -333,9 +679,18 @@ function printUsage() {
   console.error(
     '  supersendtx emails send --from you@domain.com --to user@example.com --subject "Hello" --html "<p>Hi</p>"'
   );
+  console.error("  supersendtx emails list [--limit 25] [--cursor \u2026]");
+  console.error("  supersendtx emails get --id msg_\u2026");
+  console.error("  supersendtx emails cancel --id msg_\u2026");
   console.error("  supersendtx webhooks list");
   console.error("  supersendtx webhooks create --url https://yourapp.com/hooks");
   console.error("  supersendtx webhooks delete --id <webhook-id>");
+  console.error("  supersendtx suppressions list");
+  console.error("  supersendtx suppressions add --email user@example.com [--reason \u2026]");
+  console.error("  supersendtx suppressions remove --id <id> | --email user@example.com");
+  console.error("  supersendtx keys list");
+  console.error("  supersendtx keys create [--name Default] [--scope full|sending]");
+  console.error("  supersendtx keys delete --id <api-key-id>");
   console.error("");
   console.error("Environment:");
   console.error("  SUPERSENDTX_API_KEY=stx_\u2026");
@@ -356,7 +711,7 @@ async function main() {
       process.exit(result.exitCode);
     }
     if (subcommand === "list") {
-      const result = await runListCommand(rest);
+      const result = await runListCommand2(rest);
       if (result.error) console.error(result.error);
       process.exit(result.exitCode);
     }
@@ -366,13 +721,30 @@ async function main() {
       process.exit(result.exitCode);
     }
   }
-  if (command === "emails" && subcommand === "send") {
-    const result = await runSendCommandWithClient(rest);
-    process.exit(result.exitCode);
+  if (command === "emails") {
+    if (subcommand === "send") {
+      const result = await runSendCommandWithClient(rest);
+      process.exit(result.exitCode);
+    }
+    if (subcommand === "cancel") {
+      const result = await runCancelCommandWithClient(rest);
+      if (result.error) console.error(result.error);
+      process.exit(result.exitCode);
+    }
+    if (subcommand === "list") {
+      const result = await runListCommandWithClient(rest);
+      if (result.error) console.error(result.error);
+      process.exit(result.exitCode);
+    }
+    if (subcommand === "get") {
+      const result = await runGetCommandWithClient(rest);
+      if (result.error) console.error(result.error);
+      process.exit(result.exitCode);
+    }
   }
   if (command === "webhooks") {
     if (subcommand === "list") {
-      const result = await runListCommand2(rest);
+      const result = await runListCommand3(rest);
       if (result.error) console.error(result.error);
       process.exit(result.exitCode);
     }
@@ -387,6 +759,40 @@ async function main() {
       process.exit(result.exitCode);
     }
   }
+  if (command === "suppressions") {
+    if (subcommand === "list") {
+      const result = await runListCommand4(rest);
+      if (result.error) console.error(result.error);
+      process.exit(result.exitCode);
+    }
+    if (subcommand === "add" || subcommand === "create") {
+      const result = await runAddCommand2(rest);
+      if (result.error) console.error(result.error);
+      process.exit(result.exitCode);
+    }
+    if (subcommand === "remove" || subcommand === "delete") {
+      const result = await runRemoveCommand(rest);
+      if (result.error) console.error(result.error);
+      process.exit(result.exitCode);
+    }
+  }
+  if (command === "keys") {
+    if (subcommand === "list") {
+      const result = await runListKeysCommandWithClient(rest);
+      if (result.error) console.error(result.error);
+      process.exit(result.exitCode);
+    }
+    if (subcommand === "create") {
+      const result = await runCreateKeyCommandWithClient(rest);
+      if (result.error) console.error(result.error);
+      process.exit(result.exitCode);
+    }
+    if (subcommand === "delete") {
+      const result = await runDeleteKeyCommandWithClient(rest);
+      if (result.error) console.error(result.error);
+      process.exit(result.exitCode);
+    }
+  }
   printUsage();
   process.exit(1);
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "supersendtx-cli",
-  "version": "0.3.0",
+  "version": "0.6.0",
   "description": "SuperSend TX CLI — send transactional email from the terminal",
   "license": "MIT",
   "type": "module",
@@ -39,7 +39,7 @@
     "prepublishOnly": "npm run build"
   },
   "dependencies": {
-    "supersendtx": "^0.3.0"
+    "supersendtx": "0.6.0"
   },
   "devDependencies": {
     "tsup": "^8.5.0",