npm - @ascendkit/cli - Versions diffs - 0.3.1 → 0.3.8 - Mend

@ascendkit/cli 0.3.1 → 0.3.8

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (8) hide show

package/dist/cli.js +339 -52
package/dist/commands/content.d.ts +2 -0
package/dist/commands/email.d.ts +4 -0
package/dist/commands/email.js +3 -0
package/dist/tools/email.js +7 -0
package/dist/utils/journey-format.d.ts +10 -3
package/dist/utils/journey-format.js +13 -8
package/package.json +1 -1

package/dist/cli.js CHANGED Viewed

@@ -20,6 +20,7 @@ import { redactArgs } from "./utils/redaction.js";
 import { captureTelemetry } from "./utils/telemetry.js";
 import { hostname as osHostname, platform as osPlatform } from "node:os";
 import { formatJourneyAnalytics, formatJourneyWithGuidance, formatNodeList, formatSingleNode, formatSingleTransition, formatTransitionList, } from "./utils/journey-format.js";
+import { formatDistributionResult, formatQuestionList, formatSingleQuestion, } from "./utils/survey-format.js";
 const require = createRequire(import.meta.url);
 const { version: CLI_VERSION } = require("../package.json");
 const HELP = `ascendkit v${CLI_VERSION} - AscendKit CLI
@@ -68,10 +69,10 @@ Commands:
     template: `Usage: ascendkit template <command>
 Commands:
-  template create --name <name> --subject <subject> --body-html <html> --body-text <text> [--slug <slug>] [--description <description>]
+  template create --name <name> --subject <subject> --body-html <html> --body-text <text> [--slug <slug>] [--description <description>] [--category <marketing|transactional>]
   template list [--query <search>] [--system true|--custom true]
   template show <template-id>
-  template update <template-id> [--subject <subject>] [--body-html <html>] [--body-text <text>] [--change-note <note>]
+  template update <template-id> [--subject <subject>] [--body-html <html>] [--body-text <text>] [--change-note <note>] [--category <marketing|transactional>]
   template remove <template-id>
   template version list <template-id>
   template version show <template-id> <n>`,
@@ -102,16 +103,16 @@ Commands:
   journey update <journey-id> [--name <name>] [--nodes <json>] [--transitions <json>] [--description <description>] [--entry-event <event>] [--entry-node <node>] [--entry-conditions <json>] [--re-entry-policy <skip|restart>]
   journey remove <journey-id>
   journey activate <journey-id>
-  journey pause <journey-id>
+  journey pause <journey-id> [--yes]
   journey resume <journey-id>
   journey archive <journey-id>
   journey analytics <journey-id>
   journey node list <journey-id>
-  journey node add <journey-id> --name <node-name> [--action <json>] [--email-id <email>] [--terminal <true|false>]
+  journey node add <journey-id> --name <node-name> [--action <json>] [--email-id <email>] [--terminal <true|false>] [--quiet]
   journey node update <journey-id> <node-name> [--action <json>] [--email-id <email>] [--terminal <true|false>]
   journey node remove <journey-id> <node-name>
   journey transition list <journey-id> [--from <node-name>] [--to <node-name>]
-  journey transition add <journey-id> --from <node-name> --to <node-name> --trigger <json> [--priority <n>] [--name <transition-name>]
+  journey transition add <journey-id> --from <node-name> --to <node-name> --trigger <json> [--priority <n>] [--name <transition-name>] [--quiet]
   journey transition update <journey-id> <transition-name> [--trigger <json>] [--priority <n>]
   journey transition remove <journey-id> <transition-name>`,
     "email-identity": `Usage: ascendkit email-identity <command>
@@ -123,6 +124,7 @@ Commands:
   email-identity remove-domain
   email-identity list
   email-identity add <email> [--display-name <name>]
+  email-identity update <email> --display-name <name>
   email-identity resend <email>
   email-identity set-default <email> [--display-name <name>]
   email-identity remove <email>
@@ -291,6 +293,8 @@ function printTemplateSummary(data, opts) {
     console.log(`Template: ${data.name} (${data.id})`);
     if (data.slug)
         console.log(`Slug: ${data.slug}`);
+    if (data.category)
+        console.log(`Category: ${data.category}`);
     console.log(`Subject: ${data.subject ?? "-"}`);
     if (data.currentVersion != null)
         console.log(`Version: ${data.currentVersion}`);
@@ -338,6 +342,65 @@ function printSurveySummary(data) {
     if (questions != null)
         console.log(`Questions: ${questions}`);
 }
+function printEnvironmentSummary(data) {
+    console.log(`${data.name} (${data.id})`);
+    console.log(`Tier: ${data.tier}`);
+    if (data.description)
+        console.log(`Description: ${data.description}`);
+    console.log(`Public key: ${data.publicKey}`);
+    if (data.secretKey) {
+        const masked = data.secretKey.slice(0, 10) + "****";
+        console.log(`Secret key: ${masked}`);
+    }
+    const vars = data.variables && typeof data.variables === "object" ? Object.entries(data.variables) : [];
+    if (vars.length > 0) {
+        console.log(`Variables:`);
+        for (const [k, v] of vars)
+            console.log(`  ${k}=${v}`);
+    }
+}
+function printPromotionSummary(result) {
+    const src = result.source ?? {};
+    const tgt = result.target ?? {};
+    console.log(`Promoted ${src.tier} → ${tgt.tier} (${tgt.envId})`);
+    console.log("");
+    const changes = result.changes ?? {};
+    const rows = [];
+    for (const [key, val] of Object.entries(changes)) {
+        const label = key.padEnd(14);
+        if (val.action === "unchanged") {
+            rows.push([label, "unchanged"]);
+        }
+        else if (val.action === "skip") {
+            rows.push([label, `skipped — ${val.reason}`]);
+        }
+        else if (val.action === "update" || val.action === "add_only") {
+            const fields = Array.isArray(val.fields) && val.fields.length ? ` (${val.fields.join(", ")})` : "";
+            rows.push([label, `updated${fields}`]);
+        }
+        else if (val.items) {
+            const counts = Object.entries(val.counts ?? {}).map(([k, v]) => `${v} ${k}`).join(", ");
+            rows.push([label, counts || "unchanged"]);
+        }
+        else {
+            rows.push([label, val.action ?? "—"]);
+        }
+    }
+    for (const [label, status] of rows) {
+        console.log(`  ${label} ${status}`);
+    }
+    // Only show warnings not already conveyed by a skipped row in the table
+    const skippedKeys = new Set(Object.entries(changes)
+        .filter(([, v]) => v.action === "skip")
+        .map(([k]) => k.toUpperCase()));
+    const warnings = (Array.isArray(result.warnings) ? result.warnings : [])
+        .filter((w) => !skippedKeys.size || !Array.from(skippedKeys).some(k => w.code?.toUpperCase().includes(k)));
+    if (warnings.length > 0) {
+        console.log("");
+        for (const w of warnings)
+            console.log(`⚠ ${w.message}`);
+    }
+}
 function printProjectSummary(data) {
     console.log(`Project: ${data.id}`);
     console.log(`Name: ${data.name}`);
@@ -348,6 +411,92 @@ function printProjectSummary(data) {
         console.log(`Environment: ${data.environment.publicKey}`);
     }
 }
+function printCampaignSummary(data) {
+    console.log(`Campaign: ${data.name} (${data.id})`);
+    if (data.templateName)
+        console.log(`Template: ${data.templateName}`);
+    console.log(`Status: ${data.status} | Recipients: ${data.totalRecipients ?? 0}`);
+    if (data.audienceSummary)
+        console.log(`Audience: ${data.audienceSummary}`);
+    if (data.scheduledAt)
+        console.log(`Scheduled: ${data.scheduledAt}`);
+    if (data.sentAt)
+        console.log(`Sent: ${data.sentAt}`);
+    if (data.fromIdentityEmail)
+        console.log(`From: ${data.fromIdentityEmail}`);
+}
+function printCampaignAnalytics(data) {
+    const sent = data.sent ?? 0;
+    const opened = data.opened ?? 0;
+    const clicked = data.clicked ?? 0;
+    const bounced = data.bounced ?? 0;
+    const rates = data.rates ?? {};
+    const fmtRate = (r) => r != null ? ` (${Math.round(r * 100)}%)` : "";
+    console.log(`Sent: ${sent} | Opened: ${opened}${fmtRate(rates.openRate)} | Clicked: ${clicked}${fmtRate(rates.clickRate)} | Bounced: ${bounced}`);
+}
+function printAudiencePreview(data) {
+    const count = data.count ?? data.total ?? 0;
+    console.log(`Matched ${count} recipient(s)`);
+}
+function printWebhookSummary(data, opts) {
+    console.log(`Webhook: ${data.id}`);
+    const events = Array.isArray(data.events) && data.events.length > 0 ? data.events.join(", ") : "all";
+    console.log(`URL: ${data.url} | Status: ${data.status}`);
+    console.log(`Events: ${events}`);
+    if (opts?.showSecret && data.secret) {
+        console.log(`Secret: ${data.secret} (save this — it won't be shown again)`);
+    }
+}
+function printWebhookTestResult(data) {
+    if (data.success) {
+        console.log(`✓ Delivered: HTTP ${data.statusCode}`);
+    }
+    else if (data.statusCode) {
+        console.log(`✗ Failed: HTTP ${data.statusCode}`);
+    }
+    else {
+        console.log(`✗ Failed`);
+    }
+    if (data.error)
+        console.log(data.error);
+}
+function printTemplateVersionSummary(data) {
+    const note = data.changeNote || "no note";
+    console.log(`Version ${data.versionNumber} — ${note}`);
+    console.log(`Subject: ${data.subject ?? "—"}`);
+    if (Array.isArray(data.variables) && data.variables.length > 0) {
+        console.log(`Variables: ${data.variables.join(", ")}`);
+    }
+    if (data.createdAt) {
+        console.log(`Created: ${data.createdAt}`);
+    }
+    if (data.bodyHtml) {
+        console.log(`\n--- HTML Body ---\n${data.bodyHtml}`);
+    }
+    if (data.bodyText) {
+        console.log(`\n--- Plain Text Body ---\n${data.bodyText}`);
+    }
+}
+function printSurveyAnalytics(data) {
+    const funnel = data.funnel ?? {};
+    const invited = funnel.sent ?? data.totalInvited ?? 0;
+    const responded = funnel.submitted ?? data.totalResponded ?? 0;
+    const rate = funnel.completionRate ?? data.completionRate ?? 0;
+    console.log(`Responses: ${responded}/${invited} (${rate}%)`);
+    if (data.npsScore != null)
+        console.log(`NPS: ${data.npsScore}`);
+    if (data.csatAverage != null)
+        console.log(`CSAT: ${data.csatAverage}`);
+}
+function printSurveyInvitations(data) {
+    const rows = Array.isArray(data) ? data : [];
+    table(rows, [
+        { key: "id", label: "ID", width: 20 },
+        { key: "userId", label: "User", width: 20 },
+        { key: "status", label: "Status", width: 12 },
+        { key: "sentAt", label: "Sent At", width: 22 },
+    ]);
+}
 function normalizeJourneyRows(data) {
     if (Array.isArray(data)) {
         return data;
@@ -383,6 +532,16 @@ function table(rows, columns) {
         console.log(line);
     }
 }
+function normalizeTemplateCategoryFlag(value) {
+    if (value === undefined)
+        return undefined;
+    if (typeof value != "string")
+        return undefined;
+    const normalized = value.trim().toLowerCase();
+    if (normalized === "marketing" || normalized === "transactional")
+        return normalized;
+    return undefined;
+}
 async function run() {
     installGlobalHandlers();
     const args = process.argv.slice(2);
@@ -447,6 +606,14 @@ async function run() {
         }
         return;
     }
+    // --help anywhere after the action (e.g. ascendkit template update <id> --help)
+    if (args.slice(2).some(a => a === "--help" || a === "-h")) {
+        if (!printSectionHelp(domain)) {
+            console.error(`Unknown command section: ${domain}`);
+            return await exitCli(1);
+        }
+        return;
+    }
     // Platform commands (don't need environment key)
     switch (domain) {
         case "init": {
@@ -756,7 +923,7 @@ async function runEnvironment(action, rest) {
     }
     switch (action) {
         case "show":
-            output(await platform.getEnvironment(ctx.projectId, ctx.environmentId));
+            printEnvironmentSummary(await platform.getEnvironment(ctx.projectId, ctx.environmentId));
             return;
         case "promote": {
             const envId = rest[0] && !rest[0].startsWith("--") ? rest[0] : ctx.environmentId;
@@ -767,8 +934,7 @@ async function runEnvironment(action, rest) {
             }
             try {
                 const result = await platform.promoteEnvironment(envId, target);
-                console.log("Promotion successful:");
-                console.log(JSON.stringify(result, null, 2));
+                printPromotionSummary(result);
             }
             catch (err) {
                 let message = err instanceof Error ? err.message : String(err);
@@ -799,7 +965,7 @@ async function runEnvironment(action, rest) {
             try {
                 const result = await platform.updateEnvironment(ctx.projectId, envId, name, description);
                 console.log("Environment updated:");
-                console.log(JSON.stringify(result, null, 2));
+                printEnvironmentSummary(result);
             }
             catch (err) {
                 let message = err instanceof Error ? err.message : String(err);
@@ -1029,6 +1195,16 @@ async function runAuth(client, action, rest) {
 }
 async function runContent(client, action, rest) {
     const flags = parseFlags(rest);
+    // Accept --html/--text as aliases for --body-html/--body-text
+    if (!flags["body-html"] && flags.html)
+        flags["body-html"] = flags.html;
+    if (!flags["body-text"] && flags.text)
+        flags["body-text"] = flags.text;
+    const category = normalizeTemplateCategoryFlag(flags.category);
+    if (flags.category && !category) {
+        console.error("Invalid --category. Use marketing or transactional.");
+        return await exitCli(1);
+    }
     if (!action) {
         console.log(HELP_SECTION.template);
         return;
@@ -1039,13 +1215,14 @@ async function runContent(client, action, rest) {
     switch (normalizedAction) {
         case "create":
             if (!flags.name || !flags.subject || !flags["body-html"] || !flags["body-text"]) {
-                console.error("Usage: ascendkit template create --name <n> --subject <s> --body-html <h> --body-text <t> [--slug <slug>] [--description <desc>]");
+                console.error("Usage: ascendkit template create --name <n> --subject <s> --body-html <h> --body-text <t> [--slug <slug>] [--description <desc>] [--category <marketing|transactional>]");
                 return await exitCli(1);
             }
             printTemplateSummary(await content.createTemplate(client, {
                 name: flags.name, subject: flags.subject,
                 bodyHtml: flags["body-html"], bodyText: flags["body-text"],
                 slug: flags.slug, description: flags.description,
+                category,
             }));
             break;
         case "list": {
@@ -1061,6 +1238,7 @@ async function runContent(client, action, rest) {
                 { key: "id", label: "ID" },
                 { key: "name", label: "Name", width: 30 },
                 { key: "slug", label: "Slug", width: 25 },
+                { key: "category", label: "Category", width: 14 },
                 { key: "subject", label: "Subject", width: 30 },
             ]);
             break;
@@ -1082,6 +1260,7 @@ async function runContent(client, action, rest) {
                 bodyHtml: flags["body-html"],
                 bodyText: flags["body-text"],
                 changeNote: flags["change-note"],
+                category,
             }));
             break;
         case "remove":
@@ -1114,7 +1293,7 @@ async function runContent(client, action, rest) {
                     console.error("Usage: ascendkit template version show <template-id> <n>");
                     return await exitCli(1);
                 }
-                output(await content.getVersion(client, templateId, parseInt(versionNumber, 10)));
+                printTemplateVersionSummary(await content.getVersion(client, templateId, parseInt(versionNumber, 10)));
             }
             break;
         default:
@@ -1182,7 +1361,7 @@ async function runSurvey(client, action, rest) {
                 console.error("Usage: ascendkit survey distribute <survey-id> --users <usr_id1,usr_id2,...>");
                 return await exitCli(1);
             }
-            output(await surveys.distributeSurvey(client, rest[0], flags.users.split(",")));
+            console.log(formatDistributionResult(await surveys.distributeSurvey(client, rest[0], flags.users.split(","))));
             break;
         case "invitations":
         case "invitation":
@@ -1192,7 +1371,7 @@ async function runSurvey(client, action, rest) {
                     console.error("Usage: ascendkit survey invitation list <survey-id>");
                     return await exitCli(1);
                 }
-                output(await surveys.listInvitations(client, surveyId));
+                printSurveyInvitations(await surveys.listInvitations(client, surveyId));
             }
             else {
                 console.error(`Unknown survey invitation command: ${rest[0]}`);
@@ -1204,7 +1383,7 @@ async function runSurvey(client, action, rest) {
                 console.error("Usage: ascendkit survey analytics <survey-id>");
                 return await exitCli(1);
             }
-            output(await surveys.getAnalytics(client, rest[0]));
+            printSurveyAnalytics(await surveys.getAnalytics(client, rest[0]));
             break;
         case "export-definition":
         case "import-definition":
@@ -1269,7 +1448,7 @@ async function runSurvey(client, action, rest) {
                 return await exitCli(1);
             }
             if (questionAction === "list") {
-                output(await surveys.listQuestions(client, surveyId));
+                console.log(formatQuestionList(await surveys.listQuestions(client, surveyId)));
             }
             else if (questionAction === "add") {
                 if (!flags.type || !flags.title) {
@@ -1285,13 +1464,17 @@ async function runSurvey(client, action, rest) {
                     params.choices = flags.choices.split(",");
                 if (flags.position != null)
                     params.position = Number(flags.position);
-                output(await surveys.addQuestion(client, surveyId, params));
+                console.log(formatSingleQuestion(await surveys.addQuestion(client, surveyId, params), "Added"));
             }
             else if (questionAction === "update") {
                 if (!questionName) {
                     console.error("Usage: ascendkit survey question update <survey-id> <question-name> [--title <title>] [--required <true|false>] [--choices <c1,c2,...>]");
                     return await exitCli(1);
                 }
+                if (flags.type) {
+                    console.error("Error: question type cannot be changed on an existing question. Remove and re-add it to change the type.");
+                    return await exitCli(1);
+                }
                 const params = {};
                 if (flags.title)
                     params.title = flags.title;
@@ -1299,21 +1482,23 @@ async function runSurvey(client, action, rest) {
                     params.isRequired = flags.required === "true";
                 if (flags.choices)
                     params.choices = flags.choices.split(",");
-                output(await surveys.editQuestion(client, surveyId, questionName, params));
+                console.log(formatSingleQuestion(await surveys.editQuestion(client, surveyId, questionName, params), "Updated"));
             }
             else if (questionAction === "remove") {
                 if (!questionName) {
                     console.error("Usage: ascendkit survey question remove <survey-id> <question-name>");
                     return await exitCli(1);
                 }
-                output(await surveys.removeQuestion(client, surveyId, questionName));
+                await surveys.removeQuestion(client, surveyId, questionName);
+                console.log("Question removed.");
             }
             else if (questionAction === "reorder") {
                 if (!flags.order) {
                     console.error("Usage: ascendkit survey question reorder <survey-id> --order <name1,name2,...>");
                     return await exitCli(1);
                 }
-                output(await surveys.reorderQuestions(client, surveyId, flags.order.split(",")));
+                await surveys.reorderQuestions(client, surveyId, flags.order.split(","));
+                console.log("Questions reordered.");
             }
             else {
                 console.error(`Unknown survey question command: ${questionAction}`);
@@ -1507,13 +1692,36 @@ async function runJourney(client, action, rest) {
             }
             console.log(formatJourneyWithGuidance(await journeys.activateJourney(client, rest[0])));
             break;
-        case "pause":
+        case "pause": {
             if (!rest[0]) {
-                console.error("Usage: ascendkit journey pause <journey-id>");
+                console.error("Usage: ascendkit journey pause <journey-id> [--yes]");
                 return await exitCli(1);
             }
+            const journeyForPause = await journeys.getJourney(client, rest[0]);
+            const activeUsers = journeyForPause?.stats?.currentlyActive ?? 0;
+            if (activeUsers > 0 && !flags.yes) {
+                if (process.stdin.isTTY && process.stdout.isTTY) {
+                    const { createInterface } = await import("node:readline/promises");
+                    const rl = createInterface({ input: process.stdin, output: process.stdout });
+                    try {
+                        const answer = (await rl.question(`${activeUsers} user(s) are currently active in this journey. Actions will be queued while paused. Proceed? [y/N] `)).trim().toLowerCase();
+                        if (answer !== "y" && answer !== "yes") {
+                            console.log("Cancelled.");
+                            return;
+                        }
+                    }
+                    finally {
+                        rl.close();
+                    }
+                }
+                else {
+                    console.error(`Warning: ${activeUsers} user(s) are currently active. Pass --yes to skip confirmation.`);
+                    return await exitCli(1);
+                }
+            }
             console.log(formatJourneyWithGuidance(await journeys.pauseJourney(client, rest[0])));
             break;
+        }
         case "resume":
             if (!rest[0]) {
                 console.error("Usage: ascendkit journey resume <journey-id>");
@@ -1559,7 +1767,7 @@ async function runJourney(client, action, rest) {
             }
             if (flags.terminal)
                 params.terminal = flags.terminal === "true";
-            console.log(formatSingleNode(await journeys.addNode(client, rest[0], params), "Added", flags.name));
+            console.log(formatSingleNode(await journeys.addNode(client, rest[0], params), "Added", flags.name, { suppressWarnings: !!flags.quiet }));
             break;
         }
         case "edit-node": {
@@ -1634,7 +1842,7 @@ async function runJourney(client, action, rest) {
             if (flags.name)
                 params.name = flags.name;
             const transitionName = flags.name || `${flags.from}-to-${flags.to}`;
-            console.log(formatSingleTransition(await journeys.addTransition(client, rest[0], params), "Added", transitionName));
+            console.log(formatSingleTransition(await journeys.addTransition(client, rest[0], params), "Added", transitionName, { suppressWarnings: !!flags.quiet }));
             break;
         }
         case "edit-transition": {
@@ -1677,10 +1885,10 @@ async function runWebhook(client, action, rest) {
                 console.error("Usage: ascendkit webhook create --url <url> [--events <e1,e2,...>]");
                 return await exitCli(1);
             }
-            output(await webhooks.createWebhook(client, {
+            printWebhookSummary(await webhooks.createWebhook(client, {
                 url: flags.url,
                 events: flags.events ? flags.events.split(",") : undefined,
-            }));
+            }), { showSecret: true });
             break;
         case "list":
             table(await webhooks.listWebhooks(client), [
@@ -1695,7 +1903,7 @@ async function runWebhook(client, action, rest) {
                 console.error("Usage: ascendkit webhook get <webhook-id>");
                 return await exitCli(1);
             }
-            output(await webhooks.getWebhook(client, rest[0]));
+            printWebhookSummary(await webhooks.getWebhook(client, rest[0]));
             break;
         case "update": {
             if (!rest[0]) {
@@ -1718,14 +1926,15 @@ async function runWebhook(client, action, rest) {
                 console.error("Usage: ascendkit webhook delete <webhook-id>");
                 return await exitCli(1);
             }
-            output(await webhooks.deleteWebhook(client, rest[0]));
+            await webhooks.deleteWebhook(client, rest[0]);
+            console.log("Webhook deleted.");
             break;
         case "test":
             if (!rest[0]) {
                 console.error("Usage: ascendkit webhook test <webhook-id> [--event <event-type>]");
                 return await exitCli(1);
             }
-            output(await webhooks.testWebhook(client, rest[0], flags.event));
+            printWebhookTestResult(await webhooks.testWebhook(client, rest[0], flags.event));
             break;
         default:
             console.error(`Unknown webhook command: ${action}`);
@@ -1753,7 +1962,7 @@ async function runCampaign(client, action, rest) {
                 console.error("Invalid JSON for --audience flag. Provide a valid JSON object.");
                 return await exitCli(1);
             }
-            output(await campaigns.createCampaign(client, {
+            printCampaignSummary(await campaigns.createCampaign(client, {
                 name: flags.name,
                 templateId: flags.template,
                 audienceFilter: createFilter,
@@ -1778,7 +1987,7 @@ async function runCampaign(client, action, rest) {
                 console.error("Usage: ascendkit campaign show <campaign-id>");
                 return await exitCli(1);
             }
-            output(await campaigns.getCampaign(client, rest[0]));
+            printCampaignSummary(await campaigns.getCampaign(client, rest[0]));
             break;
         case "update": {
             if (!rest[0]) {
@@ -1795,7 +2004,7 @@ async function runCampaign(client, action, rest) {
                     return await exitCli(1);
                 }
             }
-            output(await campaigns.updateCampaign(client, rest[0], {
+            printCampaignSummary(await campaigns.updateCampaign(client, rest[0], {
                 name: flags.name,
                 templateId: flags.template,
                 audienceFilter: updateFilter,
@@ -1813,7 +2022,7 @@ async function runCampaign(client, action, rest) {
                 console.error("Campaign has no audience filter set.");
                 return await exitCli(1);
             }
-            output(await campaigns.previewAudience(client, detail.audienceFilter));
+            printAudiencePreview(await campaigns.previewAudience(client, detail.audienceFilter));
             break;
         }
         case "schedule":
@@ -1821,21 +2030,22 @@ async function runCampaign(client, action, rest) {
                 console.error("Usage: ascendkit campaign schedule <campaign-id> --at <datetime>");
                 return await exitCli(1);
             }
-            output(await campaigns.updateCampaign(client, rest[0], { scheduledAt: flags.at }));
+            printCampaignSummary(await campaigns.updateCampaign(client, rest[0], { scheduledAt: flags.at }));
             break;
         case "cancel":
             if (!rest[0]) {
                 console.error("Usage: ascendkit campaign cancel <campaign-id>");
                 return await exitCli(1);
             }
-            output(await campaigns.deleteCampaign(client, rest[0]));
+            await campaigns.deleteCampaign(client, rest[0]);
+            console.log("Campaign cancelled.");
             break;
         case "analytics":
             if (!rest[0]) {
                 console.error("Usage: ascendkit campaign analytics <campaign-id>");
                 return await exitCli(1);
             }
-            output(await campaigns.getCampaignAnalytics(client, rest[0]));
+            printCampaignAnalytics(await campaigns.getCampaignAnalytics(client, rest[0]));
             break;
         default:
             console.error(`Unknown campaign command: ${action}`);
@@ -1895,7 +2105,8 @@ async function runEmail(client, action, rest) {
             break;
         }
         case "remove-domain":
-            output(await email.removeDomain(client));
+            await email.removeDomain(client);
+            console.log("Domain removed.");
             break;
         case "list": {
             const result = await email.listIdentities(client);
@@ -1908,10 +2119,25 @@ async function runEmail(client, action, rest) {
                 console.error("Usage: ascendkit email-identity add <email> [--display-name <name>]");
                 return await exitCli(1);
             }
-            output(await email.createIdentity(client, {
+            const added = await email.createIdentity(client, {
                 email: identityEmail,
                 displayName: flags["display-name"],
-            }));
+            });
+            printEmailIdentities(added.identities ?? []);
+            console.log("Verification email sent.");
+            break;
+        }
+        case "update": {
+            const identityEmail = rest[0];
+            if (!identityEmail || !flags["display-name"]) {
+                console.error("Usage: ascendkit email-identity update <email> --display-name <name>");
+                return await exitCli(1);
+            }
+            const updated = await email.updateIdentity(client, {
+                email: identityEmail,
+                displayName: flags["display-name"],
+            });
+            printEmailIdentities(updated.identities ?? []);
             break;
         }
         case "resend": {
@@ -1920,7 +2146,8 @@ async function runEmail(client, action, rest) {
                 console.error("Usage: ascendkit email-identity resend <email>");
                 return await exitCli(1);
             }
-            output(await email.resendIdentityVerification(client, identityEmail));
+            await email.resendIdentityVerification(client, identityEmail);
+            console.log(`Verification email sent to ${identityEmail}.`);
             break;
         }
         case "set-default": {
@@ -1929,10 +2156,11 @@ async function runEmail(client, action, rest) {
                 console.error("Usage: ascendkit email-identity set-default <email> [--display-name <name>]");
                 return await exitCli(1);
             }
-            output(await email.setDefaultIdentity(client, {
+            const updated = await email.setDefaultIdentity(client, {
                 email: identityEmail,
                 displayName: flags["display-name"],
-            }));
+            });
+            printEmailIdentities(updated.identities ?? []);
             break;
         }
         case "remove":
@@ -1942,7 +2170,9 @@ async function runEmail(client, action, rest) {
                 console.error("Usage: ascendkit email-identity remove <email>");
                 return await exitCli(1);
             }
-            output(await email.removeIdentity(client, identityEmail));
+            const remaining = await email.removeIdentity(client, identityEmail);
+            console.log("Identity removed.");
+            printEmailIdentities(remaining.identities ?? []);
             break;
         }
         case "test": {
@@ -1951,10 +2181,11 @@ async function runEmail(client, action, rest) {
                 console.error("Usage: ascendkit email-identity test <email> --to <recipient>");
                 return await exitCli(1);
             }
-            output(await email.sendTestEmail(client, {
+            const testResult = await email.sendTestEmail(client, {
                 to: flags.to,
                 fromIdentityEmail: identityEmail,
-            }));
+            });
+            console.log(testResult.message ?? "Test email sent.");
             break;
         }
         default:
@@ -1967,12 +2198,12 @@ run().catch((err) => {
     exitCli(1, err instanceof Error ? err : new Error(String(err)));
 });
 async function printEmailSetup(settings) {
-    output(settings);
     if (!settings.domain)
         return;
     const provider = settings.dnsProvider;
+    console.log(`Domain: ${settings.domain}`);
     if (provider?.name) {
-        console.log(`\nDetected DNS provider: ${provider.name} (${provider.confidence ?? "unknown"})`);
+        console.log(`DNS provider: ${provider.name} (${provider.confidence ?? "unknown"})`);
     }
     if (provider?.portalUrl) {
         console.log(`Provider console: ${provider.portalUrl}`);
@@ -1980,10 +2211,54 @@ async function printEmailSetup(settings) {
     if (provider?.assistantSetupUrl) {
         console.log(`Guided setup: ${provider.assistantSetupUrl}`);
     }
-    if (Array.isArray(settings.dnsRecords) && settings.dnsRecords.length > 0) {
-        console.log("\nAdd these DNS records:");
-        for (const rec of settings.dnsRecords) {
-            console.log(`  ${rec.type}\t${rec.name}\t${rec.value}`);
+    const records = Array.isArray(settings.dnsRecords) ? settings.dnsRecords : [];
+    if (records.length > 0) {
+        console.log("\nDNS records to add:");
+        for (const rec of records) {
+            console.log(`  ${rec.type.padEnd(6)} ${rec.name}  ${rec.value}`);
+        }
+        if (process.stdin.isTTY && process.stdout.isTTY) {
+            const defaultFile = `dns-records-${settings.domain}.txt`;
+            const { createInterface } = await import("node:readline/promises");
+            const rl = createInterface({ input: process.stdin, output: process.stdout });
+            try {
+                const answer = (await rl.question(`\nSave records to file [${defaultFile}]: `)).trim();
+                const filename = answer || defaultFile;
+                const { existsSync, writeFileSync } = await import("node:fs");
+                if (existsSync(filename)) {
+                    const overwrite = (await rl.question(`${filename} already exists. Overwrite? [y/N] `)).trim().toLowerCase();
+                    if (overwrite !== "y" && overwrite !== "yes") {
+                        console.log("Skipped.");
+                        return;
+                    }
+                }
+                const lines = [
+                    `; DNS records for ${settings.domain}`,
+                    `; Generated by AscendKit CLI`,
+                    "",
+                    ...records.map(rec => {
+                        let value;
+                        if (rec.type === "TXT") {
+                            value = `"${rec.value}"`;
+                        }
+                        else if (rec.type === "CNAME" || rec.type === "MX") {
+                            // Ensure absolute FQDN with trailing dot to prevent zone-relative expansion
+                            const target = rec.type === "MX" ? rec.value.replace(/^(\d+)\s+/, "$1 ") : rec.value;
+                            value = target.endsWith(".") ? target : `${target}.`;
+                        }
+                        else {
+                            value = rec.value;
+                        }
+                        const name = rec.name.endsWith(".") ? rec.name : `${rec.name}.`;
+                        return `${name}\t3600\tIN\t${rec.type}\t${value} ; cf_tags=cf-proxied:false`;
+                    }),
+                ];
+                writeFileSync(filename, lines.join("\n") + "\n");
+                console.log(`Saved to ${filename}`);
+            }
+            finally {
+                rl.close();
+            }
         }
     }
 }
@@ -2015,8 +2290,20 @@ function printEmailStatusSummary(settings, domainStatus, dnsCheck, identities) {
         return;
     }
     console.log(`Domain:        ${settings.domain} (${domainStatus.status || settings.verificationStatus || "unknown"})`);
-    if (dnsCheck?.summary) {
-        console.log(`DNS:           ${dnsCheck.summary.found}/${dnsCheck.summary.total} verified`);
+    if (dnsCheck) {
+        const { summary, records } = dnsCheck;
+        if (summary.notFound === 0 && summary.mismatch === 0 && summary.errored === 0) {
+            console.log("DNS:           all records verified");
+        }
+        else {
+            console.log(`DNS:           ${summary.found}/${summary.total} verified`);
+            const pending = records.filter(r => !r.found || r.mismatch);
+            if (pending.length > 0) {
+                console.log("Pending:");
+                for (const r of pending)
+                    console.log(`  ${r.type.padEnd(6)} ${r.name}`);
+            }
+        }
     }
     console.log("");
     printEmailIdentities(identities);

package/dist/commands/content.d.ts CHANGED Viewed

@@ -6,12 +6,14 @@ export interface CreateTemplateParams {
     bodyText: string;
     slug?: string;
     description?: string;
+    category?: "marketing" | "transactional";
 }
 export interface UpdateTemplateParams {
     subject?: string;
     bodyHtml?: string;
     bodyText?: string;
     changeNote?: string;
+    category?: "marketing" | "transactional";
 }
 export declare function createTemplate(client: AscendKitClient, params: CreateTemplateParams): Promise<unknown>;
 export declare function listTemplates(client: AscendKitClient, params?: {

package/dist/commands/email.d.ts CHANGED Viewed

@@ -80,6 +80,10 @@ export declare function createIdentity(client: AscendKitClient, identity: {
     displayName?: string;
 }): Promise<EmailIdentitiesResponse>;
 export declare function resendIdentityVerification(client: AscendKitClient, email: string): Promise<EmailIdentitiesResponse>;
+export declare function updateIdentity(client: AscendKitClient, identity: {
+    email: string;
+    displayName: string;
+}): Promise<EmailIdentitiesResponse>;
 export declare function setDefaultIdentity(client: AscendKitClient, identity: {
     email: string;
     displayName?: string;

package/dist/commands/email.js CHANGED Viewed

@@ -37,6 +37,9 @@ export async function createIdentity(client, identity) {
 export async function resendIdentityVerification(client, email) {
     return client.managedPost(`/api/email/settings/identities/${encodeURIComponent(email)}/resend`, {});
 }
+export async function updateIdentity(client, identity) {
+    return client.managedPost(`/api/email/settings/identities/${encodeURIComponent(identity.email)}/update`, { displayName: identity.displayName });
+}
 export async function setDefaultIdentity(client, identity) {
     return client.managedPost(`/api/email/settings/identities/${encodeURIComponent(identity.email)}/default`, { displayName: identity.displayName ?? "" });
 }

package/dist/tools/email.js CHANGED Viewed

@@ -64,6 +64,13 @@ export function registerEmailTools(server, client) {
         const data = await email.resendIdentityVerification(client, params.email);
         return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
     });
+    server.tool("email_identity_update", "Update the display name of a sender identity", {
+        email: z.string().describe("Sender identity email"),
+        displayName: z.string().describe("New display name"),
+    }, async (params) => {
+        const data = await email.updateIdentity(client, params);
+        return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+    });
     server.tool("email_identity_set_default", "Set the default sender identity for this environment", {
         email: z.string().describe("Sender identity email"),
         displayName: z.string().optional().describe("Optional updated display name"),

package/dist/utils/journey-format.d.ts CHANGED Viewed

@@ -22,6 +22,7 @@ interface JourneyData {
         terminal?: boolean;
     }>;
     transitions?: Array<{
+        name?: string;
         from?: string;
         from_?: string;
         to?: string;
@@ -75,7 +76,9 @@ interface AnalyticsData {
         exited?: number;
     };
 }
-export declare function formatJourneyWithGuidance(journey: JourneyData): string;
+export declare function formatJourneyWithGuidance(journey: JourneyData, opts?: {
+    suppressWarnings?: boolean;
+}): string;
 export declare function formatJourneyList(data: {
     journeys: JourneyData[];
     total: number;
@@ -109,10 +112,14 @@ interface TransitionListItem {
 export declare function formatNodeList(data: {
     nodes: NodeListItem[];
 }): string;
-export declare function formatSingleNode(data: JourneyData, action: string, nodeName: string): string;
+export declare function formatSingleNode(data: JourneyData, action: string, nodeName: string, opts?: {
+    suppressWarnings?: boolean;
+}): string;
 export declare function formatTransitionList(data: {
     transitions: TransitionListItem[];
 }): string;
-export declare function formatSingleTransition(data: JourneyData, action: string, transitionName: string): string;
+export declare function formatSingleTransition(data: JourneyData, action: string, transitionName: string, opts?: {
+    suppressWarnings?: boolean;
+}): string;
 export declare function formatJourneyAnalytics(data: AnalyticsData): string;
 export {};

package/dist/utils/journey-format.js CHANGED Viewed

@@ -14,7 +14,7 @@ function nodeCount(journey) {
 function transitionCount(journey) {
     return (journey.transitions || []).length;
 }
-export function formatJourneyWithGuidance(journey) {
+export function formatJourneyWithGuidance(journey, opts) {
     const nodes = nodeCount(journey);
     const transitions = transitionCount(journey);
     const stats = journey.stats;
@@ -50,11 +50,16 @@ export function formatJourneyWithGuidance(journey) {
             else {
                 desc = trigger?.event || "event";
             }
-            lines.push(`  ${from} → ${t.to} [${desc}]`);
+            const id = t.name ? ` (${t.name})` : "";
+            lines.push(`  ${from} → ${t.to} [${desc}]${id}`);
         }
     }
-    // Warnings
-    if (journey.warnings && journey.warnings.length > 0) {
+    // Warnings — suppressed on paused journeys (mid-construction) or when opts.suppressWarnings is set
+    const showWarnings = !opts?.suppressWarnings &&
+        journey.status !== "paused" &&
+        journey.warnings &&
+        journey.warnings.length > 0;
+    if (showWarnings) {
         lines.push("");
         lines.push("Warnings:");
         for (const w of journey.warnings) {
@@ -146,8 +151,8 @@ export function formatNodeList(data) {
     }
     return lines.join("\n");
 }
-export function formatSingleNode(data, action, nodeName) {
-    return `${action} node '${nodeName}'.\n\n${formatJourneyWithGuidance(data)}`;
+export function formatSingleNode(data, action, nodeName, opts) {
+    return `${action} node '${nodeName}'.\n\n${formatJourneyWithGuidance(data, opts)}`;
 }
 export function formatTransitionList(data) {
     const transitions = data.transitions || [];
@@ -162,8 +167,8 @@ export function formatTransitionList(data) {
     }
     return lines.join("\n");
 }
-export function formatSingleTransition(data, action, transitionName) {
-    return `${action} transition '${transitionName}'.\n\n${formatJourneyWithGuidance(data)}`;
+export function formatSingleTransition(data, action, transitionName, opts) {
+    return `${action} transition '${transitionName}'.\n\n${formatJourneyWithGuidance(data, opts)}`;
 }
 export function formatJourneyAnalytics(data) {
     const { journey, nodes, transitions, terminalDistribution, totals } = data;

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@ascendkit/cli",
-  "version": "0.3.1",
+  "version": "0.3.8",
   "description": "AscendKit CLI and MCP server",
   "author": "ascendkit.dev",
   "license": "MIT",