supersendtx-cli 0.4.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,18 @@ async function runSendCommandWithClient(args, env = process.env) {
   return { exitCode };
 }
 
-// src/commands/emails/get.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 runGetCommand(args, deps) {
+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 id = readFlag2(args, "--id") || args.find((a) => !a.startsWith("--"));
   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" };
@@ -103,7 +137,7 @@ async function runGetCommand(args, deps) {
     return { exitCode: 1, error: "missing id" };
   }
   try {
-    const result = await deps.getEmail(id);
+    const result = await deps.cancelEmail(id);
     stdout(JSON.stringify(result));
     return { exitCode: 0 };
   } catch (error) {
@@ -111,7 +145,7 @@ async function runGetCommand(args, deps) {
     return { exitCode: 1, error: String(error) };
   }
 }
-async function runGetCommandWithClient(args, env = process.env) {
+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) {
@@ -119,6 +153,49 @@ async function runGetCommandWithClient(args, env = process.env) {
   }
   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)
@@ -126,7 +203,7 @@ async function runGetCommandWithClient(args, env = process.env) {
 }
 
 // src/commands/emails/list.ts
-function readFlag3(args, flag) {
+function readFlag4(args, flag) {
   const index = args.indexOf(flag);
   if (index === -1) return void 0;
   return args[index + 1];
@@ -135,13 +212,13 @@ 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 = readFlag3(args, "--api-key") || env.SUPERSENDTX_API_KEY || env.SUPERTX_API_KEY;
+  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 = readFlag3(args, "--limit");
-  const cursor = readFlag3(args, "--cursor");
+  const limitRaw = readFlag4(args, "--limit");
+  const cursor = readFlag4(args, "--cursor");
   const limit = limitRaw ? Number(limitRaw) : void 0;
   try {
     const result = await deps.listEmails({
@@ -156,8 +233,8 @@ async function runListCommand(args, deps) {
   }
 }
 async function runListCommandWithClient(args, env = process.env) {
-  const apiKey = readFlag3(args, "--api-key") || env.SUPERSENDTX_API_KEY || env.SUPERTX_API_KEY;
-  const baseUrl = readFlag3(args, "--base-url");
+  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." };
   }
@@ -170,17 +247,17 @@ async function runListCommandWithClient(args, env = process.env) {
 }
 
 // src/commands/domains/shared.ts
-function readFlag4(args, flag) {
+function readFlag5(args, flag) {
   const index = args.indexOf(flag);
   if (index === -1) return void 0;
   return args[index + 1];
 }
 function parseDomainsCommonArgs(args) {
   return {
-    apiKey: readFlag4(args, "--api-key"),
-    baseUrl: readFlag4(args, "--base-url"),
-    name: readFlag4(args, "--name") || readFlag4(args, "--domain"),
-    id: readFlag4(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) {
@@ -331,15 +408,15 @@ async function runVerifyCommand(args, env = process.env) {
 }
 
 // src/commands/webhooks/shared.ts
-function readFlag5(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: readFlag5(args, "--api-key"),
-    baseUrl: readFlag5(args, "--base-url")
+    apiKey: readFlag6(args, "--api-key"),
+    baseUrl: readFlag6(args, "--base-url")
   };
 }
 function resolveApiKey2(options, env) {
@@ -357,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 = readFlag5(args, "--url");
+  const url = readFlag6(args, "--url");
   if (!url) {
     return { exitCode: 1, error: "Required flag: --url" };
   }
@@ -378,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 = readFlag5(args, "--id");
+  const id = readFlag6(args, "--id");
   if (!id) {
     return { exitCode: 1, error: "Required flag: --id" };
   }
@@ -410,22 +487,22 @@ async function runListCommand3(args, env = process.env) {
 }
 
 // src/commands/keys/list.ts
-function readFlag6(args, flag) {
+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 = readFlag6(args, "--api-key") || env.SUPERSENDTX_API_KEY || env.SUPERTX_API_KEY;
-  const baseUrl = readFlag6(args, "--base-url");
+  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 = readFlag6(args, "--limit");
-    const cursor = readFlag6(args, "--cursor");
+    const limitRaw = readFlag7(args, "--limit");
+    const cursor = readFlag7(args, "--cursor");
     const result = await client.apiKeys.list({
       ...limitRaw ? { limit: Number(limitRaw) } : {},
       ...cursor ? { cursor } : {}
@@ -440,19 +517,19 @@ async function runListKeysCommandWithClient(args, env = process.env) {
 }
 
 // src/commands/keys/create.ts
-function readFlag7(args, flag) {
+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 = readFlag7(args, "--api-key") || env.SUPERSENDTX_API_KEY || env.SUPERTX_API_KEY;
-  const baseUrl = readFlag7(args, "--base-url");
+  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 = readFlag7(args, "--name");
-  const scope = readFlag7(args, "--scope");
+  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" };
   }
@@ -473,15 +550,15 @@ async function runCreateKeyCommandWithClient(args, env = process.env) {
 }
 
 // src/commands/keys/delete.ts
-function readFlag8(args, flag) {
+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 = readFlag8(args, "--api-key") || env.SUPERSENDTX_API_KEY || env.SUPERTX_API_KEY;
-  const baseUrl = readFlag8(args, "--base-url");
-  const id = readFlag8(args, "--id");
+  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." };
   }
@@ -501,6 +578,96 @@ async function runDeleteKeyCommandWithClient(args, env = process.env) {
   }
 }
 
+// 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:");
@@ -514,9 +681,13 @@ function printUsage() {
   );
   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>");
@@ -555,6 +726,11 @@ async function main() {
       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);
@@ -583,6 +759,23 @@ 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);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "supersendtx-cli",
-  "version": "0.4.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.4.0"
+    "supersendtx": "0.6.0"
   },
   "devDependencies": {
     "tsup": "^8.5.0",