ardent-cli 0.0.16 → 0.0.18

package/dist/index.js

@@ -1,8 +1,8 @@
 #!/usr/bin/env node
 
 // src/index.ts
-import { readFileSync as readFileSync4 } from "fs";
-import { Command as Command7 } from "commander";
+import { readFileSync as readFileSync5 } from "fs";
+import { Command as Command8 } from "commander";
 
 // src/commands/branch/index.ts
 import { Command } from "commander";
@@ -700,6 +700,33 @@ async function createAction2(type, url, options) {
     console.error(`  Supported: ${supportedTypes.join(", ")}`);
     process.exit(1);
   }
+  const deploymentModel = options.deploymentModel ?? "ardent-cloud";
+  if (deploymentModel !== "ardent-cloud" && deploymentModel !== "customer-cloud") {
+    console.error(`\u2717 Invalid --deployment-model: ${deploymentModel}`);
+    console.error("  Supported: ardent-cloud, customer-cloud");
+    process.exit(1);
+  }
+  const isCustomerCloud = deploymentModel === "customer-cloud";
+  if (isCustomerCloud) {
+    const missing = [];
+    if (!options.awsRoleArn) missing.push("--aws-role-arn");
+    if (!options.awsExternalId) missing.push("--aws-external-id");
+    if (!options.awsRegion) missing.push("--aws-region");
+    if (missing.length > 0) {
+      console.error(
+        `\u2717 ${missing.join(", ")} required when --deployment-model=customer-cloud`
+      );
+      process.exit(1);
+    }
+  } else {
+    const stray = options.awsRoleArn || options.awsExternalId || options.awsRegion;
+    if (stray) {
+      console.error(
+        "\u2717 --aws-role-arn / --aws-external-id / --aws-region require --deployment-model=customer-cloud"
+      );
+      process.exit(1);
+    }
+  }
   const isByoc = Boolean(options.byoc);
   if (isByoc) {
     if (!options.apiKey || !options.projectId) {
@@ -727,7 +754,9 @@ async function createAction2(type, url, options) {
     }
     let createPayload;
     if (isByoc) {
-      console.log("Creating connector (BYOC Neon)...");
+      console.log(
+        `Creating connector (BYOC Neon${isCustomerCloud ? ", customer-cloud data plane" : ""})...`
+      );
       createPayload = {
         name: connectorName,
         service_name: "postgresql",
@@ -744,7 +773,9 @@ async function createAction2(type, url, options) {
         console.error("  Example: postgresql://user:password@host:5432/db");
         process.exit(1);
       }
-      console.log("Creating connector...");
+      console.log(
+        `Creating connector${isCustomerCloud ? " (customer-cloud data plane)" : ""}...`
+      );
       createPayload = {
         name: connectorName,
         service_name: "postgresql",
@@ -757,6 +788,14 @@ async function createAction2(type, url, options) {
         }
       };
     }
+    if (isCustomerCloud) {
+      createPayload.deployment_model = "customer-cloud";
+      createPayload.byoc_access_credentials = {
+        role_arn: options.awsRoleArn,
+        external_id: options.awsExternalId,
+        region: options.awsRegion
+      };
+    }
     const created = await api.post("/v1/connectors", createPayload);
     const connectorId = created.id;
     if (isByoc) {
@@ -807,7 +846,11 @@ async function createAction2(type, url, options) {
     setCacheEntry("connectors", cachedConnectors);
     setConfig("currentConnectorId", connectorId);
     setConfig("currentConnectorName", connectorName);
-    trackEvent("CLI: connector create succeeded", { db_type: type, byoc: isByoc });
+    trackEvent("CLI: connector create succeeded", {
+      db_type: type,
+      byoc: isByoc,
+      deployment_model: deploymentModel
+    });
     console.log("\u2713 Connector created and ready");
     console.log(`  ID: ${connectorId}`);
     showNextStep();
@@ -1009,7 +1052,19 @@ async function switchAction2(name) {
 
 // src/commands/connector/index.ts
 var connectorCommand = new Command2("connector").description("Manage database connectors");
-connectorCommand.command("create <type> [url]").description("Create a new connector").option("-n, --name <name>", "Connector name").option("--byoc <provider>", "Bring your own Neon project (e.g. neon)").option("--api-key <key>", "Neon API key (required with --byoc)").option("--project-id <id>", "Neon project ID (required with --byoc)").action(createAction2);
+connectorCommand.command("create <type> [url]").description("Create a new connector").option("-n, --name <name>", "Connector name").option("--byoc <provider>", "Bring your own Neon project (e.g. neon)").option("--api-key <key>", "Neon API key (required with --byoc)").option("--project-id <id>", "Neon project ID (required with --byoc)").option(
+  "--deployment-model <model>",
+  "'ardent-cloud' (default) or 'customer-cloud' to route CDC through the customer's AWS account"
+).option(
+  "--aws-role-arn <arn>",
+  "ArdentDeployer role ARN in the customer account (required with --deployment-model=customer-cloud)"
+).option(
+  "--aws-external-id <id>",
+  "External ID for sts:AssumeRole (required with --deployment-model=customer-cloud)"
+).option(
+  "--aws-region <region>",
+  "AWS region of the customer data plane (required with --deployment-model=customer-cloud)"
+).action(createAction2);
 connectorCommand.command("list").description("List your connectors").action(listAction2);
 connectorCommand.command("switch <name>").description("Switch to a different connector").action(switchAction2);
 connectorCommand.command("delete <name>").description("Delete a connector by name").action(deleteAction2);
@@ -1385,9 +1440,174 @@ projectCommand.command("create <name>").description("Create a new project").acti
 projectCommand.command("list").description("List your projects").action(listAction4);
 projectCommand.command("switch <name>").description("Switch to a different project").action(switchAction3);
 
-// src/commands/auth/index.ts
+// src/commands/settings/index.ts
 import { Command as Command6 } from "commander";
 
+// src/lib/settings.ts
+import { readFileSync as readFileSync3 } from "fs";
+var SETTING_KEYS = ["default_db", "branch_sql"];
+function requireConnectorAndOrg() {
+  const connectorId = getConfig("currentConnectorId");
+  const user = getConfig("user");
+  const orgId = user?.org_id;
+  if (!connectorId) {
+    console.error("\u2717 No connector selected. Run 'ardent connector switch' first.");
+    process.exit(1);
+  }
+  if (!orgId) {
+    console.error("\u2717 Not logged in. Run 'ardent login' first.");
+    process.exit(1);
+  }
+  return {
+    connectorId,
+    connectorName: getConfig("currentConnectorName") ?? connectorId,
+    orgId
+  };
+}
+function parseSettingKey(key) {
+  if (!SETTING_KEYS.includes(key)) {
+    console.error(`\u2717 Unknown setting '${key}'. Valid: ${SETTING_KEYS.join(", ")}`);
+    process.exit(1);
+  }
+  return key;
+}
+var SETTING_DESCRIPTIONS = {
+  default_db: "Default database in branch URLs",
+  branch_sql: "SQL to run on every new branch after creation"
+};
+function settingKeyToPolicyType(key) {
+  if (key === "default_db") return "connection_default_db";
+  if (key === "branch_sql") return "branch_create_hook";
+  throw new Error(`Unknown setting key: ${key}`);
+}
+function buildPolicyConfig(key, value) {
+  if (key === "default_db") return { database: value };
+  if (key === "branch_sql") return { sql: value };
+  throw new Error(`Unknown setting key: ${key}`);
+}
+function readSettingValue(key, config) {
+  if (key === "default_db") return String(config.database ?? "");
+  if (key === "branch_sql") return String(config.sql ?? "");
+  throw new Error(`Unknown setting key: ${key}`);
+}
+function resolveValueFromArg(value) {
+  if (value.startsWith("@")) {
+    const path = value.slice(1);
+    try {
+      return readFileSync3(path, "utf-8");
+    } catch (err) {
+      throw new Error(
+        `Failed to read ${path}: ${err instanceof Error ? err.message : String(err)}`
+      );
+    }
+  }
+  return value;
+}
+async function findPolicyForConnector(orgId, connectorId, policyType) {
+  const policies = await api.get(
+    `/v1/policies?org_id=${orgId}&connector_id=${connectorId}`
+  );
+  return policies.find((policy) => policy.type === policyType) ?? null;
+}
+
+// src/commands/settings/list.ts
+async function listAction5() {
+  const { connectorId, connectorName, orgId } = requireConnectorAndOrg();
+  try {
+    console.log(`Connector: ${connectorName}
+`);
+    for (const key of SETTING_KEYS) {
+      const policy = await findPolicyForConnector(
+        orgId,
+        connectorId,
+        settingKeyToPolicyType(key)
+      );
+      if (policy) {
+        const value = readSettingValue(key, policy.config);
+        const display = value.length > 80 ? value.slice(0, 77) + "..." : value;
+        console.log(`  ${key.padEnd(12)} ${display}`);
+      } else {
+        console.log(`  ${key.padEnd(12)} (not set)  \u2014 ${SETTING_DESCRIPTIONS[key]}`);
+      }
+    }
+    trackEvent("CLI: settings list succeeded");
+  } catch (err) {
+    trackEvent("CLI: settings list failed", { reason: "api_error" });
+    console.error("\u2717 Failed:", err instanceof Error ? err.message : err);
+    process.exit(1);
+  }
+}
+
+// src/commands/settings/set.ts
+async function setAction(key, value) {
+  const settingKey = parseSettingKey(key);
+  const { connectorId, orgId } = requireConnectorAndOrg();
+  let resolvedValue;
+  try {
+    resolvedValue = resolveValueFromArg(value);
+  } catch (err) {
+    console.error("\u2717", err instanceof Error ? err.message : err);
+    process.exit(1);
+  }
+  const policyType = settingKeyToPolicyType(settingKey);
+  const config = buildPolicyConfig(settingKey, resolvedValue);
+  try {
+    const existing = await findPolicyForConnector(orgId, connectorId, policyType);
+    if (existing) {
+      await api.patch(`/v1/policies/${existing.id}`, { config });
+      console.log(`\u2713 Updated ${settingKey}`);
+      trackEvent("CLI: settings set succeeded", { key: settingKey, op: "update" });
+      return;
+    }
+    await api.post("/v1/policies", {
+      org_id: orgId,
+      name: settingKey,
+      type: policyType,
+      config,
+      assign_to_scope: { scope_type: "connectors", scope_id: connectorId }
+    });
+    console.log(`\u2713 Set ${settingKey}`);
+    trackEvent("CLI: settings set succeeded", { key: settingKey, op: "create" });
+  } catch (err) {
+    trackEvent("CLI: settings set failed", { key: settingKey });
+    console.error("\u2717 Failed:", err instanceof Error ? err.message : err);
+    process.exit(1);
+  }
+}
+
+// src/commands/settings/remove.ts
+async function removeAction2(key) {
+  const settingKey = parseSettingKey(key);
+  const { connectorId, orgId } = requireConnectorAndOrg();
+  const policyType = settingKeyToPolicyType(settingKey);
+  try {
+    const existing = await findPolicyForConnector(orgId, connectorId, policyType);
+    if (!existing) {
+      console.log(`${settingKey} is not set`);
+      trackEvent("CLI: settings remove noop", { key: settingKey });
+      return;
+    }
+    await api.delete(`/v1/policies/${existing.id}`);
+    console.log(`\u2713 Removed ${settingKey}`);
+    trackEvent("CLI: settings remove succeeded", { key: settingKey });
+  } catch (err) {
+    trackEvent("CLI: settings remove failed", { key: settingKey });
+    console.error("\u2717 Failed:", err instanceof Error ? err.message : err);
+    process.exit(1);
+  }
+}
+
+// src/commands/settings/index.ts
+var settingsCommand = new Command6("settings").description("Manage settings for the current connector").showHelpAfterError("(run 'ardent settings --help' for valid keys)");
+settingsCommand.command("list").description("List current settings for the connector").action(listAction5);
+settingsCommand.command("set <key> <value>").description(
+  "Set a setting. Keys: default_db, branch_sql. For branch_sql, prefix value with @ to read from file."
+).action(setAction);
+settingsCommand.command("remove <key>").description("Remove a setting. Keys: default_db, branch_sql.").action(removeAction2);
+
+// src/commands/auth/index.ts
+import { Command as Command7 } from "commander";
+
 // src/commands/auth/login.ts
 async function loginAction(options) {
   if (options.token) {
@@ -1517,12 +1737,12 @@ function statusAction() {
 }
 
 // src/commands/auth/index.ts
-var loginCommand = new Command6("login").description("Login to Ardent").option("-t, --token <token>", "API token (skip browser login)").action(loginAction);
-var logoutCommand = new Command6("logout").description("Logout from Ardent").action(logoutAction);
-var statusCommand = new Command6("status").description("Show status").action(statusAction);
+var loginCommand = new Command7("login").description("Login to Ardent").option("-t, --token <token>", "API token (skip browser login)").action(loginAction);
+var logoutCommand = new Command7("logout").description("Logout from Ardent").action(logoutAction);
+var statusCommand = new Command7("status").description("Show status").action(statusAction);
 
 // src/lib/update-check.ts
-import { existsSync as existsSync2, readFileSync as readFileSync3, writeFileSync as writeFileSync2 } from "fs";
+import { existsSync as existsSync2, readFileSync as readFileSync4, writeFileSync as writeFileSync2 } from "fs";
 import { join as join2 } from "path";
 import { homedir as homedir2 } from "os";
 var UPDATE_CHECK_FILE = join2(homedir2(), ".ardent", "update-check.json");
@@ -1531,7 +1751,7 @@ var PACKAGE_NAME = "ardent-cli";
 function loadCache() {
   try {
     if (existsSync2(UPDATE_CHECK_FILE)) {
-      return JSON.parse(readFileSync3(UPDATE_CHECK_FILE, "utf-8"));
+      return JSON.parse(readFileSync4(UPDATE_CHECK_FILE, "utf-8"));
     }
   } catch {
   }
@@ -1624,6 +1844,11 @@ BRANCHES
   branch delete          Delete a branch
   branch switch          Switch to a different branch
 
+SETTINGS
+  settings list          List current settings for the connector
+  settings set           Set a setting (e.g. default_db testdb)
+  settings remove        Remove a setting
+
 TEAM
   invite <email>         Invite a user to your organization
   invite list            List pending invites
@@ -1644,11 +1869,11 @@ EXAMPLES
   ardent org members
 `;
 var CLI_VERSION2 = getCliVersion2();
-var program = new Command7();
+var program = new Command8();
 function getCliVersion2() {
   try {
     const packageUrl = new URL("../package.json", import.meta.url);
-    const raw = readFileSync4(packageUrl, "utf-8");
+    const raw = readFileSync5(packageUrl, "utf-8");
     const parsed = JSON.parse(raw);
     return parsed.version ?? "unknown";
   } catch {
@@ -1664,6 +1889,7 @@ program.addCommand(statusCommand);
 program.addCommand(projectCommand);
 program.addCommand(connectorCommand);
 program.addCommand(branchCommand);
+program.addCommand(settingsCommand);
 program.addCommand(inviteCommand);
 program.addCommand(orgCommand);
 program.on("command:*", (operands) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ardent-cli",
-  "version": "0.0.16",
+  "version": "0.0.18",
   "description": "Git for Data infrastructure",
   "type": "module",
   "bin": {