supersendtx-cli 0.2.0 → 0.4.0

package/dist/cli.js

@@ -82,18 +82,105 @@ async function runSendCommandWithClient(args, env = process.env) {
   return { exitCode };
 }
 
-// src/commands/domains/shared.ts
+// src/commands/emails/get.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) {
+  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;
+  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 = 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 runGetCommand(args, {
+    env,
+    getEmail: (id) => client.emails.get(id)
+  });
+}
+
+// src/commands/emails/list.ts
+function readFlag3(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 = 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" };
+  }
+  const limitRaw = readFlag3(args, "--limit");
+  const cursor = readFlag3(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 = 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 runListCommand(args, {
+    env,
+    listEmails: (params) => client.emails.list(params)
+  });
+}
+
+// src/commands/domains/shared.ts
+function readFlag4(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: readFlag4(args, "--api-key"),
+    baseUrl: readFlag4(args, "--base-url"),
+    name: readFlag4(args, "--name") || readFlag4(args, "--domain"),
+    id: readFlag4(args, "--id")
   };
 }
 function resolveApiKey(options, env) {
@@ -174,16 +261,20 @@ async function runApplyCommand(args, env = process.env) {
   }
   try {
     const client = await createDomainsClient(apiKey, options.baseUrl);
-    const result = await client.domains.applyDns({
+    const localCloudflare = env.CLOUDFLARE_API_TOKEN || env.CLOUDFLARE_API_KEY;
+    const useStoredCloudflare = provider === "cloudflare" && !localCloudflare;
+    const result = useStoredCloudflare ? await client.domains.apply(idOrName, { provider: "cloudflare" }) : await client.domains.applyDns({
       idOrName,
       provider,
-      cloudflareApiToken: env.CLOUDFLARE_API_TOKEN || env.CLOUDFLARE_API_KEY,
+      cloudflareApiToken: localCloudflare,
       cloudflareZoneId: env.CLOUDFLARE_ZONE_ID,
       godaddyApiKey: env.GODADDY_API_KEY,
       godaddyApiSecret: env.GODADDY_API_SECRET
     });
     console.log(JSON.stringify(result));
-    console.error(`Applied ${result.results.length} DNS change(s) via ${result.provider} for ${result.domain}.`);
+    console.error(
+      useStoredCloudflare ? `Applied ${result.results.length} DNS change(s) via stored Cloudflare credentials for ${result.domain}.` : `Applied ${result.results.length} DNS change(s) via ${result.provider} for ${result.domain}.`
+    );
     for (const row of result.results) {
       console.error(`  ${row.action.padEnd(10)} ${row.purpose} \u2192 ${row.host}`);
     }
@@ -196,7 +287,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) {
@@ -240,15 +331,15 @@ async function runVerifyCommand(args, env = process.env) {
 }
 
 // src/commands/webhooks/shared.ts
-function readFlag3(args, flag) {
+function readFlag5(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: readFlag5(args, "--api-key"),
+    baseUrl: readFlag5(args, "--base-url")
   };
 }
 function resolveApiKey2(options, env) {
@@ -266,7 +357,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 = readFlag5(args, "--url");
   if (!url) {
     return { exitCode: 1, error: "Required flag: --url" };
   }
@@ -287,7 +378,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 = readFlag5(args, "--id");
   if (!id) {
     return { exitCode: 1, error: "Required flag: --id" };
   }
@@ -302,7 +393,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) {
@@ -318,6 +409,98 @@ async function runListCommand2(args, env = process.env) {
   }
 }
 
+// src/commands/keys/list.ts
+function readFlag6(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");
+  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 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 readFlag7(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");
+  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");
+  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 readFlag8(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");
+  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/cli.ts
 function printUsage() {
   console.error("Usage:");
@@ -329,13 +512,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 webhooks list");
   console.error("  supersendtx webhooks create --url https://yourapp.com/hooks");
   console.error("  supersendtx webhooks delete --id <webhook-id>");
+  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");
-  console.error("  CLOUDFLARE_API_TOKEN=\u2026            (domains apply --provider cloudflare)");
+  console.error("  CLOUDFLARE_API_TOKEN=\u2026            (optional local apply; else uses dashboard Integrations)");
   console.error("  GODADDY_API_KEY=\u2026 GODADDY_API_SECRET=\u2026  (domains apply --provider godaddy)");
 }
 async function main() {
@@ -352,7 +540,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);
     }
@@ -362,13 +550,25 @@ 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 === "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);
     }
@@ -383,6 +583,23 @@ async function main() {
       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.2.0",
+  "version": "0.4.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.2.0"
+    "supersendtx": "0.4.0"
   },
   "devDependencies": {
     "tsup": "^8.5.0",