supersendtx-cli 0.1.0

package/dist/cli.d.ts

@@ -0,0 +1 @@
+#!/usr/bin/env node

package/dist/cli.js

@@ -0,0 +1,204 @@
+#!/usr/bin/env node
+#!/usr/bin/env node
+
+// src/commands/emails/send.ts
+function readFlag(args, flag) {
+  const index = args.indexOf(flag);
+  if (index === -1) return void 0;
+  return args[index + 1];
+}
+function parseSendCommandArgs(args) {
+  return {
+    from: readFlag(args, "--from"),
+    to: readFlag(args, "--to"),
+    subject: readFlag(args, "--subject"),
+    html: readFlag(args, "--html"),
+    text: readFlag(args, "--text"),
+    apiKey: readFlag(args, "--api-key"),
+    baseUrl: readFlag(args, "--base-url")
+  };
+}
+async function runSendCommand(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 options = parseSendCommandOptions(args, env);
+  if ("error" in options) {
+    stderr(options.error);
+    return 1;
+  }
+  try {
+    const result = await deps.sendEmail({
+      from: options.from,
+      to: options.to,
+      subject: options.subject,
+      html: options.html,
+      text: options.text
+    });
+    stdout(JSON.stringify(result));
+    return 0;
+  } catch (error) {
+    stderr(error instanceof Error ? error.message : String(error));
+    return 1;
+  }
+}
+function parseSendCommandOptions(args, env) {
+  const parsed = parseSendCommandArgs(args);
+  const apiKey = parsed.apiKey || env.SUPERSENDTX_API_KEY || env.SUPERTX_API_KEY;
+  if (!apiKey) {
+    return { error: "Missing API key. Set SUPERSENDTX_API_KEY or pass --api-key." };
+  }
+  if (!parsed.from || !parsed.to || !parsed.subject) {
+    return { error: "Required flags: --from --to --subject (and --html or --text)" };
+  }
+  if (!parsed.html && !parsed.text) {
+    return { error: "Provide --html or --text" };
+  }
+  return {
+    from: parsed.from,
+    to: parsed.to,
+    subject: parsed.subject,
+    html: parsed.html,
+    text: parsed.text,
+    apiKey,
+    baseUrl: parsed.baseUrl
+  };
+}
+function createDefaultSendDeps(apiKey, baseUrl) {
+  return {
+    sendEmail: async (params) => {
+      const { SuperSendTX } = await import("supersendtx");
+      const client = new SuperSendTX(apiKey, baseUrl ? { baseUrl } : void 0);
+      return client.emails.send(params);
+    }
+  };
+}
+async function runSendCommandWithClient(args, env = process.env) {
+  const parsed = parseSendCommandOptions(args, env);
+  if ("error" in parsed) {
+    return { exitCode: 1, error: parsed.error };
+  }
+  const deps = createDefaultSendDeps(parsed.apiKey, parsed.baseUrl);
+  const exitCode = await runSendCommand(args, { ...deps, env });
+  return { exitCode };
+}
+
+// src/commands/webhooks/shared.ts
+function readFlag2(args, flag) {
+  const index = args.indexOf(flag);
+  if (index === -1) return void 0;
+  return args[index + 1];
+}
+function parseWebhooksCommonArgs(args) {
+  return {
+    apiKey: readFlag2(args, "--api-key"),
+    baseUrl: readFlag2(args, "--base-url")
+  };
+}
+function resolveApiKey(options, env) {
+  return options.apiKey || env.SUPERSENDTX_API_KEY || env.SUPERTX_API_KEY || null;
+}
+async function createWebhooksClient(apiKey, baseUrl) {
+  const { SuperSendTX } = await import("supersendtx");
+  return new SuperSendTX(apiKey, baseUrl ? { baseUrl } : void 0);
+}
+
+// src/commands/webhooks/create.ts
+async function runCreateCommand(args, env = process.env) {
+  const options = parseWebhooksCommonArgs(args);
+  const apiKey = resolveApiKey(options, env);
+  if (!apiKey) {
+    return { exitCode: 1, error: "Missing API key. Set SUPERSENDTX_API_KEY or pass --api-key." };
+  }
+  const url = readFlag2(args, "--url");
+  if (!url) {
+    return { exitCode: 1, error: "Required flag: --url" };
+  }
+  try {
+    const client = await createWebhooksClient(apiKey, options.baseUrl);
+    const result = await client.webhooks.create({ url });
+    console.log(JSON.stringify(result));
+    return { exitCode: 0 };
+  } catch (error) {
+    return { exitCode: 1, error: error instanceof Error ? error.message : String(error) };
+  }
+}
+
+// src/commands/webhooks/delete.ts
+async function runDeleteCommand(args, env = process.env) {
+  const options = parseWebhooksCommonArgs(args);
+  const apiKey = resolveApiKey(options, env);
+  if (!apiKey) {
+    return { exitCode: 1, error: "Missing API key. Set SUPERSENDTX_API_KEY or pass --api-key." };
+  }
+  const id = readFlag2(args, "--id");
+  if (!id) {
+    return { exitCode: 1, error: "Required flag: --id" };
+  }
+  try {
+    const client = await createWebhooksClient(apiKey, options.baseUrl);
+    const result = await client.webhooks.delete(id);
+    console.log(JSON.stringify(result));
+    return { exitCode: 0 };
+  } catch (error) {
+    return { exitCode: 1, error: error instanceof Error ? error.message : String(error) };
+  }
+}
+
+// src/commands/webhooks/list.ts
+async function runListCommand(args, env = process.env) {
+  const options = parseWebhooksCommonArgs(args);
+  const apiKey = resolveApiKey(options, env);
+  if (!apiKey) {
+    return { exitCode: 1, error: "Missing API key. Set SUPERSENDTX_API_KEY or pass --api-key." };
+  }
+  try {
+    const client = await createWebhooksClient(apiKey, options.baseUrl);
+    const result = await client.webhooks.list();
+    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:");
+  console.error('  supersendtx emails send --from you@domain.com --to user@example.com --subject "Hello" --html "<p>Hi</p>"');
+  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("");
+  console.error("Environment: SUPERSENDTX_API_KEY=stx_\u2026");
+}
+async function main() {
+  const [, , command, subcommand, ...rest] = process.argv;
+  if (command === "emails" && subcommand === "send") {
+    const result = await runSendCommandWithClient(rest);
+    process.exit(result.exitCode);
+  }
+  if (command === "webhooks") {
+    if (subcommand === "list") {
+      const result = await runListCommand(rest);
+      if (result.error) console.error(result.error);
+      process.exit(result.exitCode);
+    }
+    if (subcommand === "create") {
+      const result = await runCreateCommand(rest);
+      if (result.error) console.error(result.error);
+      process.exit(result.exitCode);
+    }
+    if (subcommand === "delete") {
+      const result = await runDeleteCommand(rest);
+      if (result.error) console.error(result.error);
+      process.exit(result.exitCode);
+    }
+  }
+  printUsage();
+  process.exit(1);
+}
+main().catch((error) => {
+  console.error(error instanceof Error ? error.message : String(error));
+  process.exit(1);
+});

package/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "supersendtx-cli",
+  "version": "0.1.0",
+  "description": "SuperSend TX CLI — send transactional email from the terminal",
+  "license": "MIT",
+  "type": "module",
+  "bin": {
+    "supersendtx": "dist/cli.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Super-Send/superTX-app.git",
+    "directory": "packages/supersendtx-cli"
+  },
+  "homepage": "https://supersendtx.com",
+  "bugs": {
+    "url": "https://github.com/Super-Send/superTX-app/issues"
+  },
+  "keywords": [
+    "email",
+    "cli",
+    "transactional",
+    "supersend",
+    "supersendtx"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "scripts": {
+    "build": "tsup",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "supersendtx": "^0.1.0"
+  },
+  "devDependencies": {
+    "tsup": "^8.5.0",
+    "typescript": "^5",
+    "vitest": "^3.2.4"
+  }
+}