automate.ax 0.1.3

package/dist/cli/commands/org-invite.js

@@ -0,0 +1,66 @@
+import { log } from "@clack/prompts";
+import { defineCommand } from "citty";
+import z from "zod";
+import { commandNames } from "../command-names.js";
+import { apiClient } from "../lib/api-client.js";
+import { createCommandRun, ORG_OPT, orgOptsSchema, output, promptableOption, requireAuthenticatedSession, safelyPromptTextWithValidation, sessionIntro, useOrganization, } from "../utils.js";
+import { accent, dimmed } from "../lib/io.js";
+import { clearSpinner, startSpinner, withSpinner } from "../lib/spinner.js";
+/** Organization roles assignable through an invitation. */
+const roles = ["member", "admin", "owner"];
+/** Arguments accepted by the organization invitation command. */
+const inviteOrgOptsSchema = orgOptsSchema.extend({
+    email: promptableOption(z.email(), "email"),
+    role: z.enum(roles).default("member"),
+});
+export const orgInviteCommand = defineCommand({
+    meta: {
+        name: commandNames.org.invite,
+        description: "Invite a member to an organization",
+    },
+    args: {
+        email: {
+            type: "positional",
+            description: "Email address to invite",
+            required: false,
+        },
+        role: {
+            type: "enum",
+            options: [...roles],
+            description: `Role to assign (${roles.join(", ")})`,
+            alias: ["r"],
+            default: "member",
+        },
+        ...ORG_OPT,
+    },
+    run: createCommandRun(inviteOrgOptsSchema, inviteMember),
+});
+/**
+ * Invites a user to the resolved organization by email.
+ *
+ * @param opts - Validated organization, email, and role options.
+ * @throws When the organization's seat limit has been reached.
+ */
+export async function inviteMember(opts) {
+    const session = await requireAuthenticatedSession("invite organization members");
+    output.normal(() => sessionIntro(session));
+    const org = await useOrganization(opts, { whenEmpty: "prompt-create" });
+    if (!(await withSpinner("Checking seat limit", () => apiClient.org.canInvite({ organizationId: org.id })))) {
+        throw new Error(`Seat limit reached. Run \`${commandNames.root} ${commandNames.org.root} ${commandNames.org.upgrade} -o ${org.id}\` to add more members.`);
+    }
+    const email = opts.email ??
+        (await safelyPromptTextWithValidation({
+            message: "Who should we invite?",
+            placeholder: "john@example.com",
+        }, z.email(), "email"));
+    startSpinner(`Inviting ${accent(email)}`);
+    const invitation = await apiClient.org.invite({
+        email,
+        role: opts.role,
+        organizationId: org.id,
+    });
+    clearSpinner();
+    output
+        .normal(() => log.success(`Invited ${accent(email)} as ${dimmed(opts.role)} to ${accent(org.name)}`))
+        .json(invitation);
+}

package/dist/cli/commands/org-leave.d.ts

@@ -0,0 +1,27 @@
+import z from "zod";
+/** Arguments accepted by the organization leave command. */
+declare const leaveOrgOptsSchema: z.ZodObject<{
+    org: z.ZodOptional<z.ZodString>;
+    yes: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strip>;
+export declare const orgLeaveCommand: import("citty").CommandDef<{
+    readonly yes: {
+        readonly type: "boolean";
+        readonly description: "Skip confirmation prompt";
+        readonly alias: ["y"];
+        readonly default: false;
+    };
+    readonly org: {
+        type: "string";
+        description: string;
+        alias: string[];
+    };
+}>;
+/**
+ * Removes the current user from the resolved organization.
+ *
+ * @param opts - Validated organization selector and confirmation options.
+ */
+export declare function leaveOrganization(opts: z.infer<typeof leaveOrgOptsSchema>): Promise<void>;
+export {};
+//# sourceMappingURL=org-leave.d.ts.map

package/dist/cli/commands/org-leave.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"org-leave.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/org-leave.ts"],"names":[],"mappings":"AAEA,OAAO,CAAC,MAAM,KAAK,CAAA;AAgBnB,4DAA4D;AAC5D,QAAA,MAAM,kBAAkB;;;iBAEtB,CAAA;AAEF,eAAO,MAAM,eAAe;;;;;;;;;;;;EAe1B,CAAA;AAEF;;;;GAIG;AACH,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,iBAgCzC"}

package/dist/cli/commands/org-leave.js

@@ -0,0 +1,56 @@
+import { confirm, log } from "@clack/prompts";
+import { defineCommand } from "citty";
+import z from "zod";
+import { commandNames } from "../command-names.js";
+import { apiClient } from "../lib/api-client.js";
+import { createCommandRun, ORG_OPT, orgOptsSchema, output, safelyPrompt, sessionIntro, useOrganization, useSession, } from "../utils.js";
+import { accent } from "../lib/io.js";
+import { clearSpinner, startSpinner } from "../lib/spinner.js";
+/** Arguments accepted by the organization leave command. */
+const leaveOrgOptsSchema = orgOptsSchema.extend({
+    yes: z.boolean().default(false),
+});
+export const orgLeaveCommand = defineCommand({
+    meta: {
+        name: commandNames.org.leave,
+        description: "Leave an organization",
+    },
+    args: {
+        ...ORG_OPT,
+        yes: {
+            type: "boolean",
+            description: "Skip confirmation prompt",
+            alias: ["y"],
+            default: false,
+        },
+    },
+    run: createCommandRun(leaveOrgOptsSchema, leaveOrganization),
+});
+/**
+ * Removes the current user from the resolved organization.
+ *
+ * @param opts - Validated organization selector and confirmation options.
+ */
+export async function leaveOrganization(opts) {
+    const session = await useSession();
+    output.normal(() => sessionIntro(session));
+    const org = await useOrganization(opts);
+    if (!opts.yes) {
+        if (!(await safelyPrompt(() => confirm({
+            message: `Are you sure you want to leave ${accent(org.name)}?`,
+            initialValue: false,
+        }), "--yes"))) {
+            output.json({ cancelled: true });
+            return;
+        }
+    }
+    startSpinner("Leaving organization");
+    await apiClient.org.leave({ organizationId: org.id });
+    clearSpinner();
+    output
+        .normal(() => log.success(`Left ${accent(org.name)}`))
+        .json({
+        left: true,
+        organization: org,
+    });
+}

package/dist/cli/commands/org-list.d.ts

@@ -0,0 +1,4 @@
+export declare const orgListCommand: import("citty").CommandDef<import("citty").ArgsDef>;
+/** Lists organizations for the current session, including the user's role. */
+export declare function listOrganizations(): Promise<void>;
+//# sourceMappingURL=org-list.d.ts.map

package/dist/cli/commands/org-list.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"org-list.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/org-list.ts"],"names":[],"mappings":"AAgBA,eAAO,MAAM,cAAc,qDAMzB,CAAA;AAEF,8EAA8E;AAC9E,wBAAsB,iBAAiB,kBA0BtC"}

package/dist/cli/commands/org-list.js

@@ -0,0 +1,36 @@
+import { log } from "@clack/prompts";
+import { defineCommand } from "citty";
+import { commandNames } from "../command-names.js";
+import { apiClient } from "../lib/api-client.js";
+import { createCommandRun, output, pluralize, sessionIntro, useSession, } from "../utils.js";
+import { accent } from "../lib/io.js";
+import { renderOrganizationDetailBlock } from "../lib/organization-detail-block.js";
+import { clearSpinner, startSpinner } from "../lib/spinner.js";
+export const orgListCommand = defineCommand({
+    meta: {
+        name: commandNames.org.list,
+        description: "List all organizations",
+    },
+    run: createCommandRun(null, listOrganizations),
+});
+/** Lists organizations for the current session, including the user's role. */
+export async function listOrganizations() {
+    const session = await useSession();
+    output.normal(() => sessionIntro(session));
+    startSpinner("Fetching organizations");
+    const organizations = await apiClient.org.list();
+    clearSpinner();
+    output
+        .normal(() => {
+        if (organizations.length === 0) {
+            log.warn("You don't belong to any organizations.");
+            return;
+        }
+        log.message(`${accent(organizations.length)} ${pluralize(organizations.length, "organization")}`);
+        for (const org of organizations) {
+            log.info(renderOrganizationDetailBlock(org, { includeRole: true }));
+        }
+        log.message();
+    })
+        .json(organizations);
+}

package/dist/cli/commands/org-remove.d.ts

@@ -0,0 +1,33 @@
+import z from "zod";
+/** Arguments accepted by the organization member removal command. */
+declare const removeOrgOptsSchema: z.ZodObject<{
+    org: z.ZodOptional<z.ZodString>;
+    member: z.ZodPrefault<z.ZodNullable<z.ZodString>>;
+    yes: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strip>;
+export declare const orgRemoveCommand: import("citty").CommandDef<{
+    readonly org: {
+        type: "string";
+        description: string;
+        alias: string[];
+    };
+    readonly member: {
+        readonly type: "positional";
+        readonly description: "Email or member ID to remove";
+        readonly required: false;
+    };
+    readonly yes: {
+        readonly type: "boolean";
+        readonly description: "Skip confirmation prompt";
+        readonly alias: ["y"];
+        readonly default: false;
+    };
+}>;
+/**
+ * Removes a member from the resolved organization.
+ *
+ * @param opts - Validated organization, member, and confirmation options.
+ */
+export declare function removeMember(opts: z.infer<typeof removeOrgOptsSchema>): Promise<void>;
+export {};
+//# sourceMappingURL=org-remove.d.ts.map

package/dist/cli/commands/org-remove.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"org-remove.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/org-remove.ts"],"names":[],"mappings":"AAEA,OAAO,CAAC,MAAM,KAAK,CAAA;AAkBnB,qEAAqE;AACrE,QAAA,MAAM,mBAAmB;;;;iBAGvB,CAAA;AAEF,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;EAoB3B,CAAA;AAEF;;;;GAIG;AACH,wBAAsB,YAAY,CAAC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,iBA6C3E"}

package/dist/cli/commands/org-remove.js

@@ -0,0 +1,66 @@
+import { confirm, log } from "@clack/prompts";
+import { defineCommand } from "citty";
+import z from "zod";
+import { commandNames } from "../command-names.js";
+import { apiClient } from "../lib/api-client.js";
+import { createCommandRun, ORG_OPT, orgOptsSchema, output, promptableOption, requireAuthenticatedSession, safelyPrompt, safelyPromptTextWithValidation, sessionIntro, useOrganization, } from "../utils.js";
+import { accent } from "../lib/io.js";
+import { clearSpinner, startSpinner } from "../lib/spinner.js";
+/** Arguments accepted by the organization member removal command. */
+const removeOrgOptsSchema = orgOptsSchema.extend({
+    member: promptableOption(z.string().min(1), "member"),
+    yes: z.boolean().default(false),
+});
+export const orgRemoveCommand = defineCommand({
+    meta: {
+        name: commandNames.org.remove,
+        description: "Remove a member from an organization",
+    },
+    args: {
+        member: {
+            type: "positional",
+            description: "Email or member ID to remove",
+            required: false,
+        },
+        yes: {
+            type: "boolean",
+            description: "Skip confirmation prompt",
+            alias: ["y"],
+            default: false,
+        },
+        ...ORG_OPT,
+    },
+    run: createCommandRun(removeOrgOptsSchema, removeMember),
+});
+/**
+ * Removes a member from the resolved organization.
+ *
+ * @param opts - Validated organization, member, and confirmation options.
+ */
+export async function removeMember(opts) {
+    const session = await requireAuthenticatedSession("remove organization members");
+    output.normal(() => sessionIntro(session));
+    const org = await useOrganization(opts);
+    const member = opts.member ??
+        (await safelyPromptTextWithValidation({
+            message: "Which member should we remove?",
+        }, z.string().min(1), "member"));
+    if (!opts.yes) {
+        if (!(await safelyPrompt(() => confirm({
+            message: `Remove ${accent(member)} from ${accent(org.name)}?`,
+            initialValue: false,
+        }), "--yes"))) {
+            output.json({ cancelled: true });
+            return;
+        }
+    }
+    startSpinner(`Removing ${accent(member)}`);
+    await apiClient.org.remove({
+        memberIdOrEmail: member,
+        organizationId: org.id,
+    });
+    clearSpinner();
+    output
+        .normal(() => log.success(`Removed ${accent(member)} from ${accent(org.name)}`))
+        .json({ removed: true, member, organization: org });
+}

package/dist/cli/commands/org-rename.d.ts

@@ -0,0 +1,26 @@
+import z from "zod";
+/** Arguments accepted by the organization rename command. */
+declare const renameOrgOptsSchema: z.ZodObject<{
+    org: z.ZodOptional<z.ZodString>;
+    name: z.ZodPrefault<z.ZodNullable<z.ZodString>>;
+}, z.core.$strip>;
+export declare const orgRenameCommand: import("citty").CommandDef<{
+    readonly name: {
+        readonly type: "string";
+        readonly description: "New name for the organization";
+        readonly alias: ["n"];
+    };
+    readonly org: {
+        type: "string";
+        description: string;
+        alias: string[];
+    };
+}>;
+/**
+ * Renames an organization without changing its internal authentication slug.
+ *
+ * @param opts - Validated organization selector and optional new name.
+ */
+export declare function renameOrganization(opts: z.infer<typeof renameOrgOptsSchema>): Promise<void>;
+export {};
+//# sourceMappingURL=org-rename.d.ts.map

package/dist/cli/commands/org-rename.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"org-rename.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/org-rename.ts"],"names":[],"mappings":"AAEA,OAAO,CAAC,MAAM,KAAK,CAAA;AAkBnB,6DAA6D;AAC7D,QAAA,MAAM,mBAAmB;;;iBAEvB,CAAA;AAEF,eAAO,MAAM,gBAAgB;;;;;;;;;;;EAc3B,CAAA;AAEF;;;;GAIG;AACH,wBAAsB,kBAAkB,CACtC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,iBAoB1C"}

package/dist/cli/commands/org-rename.js

@@ -0,0 +1,58 @@
+import { log } from "@clack/prompts";
+import { defineCommand } from "citty";
+import { commandNames } from "../command-names.js";
+import { apiClient } from "../lib/api-client.js";
+import { createCommandRun, ORG_OPT, orgOptsSchema, output, promptableOption, REASONABLE_NAME_SCHEMA, requireAuthenticatedSession, safelyPromptTextWithValidation, sessionIntro, useOrganization, } from "../utils.js";
+import { accent, dimmed } from "../lib/io.js";
+import { clearSpinner, startSpinner } from "../lib/spinner.js";
+/** Arguments accepted by the organization rename command. */
+const renameOrgOptsSchema = orgOptsSchema.extend({
+    name: promptableOption(REASONABLE_NAME_SCHEMA, "--name"),
+});
+export const orgRenameCommand = defineCommand({
+    meta: {
+        name: commandNames.org.rename,
+        description: "Rename an organization",
+    },
+    args: {
+        ...ORG_OPT,
+        name: {
+            type: "string",
+            description: "New name for the organization",
+            alias: ["n"],
+        },
+    },
+    run: createCommandRun(renameOrgOptsSchema, renameOrganization),
+});
+/**
+ * Renames an organization without changing its internal authentication slug.
+ *
+ * @param opts - Validated organization selector and optional new name.
+ */
+export async function renameOrganization(opts) {
+    const session = await requireAuthenticatedSession("rename an organization");
+    output.normal(() => sessionIntro(session));
+    const org = await useOrganization(opts);
+    const newName = opts.name ?? (await promptName(org.name));
+    startSpinner("Renaming organization");
+    await apiClient.org.update({
+        organizationId: org.id,
+        name: newName,
+    });
+    clearSpinner();
+    output
+        .normal(() => log.success(`Renamed ${dimmed(org.name)} to ${accent(newName)}`))
+        .json({ ...org, name: newName });
+}
+/**
+ * Prompts for and validates a replacement organization name.
+ *
+ * @param currentName - Current organization name used as the prompt default.
+ */
+async function promptName(currentName) {
+    return await safelyPromptTextWithValidation({
+        message: "What should the new organization name be?",
+        placeholder: currentName,
+        defaultValue: currentName,
+    }, REASONABLE_NAME_SCHEMA, "--name");
+}

package/dist/cli/commands/org-show.d.ts

@@ -0,0 +1,16 @@
+import z from "zod";
+import { orgOptsSchema } from "../utils.js";
+export declare const orgShowCommand: import("citty").CommandDef<{
+    readonly org: {
+        type: "string";
+        description: string;
+        alias: string[];
+    };
+}>;
+/**
+ * Displays details for a resolved organization.
+ *
+ * @param opts - Validated options selecting the organization.
+ */
+export declare function showOrganization(opts: z.infer<typeof orgOptsSchema>): Promise<void>;
+//# sourceMappingURL=org-show.d.ts.map

package/dist/cli/commands/org-show.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"org-show.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/org-show.ts"],"names":[],"mappings":"AAEA,OAAO,CAAC,MAAM,KAAK,CAAA;AAMnB,OAAO,EAGL,aAAa,EAKd,oBAAgB;AAEjB,eAAO,MAAM,cAAc;;;;;;EASzB,CAAA;AAEF;;;;GAIG;AACH,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,iBAuCzE"}

package/dist/cli/commands/org-show.js

@@ -0,0 +1,48 @@
+import { log } from "@clack/prompts";
+import { defineCommand } from "citty";
+import { commandNames } from "../command-names.js";
+import { apiClient } from "../lib/api-client.js";
+import { dimmed } from "../lib/io.js";
+import { renderOrganizationDetailBlock } from "../lib/organization-detail-block.js";
+import { clearSpinner, startSpinner } from "../lib/spinner.js";
+import { createCommandRun, ORG_OPT, orgOptsSchema, output, sessionIntro, useOrganization, useSession, } from "../utils.js";
+export const orgShowCommand = defineCommand({
+    meta: {
+        name: commandNames.org.show,
+        description: "Show organization details",
+    },
+    args: {
+        ...ORG_OPT,
+    },
+    run: createCommandRun(orgOptsSchema, showOrganization),
+});
+/**
+ * Displays details for a resolved organization.
+ *
+ * @param opts - Validated options selecting the organization.
+ */
+export async function showOrganization(opts) {
+    const session = await useSession();
+    output.normal(() => sessionIntro(session));
+    const { id: organizationId } = await useOrganization(opts);
+    startSpinner("Fetching details");
+    const org = await apiClient.org.get({ organizationId });
+    clearSpinner();
+    output
+        .normal(() => {
+        const pendingInvites = org.invitations.filter((i) => i.status === "pending");
+        log.info(renderOrganizationDetailBlock(org));
+        log.message([
+            `Members (${org.members.length}):`,
+            ...org.members.map((m) => `  ${m.email.startsWith("temp@") ? "Anonymous" : m.email}${m.userId === session.user.id ? dimmed ` (you)` : ""} - ${dimmed(m.role)}`),
+        ].join("\n"));
+        if (pendingInvites.length > 0) {
+            log.message([
+                `Pending invitations (${pendingInvites.length}):`,
+                ...pendingInvites.map((i) => `  ${i.email} - ${dimmed(i.role)}`),
+            ].join("\n"));
+        }
+        log.message();
+    })
+        .json(org);
+}

package/dist/cli/commands/org-upgrade.d.ts

@@ -0,0 +1,42 @@
+import z from "zod";
+import { useOrganization } from "../utils.js";
+/** Arguments accepted by the organization upgrade command. */
+declare const upgradeOrgOptsSchema: z.ZodObject<{
+    org: z.ZodOptional<z.ZodString>;
+    plan: z.ZodOptional<z.ZodEnum<{
+        pro: "pro";
+        enterprise: "enterprise";
+    }>>;
+}, z.core.$strip>;
+type ResolvedOrganization = Awaited<ReturnType<typeof useOrganization>>;
+export declare const orgUpgradeCommand: import("citty").CommandDef<{
+    readonly plan: {
+        readonly type: "enum";
+        readonly options: ["pro", "enterprise"];
+        readonly description: "Plan to upgrade to";
+        readonly alias: ["p"];
+    };
+    readonly org: {
+        type: "string";
+        description: string;
+        alias: string[];
+    };
+}>;
+/**
+ * Starts Checkout for Pro or prints Enterprise contact details.
+ *
+ * @param opts - Validated organization and target plan options.
+ * @param options - Presentation options for callers composing CLI flows.
+ * @param options.printSessionIntro - Whether to print the authenticated user.
+ */
+export declare function upgradeOrganization(opts: z.infer<typeof upgradeOrgOptsSchema>, options?: {
+    printSessionIntro?: boolean;
+}): Promise<void>;
+/**
+ * Prints and opens the Enterprise upgrade mailto link.
+ *
+ * @param org - Organization whose details should prefill the message.
+ */
+export declare function printEnterpriseContact(org: ResolvedOrganization): void;
+export {};
+//# sourceMappingURL=org-upgrade.d.ts.map

package/dist/cli/commands/org-upgrade.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"org-upgrade.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/org-upgrade.ts"],"names":[],"mappings":"AAIA,OAAO,CAAC,MAAM,KAAK,CAAA;AAInB,OAAO,EAOL,eAAe,EAChB,oBAAgB;AASjB,8DAA8D;AAC9D,QAAA,MAAM,oBAAoB;;;;;;iBAExB,CAAA;AAEF,KAAK,oBAAoB,GAAG,OAAO,CAAC,UAAU,CAAC,OAAO,eAAe,CAAC,CAAC,CAAA;AAEvE,eAAO,MAAM,iBAAiB;;;;;;;;;;;;EAe5B,CAAA;AAEF;;;;;;GAMG;AACH,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,EAC1C,OAAO,GAAE;IAAE,iBAAiB,CAAC,EAAE,OAAO,CAAA;CAAO,iBAqF9C;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,oBAAoB,QAqB/D"}