@barekey/cli 0.4.0 → 0.5.1

package/dist/commands/stage.js

@@ -0,0 +1,125 @@
+import { cancel, confirm, isCancel, text } from "@clack/prompts";
+import { toJsonOutput } from "../command-utils.js";
+import { createStageForProject, deleteStageForProject, listStagesForProject, promptForOrganizationSlug, promptForProjectSlug, promptForStageSlug, renameStageForProject, } from "./target-prompts.js";
+async function promptForStageName(name) {
+    const existing = name?.trim();
+    if (existing && existing.length > 0) {
+        return existing;
+    }
+    if (!process.stdout.isTTY) {
+        throw new Error("Stage name is required in non-interactive mode.");
+    }
+    const prompted = await text({
+        message: "What’s the name of this stage?",
+        validate: (value) => (value.trim().length > 0 ? undefined : "Stage name is required."),
+    });
+    if (isCancel(prompted)) {
+        cancel("Command canceled.");
+        process.exit(0);
+    }
+    return prompted.trim();
+}
+async function runStageList(options) {
+    const orgSlug = await promptForOrganizationSlug(options.org);
+    const projectSlug = await promptForProjectSlug(orgSlug, options.project);
+    const stages = await listStagesForProject(orgSlug, projectSlug);
+    if (options.json) {
+        toJsonOutput(true, stages);
+        return;
+    }
+    if (stages.length === 0) {
+        console.log("No stages found.");
+        return;
+    }
+    for (const stage of stages) {
+        console.log(`${stage.name} (${stage.slug}) variables=${stage.variableCount}`);
+    }
+}
+async function runStageCreate(name, options) {
+    const orgSlug = await promptForOrganizationSlug(options.org);
+    const projectSlug = await promptForProjectSlug(orgSlug, options.project);
+    const stageName = await promptForStageName(name);
+    const stage = await createStageForProject(orgSlug, projectSlug, stageName);
+    if (options.json) {
+        toJsonOutput(true, stage);
+        return;
+    }
+    console.log(`Created stage ${stage.name} (${stage.slug}).`);
+}
+export function registerStageCommands(program) {
+    const stage = program.command("stage").description("Stage management");
+    stage
+        .command("list")
+        .description("List stages in a project")
+        .option("--org <slug>", "Organization slug")
+        .option("--project <slug>", "Project slug")
+        .option("--json", "Machine-readable output", false)
+        .action(async (options) => {
+        await runStageList(options);
+    });
+    stage
+        .command("create")
+        .description("Create a stage")
+        .argument("[name]", "Stage name")
+        .option("--org <slug>", "Organization slug")
+        .option("--project <slug>", "Project slug")
+        .option("--json", "Machine-readable output", false)
+        .action(async (name, options) => {
+        await runStageCreate(name, options);
+    });
+    stage
+        .command("rename")
+        .description("Rename a stage")
+        .argument("[slug]", "Stage slug")
+        .argument("[name]", "New stage display name")
+        .option("--org <slug>", "Organization slug")
+        .option("--project <slug>", "Project slug")
+        .option("--json", "Machine-readable output", false)
+        .action(async (slug, name, options) => {
+        const orgSlug = await promptForOrganizationSlug(options.org);
+        const projectSlug = await promptForProjectSlug(orgSlug, options.project);
+        const stageSlug = await promptForStageSlug(orgSlug, projectSlug, slug);
+        const stageName = await promptForStageName(name);
+        const stage = await renameStageForProject(orgSlug, projectSlug, stageSlug, stageName);
+        if (options.json) {
+            toJsonOutput(true, stage);
+            return;
+        }
+        console.log(`Renamed stage ${stage.slug} to ${stage.name}.`);
+    });
+    stage
+        .command("delete")
+        .description("Delete a stage")
+        .argument("[slug]", "Stage slug")
+        .option("--org <slug>", "Organization slug")
+        .option("--project <slug>", "Project slug")
+        .option("--yes", "Skip confirmation prompt", false)
+        .option("--json", "Machine-readable output", false)
+        .action(async (slug, options) => {
+        const orgSlug = await promptForOrganizationSlug(options.org);
+        const projectSlug = await promptForProjectSlug(orgSlug, options.project);
+        const stageSlug = await promptForStageSlug(orgSlug, projectSlug, slug);
+        if (!options.yes) {
+            if (!process.stdout.isTTY) {
+                throw new Error("Stage deletion requires --yes in non-interactive mode.");
+            }
+            const confirmed = await confirm({
+                message: `Delete stage ${stageSlug}?`,
+                initialValue: false,
+            });
+            if (isCancel(confirmed)) {
+                cancel("Command canceled.");
+                process.exit(0);
+            }
+            if (!confirmed) {
+                throw new Error("Delete canceled.");
+            }
+        }
+        const response = await deleteStageForProject(orgSlug, projectSlug, stageSlug);
+        if (options.json) {
+            toJsonOutput(true, response);
+            return;
+        }
+        console.log(`Deleted stage ${response.deletedStageSlug}.`);
+    });
+}

package/dist/commands/target-prompts.d.ts

@@ -0,0 +1,184 @@
+/**
+ * Loads organizations for the current CLI user.
+ *
+ * @returns The accessible organizations for the signed-in user.
+ * @remarks Interactive command flows use this to avoid any hidden org-scoped auth fallback.
+ * @lastModified 2026-03-19
+ * @author GPT-5.4
+ */
+export declare function listOrganizationsForCurrentUser(): Promise<readonly {
+    readonly name: string;
+    readonly id: string;
+    readonly slug: string;
+    readonly role: string;
+    readonly imageUrl: string;
+}[]>;
+/**
+ * Loads projects for one organization.
+ *
+ * @param orgSlug The organization slug to inspect.
+ * @returns The projects for the organization.
+ * @remarks Project-scoped CLI flows call the same backend contract as `barekey init`.
+ * @lastModified 2026-03-19
+ * @author GPT-5.4
+ */
+export declare function listProjectsForOrganization(orgSlug: string): Promise<readonly {
+    readonly orgId: string;
+    readonly orgSlug: string;
+    readonly name: string;
+    readonly createdAtMs: number;
+    readonly updatedAtMs: number;
+    readonly id: string;
+    readonly slug: string;
+    readonly slugBase: string;
+    readonly createdByClerkUserId: string;
+    readonly secretCount: number;
+}[]>;
+/**
+ * Loads stages for one project.
+ *
+ * @param orgSlug The organization slug to inspect.
+ * @param projectSlug The project slug to inspect.
+ * @returns The stages for the selected project.
+ * @remarks Stage prompts use this to drive repo initialization and stage management flows.
+ * @lastModified 2026-03-19
+ * @author GPT-5.4
+ */
+export declare function listStagesForProject(orgSlug: string, projectSlug: string): Promise<readonly {
+    readonly orgId: string;
+    readonly name: string;
+    readonly createdAtMs: number;
+    readonly updatedAtMs: number;
+    readonly id: string;
+    readonly slug: string;
+    readonly projectId: string;
+    readonly isDefault: boolean;
+    readonly variableCount: number;
+}[]>;
+/**
+ * Creates one project for one organization.
+ *
+ * @param orgSlug The organization slug that should own the project.
+ * @param name The project name to create.
+ * @returns The created project summary.
+ * @remarks CLI project-create flows use this helper so the command stays a thin prompt wrapper.
+ * @lastModified 2026-03-19
+ * @author GPT-5.4
+ */
+export declare function createProjectForOrganization(orgSlug: string, name: string): Promise<{
+    readonly orgId: string;
+    readonly orgSlug: string;
+    readonly name: string;
+    readonly createdAtMs: number;
+    readonly updatedAtMs: number;
+    readonly id: string;
+    readonly slug: string;
+    readonly slugBase: string;
+    readonly createdByClerkUserId: string;
+}>;
+/**
+ * Deletes one project for one organization.
+ *
+ * @param orgSlug The organization slug that owns the project.
+ * @param projectSlug The project slug to delete.
+ * @returns The deleted project payload.
+ * @remarks Destructive project flows use this shared helper so command handlers stay focused on prompts and output.
+ * @lastModified 2026-03-19
+ * @author GPT-5.4
+ */
+export declare function deleteProjectForOrganization(orgSlug: string, projectSlug: string): Promise<{
+    readonly deletedProjectId: string;
+    readonly deletedProjectSlug: string;
+}>;
+/**
+ * Creates one stage for one project.
+ *
+ * @param orgSlug The organization slug that owns the project.
+ * @param projectSlug The project slug that should receive the stage.
+ * @param name The stage name to create.
+ * @returns The created stage summary.
+ * @remarks CLI stage-create flows use this helper so the command stays a thin prompt wrapper.
+ * @lastModified 2026-03-19
+ * @author GPT-5.4
+ */
+export declare function createStageForProject(orgSlug: string, projectSlug: string, name: string): Promise<{
+    readonly orgId: string;
+    readonly name: string;
+    readonly createdAtMs: number;
+    readonly updatedAtMs: number;
+    readonly id: string;
+    readonly slug: string;
+    readonly projectId: string;
+    readonly isDefault: boolean;
+    readonly variableCount: number;
+}>;
+/**
+ * Renames one stage for one project.
+ *
+ * @param orgSlug The organization slug that owns the project.
+ * @param projectSlug The project slug that owns the stage.
+ * @param stageSlug The stage slug to rename.
+ * @param name The next display name for the stage.
+ * @returns The updated stage summary.
+ * @remarks Stage rename keeps immutable slugs and only patches the display name.
+ * @lastModified 2026-03-19
+ * @author GPT-5.4
+ */
+export declare function renameStageForProject(orgSlug: string, projectSlug: string, stageSlug: string, name: string): Promise<{
+    readonly orgId: string;
+    readonly name: string;
+    readonly createdAtMs: number;
+    readonly updatedAtMs: number;
+    readonly id: string;
+    readonly slug: string;
+    readonly projectId: string;
+    readonly isDefault: boolean;
+    readonly variableCount: number;
+}>;
+/**
+ * Deletes one stage for one project.
+ *
+ * @param orgSlug The organization slug that owns the project.
+ * @param projectSlug The project slug that owns the stage.
+ * @param stageSlug The stage slug to delete.
+ * @returns The deleted stage payload.
+ * @remarks Destructive stage flows use this helper so command handlers stay prompt-focused.
+ * @lastModified 2026-03-19
+ * @author GPT-5.4
+ */
+export declare function deleteStageForProject(orgSlug: string, projectSlug: string, stageSlug: string): Promise<{
+    readonly deletedStageSlug: string;
+}>;
+/**
+ * Resolves one organization target from an explicit flag or an interactive selection.
+ *
+ * @param orgSlug The optionally supplied organization slug.
+ * @returns The resolved organization slug.
+ * @remarks Non-interactive runs must provide the target explicitly or via local repo config higher up the call stack.
+ * @lastModified 2026-03-19
+ * @author GPT-5.4
+ */
+export declare function promptForOrganizationSlug(orgSlug: string | undefined): Promise<string>;
+/**
+ * Resolves one project target from an explicit flag or an interactive selection.
+ *
+ * @param orgSlug The owning organization slug.
+ * @param projectSlug The optionally supplied project slug.
+ * @returns The resolved project slug.
+ * @remarks This intentionally loads live project choices instead of guessing from auth state.
+ * @lastModified 2026-03-19
+ * @author GPT-5.4
+ */
+export declare function promptForProjectSlug(orgSlug: string, projectSlug: string | undefined): Promise<string>;
+/**
+ * Resolves one stage target from an explicit flag or an interactive selection.
+ *
+ * @param orgSlug The owning organization slug.
+ * @param projectSlug The owning project slug.
+ * @param stageSlug The optionally supplied stage slug.
+ * @returns The resolved stage slug.
+ * @remarks This is used by `barekey init` so local repo setup can be a guided flow.
+ * @lastModified 2026-03-19
+ * @author GPT-5.4
+ */
+export declare function promptForStageSlug(orgSlug: string, projectSlug: string, stageSlug: string | undefined): Promise<string>;

package/dist/commands/target-prompts.js

@@ -0,0 +1,312 @@
+import { cancel, isCancel, select } from "@clack/prompts";
+import { createCliAuthProvider } from "../auth-provider.js";
+import { requireLocalSession } from "../command-utils.js";
+import { OrganizationsResponseSchema, ProjectCreateResponseSchema, ProjectDeleteResponseSchema, ProjectsListResponseSchema, StageCreateResponseSchema, StageDeleteResponseSchema, StageRenameResponseSchema, StagesListResponseSchema, } from "../contracts/index.js";
+import { getJson, postJson } from "../http.js";
+async function resolveManagementAccess() {
+    const local = await requireLocalSession();
+    const authProvider = createCliAuthProvider();
+    const accessToken = await authProvider.getAccessToken();
+    return {
+        local,
+        accessToken,
+    };
+}
+/**
+ * Loads organizations for the current CLI user.
+ *
+ * @returns The accessible organizations for the signed-in user.
+ * @remarks Interactive command flows use this to avoid any hidden org-scoped auth fallback.
+ * @lastModified 2026-03-19
+ * @author GPT-5.4
+ */
+export async function listOrganizationsForCurrentUser() {
+    const { local, accessToken } = await resolveManagementAccess();
+    const response = await getJson({
+        baseUrl: local.baseUrl,
+        path: "/v1/cli/orgs",
+        accessToken,
+        schema: OrganizationsResponseSchema,
+    });
+    return response.organizations;
+}
+/**
+ * Loads projects for one organization.
+ *
+ * @param orgSlug The organization slug to inspect.
+ * @returns The projects for the organization.
+ * @remarks Project-scoped CLI flows call the same backend contract as `barekey init`.
+ * @lastModified 2026-03-19
+ * @author GPT-5.4
+ */
+export async function listProjectsForOrganization(orgSlug) {
+    const { local, accessToken } = await resolveManagementAccess();
+    const response = await postJson({
+        baseUrl: local.baseUrl,
+        path: "/v1/cli/projects/list",
+        accessToken,
+        payload: {
+            orgSlug,
+        },
+        schema: ProjectsListResponseSchema,
+    });
+    return response.projects;
+}
+/**
+ * Loads stages for one project.
+ *
+ * @param orgSlug The organization slug to inspect.
+ * @param projectSlug The project slug to inspect.
+ * @returns The stages for the selected project.
+ * @remarks Stage prompts use this to drive repo initialization and stage management flows.
+ * @lastModified 2026-03-19
+ * @author GPT-5.4
+ */
+export async function listStagesForProject(orgSlug, projectSlug) {
+    const { local, accessToken } = await resolveManagementAccess();
+    const response = await postJson({
+        baseUrl: local.baseUrl,
+        path: "/v1/cli/stages/list",
+        accessToken,
+        payload: {
+            orgSlug,
+            projectSlug,
+        },
+        schema: StagesListResponseSchema,
+    });
+    return response.stages;
+}
+/**
+ * Creates one project for one organization.
+ *
+ * @param orgSlug The organization slug that should own the project.
+ * @param name The project name to create.
+ * @returns The created project summary.
+ * @remarks CLI project-create flows use this helper so the command stays a thin prompt wrapper.
+ * @lastModified 2026-03-19
+ * @author GPT-5.4
+ */
+export async function createProjectForOrganization(orgSlug, name) {
+    const { local, accessToken } = await resolveManagementAccess();
+    const response = await postJson({
+        baseUrl: local.baseUrl,
+        path: "/v1/cli/projects/create",
+        accessToken,
+        payload: {
+            orgSlug,
+            name,
+        },
+        schema: ProjectCreateResponseSchema,
+    });
+    return response.project;
+}
+/**
+ * Deletes one project for one organization.
+ *
+ * @param orgSlug The organization slug that owns the project.
+ * @param projectSlug The project slug to delete.
+ * @returns The deleted project payload.
+ * @remarks Destructive project flows use this shared helper so command handlers stay focused on prompts and output.
+ * @lastModified 2026-03-19
+ * @author GPT-5.4
+ */
+export async function deleteProjectForOrganization(orgSlug, projectSlug) {
+    const { local, accessToken } = await resolveManagementAccess();
+    return await postJson({
+        baseUrl: local.baseUrl,
+        path: "/v1/cli/projects/delete",
+        accessToken,
+        payload: {
+            orgSlug,
+            projectSlug,
+        },
+        schema: ProjectDeleteResponseSchema,
+    });
+}
+/**
+ * Creates one stage for one project.
+ *
+ * @param orgSlug The organization slug that owns the project.
+ * @param projectSlug The project slug that should receive the stage.
+ * @param name The stage name to create.
+ * @returns The created stage summary.
+ * @remarks CLI stage-create flows use this helper so the command stays a thin prompt wrapper.
+ * @lastModified 2026-03-19
+ * @author GPT-5.4
+ */
+export async function createStageForProject(orgSlug, projectSlug, name) {
+    const { local, accessToken } = await resolveManagementAccess();
+    const response = await postJson({
+        baseUrl: local.baseUrl,
+        path: "/v1/cli/stages/create",
+        accessToken,
+        payload: {
+            orgSlug,
+            projectSlug,
+            name,
+        },
+        schema: StageCreateResponseSchema,
+    });
+    return response.stage;
+}
+/**
+ * Renames one stage for one project.
+ *
+ * @param orgSlug The organization slug that owns the project.
+ * @param projectSlug The project slug that owns the stage.
+ * @param stageSlug The stage slug to rename.
+ * @param name The next display name for the stage.
+ * @returns The updated stage summary.
+ * @remarks Stage rename keeps immutable slugs and only patches the display name.
+ * @lastModified 2026-03-19
+ * @author GPT-5.4
+ */
+export async function renameStageForProject(orgSlug, projectSlug, stageSlug, name) {
+    const { local, accessToken } = await resolveManagementAccess();
+    const response = await postJson({
+        baseUrl: local.baseUrl,
+        path: "/v1/cli/stages/rename",
+        accessToken,
+        payload: {
+            orgSlug,
+            projectSlug,
+            stageSlug,
+            name,
+        },
+        schema: StageRenameResponseSchema,
+    });
+    return response.stage;
+}
+/**
+ * Deletes one stage for one project.
+ *
+ * @param orgSlug The organization slug that owns the project.
+ * @param projectSlug The project slug that owns the stage.
+ * @param stageSlug The stage slug to delete.
+ * @returns The deleted stage payload.
+ * @remarks Destructive stage flows use this helper so command handlers stay prompt-focused.
+ * @lastModified 2026-03-19
+ * @author GPT-5.4
+ */
+export async function deleteStageForProject(orgSlug, projectSlug, stageSlug) {
+    const { local, accessToken } = await resolveManagementAccess();
+    return await postJson({
+        baseUrl: local.baseUrl,
+        path: "/v1/cli/stages/delete",
+        accessToken,
+        payload: {
+            orgSlug,
+            projectSlug,
+            stageSlug,
+        },
+        schema: StageDeleteResponseSchema,
+    });
+}
+/**
+ * Resolves one organization target from an explicit flag or an interactive selection.
+ *
+ * @param orgSlug The optionally supplied organization slug.
+ * @returns The resolved organization slug.
+ * @remarks Non-interactive runs must provide the target explicitly or via local repo config higher up the call stack.
+ * @lastModified 2026-03-19
+ * @author GPT-5.4
+ */
+export async function promptForOrganizationSlug(orgSlug) {
+    const explicit = orgSlug?.trim();
+    if (explicit && explicit.length > 0) {
+        return explicit;
+    }
+    if (!process.stdout.isTTY) {
+        throw new Error("Organization slug is required in non-interactive mode.");
+    }
+    const organizations = await listOrganizationsForCurrentUser();
+    if (organizations.length === 0) {
+        throw new Error("No organizations found. Create one first with barekey org create.");
+    }
+    const selected = await select({
+        message: "Which organization should Barekey use?",
+        options: organizations.map((organization) => ({
+            value: organization.slug,
+            label: organization.name,
+            hint: organization.slug,
+        })),
+    });
+    if (isCancel(selected)) {
+        cancel("Command canceled.");
+        process.exit(0);
+    }
+    return selected;
+}
+/**
+ * Resolves one project target from an explicit flag or an interactive selection.
+ *
+ * @param orgSlug The owning organization slug.
+ * @param projectSlug The optionally supplied project slug.
+ * @returns The resolved project slug.
+ * @remarks This intentionally loads live project choices instead of guessing from auth state.
+ * @lastModified 2026-03-19
+ * @author GPT-5.4
+ */
+export async function promptForProjectSlug(orgSlug, projectSlug) {
+    const explicit = projectSlug?.trim();
+    if (explicit && explicit.length > 0) {
+        return explicit;
+    }
+    if (!process.stdout.isTTY) {
+        throw new Error("Project slug is required in non-interactive mode.");
+    }
+    const projects = await listProjectsForOrganization(orgSlug);
+    if (projects.length === 0) {
+        throw new Error("No projects found. Create one first with barekey project create.");
+    }
+    const selected = await select({
+        message: "Which project should Barekey use?",
+        options: projects.map((project) => ({
+            value: project.slug,
+            label: project.name,
+            hint: project.slug,
+        })),
+    });
+    if (isCancel(selected)) {
+        cancel("Command canceled.");
+        process.exit(0);
+    }
+    return selected;
+}
+/**
+ * Resolves one stage target from an explicit flag or an interactive selection.
+ *
+ * @param orgSlug The owning organization slug.
+ * @param projectSlug The owning project slug.
+ * @param stageSlug The optionally supplied stage slug.
+ * @returns The resolved stage slug.
+ * @remarks This is used by `barekey init` so local repo setup can be a guided flow.
+ * @lastModified 2026-03-19
+ * @author GPT-5.4
+ */
+export async function promptForStageSlug(orgSlug, projectSlug, stageSlug) {
+    const explicit = stageSlug?.trim();
+    if (explicit && explicit.length > 0) {
+        return explicit;
+    }
+    if (!process.stdout.isTTY) {
+        throw new Error("Stage slug is required in non-interactive mode.");
+    }
+    const stages = await listStagesForProject(orgSlug, projectSlug);
+    if (stages.length === 0) {
+        throw new Error("No stages found. Create one first with barekey stage create.");
+    }
+    const selected = await select({
+        message: "Which stage should Barekey use?",
+        options: stages.map((stage) => ({
+            value: stage.slug,
+            label: stage.name,
+            hint: stage.slug,
+        })),
+    });
+    if (isCancel(selected)) {
+        cancel("Command canceled.");
+        process.exit(0);
+    }
+    return selected;
+}

package/dist/commands/typegen.d.ts

@@ -1,6 +1,6 @@
-import type { BarekeyTypegenResult } from "@barekey/sdk/server";
 import { Command } from "commander";
-export declare function formatTypegenResultMessage(result: BarekeyTypegenResult): string;
+import { type CliTypegenResult } from "../typegen/core.js";
+export declare function formatTypegenResultMessage(result: CliTypegenResult): string;
 export declare function formatTypegenWatchStartedMessage(input: {
     organization: string;
     project: string;