npm - @ascendkit/cli - Versions diffs - 0.1.10 - Mend

@ascendkit/cli 0.1.10

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 (48) hide show

package/LICENSE +21 -0
package/dist/api/client.d.ts +34 -0
package/dist/api/client.js +155 -0
package/dist/cli.d.ts +2 -0
package/dist/cli.js +1153 -0
package/dist/commands/auth.d.ts +17 -0
package/dist/commands/auth.js +29 -0
package/dist/commands/content.d.ts +25 -0
package/dist/commands/content.js +28 -0
package/dist/commands/email.d.ts +37 -0
package/dist/commands/email.js +39 -0
package/dist/commands/journeys.d.ts +86 -0
package/dist/commands/journeys.js +69 -0
package/dist/commands/platform.d.ts +35 -0
package/dist/commands/platform.js +517 -0
package/dist/commands/surveys.d.ts +51 -0
package/dist/commands/surveys.js +41 -0
package/dist/commands/webhooks.d.ts +16 -0
package/dist/commands/webhooks.js +28 -0
package/dist/index.d.ts +2 -0
package/dist/index.js +29 -0
package/dist/mcp.d.ts +2 -0
package/dist/mcp.js +40 -0
package/dist/tools/auth.d.ts +3 -0
package/dist/tools/auth.js +75 -0
package/dist/tools/content.d.ts +3 -0
package/dist/tools/content.js +64 -0
package/dist/tools/email.d.ts +3 -0
package/dist/tools/email.js +57 -0
package/dist/tools/journeys.d.ts +3 -0
package/dist/tools/journeys.js +302 -0
package/dist/tools/platform.d.ts +3 -0
package/dist/tools/platform.js +63 -0
package/dist/tools/surveys.d.ts +3 -0
package/dist/tools/surveys.js +212 -0
package/dist/tools/webhooks.d.ts +3 -0
package/dist/tools/webhooks.js +56 -0
package/dist/types.d.ts +96 -0
package/dist/types.js +4 -0
package/dist/utils/credentials.d.ts +27 -0
package/dist/utils/credentials.js +90 -0
package/dist/utils/duration.d.ts +16 -0
package/dist/utils/duration.js +47 -0
package/dist/utils/journey-format.d.ts +112 -0
package/dist/utils/journey-format.js +200 -0
package/dist/utils/survey-format.d.ts +60 -0
package/dist/utils/survey-format.js +164 -0
package/package.json +37 -0

package/dist/cli.js ADDED Viewed

@@ -0,0 +1,1153 @@
+#!/usr/bin/env node
+import { readFileSync, writeFileSync } from "fs";
+import { AscendKitClient } from "./api/client.js";
+import { loadAuth, loadEnvContext } from "./utils/credentials.js";
+import * as auth from "./commands/auth.js";
+import * as content from "./commands/content.js";
+import * as surveys from "./commands/surveys.js";
+import * as platform from "./commands/platform.js";
+import * as journeys from "./commands/journeys.js";
+import * as email from "./commands/email.js";
+import { parseDelay } from "./utils/duration.js";
+const HELP = `ascendkit - AscendKit CLI
+Usage: ascendkit <command> [options]
+       ascendkit help [section]
+Platform Commands:
+  init                                   Initialize AscendKit in this directory (login via browser)
+    --backend <url>                        API URL (default: https://api.ascendkit.com)
+    --portal <url>                         Portal URL (default: http://localhost:3000)
+  logout                                 Clear local credentials
+  set-env <public-key>                   Set active environment by public key
+  projects list                          List your projects
+  env list --project <project-id>        List environments for a project
+  env use <tier> --project <project-id>  Set active environment by tier
+Service Commands (require 'ascendkit init' AND 'ascendkit set-env'):
+  auth settings                        Get auth settings
+  auth settings update                 Update auth settings
+    --providers <p1,p2,...>               Comma-separated provider list
+    --email-verification <true|false>    Toggle email verification
+    --waitlist <true|false>              Toggle waitlist
+    --password-reset <true|false>        Toggle password reset
+    --session-duration <duration>        e.g. "7d", "24h"
+  auth providers <p1,p2,...>           Set enabled providers
+  auth oauth <provider>                Open browser to configure OAuth credentials
+  auth oauth set <provider>            Set OAuth credentials from CLI
+    --client-id <id>
+    --client-secret <secret>             (not recommended; appears in shell history)
+    --client-secret-stdin                Read secret from stdin
+    --callback-url <url>                 Auth callback URL for this provider
+  auth users                           List project users
+  content create                       Create a content template
+    --name <name>
+    --subject <subject>
+    --body-html <html>
+    --body-text <text>
+    --slug <slug>                        URL-safe identifier
+    --description <description>          Template description
+  content list                         List all templates
+    --query <search>                     Search by name/slug/description
+    --system true                        Show only system templates
+    --custom true                        Show only custom templates
+  content get <template-id>            Get a template
+  content update <template-id>         Update a template (creates new version)
+    --subject <subject>
+    --body-html <html>
+    --body-text <text>
+    --change-note <note>
+  content delete <template-id>         Delete a template
+  content versions <template-id>       List template versions
+  content version <template-id> <n>    Get specific version
+  survey create                        Create a survey
+    --name <name>
+    --type <nps|csat|custom>
+    --definition <json>
+  survey list                          List all surveys
+  survey get <survey-id>               Get a survey
+  survey update <survey-id>            Update a survey
+    --name <name>
+    --status <draft|active|paused>
+    --definition <json>
+  survey delete <survey-id>            Delete a survey
+  survey distribute <survey-id>        Distribute to users
+    --users <usr_id1,usr_id2,...>
+  survey invitations <survey-id>       List invitations
+  survey analytics <survey-id>         Get analytics
+  survey export-definition <survey-id> Export survey definition JSON
+    --out <file>                         Optional output file path (prints to stdout if omitted)
+  survey import-definition <survey-id> Import survey definition JSON (definition only; slug unchanged)
+    --in <file>                          Input JSON file (accepts raw definition or {definition: ...})
+  journey create                       Create a journey
+    --name <name>
+    --entry-event <event>                e.g. "user.created"
+    --entry-node <node>                  First node name
+    --nodes <json>                       Node definitions (JSON, optional)
+    --transitions <json>                 Transition definitions (JSON)
+    --description <description>
+    --entry-conditions <json>            Filter on entry event payload
+    --re-entry-policy <skip|restart>     Default: skip
+  journey list                         List all journeys
+    --status <draft|active|paused|archived>
+  journey get <journey-id>             Get a journey
+  journey update <journey-id>          Update a journey
+    --name <name>
+    --nodes <json>
+    --transitions <json>
+    --description <description>
+    --entry-event <event>
+    --entry-node <node>
+    --entry-conditions <json>
+    --re-entry-policy <skip|restart>
+  journey delete <journey-id>          Delete a journey
+  journey activate <journey-id>        Activate a draft journey
+  journey pause <journey-id>           Pause an active journey
+  journey archive <journey-id>         Archive a journey (permanent)
+  journey analytics <journey-id>       Get journey analytics
+  journey list-nodes <journey-id>      List nodes with action and transition counts
+  journey add-node <journey-id>        Add a node
+    --name <node-name>
+    --action <json>                      Optional action JSON (default: {"type":"none"})
+    --terminal <true|false>              Optional terminal flag (default: false)
+  journey edit-node <journey-id> <node-name>
+    --action <json>                      Optional action JSON
+    --terminal <true|false>              Optional terminal flag
+  journey remove-node <journey-id> <node-name>
+  journey list-transitions <journey-id>
+    --from <node-name>                   Optional source node filter
+    --to <node-name>                     Optional target node filter
+  journey add-transition <journey-id>
+    --from <node-name>
+    --to <node-name>
+    --trigger <json>                     Trigger JSON, e.g. {"type":"event","event":"user.login"}
+    --priority <n>                       Optional numeric priority
+    --name <transition-name>             Optional transition name
+  journey edit-transition <journey-id> <transition-name>
+    --trigger <json>                     Optional trigger JSON
+    --priority <n>                       Optional numeric priority
+  journey remove-transition <journey-id> <transition-name>
+  email settings                       Get email settings
+  email settings update                Update email settings
+    --from-email <email>                 Sender email address
+    --from-name <name>                   Sender display name
+  email identity                       Show current identity mode and next steps
+  email use-default                    Switch to AscendKit default sender
+  email use-custom <domain>            Switch to customer-owned identity (starts DNS setup)
+    --from-email <email>                 Optional sender after domain setup
+    --from-name <name>                   Optional display name after domain setup
+  email setup-domain <domain>          Start domain verification
+  email domain-status                  Check domain verification status
+    --watch                              Poll until verified/failed
+    --interval <seconds>                 Poll interval for --watch (default: 15)
+  email open-dns                       Show DNS provider URL for current domain
+    --domain <domain>                    Optional override domain
+    --open                               Open URL in browser
+  email remove-domain                  Remove domain and reset to default
+  status                               Show current login and environment state
+  verify                               Check all services in the active environment
+Environment:
+  ASCENDKIT_PUBLIC_KEY    Environment public key (overrides stored credentials)
+  ASCENDKIT_API_URL       API URL (default: https://api.ascendkit.com)
+`;
+const HELP_SECTION = {
+    auth: `Usage: ascendkit auth <command>
+Commands:
+  auth settings
+  auth settings update --providers <p1,p2,...> [--email-verification <true|false>] [--waitlist <true|false>] [--password-reset <true|false>] [--session-duration <duration>]
+  auth providers <p1,p2,...>
+  auth oauth <provider>
+  auth oauth set <provider> --client-id <id> [--client-secret <secret> | --client-secret-stdin] [--callback-url <url>]
+  auth users`,
+    content: `Usage: ascendkit content <command>
+Commands:
+  content create --name <name> --subject <subject> --body-html <html> --body-text <text> [--slug <slug>] [--description <description>]
+  content list [--query <search>] [--system true|--custom true]
+  content get <template-id>
+  content update <template-id> [--subject <subject>] [--body-html <html>] [--body-text <text>] [--change-note <note>]
+  content delete <template-id>
+  content versions <template-id>
+  content version <template-id> <n>`,
+    survey: `Usage: ascendkit survey <command>
+Commands:
+  survey create --name <name> [--type <nps|csat|custom>] [--definition <json>]
+  survey list
+  survey get <survey-id>
+  survey update <survey-id> [--name <name>] [--status <draft|active|paused>] [--definition <json>]
+  survey delete <survey-id>
+  survey distribute <survey-id> --users <usr_id1,usr_id2,...>
+  survey invitations <survey-id>
+  survey analytics <survey-id>
+  survey export-definition <survey-id> [--out <file>]
+  survey import-definition <survey-id> --in <file>
+Notes:
+  - Question-level editing commands are available via MCP tools, not this terminal CLI.
+  - import-definition only updates the survey definition. It does not mutate slug/name/status.`,
+    journey: `Usage: ascendkit journey <command>
+Commands:
+  journey create --name <name> --entry-event <event> --entry-node <node> [--nodes <json>] [--transitions <json>] [--description <description>] [--entry-conditions <json>] [--re-entry-policy <skip|restart>]
+  journey list [--status <draft|active|paused|archived>]
+  journey get <journey-id>
+  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 delete <journey-id>
+  journey activate <journey-id>
+  journey pause <journey-id>
+  journey archive <journey-id>
+  journey analytics <journey-id>
+  journey list-nodes <journey-id>
+  journey add-node <journey-id> --name <node-name> [--action <json>] [--terminal <true|false>]
+  journey edit-node <journey-id> <node-name> [--action <json>] [--terminal <true|false>]
+  journey remove-node <journey-id> <node-name>
+  journey list-transitions <journey-id> [--from <node-name>] [--to <node-name>]
+  journey add-transition <journey-id> --from <node-name> --to <node-name> --trigger <json> [--priority <n>] [--name <transition-name>]
+  journey edit-transition <journey-id> <transition-name> [--trigger <json>] [--priority <n>]
+  journey remove-transition <journey-id> <transition-name>`,
+    email: `Usage: ascendkit email <command>
+Commands:
+  email settings
+  email settings update [--from-email <email>] [--from-name <name>]
+  email identity
+  email use-default
+  email use-custom <domain> [--from-email <email>] [--from-name <name>]
+  email setup-domain <domain>
+  email domain-status [--watch] [--interval <seconds>]
+  email open-dns [--domain <domain>] [--open]
+  email remove-domain`,
+    env: `Usage: ascendkit env <command>
+Commands:
+  env list --project <project-id>
+  env use <tier> --project <project-id>`,
+    projects: `Usage: ascendkit projects list`,
+};
+function printSectionHelp(section) {
+    if (!section)
+        return false;
+    const key = section.toLowerCase();
+    const text = HELP_SECTION[key];
+    if (!text)
+        return false;
+    console.log(text);
+    return true;
+}
+function getClient() {
+    let publicKey = process.env.ASCENDKIT_PUBLIC_KEY;
+    let apiUrl = process.env.ASCENDKIT_API_URL;
+    const auth = loadAuth();
+    const env = loadEnvContext();
+    // Require auth unless env var provides the public key (CI/CD escape hatch)
+    if (!auth?.token && !publicKey) {
+        console.error("Not initialized. Run: ascendkit init");
+        process.exit(1);
+    }
+    if (!publicKey && env?.publicKey) {
+        publicKey = env.publicKey;
+    }
+    if (!apiUrl && auth?.apiUrl) {
+        apiUrl = auth.apiUrl;
+    }
+    if (!publicKey) {
+        console.error("No environment set. Run: ascendkit set-env <public-key>");
+        process.exit(1);
+    }
+    const client = new AscendKitClient({
+        apiUrl: apiUrl ?? "https://api.ascendkit.com",
+        publicKey,
+    });
+    if (auth?.token) {
+        client.configurePlatform(auth.token);
+    }
+    return client;
+}
+function parseFlags(args) {
+    const flags = {};
+    for (let i = 0; i < args.length; i++) {
+        if (args[i].startsWith("--")) {
+            const key = args[i].slice(2);
+            if (i + 1 < args.length && !args[i + 1].startsWith("--")) {
+                flags[key] = args[++i];
+            }
+            else {
+                flags[key] = "true";
+            }
+        }
+    }
+    return flags;
+}
+async function readSecretFromStdin() {
+    const chunks = [];
+    for await (const chunk of process.stdin) {
+        chunks.push(Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk));
+    }
+    return Buffer.concat(chunks).toString("utf8").trim();
+}
+function output(data) {
+    console.log(JSON.stringify(data, null, 2));
+}
+function normalizeJourneyRows(data) {
+    if (Array.isArray(data)) {
+        return data;
+    }
+    if (data && typeof data === "object") {
+        const rows = data.journeys;
+        if (Array.isArray(rows)) {
+            return rows;
+        }
+    }
+    return [];
+}
+function table(rows, columns) {
+    if (rows.length === 0) {
+        console.log("No results.");
+        return;
+    }
+    // Compute column widths
+    const widths = columns.map(col => {
+        const max = Math.max(col.label.length, ...rows.map(r => String(r[col.key] ?? "").length));
+        return col.width ? Math.min(max, col.width) : max;
+    });
+    // Header
+    const header = columns.map((col, i) => col.label.padEnd(widths[i])).join("  ");
+    console.log(header);
+    console.log(columns.map((_, i) => "─".repeat(widths[i])).join("  "));
+    // Rows
+    for (const row of rows) {
+        const line = columns.map((col, i) => {
+            const val = String(row[col.key] ?? "");
+            return val.length > widths[i] ? val.slice(0, widths[i] - 1) + "…" : val.padEnd(widths[i]);
+        }).join("  ");
+        console.log(line);
+    }
+}
+async function run() {
+    const args = process.argv.slice(2);
+    if (args.length === 0 || args[0] === "--help" || args[0] === "-h") {
+        console.log(HELP);
+        return;
+    }
+    if (args[0] === "help") {
+        if (args[1]) {
+            if (!printSectionHelp(args[1])) {
+                console.error(`Unknown help section: ${args[1]}`);
+                console.error('Run "ascendkit --help" for available sections.');
+                process.exit(1);
+            }
+            return;
+        }
+        console.log(HELP);
+        return;
+    }
+    const domain = args[0];
+    const action = args[1];
+    if (!action && printSectionHelp(domain)) {
+        return;
+    }
+    if (action === "--help" || action === "-h" || action === "help") {
+        if (!printSectionHelp(domain)) {
+            console.error(`Unknown command section: ${domain}`);
+            console.error('Run "ascendkit --help" for usage');
+            process.exit(1);
+        }
+        return;
+    }
+    // Platform commands (don't need environment key)
+    switch (domain) {
+        case "init": {
+            const flags = parseFlags(args.slice(1));
+            await platform.init(flags["backend"], flags["portal"]);
+            return;
+        }
+        case "logout":
+            platform.logout();
+            return;
+        case "projects":
+            if (action === "list") {
+                const projects = await platform.listProjects();
+                table(projects, [
+                    { key: "id", label: "ID" },
+                    { key: "name", label: "Name", width: 30 },
+                    { key: "enabledServices", label: "Services", width: 30 },
+                ]);
+            }
+            else {
+                console.error('Usage: ascendkit projects list');
+                process.exit(1);
+            }
+            return;
+        case "set-env":
+            if (!action) {
+                console.error("Usage: ascendkit set-env <public-key>");
+                process.exit(1);
+            }
+            await platform.setEnv(action);
+            return;
+        case "status":
+            runStatus();
+            return;
+        case "verify":
+            await runVerify();
+            return;
+        case "env":
+            await runEnv(action, args.slice(2));
+            return;
+    }
+    // Service commands (need environment key)
+    const client = getClient();
+    switch (domain) {
+        case "auth":
+            await runAuth(client, action, args.slice(2));
+            break;
+        case "content":
+            await runContent(client, action, args.slice(2));
+            break;
+        case "survey":
+            await runSurvey(client, action, args.slice(2));
+            break;
+        case "journey":
+            await runJourney(client, action, args.slice(2));
+            break;
+        case "email":
+            await runEmail(client, action, args.slice(2));
+            break;
+        default:
+            console.error(`Unknown command: ${domain}`);
+            console.error('Run "ascendkit --help" for usage');
+            process.exit(1);
+    }
+}
+async function runEnv(action, rest) {
+    const flags = parseFlags(rest);
+    switch (action) {
+        case "list":
+            if (!flags.project) {
+                console.error("Usage: ascendkit env list --project <project-id>");
+                process.exit(1);
+            }
+            table(await platform.listEnvironments(flags.project), [
+                { key: "name", label: "Name", width: 20 },
+                { key: "tier", label: "Tier" },
+                { key: "publicKey", label: "Public Key" },
+            ]);
+            break;
+        case "use":
+            if (!rest[0] || !flags.project) {
+                console.error("Usage: ascendkit env use <tier> --project <project-id>");
+                process.exit(1);
+            }
+            await platform.useEnvironment(rest[0], flags.project);
+            break;
+        default:
+            console.error(`Unknown env command: ${action}`);
+            console.error("Usage: ascendkit env list|use");
+            process.exit(1);
+    }
+}
+async function runAuth(client, action, rest) {
+    const flags = parseFlags(rest);
+    switch (action) {
+        case "settings":
+            if (rest[0] === "update") {
+                const params = {};
+                if (flags.providers)
+                    params.providers = flags.providers.split(",");
+                if (flags["email-verification"] || flags.waitlist || flags["password-reset"]) {
+                    params.features = {};
+                    if (flags["email-verification"])
+                        params.features.emailVerification = flags["email-verification"] === "true";
+                    if (flags.waitlist)
+                        params.features.waitlist = flags.waitlist === "true";
+                    if (flags["password-reset"])
+                        params.features.passwordReset = flags["password-reset"] === "true";
+                }
+                if (flags["session-duration"])
+                    params.sessionDuration = flags["session-duration"];
+                output(await auth.updateSettings(client, params));
+            }
+            else {
+                output(await auth.getSettings(client));
+            }
+            break;
+        case "providers":
+            if (!rest[0]) {
+                console.error("Usage: ascendkit auth providers <p1,p2,...>");
+                process.exit(1);
+            }
+            output(await auth.updateProviders(client, rest[0].split(",")));
+            break;
+        case "oauth": {
+            if (rest[0] === "set") {
+                const provider = rest[1];
+                if (!provider || !flags["client-id"]) {
+                    console.error("Usage: ascendkit auth oauth set <provider> --client-id <id> [--client-secret <secret> | --client-secret-stdin] [--callback-url <url>]");
+                    process.exit(1);
+                }
+                const secretFromArg = flags["client-secret"];
+                const secretFromStdin = flags["client-secret-stdin"] === "true";
+                if (!secretFromArg && !secretFromStdin) {
+                    console.error("Missing client secret. Use --client-secret-stdin (recommended) or --client-secret.");
+                    process.exit(1);
+                }
+                if (secretFromArg && secretFromStdin) {
+                    console.error("Use only one of --client-secret or --client-secret-stdin.");
+                    process.exit(1);
+                }
+                const clientSecret = secretFromArg ?? await readSecretFromStdin();
+                if (!clientSecret) {
+                    console.error("Client secret cannot be empty.");
+                    process.exit(1);
+                }
+                output(await auth.updateOAuthCredentials(client, provider, flags["client-id"], clientSecret, flags["callback-url"]));
+            }
+            else {
+                if (!rest[0]) {
+                    console.error("Usage: ascendkit auth oauth <provider>");
+                    process.exit(1);
+                }
+                const portalUrl = process.env.ASCENDKIT_PORTAL_URL ?? "http://localhost:3000";
+                const url = auth.getOAuthSetupUrl(portalUrl, rest[0], client.currentPublicKey ?? undefined);
+                console.log(`Opening browser to configure ${rest[0]} OAuth credentials...`);
+                console.log(url);
+                openBrowser(url);
+            }
+            break;
+        }
+        case "users":
+            table(await auth.listUsers(client), [
+                { key: "id", label: "ID" },
+                { key: "email", label: "Email", width: 35 },
+                { key: "name", label: "Name", width: 25 },
+                { key: "status", label: "Status" },
+            ]);
+            break;
+        default:
+            console.error(`Unknown auth command: ${action}`);
+            process.exit(1);
+    }
+}
+async function runContent(client, action, rest) {
+    const flags = parseFlags(rest);
+    switch (action) {
+        case "create":
+            if (!flags.name || !flags.subject || !flags["body-html"] || !flags["body-text"]) {
+                console.error("Usage: ascendkit content create --name <n> --subject <s> --body-html <h> --body-text <t> [--slug <slug>] [--description <desc>]");
+                process.exit(1);
+            }
+            output(await content.createTemplate(client, {
+                name: flags.name, subject: flags.subject,
+                bodyHtml: flags["body-html"], bodyText: flags["body-text"],
+                slug: flags.slug, description: flags.description,
+            }));
+            break;
+        case "list": {
+            const listParams = {};
+            if (flags.query)
+                listParams.query = flags.query;
+            if (flags.system === "true")
+                listParams.isSystem = true;
+            else if (flags.custom === "true")
+                listParams.isSystem = false;
+            const templates = await content.listTemplates(client, Object.keys(listParams).length > 0 ? listParams : undefined);
+            table(templates, [
+                { key: "id", label: "ID" },
+                { key: "name", label: "Name", width: 30 },
+                { key: "slug", label: "Slug", width: 25 },
+                { key: "subject", label: "Subject", width: 30 },
+            ]);
+            break;
+        }
+        case "get":
+            if (!rest[0]) {
+                console.error("Usage: ascendkit content get <template-id>");
+                process.exit(1);
+            }
+            output(await content.getTemplate(client, rest[0]));
+            break;
+        case "update":
+            if (!rest[0]) {
+                console.error("Usage: ascendkit content update <template-id> [--flags]");
+                process.exit(1);
+            }
+            output(await content.updateTemplate(client, rest[0], {
+                subject: flags.subject,
+                bodyHtml: flags["body-html"],
+                bodyText: flags["body-text"],
+                changeNote: flags["change-note"],
+            }));
+            break;
+        case "delete":
+            if (!rest[0]) {
+                console.error("Usage: ascendkit content delete <template-id>");
+                process.exit(1);
+            }
+            output(await content.deleteTemplate(client, rest[0]));
+            break;
+        case "versions":
+            if (!rest[0]) {
+                console.error("Usage: ascendkit content versions <template-id>");
+                process.exit(1);
+            }
+            output(await content.listVersions(client, rest[0]));
+            break;
+        case "version":
+            if (!rest[0] || !rest[1]) {
+                console.error("Usage: ascendkit content version <template-id> <n>");
+                process.exit(1);
+            }
+            output(await content.getVersion(client, rest[0], parseInt(rest[1], 10)));
+            break;
+        default:
+            console.error(`Unknown content command: ${action}`);
+            process.exit(1);
+    }
+}
+async function runSurvey(client, action, rest) {
+    const flags = parseFlags(rest);
+    if (!action) {
+        console.log(HELP_SECTION.survey);
+        return;
+    }
+    switch (action) {
+        case "create":
+            if (!flags.name) {
+                console.error("Usage: ascendkit survey create --name <n> [--type nps|csat|custom]");
+                process.exit(1);
+            }
+            output(await surveys.createSurvey(client, {
+                name: flags.name,
+                type: flags.type ?? "custom",
+                definition: flags.definition ? JSON.parse(flags.definition) : undefined,
+            }));
+            break;
+        case "list":
+            table(await surveys.listSurveys(client), [
+                { key: "id", label: "ID" },
+                { key: "name", label: "Name", width: 30 },
+                { key: "type", label: "Type" },
+                { key: "status", label: "Status" },
+            ]);
+            break;
+        case "get":
+            if (!rest[0]) {
+                console.error("Usage: ascendkit survey get <survey-id>");
+                process.exit(1);
+            }
+            output(await surveys.getSurvey(client, rest[0]));
+            break;
+        case "update":
+            if (!rest[0]) {
+                console.error("Usage: ascendkit survey update <survey-id> [--flags]");
+                process.exit(1);
+            }
+            output(await surveys.updateSurvey(client, rest[0], {
+                name: flags.name,
+                status: flags.status,
+                definition: flags.definition ? JSON.parse(flags.definition) : undefined,
+            }));
+            break;
+        case "delete":
+            if (!rest[0]) {
+                console.error("Usage: ascendkit survey delete <survey-id>");
+                process.exit(1);
+            }
+            output(await surveys.deleteSurvey(client, rest[0]));
+            break;
+        case "distribute":
+            if (!rest[0] || !flags.users) {
+                console.error("Usage: ascendkit survey distribute <survey-id> --users <usr_id1,usr_id2,...>");
+                process.exit(1);
+            }
+            output(await surveys.distributeSurvey(client, rest[0], flags.users.split(",")));
+            break;
+        case "invitations":
+            if (!rest[0]) {
+                console.error("Usage: ascendkit survey invitations <survey-id>");
+                process.exit(1);
+            }
+            output(await surveys.listInvitations(client, rest[0]));
+            break;
+        case "analytics":
+            if (!rest[0]) {
+                console.error("Usage: ascendkit survey analytics <survey-id>");
+                process.exit(1);
+            }
+            output(await surveys.getAnalytics(client, rest[0]));
+            break;
+        case "export-definition": {
+            if (!rest[0]) {
+                console.error("Usage: ascendkit survey export-definition <survey-id> [--out <file>]");
+                process.exit(1);
+            }
+            const survey = await surveys.getSurvey(client, rest[0]);
+            const text = `${JSON.stringify(survey.definition ?? {}, null, 2)}\n`;
+            const outPath = flags.out || flags.file;
+            if (outPath) {
+                writeFileSync(outPath, text, "utf8");
+                console.log(`Wrote survey definition to ${outPath}`);
+            }
+            else {
+                process.stdout.write(text);
+            }
+            break;
+        }
+        case "import-definition": {
+            if (!rest[0] || !(flags.in || flags.file)) {
+                console.error("Usage: ascendkit survey import-definition <survey-id> --in <file>");
+                process.exit(1);
+            }
+            const inPath = flags.in || flags.file;
+            const raw = readFileSync(inPath, "utf8");
+            const parsed = JSON.parse(raw);
+            const candidate = parsed && typeof parsed === "object" && "definition" in parsed
+                ? parsed.definition
+                : parsed;
+            if (!candidate || typeof candidate !== "object" || Array.isArray(candidate)) {
+                console.error("Invalid definition JSON: expected an object or { definition: object }");
+                process.exit(1);
+            }
+            output(await surveys.updateSurvey(client, rest[0], {
+                definition: candidate,
+            }));
+            break;
+        }
+        default:
+            console.error(`Unknown survey command: ${action}`);
+            console.error('Run "ascendkit survey --help" for usage');
+            process.exit(1);
+    }
+}
+function runStatus() {
+    const authData = loadAuth();
+    const env = loadEnvContext();
+    console.log("\nLogin:");
+    if (authData?.token) {
+        console.log(`  Logged in (API: ${authData.apiUrl})`);
+    }
+    else {
+        console.log("  Not initialized. Run: ascendkit init");
+    }
+    console.log("\nEnvironment:");
+    if (env?.publicKey) {
+        console.log(`  Project:     ${env.projectName || env.projectId}`);
+        console.log(`  Environment: ${env.environmentName || env.environmentId} (${env.tier})`);
+        console.log(`  Public key:  ${env.publicKey}`);
+    }
+    else {
+        console.log("  No environment set. Run: ascendkit set-env <public-key>");
+        console.log("  List environments: ascendkit env list --project <project-id>");
+    }
+    console.log();
+}
+async function runVerify() {
+    const client = getClient();
+    const checks = [
+        {
+            service: "Auth",
+            check: async () => {
+                const s = await auth.getSettings(client);
+                const providers = s?.providers ?? [];
+                return providers.length > 0 ? `configured (${providers.join(", ")})` : "no providers configured";
+            },
+        },
+        {
+            service: "Email",
+            check: async () => {
+                const s = await email.getSettings(client);
+                if (s?.domain)
+                    return `domain ${s.verificationStatus === "verified" ? "verified" : "pending DNS verification"} (${s.domain})`;
+                return "no domain configured (using AscendKit default sender)";
+            },
+        },
+        {
+            service: "Content",
+            check: async () => {
+                const items = await content.listTemplates(client);
+                return `${items.length} template${items.length !== 1 ? "s" : ""}`;
+            },
+        },
+        {
+            service: "Surveys",
+            check: async () => {
+                const items = await surveys.listSurveys(client);
+                const active = items.filter(s => s.status === "active").length;
+                return `${items.length} survey${items.length !== 1 ? "s" : ""}${active > 0 ? ` (${active} active)` : ""}`;
+            },
+        },
+        {
+            service: "Journeys",
+            check: async () => {
+                const raw = await journeys.listJourneys(client);
+                const items = normalizeJourneyRows(raw);
+                const active = items.filter(j => j.status === "active").length;
+                return `${items.length} journey${items.length !== 1 ? "s" : ""}${active > 0 ? ` (${active} active)` : ""}`;
+            },
+        },
+    ];
+    console.log();
+    const results = await Promise.allSettled(checks.map(c => c.check()));
+    for (let i = 0; i < checks.length; i++) {
+        const r = results[i];
+        const label = checks[i].service.padEnd(12);
+        if (r.status === "fulfilled") {
+            console.log(`  ${label} ✓ ${r.value}`);
+        }
+        else {
+            console.log(`  ${label} ✗ ${r.reason?.message ?? "unavailable"}`);
+        }
+    }
+    console.log();
+}
+async function runJourney(client, action, rest) {
+    const flags = parseFlags(rest);
+    switch (action) {
+        case "create":
+            if (!flags.name || !flags["entry-event"] || !flags["entry-node"]) {
+                console.error("Usage: ascendkit journey create --name <n> --entry-event <e> --entry-node <n> [--nodes <json>] [--transitions <json>] [--description <d>] [--entry-conditions <json>] [--re-entry-policy <skip|restart>]");
+                process.exit(1);
+            }
+            output(await journeys.createJourney(client, {
+                name: flags.name,
+                entryEvent: flags["entry-event"],
+                entryNode: flags["entry-node"],
+                nodes: flags.nodes ? JSON.parse(flags.nodes) : undefined,
+                transitions: flags.transitions ? JSON.parse(flags.transitions) : undefined,
+                description: flags.description,
+                entryConditions: flags["entry-conditions"] ? JSON.parse(flags["entry-conditions"]) : undefined,
+                reEntryPolicy: flags["re-entry-policy"],
+            }));
+            break;
+        case "list": {
+            const opts = {};
+            if (flags.status)
+                opts.status = flags.status;
+            const raw = await journeys.listJourneys(client, Object.keys(opts).length > 0 ? opts : undefined);
+            const items = normalizeJourneyRows(raw);
+            table(items, [
+                { key: "id", label: "ID" },
+                { key: "name", label: "Name", width: 30 },
+                { key: "status", label: "Status" },
+                { key: "entryEvent", label: "Entry Event", width: 20 },
+            ]);
+            break;
+        }
+        case "get":
+            if (!rest[0]) {
+                console.error("Usage: ascendkit journey get <journey-id>");
+                process.exit(1);
+            }
+            output(await journeys.getJourney(client, rest[0]));
+            break;
+        case "update":
+            if (!rest[0]) {
+                console.error("Usage: ascendkit journey update <journey-id> [--flags]");
+                process.exit(1);
+            }
+            output(await journeys.updateJourney(client, rest[0], {
+                name: flags.name,
+                description: flags.description,
+                entryEvent: flags["entry-event"],
+                entryNode: flags["entry-node"],
+                entryConditions: flags["entry-conditions"] ? JSON.parse(flags["entry-conditions"]) : undefined,
+                reEntryPolicy: flags["re-entry-policy"],
+                nodes: flags.nodes ? JSON.parse(flags.nodes) : undefined,
+                transitions: flags.transitions ? JSON.parse(flags.transitions) : undefined,
+            }));
+            break;
+        case "delete":
+            if (!rest[0]) {
+                console.error("Usage: ascendkit journey delete <journey-id>");
+                process.exit(1);
+            }
+            output(await journeys.deleteJourney(client, rest[0]));
+            break;
+        case "activate":
+            if (!rest[0]) {
+                console.error("Usage: ascendkit journey activate <journey-id>");
+                process.exit(1);
+            }
+            output(await journeys.activateJourney(client, rest[0]));
+            break;
+        case "pause":
+            if (!rest[0]) {
+                console.error("Usage: ascendkit journey pause <journey-id>");
+                process.exit(1);
+            }
+            output(await journeys.pauseJourney(client, rest[0]));
+            break;
+        case "archive":
+            if (!rest[0]) {
+                console.error("Usage: ascendkit journey archive <journey-id>");
+                process.exit(1);
+            }
+            output(await journeys.archiveJourney(client, rest[0]));
+            break;
+        case "analytics":
+            if (!rest[0]) {
+                console.error("Usage: ascendkit journey analytics <journey-id>");
+                process.exit(1);
+            }
+            output(await journeys.getJourneyAnalytics(client, rest[0]));
+            break;
+        case "list-nodes":
+            if (!rest[0]) {
+                console.error("Usage: ascendkit journey list-nodes <journey-id>");
+                process.exit(1);
+            }
+            output(await journeys.listNodes(client, rest[0]));
+            break;
+        case "add-node": {
+            if (!rest[0] || !flags.name) {
+                console.error("Usage: ascendkit journey add-node <journey-id> --name <node-name> [--action <json>] [--terminal <true|false>]");
+                process.exit(1);
+            }
+            const params = { name: flags.name };
+            if (flags.action)
+                params.action = JSON.parse(flags.action);
+            if (flags.terminal)
+                params.terminal = flags.terminal === "true";
+            output(await journeys.addNode(client, rest[0], params));
+            break;
+        }
+        case "edit-node": {
+            if (!rest[0] || !rest[1]) {
+                console.error("Usage: ascendkit journey edit-node <journey-id> <node-name> [--action <json>] [--terminal <true|false>]");
+                process.exit(1);
+            }
+            const params = {};
+            if (flags.action)
+                params.action = JSON.parse(flags.action);
+            if (flags.terminal)
+                params.terminal = flags.terminal === "true";
+            output(await journeys.editNode(client, rest[0], rest[1], params));
+            break;
+        }
+        case "remove-node":
+            if (!rest[0] || !rest[1]) {
+                console.error("Usage: ascendkit journey remove-node <journey-id> <node-name>");
+                process.exit(1);
+            }
+            output(await journeys.removeNode(client, rest[0], rest[1]));
+            break;
+        case "list-transitions": {
+            if (!rest[0]) {
+                console.error("Usage: ascendkit journey list-transitions <journey-id> [--from <node-name>] [--to <node-name>]");
+                process.exit(1);
+            }
+            output(await journeys.listTransitions(client, rest[0], {
+                from_node: flags.from,
+                to_node: flags.to,
+            }));
+            break;
+        }
+        case "add-transition": {
+            if (!rest[0] || !flags.from || !flags.to || !(flags.on || flags.after || flags.trigger)) {
+                console.error("Usage: ascendkit journey add-transition <journey-id> --from <node-name> --to <node-name> --on <event> | --after <delay> | --trigger <json> [--priority <n>] [--name <transition-name>]");
+                process.exit(1);
+            }
+            let trigger;
+            if (flags.on) {
+                trigger = { type: "event", event: flags.on };
+            }
+            else if (flags.after) {
+                trigger = { type: "timer", delay: parseDelay(flags.after) };
+            }
+            else {
+                trigger = JSON.parse(flags.trigger);
+            }
+            const params = {
+                from: flags.from,
+                to: flags.to,
+                trigger,
+            };
+            if (flags.priority != null)
+                params.priority = Number(flags.priority);
+            if (flags.name)
+                params.name = flags.name;
+            output(await journeys.addTransition(client, rest[0], params));
+            break;
+        }
+        case "edit-transition": {
+            if (!rest[0] || !rest[1]) {
+                console.error("Usage: ascendkit journey edit-transition <journey-id> <transition-name> [--on <event>] [--after <delay>] [--trigger <json>] [--priority <n>]");
+                process.exit(1);
+            }
+            const params = {};
+            if (flags.on) {
+                params.trigger = { type: "event", event: flags.on };
+            }
+            else if (flags.after) {
+                params.trigger = { type: "timer", delay: parseDelay(flags.after) };
+            }
+            else if (flags.trigger) {
+                params.trigger = JSON.parse(flags.trigger);
+            }
+            if (flags.priority != null)
+                params.priority = Number(flags.priority);
+            output(await journeys.editTransition(client, rest[0], rest[1], params));
+            break;
+        }
+        case "remove-transition":
+            if (!rest[0] || !rest[1]) {
+                console.error("Usage: ascendkit journey remove-transition <journey-id> <transition-name>");
+                process.exit(1);
+            }
+            output(await journeys.removeTransition(client, rest[0], rest[1]));
+            break;
+        default:
+            console.error(`Unknown journey command: ${action}`);
+            process.exit(1);
+    }
+}
+async function runEmail(client, action, rest) {
+    const flags = parseFlags(rest);
+    switch (action) {
+        case "identity": {
+            const s = await email.getSettings(client);
+            printIdentityStatus(s);
+            break;
+        }
+        case "use-default": {
+            const s = await email.useDefaultIdentity(client);
+            printIdentityStatus(s);
+            break;
+        }
+        case "use-custom": {
+            if (!rest[0]) {
+                console.error("Usage: ascendkit email use-custom <domain> [--from-email <email>] [--from-name <name>]");
+                process.exit(1);
+            }
+            const s = await email.useCustomIdentity(client, rest[0], {
+                fromEmail: flags["from-email"],
+                fromName: flags["from-name"],
+            });
+            await printEmailSetup(s);
+            break;
+        }
+        case "settings":
+            if (rest[0] === "update") {
+                const params = {};
+                if (flags["from-email"])
+                    params.fromEmail = flags["from-email"];
+                if (flags["from-name"])
+                    params.fromName = flags["from-name"];
+                output(await email.updateSettings(client, params));
+            }
+            else {
+                output(await email.getSettings(client));
+            }
+            break;
+        case "setup-domain":
+            if (!rest[0]) {
+                console.error("Usage: ascendkit email setup-domain <domain>");
+                process.exit(1);
+            }
+            await printEmailSetup(await email.setupDomain(client, rest[0]));
+            break;
+        case "domain-status": {
+            const interval = Math.max(5, Number.parseInt(flags.interval || "15", 10) || 15);
+            if (flags.watch === "true") {
+                await watchDomainStatus(client, interval);
+            }
+            else {
+                output(await email.checkDomainStatus(client));
+            }
+            break;
+        }
+        case "open-dns": {
+            const provider = await email.getDnsProvider(client, flags.domain);
+            const url = provider?.portalUrl;
+            if (!url) {
+                console.error("Could not determine DNS provider URL for this domain.");
+                process.exit(1);
+            }
+            console.log(url);
+            if (flags.open === "true") {
+                openBrowser(url);
+            }
+            break;
+        }
+        case "remove-domain":
+            output(await email.removeDomain(client));
+            break;
+        default:
+            console.error(`Unknown email command: ${action}`);
+            process.exit(1);
+    }
+}
+run().catch((err) => {
+    console.error(err.message);
+    process.exit(1);
+});
+async function printEmailSetup(settings) {
+    output(settings);
+    if (!settings.domain)
+        return;
+    const provider = settings.dnsProvider;
+    if (provider?.name) {
+        console.log(`\nDetected DNS provider: ${provider.name} (${provider.confidence ?? "unknown"})`);
+    }
+    if (provider?.portalUrl) {
+        console.log(`Provider console: ${provider.portalUrl}`);
+    }
+    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}`);
+        }
+    }
+}
+function printIdentityStatus(settings) {
+    const mode = settings.domain ? "customer-owned" : "ascendkit-default";
+    const from = settings.fromEmail || "noreply@ascendkit.dev";
+    const status = settings.verificationStatus || "none";
+    console.log(`Identity mode: ${mode}`);
+    console.log(`From email:    ${from}`);
+    console.log(`From name:     ${settings.fromName || "not set"}`);
+    if (settings.domain) {
+        console.log(`Domain:        ${settings.domain} (${status})`);
+        if (status !== "verified") {
+            console.log("Next step: add DNS records and run `ascendkit email domain-status --watch`");
+        }
+    }
+    else {
+        console.log("Next step: run `ascendkit email use-custom <domain>` to configure customer-owned identity.");
+    }
+}
+async function watchDomainStatus(client, intervalSeconds) {
+    while (true) {
+        const data = await email.checkDomainStatus(client);
+        output(data);
+        if (data?.status === "verified" || data?.status === "failed" || data?.status === "none") {
+            return;
+        }
+        await new Promise((resolve) => setTimeout(resolve, intervalSeconds * 1000));
+    }
+}
+function openBrowser(url) {
+    import("child_process").then(({ execFile }) => {
+        if (process.platform === "darwin") {
+            execFile("open", [url]);
+        }
+        else if (process.platform === "win32") {
+            const safe = url.replace(/[&|<>^"]/g, "^$&");
+            execFile("cmd.exe", ["/c", "start", "", safe]);
+        }
+        else {
+            execFile("xdg-open", [url]);
+        }
+    });
+}