@ascendkit/cli 0.3.9 → 0.3.12

package/dist/cli.js

@@ -40,7 +40,7 @@ Services:
   survey           Surveys, questions, distribution, analytics
   journey          Lifecycle journeys, nodes, transitions
   email-identity   Email domains, sender identities, and DNS
-  keystore         Environment runtime key-value settings
+  env              Environment variable settings
   webhook          Webhook endpoints and testing
   campaign         Email campaigns, scheduling, analytics
   import           Import users from external auth providers
@@ -61,7 +61,7 @@ Commands:
   auth provider list
   auth provider set <p1,p2,...>
   auth oauth open <provider>
-  auth oauth set <provider> --client-id <id> [--client-secret <secret> | --client-secret-stdin] [--callback-url <url>]
+  auth oauth set <provider> --client-id <id> [--client-secret <secret> | --client-secret-stdin]
   auth oauth remove <provider>
   auth user list
   auth user remove <user-id>
@@ -112,9 +112,14 @@ Commands:
   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>] [--quiet]
-  journey transition update <journey-id> <transition-name> [--trigger <json>] [--priority <n>]
-  journey transition remove <journey-id> <transition-name>`,
+  journey transition add <journey-id> --from <node-name> --to <node-name> --on <event> | --after <delay> [--priority <n>] [--name <transition-name>] [--quiet]
+  journey transition update <journey-id> <transition-name> [--on <event>] [--after <delay>] [--priority <n>]
+  journey transition remove <journey-id> <transition-name>
+
+Trigger shortcuts:
+  --on <event>       Event trigger (e.g. --on user.login, --on app.completed_onboarding)
+  --after <delay>    Timer trigger (e.g. --after 2d, --after 12h, --after 30m)
+  --trigger <json>   Raw JSON: {"type":"event","event":"user.login"} or {"type":"timer","delay":"3d"}`,
     "email-identity": `Usage: ascendkit email-identity <command>
 
 Commands:
@@ -162,12 +167,12 @@ Commands:
   environment show
   environment update [<env-id>] [--name <name>] [--description <desc>]
   environment promote [<env-id>] --target <tier>`,
-    keystore: `Usage: ascendkit keystore <command>
+    env: `Usage: ascendkit env <command>
 
 Commands:
-  keystore list
-  keystore set <key> <value>
-  keystore remove <key>`,
+  env list
+  env set <key> <value>
+  env remove <key>`,
     import: `Usage: ascendkit import <source> <action> [options]
 
 Sources:
@@ -209,7 +214,7 @@ function printSectionHelp(section) {
         key = "email-identity";
     if (key === "projects")
         key = "project";
-    if (key === "env" || key === "environments")
+    if (key === "environments")
         key = "environment";
     const text = HELP_SECTION[key];
     if (!text)
@@ -304,7 +309,7 @@ function printTemplateSummary(data, opts) {
     }
     if (Array.isArray(data.unconfiguredVariables) && data.unconfiguredVariables.length > 0) {
         console.log(`\n⚠ Unconfigured variables: ${data.unconfiguredVariables.join(", ")}`);
-        console.log(`  Set values with: ascendkit keystore set <key> <value>`);
+        console.log(`  Set values with: ascendkit env set <key> <value>`);
     }
     if (Array.isArray(data.relatedJourneys) && data.relatedJourneys.length > 0) {
         const refs = data.relatedJourneys.map((j) => `${j.name} (${j.id})`).join(", ");
@@ -692,7 +697,7 @@ async function run() {
         case "environment":
             await runEnvironment(action, args.slice(2));
             return;
-        case "keystore":
+        case "env":
             await runKeystore(action, args.slice(2));
             return;
     }
@@ -1008,7 +1013,7 @@ async function runKeystore(action, rest) {
             const key = rest[0];
             const value = rest[1];
             if (!key || value === undefined) {
-                console.error("Usage: ascendkit keystore set <key> <value>");
+                console.error("Usage: ascendkit env set <key> <value>");
                 return await exitCli(1);
             }
             vars[key] = value;
@@ -1019,7 +1024,7 @@ async function runKeystore(action, rest) {
         case "remove": {
             const key = rest[0];
             if (!key) {
-                console.error("Usage: ascendkit keystore remove <key>");
+                console.error("Usage: ascendkit env remove <key>");
                 return await exitCli(1);
             }
             if (!(key in vars)) {
@@ -1058,8 +1063,8 @@ async function runKeystore(action, rest) {
             return;
         }
         default:
-            console.error(`Unknown keystore command: ${action}`);
-            console.error("Usage: ascendkit keystore list|set|remove");
+            console.error(`Unknown env command: ${action}`);
+            console.error("Usage: ascendkit env list|set|remove");
             return await exitCli(1);
     }
 }
@@ -1116,7 +1121,7 @@ async function runAuth(client, action, rest) {
             const provider = oauthAction === "open" && rest[0] !== "open" ? rest[0] : rest[1];
             if (oauthAction === "set") {
                 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>]");
+                    console.error("Usage: ascendkit auth oauth set <provider> --client-id <id> [--client-secret <secret> | --client-secret-stdin]");
                     return await exitCli(1);
                 }
                 const secretFromArg = flags["client-secret"];
@@ -1134,7 +1139,20 @@ async function runAuth(client, action, rest) {
                     console.error("Client secret cannot be empty.");
                     return await exitCli(1);
                 }
-                await auth.updateOAuthCredentials(client, provider, flags["client-id"], clientSecret, flags["callback-url"]);
+                const ctx = loadEnvContext();
+                if (!ctx) {
+                    console.error("No environment set. Run: ascendkit set-env <public-key>");
+                    return await exitCli(1);
+                }
+                const env = await platform.getEnvironment(ctx.projectId, ctx.environmentId);
+                const variables = (env.variables ?? {});
+                const appUrl = (variables.APP_URL ?? "").trim();
+                if (!appUrl) {
+                    console.error("Set APP_URL for this environment first. AscendKit uses APP_URL to generate the redirect URI for custom OAuth credentials.");
+                    console.error("Use: ascendkit env set APP_URL https://your-app.com");
+                    return await exitCli(1);
+                }
+                await auth.updateOAuthCredentials(client, provider, flags["client-id"], clientSecret);
                 console.log(`Saved OAuth credentials for ${provider}.`);
             }
             else if (oauthAction === "remove") {

package/dist/commands/auth.d.ts

@@ -12,7 +12,7 @@ export interface UpdateSettingsParams {
 export declare function getSettings(client: AscendKitClient): Promise<unknown>;
 export declare function updateSettings(client: AscendKitClient, params: UpdateSettingsParams): Promise<unknown>;
 export declare function updateProviders(client: AscendKitClient, providers: string[]): Promise<unknown>;
-export declare function updateOAuthCredentials(client: AscendKitClient, provider: string, clientId: string, clientSecret: string, callbackUrl?: string): Promise<unknown>;
+export declare function updateOAuthCredentials(client: AscendKitClient, provider: string, clientId: string, clientSecret: string): Promise<unknown>;
 export declare function deleteOAuthCredentials(client: AscendKitClient, provider: string): Promise<unknown>;
 export declare function getOAuthSetupUrl(portalUrl: string, provider: string, publicKey?: string): string;
 export declare function listUsers(client: AscendKitClient): Promise<unknown>;

package/dist/commands/auth.js

@@ -14,11 +14,8 @@ export async function updateSettings(client, params) {
 export async function updateProviders(client, providers) {
     return client.managedPut("/api/auth/settings/providers", { providers });
 }
-export async function updateOAuthCredentials(client, provider, clientId, clientSecret, callbackUrl) {
-    const body = { clientId, clientSecret };
-    if (callbackUrl)
-        body.callbackUrl = callbackUrl;
-    return client.managedPut(`/api/auth/settings/oauth/${provider}`, body);
+export async function updateOAuthCredentials(client, provider, clientId, clientSecret) {
+    return client.managedPut(`/api/auth/settings/oauth/${provider}`, { clientId, clientSecret });
 }
 export async function deleteOAuthCredentials(client, provider) {
     return client.managedDelete(`/api/auth/settings/oauth/${provider}`);

package/dist/commands/platform.js

@@ -13,6 +13,8 @@ const ASCENDKIT_ENV_KEYS = [
     "ASCENDKIT_API_URL",
     "NEXT_PUBLIC_ASCENDKIT_ENV_KEY",
     "ASCENDKIT_ENV_KEY",
+    "APP_URL",
+    "ASCENDKIT_APP_URL",
     "ASCENDKIT_SECRET_KEY",
     "ASCENDKIT_WEBHOOK_SECRET",
 ];
@@ -135,6 +137,11 @@ function buildAscendKitEnvBlock(values) {
         `NEXT_PUBLIC_ASCENDKIT_ENV_KEY=${values.NEXT_PUBLIC_ASCENDKIT_ENV_KEY}`,
         `ASCENDKIT_ENV_KEY=${values.ASCENDKIT_ENV_KEY}`,
         "",
+        "# Public URL where your app is hosted (used for auth callbacks and redirects)",
+        "# Example: https://app.yourdomain.com",
+        "# Leave blank in local dev if the SDK should infer from the incoming request.",
+        `APP_URL=${values.APP_URL}`,
+        "",
         "# AscendKit secret key (server-only; never expose to client/browser)",
         `ASCENDKIT_SECRET_KEY=${values.ASCENDKIT_SECRET_KEY}`,
         "",
@@ -183,6 +190,8 @@ async function updateEnvExampleFile(filePath) {
         ASCENDKIT_API_URL: "",
         NEXT_PUBLIC_ASCENDKIT_ENV_KEY: "",
         ASCENDKIT_ENV_KEY: "",
+        APP_URL: "",
+        ASCENDKIT_APP_URL: "",
         ASCENDKIT_SECRET_KEY: "",
         ASCENDKIT_WEBHOOK_SECRET: "",
     });
@@ -208,6 +217,8 @@ async function updateRuntimeEnvFile(filePath, apiUrl, publicKey, secretKey, opti
         ASCENDKIT_API_URL: resolvedApiUrl,
         NEXT_PUBLIC_ASCENDKIT_ENV_KEY: resolvedPublicKey,
         ASCENDKIT_ENV_KEY: resolvedPublicKey,
+        APP_URL: readEnvValue(original, "APP_URL") ?? readEnvValue(original, "ASCENDKIT_APP_URL") ?? "",
+        ASCENDKIT_APP_URL: "",
         ASCENDKIT_SECRET_KEY: resolvedSecretKey,
         ASCENDKIT_WEBHOOK_SECRET: resolvedWebhookSecret,
     });

package/dist/tools/auth.js

@@ -1,5 +1,6 @@
 import { z } from "zod";
 import * as auth from "../commands/auth.js";
+import * as platform from "../commands/platform.js";
 function formatAuthSettings(data) {
     const providers = Array.isArray(data.providers) ? data.providers : [];
     const features = data.features ?? {};
@@ -60,7 +61,6 @@ export function registerAuthTools(server, client) {
         provider: z.string().describe('OAuth provider name, e.g. "google", "github"'),
         clientId: z.string().optional().describe("OAuth client ID (to set credentials directly)"),
         clientSecret: z.string().optional().describe("OAuth client secret (to set credentials directly)"),
-        callbackUrl: z.string().optional().describe("Auth callback URL for this provider"),
         useProxy: z.boolean().optional().describe("Clear custom credentials and use AscendKit managed proxy credentials"),
     }, async (params) => {
         if (params.useProxy && (params.clientId || params.clientSecret)) {
@@ -91,7 +91,19 @@ export function registerAuthTools(server, client) {
             };
         }
         if (params.clientId && params.clientSecret) {
-            const data = await auth.updateOAuthCredentials(client, params.provider, params.clientId, params.clientSecret, params.callbackUrl);
+            const env = await platform.mcpGetEnvironment(client, {});
+            const variables = env.variables ?? {};
+            const appUrl = (variables.APP_URL ?? "").trim();
+            if (!appUrl) {
+                return {
+                    content: [{
+                            type: "text",
+                            text: "Set APP_URL for the active environment first. AscendKit uses APP_URL to generate the redirect URI for custom OAuth credentials.",
+                        }],
+                    isError: true,
+                };
+            }
+            const data = await auth.updateOAuthCredentials(client, params.provider, params.clientId, params.clientSecret);
             return {
                 content: [{
                         type: "text",

package/dist/tools/platform.js

@@ -206,7 +206,7 @@ export function registerPlatformTools(server, client) {
             };
         }
     });
-    server.tool("keystore_list", "List keystore values for the active environment. Uses the shared .ascendkit environment context by default.", {
+    server.tool("env_list", "List environment variable values for the active environment. Uses the shared .ascendkit environment context by default.", {
         projectId: z.string().optional().describe("Optional project ID override (defaults to active environment project)"),
         envId: z.string().optional().describe("Optional environment ID override (defaults to active environment)"),
     }, async (params) => {
@@ -235,10 +235,10 @@ export function registerPlatformTools(server, client) {
             return { content: [{ type: "text", text: message }], isError: true };
         }
     });
-    server.tool("keystore_replace", "Replace the full keystore for the active environment. Pass the full key-value map.", {
+    server.tool("env_replace", "Replace the full environment variable map for the active environment. Pass the full key-value map.", {
         projectId: z.string().optional().describe("Optional project ID override (defaults to active environment project)"),
         envId: z.string().optional().describe("Optional environment ID override (defaults to active environment)"),
-        variables: z.record(z.string()).describe("Key-value map of keystore values"),
+        variables: z.record(z.string()).describe("Key-value map of environment variables"),
     }, async (params) => {
         try {
             const data = await platform.mcpUpdateEnvironmentVariables(client, params);
@@ -265,11 +265,11 @@ export function registerPlatformTools(server, client) {
             };
         }
     });
-    server.tool("keystore_set", "Set a single keystore key for the active environment.", {
+    server.tool("env_set", "Set a single environment variable for the active environment.", {
         projectId: z.string().optional().describe("Optional project ID override (defaults to active environment project)"),
         envId: z.string().optional().describe("Optional environment ID override (defaults to active environment)"),
-        key: z.string().describe("Keystore key"),
-        value: z.string().describe("Keystore value"),
+        key: z.string().describe("Environment variable key"),
+        value: z.string().describe("Environment variable value"),
     }, async (params) => {
         try {
             const env = await platform.mcpGetEnvironment(client, {
@@ -291,10 +291,10 @@ export function registerPlatformTools(server, client) {
             return { content: [{ type: "text", text: message }], isError: true };
         }
     });
-    server.tool("keystore_remove", "Remove a single keystore key from the active environment.", {
+    server.tool("env_remove", "Remove a single environment variable from the active environment.", {
         projectId: z.string().optional().describe("Optional project ID override (defaults to active environment project)"),
         envId: z.string().optional().describe("Optional environment ID override (defaults to active environment)"),
-        key: z.string().describe("Keystore key to remove"),
+        key: z.string().describe("Environment variable key to remove"),
     }, async (params) => {
         try {
             const env = await platform.mcpGetEnvironment(client, {

package/package.json

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