@get-dx/cli 0.1.5 → 0.1.7

package/README.md

@@ -18,6 +18,26 @@ Interactively login and install the AI agent skill:
 dx init
 ```
 
+The CLI uses `app.getdx.com` as the hostname and `api.getdx.com` as the api base url by default.
+
+### Dedicated or managed deployments
+
+If your organization is on a dedicated or managed DX deployment, pass your custom hostname at init time:
+
+```shell
+# Flag (dedicated instance at mycompany.getdx.io)
+dx init --host mycompany.getdx.io
+
+# Env var — useful for CI or scripted setups
+DX_HOST=mycompany.getdx.io dx init
+```
+
+The `DX_HOST` and `--host` values accept:
+
+- `app.getdx.com` — DX Cloud (default)
+- `<account>.getdx.io` — DX dedicated (derives `https://api.<account>.getdx.io` automatically)
+- Any custom domain — you will be prompted for the separate API base URL
+
 Show help text:
 
 ```shell

package/dist/commands/authRendering.js

@@ -9,6 +9,13 @@ export function renderAuthInfo(authInfo, token, baseUrl) {
             ui.dli("Token type", tokenTypeName(authInfo.auth.token_type)),
             ui.dli("Token name", authInfo.auth.token_name),
             ui.dli("Token created at", ui.timestampSummary(authInfo.auth.created_at)),
+            ...(authInfo.auth.token_type === "personal_access_token"
+                ? [
+                    ui.dli("Token expires at", authInfo.auth.expires_at
+                        ? ui.timestampSummary(authInfo.auth.expires_at)
+                        : ui.dim("(no expiration)")),
+                ]
+                : []),
         ], { termWidth: 18 }),
         ui.p(ui.bold("Token scopes:"), false),
         ...scopesContent(authInfo.auth.scopes),

package/dist/commands/init.js

@@ -50,12 +50,14 @@ export function initCommand() {
     const init = new Command()
         .name("init")
         .description("Initialize the DX CLI")
-        .action(wrapAction(async (_commandOptions, command) => {
+        .option("--host <hostname>", "DX hostname for dedicated or managed deployments (e.g. mycompany.getdx.io)")
+        .action(wrapAction(async (commandOptions, command) => {
         const context = getContext(command);
         let runtime = buildRuntimeSafe(context);
         ensureInteractive();
         showWelcomeBanner();
-        runtime = await ensureLoggedIn(runtime);
+        const host = commandOptions.host || process.env.DX_HOST;
+        runtime = await ensureLoggedIn(runtime, host);
         await optionallySetupSkill(runtime);
         renderRichText([
             ui.blankLine(),
@@ -72,7 +74,7 @@ function ensureInteractive() {
 function showWelcomeBanner() {
     renderRichText([ui.p(ui.success(WELCOME_BANNER))]);
 }
-async function ensureLoggedIn(runtime) {
+async function ensureLoggedIn(runtime, host) {
     renderRichText([ui.h1(`Checking if you are logged in...`), ui.blankLine()]);
     if (runtime) {
         let authInfo = null;
@@ -88,17 +90,9 @@ async function ensureLoggedIn(runtime) {
         }
     }
     renderRichText([ui.p(`You are not logged in yet.`), ui.blankLine()]);
-    let parsed = { type: "invalid" };
-    while (parsed.type === "invalid") {
-        const raw = await input({
-            message: "What is your DX hostname? (leave blank for app.getdx.com)",
-        });
-        parsed = parseHostname(raw);
-        if (parsed.type === "invalid") {
-            renderRichText([
-                ui.p(ui.error(`Could not recognise that hostname. Please try again.`)),
-            ]);
-        }
+    const parsed = host ? parseHostname(host) : { type: "cloud" };
+    if (parsed.type === "invalid") {
+        throw new CliError(`Could not recognize hostname "${host}". Expected app.getdx.com, <account>.getdx.io, or a custom domain.`);
     }
     switch (parsed.type) {
         case "cloud":

package/dist/commands/teams.js

@@ -1,11 +1,67 @@
 import { Command } from "commander";
 import { createExampleText, getContext, wrapAction, } from "../commandHelpers.js";
+import { CliError, EXIT_CODES, HttpError } from "../errors.js";
 import { request } from "../http.js";
 import { renderJson, renderRichText } from "../renderers.js";
 import { buildRuntime } from "../runtime.js";
 import * as ui from "../ui.js";
 export function teamsCommand() {
     const teams = new Command().name("teams").description("Manage DX teams");
+    teams
+        .command("findByMembers")
+        .description("Find a team by member email addresses")
+        .option("--team-emails <emails>", "Comma-separated list of team member email addresses")
+        .addHelpText("afterAll", createExampleText([
+        {
+            label: "Find the team for a group of members",
+            command: "dx teams findByMembers --team-emails person@example.com,another@example.com",
+        },
+        {
+            label: "Find a team and return JSON",
+            command: "dx --json teams findByMembers --team-emails person@example.com,another@example.com",
+        },
+    ]))
+        .action(wrapAction(async (options, command) => {
+        const teamEmails = parseTeamEmails(options.teamEmails);
+        const runtime = buildRuntime(getContext(command));
+        const response = await findTeamByMembers(runtime, teamEmails);
+        if (runtime.context.json) {
+            renderJson(response);
+        }
+        else {
+            renderTeamByMembers(response.team);
+        }
+    }));
+    teams
+        .command("info")
+        .description("Retrieve details for an individual team")
+        .option("--team-id <id>", "DX team ID")
+        .option("--reference-id <id>", "Team ID that is internal to your organization")
+        .addHelpText("afterAll", createExampleText([
+        {
+            label: "Fetch info for a team by DX team ID",
+            command: "dx teams info --team-id NTA4Nzc",
+        },
+        {
+            label: "Fetch info for a team by your organization's reference ID",
+            command: "dx teams info --reference-id 06BEC4E0-5A61-354E-08A6-C39D756058AB",
+        },
+        {
+            label: "Fetch team info and return JSON",
+            command: "dx --json teams info --team-id NTA4Nzc",
+        },
+    ]))
+        .action(wrapAction(async (options, command) => {
+        const lookup = parseTeamInfoLookup(options);
+        const runtime = buildRuntime(getContext(command));
+        const response = await getTeamInfo(runtime, lookup);
+        if (runtime.context.json) {
+            renderJson(response);
+        }
+        else {
+            renderTeamInfo(response.team);
+        }
+    }));
     teams
         .command("list")
         .description("List all teams in DX")
@@ -31,12 +87,74 @@ export function teamsCommand() {
     }));
     return teams;
 }
+async function findTeamByMembers(runtime, teamEmails) {
+    try {
+        const response = await request(runtime, "/teams.findByMembers", {
+            method: "GET",
+            query: { team_emails: teamEmails },
+        });
+        return response.body;
+    }
+    catch (error) {
+        if (runtime.context.json) {
+            throw error;
+        }
+        throw buildFindByMembersError(error, teamEmails);
+    }
+}
+async function getTeamInfo(runtime, lookup) {
+    const response = await request(runtime, "/teams.info", {
+        method: "GET",
+        query: lookup,
+    });
+    return response.body;
+}
 async function listTeams(runtime) {
     const response = await request(runtime, "/teams.list", {
         method: "GET",
     });
     return response.body;
 }
+function renderTeamByMembers(team) {
+    const blocks = [
+        ui.h1("Team"),
+        ui.h2(`${team.name} (${ui.code(team.id)})`),
+        ui.dl([
+            ui.dli("Manager", formatTeamMember(team.manager)),
+            ui.dli("Members", team.members.length > 0
+                ? [
+                    ui.ul(team.members.map((member) => ui.li(formatTeamMember(member)))),
+                ]
+                : ui.dim("(None)")),
+        ], { termWidth: 8 }),
+    ];
+    renderRichText(blocks);
+}
+function renderTeamInfo(team) {
+    const blocks = [ui.h1("Team Information")];
+    const heading = formatTeamHeading(team);
+    if (heading) {
+        blocks.push(ui.h2(heading));
+    }
+    const details = [];
+    pushDetail(details, "ID", formatText(team.id), team.id !== undefined);
+    pushDetail(details, "Name", team.name ?? ui.dim("(None)"), team.name !== undefined);
+    pushDetail(details, "Reference ID", formatText(team.reference_id), team.reference_id !== undefined);
+    pushDetail(details, "Parent ID", formatText(team.parent_id), team.parent_id !== undefined);
+    pushDetail(details, "Manager ID", formatText(team.manager_id), team.manager_id !== undefined);
+    pushDetail(details, "Parent team", typeof team.parent === "boolean" ? (team.parent ? "Yes" : "No") : "", team.parent !== undefined);
+    pushDetail(details, "Last changed", team.last_changed_at
+        ? ui.timestampSummary(team.last_changed_at)
+        : ui.dim("(None)"), team.last_changed_at !== undefined);
+    pushDetail(details, "Lead", formatTeamMember(team.lead), team.lead !== undefined);
+    pushDetail(details, "Manager", formatTeamMember(team.manager), team.manager !== undefined);
+    if (details.length > 0) {
+        blocks.push(ui.dl(details, { termWidth: 14 }));
+    }
+    blocks.push(ui.h2("Contributors"));
+    blocks.push(formatTeamMemberList(team.contributors));
+    renderRichText(blocks);
+}
 function renderTeams(teams) {
     const blocks = [ui.h1("Teams")];
     blocks.push(ui.p(`Displaying ${ui.bold(teams.length.toString())} teams.`));
@@ -67,3 +185,83 @@ function renderTeams(teams) {
 function formatText(value) {
     return value ? ui.code(value) : ui.dim("(None)");
 }
+function formatTeamHeading(team) {
+    if (team.name && team.id) {
+        return `${team.name} (${ui.code(team.id)})`;
+    }
+    if (team.name) {
+        return team.name;
+    }
+    if (team.id) {
+        return ui.code(team.id);
+    }
+    if (team.reference_id) {
+        return ui.code(team.reference_id);
+    }
+    return null;
+}
+function formatTeamMember(member) {
+    if (!member) {
+        return ui.dim("(None)");
+    }
+    return `${member.name} <${member.email}> (${ui.code(member.id)})`;
+}
+function formatTeamMemberList(members) {
+    if (!members || members.length === 0) {
+        return ui.p(ui.dim("(None)"));
+    }
+    return ui.ul(members.map((member) => ui.li(formatTeamMember(member))));
+}
+function pushDetail(details, term, value, shouldInclude) {
+    if (shouldInclude) {
+        details.push(ui.dli(term, value));
+    }
+}
+function parseTeamInfoLookup(options) {
+    const teamId = parseOptionalTextOption(options.teamId);
+    const referenceId = parseOptionalTextOption(options.referenceId);
+    if (!teamId && !referenceId) {
+        throw new CliError("One of --team-id or --reference-id is required", EXIT_CODES.ARGUMENT_ERROR);
+    }
+    if (teamId && referenceId) {
+        throw new CliError("--team-id and --reference-id are mutually exclusive", EXIT_CODES.ARGUMENT_ERROR);
+    }
+    return teamId ? { team_id: teamId } : { reference_id: referenceId };
+}
+function parseOptionalTextOption(value) {
+    if (typeof value !== "string") {
+        return undefined;
+    }
+    const trimmed = value.trim();
+    return trimmed.length > 0 ? trimmed : undefined;
+}
+function parseTeamEmails(value) {
+    if (typeof value !== "string") {
+        throw new CliError("--team-emails is required", EXIT_CODES.ARGUMENT_ERROR);
+    }
+    const emails = value
+        .split(",")
+        .map((email) => email.trim())
+        .filter((email) => email.length > 0);
+    if (emails.length === 0) {
+        throw new CliError("--team-emails must include at least one email address", EXIT_CODES.ARGUMENT_ERROR);
+    }
+    return emails.join(",");
+}
+function buildFindByMembersError(error, teamEmails) {
+    if (!(error instanceof HttpError)) {
+        return error instanceof Error ? error : new Error(String(error));
+    }
+    const apiError = getApiErrorCode(error.body);
+    if (apiError === "no_users_found") {
+        return new CliError(`No active DX users were found for the provided email addresses: ${teamEmails}.\n\nCheck the spelling and make sure these users exist and are active in the DX account for your API token.`, EXIT_CODES.ARGUMENT_ERROR);
+    }
+    return error;
+}
+function getApiErrorCode(body) {
+    if (!body || typeof body !== "object") {
+        return undefined;
+    }
+    const error = body.error;
+    return typeof error === "string" ? error : undefined;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@get-dx/cli",
-  "version": "0.1.5",
+  "version": "0.1.7",
   "description": "DX CLI",
   "author": "DX <developers@getdx.com>",
   "bugs": {