automate.ax 0.1.3

package/dist/cli/lib/hijack-clack-logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hijack-clack-logger.d.ts","sourceRoot":"","sources":["../../../src/cli/lib/hijack-clack-logger.ts"],"names":[],"mappings":""}

package/dist/cli/lib/hijack-clack-logger.js

@@ -0,0 +1,8 @@
+import { log } from "@clack/prompts";
+import { green, red } from "ansis";
+log.success = (message, opts) => {
+    log.message(message, { ...opts, symbol: green("✓") });
+};
+log.error = (message, opts) => {
+    log.message(message, { ...opts, symbol: red("✖") });
+};

package/dist/cli/lib/io.d.ts

@@ -0,0 +1,19 @@
+export declare const accent: import("ansis").Ansis;
+export declare const dimmed: import("ansis").Ansis;
+/** Values supported by the terminal table renderer. */
+type TableCellValue = string | number | boolean | bigint | null | undefined;
+type TableInput<Row> = {
+    columns: readonly {
+        header: string;
+        cell: (row: Row) => TableCellValue;
+    }[];
+    rows: readonly Row[];
+};
+/**
+ * Renders rows and column definitions as a bordered terminal table.
+ *
+ * @param input - Table columns and row values.
+ */
+export declare function renderTable<Row>(input: TableInput<Row>): string;
+export {};
+//# sourceMappingURL=io.d.ts.map

package/dist/cli/lib/io.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"io.d.ts","sourceRoot":"","sources":["../../../src/cli/lib/io.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,MAAM,uBAAc,CAAA;AACjC,eAAO,MAAM,MAAM,uBAAU,CAAA;AAE7B,uDAAuD;AACvD,KAAK,cAAc,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,CAAA;AAE3E,KAAK,UAAU,CAAC,GAAG,IAAI;IACrB,OAAO,EAAE,SAAS;QAChB,MAAM,EAAE,MAAM,CAAA;QACd,IAAI,EAAE,CAAC,GAAG,EAAE,GAAG,KAAK,cAAc,CAAA;KACnC,EAAE,CAAA;IACH,IAAI,EAAE,SAAS,GAAG,EAAE,CAAA;CACrB,CAAA;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,KAAK,EAAE,UAAU,CAAC,GAAG,CAAC,UA4EtD"}

package/dist/cli/lib/io.js

@@ -0,0 +1,87 @@
+import { fg, gray, yellow } from "ansis";
+import stringWidth from "string-width";
+export const accent = yellow.bold;
+export const dimmed = fg(250);
+/**
+ * Renders rows and column definitions as a bordered terminal table.
+ *
+ * @param input - Table columns and row values.
+ */
+export function renderTable(input) {
+    const { columns, rows } = input;
+    const { bodyLines, headerLines, widths } = prepareTable({ columns, rows });
+    const border = {
+        top: drawBorder("├", "┬", "┐", "─"),
+        middle: drawBorder("├", "┼", "┤", "─"),
+        bottom: drawBorder("├", "┴", "┘", "─"),
+    };
+    const lines = [border.top, drawRow(headerLines, true)];
+    if (bodyLines.length === 0) {
+        lines.push(border.bottom);
+        return lines.join("\n");
+    }
+    lines.push(border.middle);
+    for (const [index, row] of bodyLines.entries()) {
+        lines.push(drawRow(row, false));
+        lines.push(index === bodyLines.length - 1 ? border.bottom : border.middle);
+    }
+    return lines.join("\n");
+    /**
+     * Draws a horizontal border using the table's computed column widths.
+     *
+     * @param left - Character at the left edge.
+     * @param middle - Character joining adjacent columns.
+     * @param right - Character at the right edge.
+     * @param fill - Character repeated across each column.
+     */
+    function drawBorder(left, middle, right, fill) {
+        return gray(left + widths.map((width) => fill.repeat(width + 2)).join(middle) + right);
+    }
+    /**
+     * Renders one logical row, including cells containing multiple lines.
+     *
+     * @param cells - Lines for each cell in the row.
+     * @param isHeader - Whether to apply header styling.
+     */
+    function drawRow(cells, isHeader) {
+        const rowLines = [];
+        for (let lineIndex = 0; lineIndex < Math.max(...cells.map((cell) => cell.length)); lineIndex += 1) {
+            rowLines.push(gray("│") +
+                cells
+                    .map((cell, columnIndex) => {
+                    const content = padCell(cell[lineIndex] ?? "", widths[columnIndex] ?? 0);
+                    return isHeader ? yellow(content) : content;
+                })
+                    .join(gray("│")) +
+                gray("│"));
+        }
+        return rowLines.join("\n");
+    }
+}
+/**
+ * Expands table values into lines and calculates each column's width.
+ *
+ * @param input - Table columns and rows to prepare.
+ */
+function prepareTable(input) {
+    const { columns, rows } = input;
+    const headerLines = columns.map((column) => [column.header]);
+    const bodyLines = rows.map((row) => columns.map((column) => String(column.cell(row) ?? "").split("\n")));
+    const widths = columns.map((_, columnIndex) => Math.max(stringWidth(headerLines[columnIndex]?.[0] ?? ""), ...bodyLines.flatMap((row) => (row[columnIndex] ?? [""]).map((line) => stringWidth(line)))));
+    return {
+        bodyLines,
+        headerLines,
+        lineWidth: widths.reduce((sum, width) => sum + width + 2, 0) +
+            Math.max(widths.length - 1, 0) * 2,
+        widths,
+    };
+}
+/**
+ * Pads a table cell to a target visible width.
+ *
+ * @param value - Cell text to pad.
+ * @param width - Target display width excluding outer spaces.
+ */
+function padCell(value, width) {
+    return ` ${value}${" ".repeat(width - stringWidth(value) + 1)}`;
+}

package/dist/cli/lib/json-output.d.ts

@@ -0,0 +1,9 @@
+/** Checks whether the current process was invoked in JSON output mode. */
+export declare function isJsonOutput(): boolean;
+/**
+ * Writes a value as indented JSON to standard output.
+ *
+ * @param value - Serializable value to write.
+ */
+export declare function writeJson(value: unknown): void;
+//# sourceMappingURL=json-output.d.ts.map

package/dist/cli/lib/json-output.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-output.d.ts","sourceRoot":"","sources":["../../../src/cli/lib/json-output.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,wBAAgB,YAAY,YAE3B;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,QAEvC"}

package/dist/cli/lib/json-output.js

@@ -0,0 +1,12 @@
+/** Checks whether the current process was invoked in JSON output mode. */
+export function isJsonOutput() {
+    return process.argv.includes("--json");
+}
+/**
+ * Writes a value as indented JSON to standard output.
+ *
+ * @param value - Serializable value to write.
+ */
+export function writeJson(value) {
+    console.log(JSON.stringify(value, null, 2));
+}

package/dist/cli/lib/organization-detail-block.d.ts

@@ -0,0 +1,30 @@
+interface OrganizationDetail {
+    activeSubscription?: {
+        periodEnd?: Date | string | null;
+        status: string;
+    } | null;
+    createdAt: Date | string;
+    id: string;
+    limits: {
+        projects: number;
+        seats: number;
+    };
+    memberCount: number;
+    name: string;
+    pendingInvitationCount: number;
+    plan?: string | null;
+    projectCount: number;
+    role?: string;
+}
+/**
+ * Renders an organization's identity, plan, usage, and billing details.
+ *
+ * @param org - Organization data to display.
+ * @param options - Optional fields to include in the block.
+ * @param options.includeRole - Whether to include the caller's role.
+ */
+export declare function renderOrganizationDetailBlock(org: OrganizationDetail, options?: {
+    includeRole?: boolean;
+}): string;
+export {};
+//# sourceMappingURL=organization-detail-block.d.ts.map

package/dist/cli/lib/organization-detail-block.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"organization-detail-block.d.ts","sourceRoot":"","sources":["../../../src/cli/lib/organization-detail-block.ts"],"names":[],"mappings":"AAIA,UAAU,kBAAkB;IAC1B,kBAAkB,CAAC,EAAE;QACnB,SAAS,CAAC,EAAE,IAAI,GAAG,MAAM,GAAG,IAAI,CAAA;QAChC,MAAM,EAAE,MAAM,CAAA;KACf,GAAG,IAAI,CAAA;IACR,SAAS,EAAE,IAAI,GAAG,MAAM,CAAA;IACxB,EAAE,EAAE,MAAM,CAAA;IACV,MAAM,EAAE;QACN,QAAQ,EAAE,MAAM,CAAA;QAChB,KAAK,EAAE,MAAM,CAAA;KACd,CAAA;IACD,WAAW,EAAE,MAAM,CAAA;IACnB,IAAI,EAAE,MAAM,CAAA;IACZ,sBAAsB,EAAE,MAAM,CAAA;IAC9B,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACpB,YAAY,EAAE,MAAM,CAAA;IACpB,IAAI,CAAC,EAAE,MAAM,CAAA;CACd;AAED;;;;;;GAMG;AACH,wBAAgB,6BAA6B,CAC3C,GAAG,EAAE,kBAAkB,EACvB,OAAO,GAAE;IAAE,WAAW,CAAC,EAAE,OAAO,CAAA;CAAO,UAwBxC"}

package/dist/cli/lib/organization-detail-block.js

@@ -0,0 +1,72 @@
+import { toTitleCase } from "remeda";
+import { renderDetailBlock } from "./detail-block.js";
+import { dimmed } from "./io.js";
+/**
+ * Renders an organization's identity, plan, usage, and billing details.
+ *
+ * @param org - Organization data to display.
+ * @param options - Optional fields to include in the block.
+ * @param options.includeRole - Whether to include the caller's role.
+ */
+export function renderOrganizationDetailBlock(org, options = {}) {
+    return renderDetailBlock({
+        [dimmed `Name`]: org.name,
+        [dimmed `ID`]: dimmed(org.id),
+        [dimmed `Created`]: formatDate(org.createdAt),
+        [dimmed `Plan`]: getPlanName(org.plan),
+        ...(options.includeRole && org.role
+            ? { [dimmed `Role`]: toTitleCase(org.role) }
+            : {}),
+        [dimmed `Seats`]: `${org.memberCount + org.pendingInvitationCount} / ${org.limits.seats}`,
+        [dimmed `Projects`]: `${org.projectCount} / ${org.limits.projects}`,
+        ...(org.activeSubscription
+            ? {
+                [dimmed `Billing`]: formatBillingStatus(org.activeSubscription),
+                [dimmed `Renews`]: org.activeSubscription.periodEnd
+                    ? formatDate(org.activeSubscription.periodEnd)
+                    : null,
+            }
+            : {}),
+    }, { keyAlignment: "right" });
+}
+/**
+ * Converts an internal plan identifier to a display name.
+ *
+ * @param plan - Internal plan identifier.
+ */
+function getPlanName(plan) {
+    switch (plan) {
+        case "enterprise":
+            return "Enterprise";
+        case "pro":
+            return "Pro";
+        default:
+            return "Free";
+    }
+}
+/**
+ * Converts a subscription status to a billing label.
+ *
+ * @param billing - Subscription billing state.
+ * @param billing.status - Internal subscription status identifier.
+ */
+function formatBillingStatus(billing) {
+    return ({
+        active: "Active",
+        canceled: "Canceled",
+        incomplete: "Incomplete",
+        incomplete_expired: "Incomplete",
+        past_due: "Payment issue",
+        paused: "Paused",
+        trialing: "Trial",
+        unpaid: "Payment issue",
+    }[billing.status] ?? "Active");
+}
+/**
+ * Formats a date for the user's locale.
+ *
+ * @param date - Date value to format.
+ */
+function formatDate(date) {
+    return new Date(date).toLocaleDateString();
+}

package/dist/cli/lib/project-config.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Loads and validates a project's Automate.ax configuration file.
+ *
+ * @param configPath - Absolute path to the configuration file.
+ * @throws When the file cannot be loaded or its contents are invalid.
+ */
+export declare function loadProjectConfig(configPath: string): Promise<{
+    projectId: string;
+}>;
+//# sourceMappingURL=project-config.d.ts.map

package/dist/cli/lib/project-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-config.d.ts","sourceRoot":"","sources":["../../../src/cli/lib/project-config.ts"],"names":[],"mappings":"AASA;;;;;GAKG;AACH,wBAAsB,iBAAiB,CAAC,UAAU,EAAE,MAAM;;GAQzD"}

package/dist/cli/lib/project-config.js

@@ -0,0 +1,21 @@
+import { loadConfig } from "c12";
+import path from "node:path";
+import z from "zod";
+/** Schema for the project identifier stored in a Automate.ax config file. */
+const projectConfigSchema = z.object({
+    projectId: z.string(),
+});
+/**
+ * Loads and validates a project's Automate.ax configuration file.
+ *
+ * @param configPath - Absolute path to the configuration file.
+ * @throws When the file cannot be loaded or its contents are invalid.
+ */
+export async function loadProjectConfig(configPath) {
+    const { config } = await loadConfig({
+        configFile: path.basename(configPath),
+        configFileRequired: true,
+        cwd: path.dirname(configPath),
+    });
+    return projectConfigSchema.parse(config);
+}

package/dist/cli/lib/spinner.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Starts a spinner before an operation and clears it after successful
+ * completion.
+ *
+ * @param message - Status message displayed while the operation runs.
+ * @param operation - Asynchronous operation to execute.
+ */
+export declare function withSpinner<T>(message: string, operation: () => Promise<T>): Promise<T>;
+/**
+ * Replaces any active spinner with a new status message.
+ *
+ * @param message - Status message to display.
+ * @param interruptMessage - Message shown when the user interrupts the wait.
+ */
+export declare function startSpinner(message: string, interruptMessage?: string): void;
+/** Clears the active spinner and removes its terminal output. */
+export declare function clearSpinner(): void;
+//# sourceMappingURL=spinner.d.ts.map

package/dist/cli/lib/spinner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spinner.d.ts","sourceRoot":"","sources":["../../../src/cli/lib/spinner.ts"],"names":[],"mappings":"AAQA;;;;;;GAMG;AACH,wBAAsB,WAAW,CAAC,CAAC,EACjC,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAC1B,OAAO,CAAC,CAAC,CAAC,CAMZ;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,gBAAgB,SAAc,QAM3E;AAED,iEAAiE;AACjE,wBAAgB,YAAY,SAG3B"}

package/dist/cli/lib/spinner.js

@@ -0,0 +1,111 @@
+import { S_BAR, cancel, isCI, log, settings, unicode } from "@clack/prompts";
+import { dim, gray, yellow } from "ansis";
+import { clearScreenDown, cursorTo, moveCursor } from "node:readline";
+import { isJsonOutput } from "./json-output.js";
+let activeSpinner;
+let sigintHandlerInstalled = false;
+/**
+ * Starts a spinner before an operation and clears it after successful
+ * completion.
+ *
+ * @param message - Status message displayed while the operation runs.
+ * @param operation - Asynchronous operation to execute.
+ */
+export async function withSpinner(message, operation) {
+    startSpinner(message);
+    return await operation().then((result) => {
+        clearSpinner();
+        return result;
+    });
+}
+/**
+ * Replaces any active spinner with a new status message.
+ *
+ * @param message - Status message to display.
+ * @param interruptMessage - Message shown when the user interrupts the wait.
+ */
+export function startSpinner(message, interruptMessage = "Cancelled") {
+    clearSpinner();
+    if (isJsonOutput())
+        return;
+    ensureSigintHandler();
+    activeSpinner = createSpinner(message, interruptMessage);
+}
+/** Clears the active spinner and removes its terminal output. */
+export function clearSpinner() {
+    activeSpinner?.clear();
+    activeSpinner = undefined;
+}
+/** Handles interruption by clearing and marking the active operation canceled. */
+function handleSigint() {
+    if (!activeSpinner)
+        return;
+    const { interruptMessage, message } = activeSpinner;
+    clearSpinner();
+    log.error(dim.strikethrough(message));
+    cancel(interruptMessage);
+    process.exit(0);
+}
+/** Installs the process interruption handler at most once. */
+function ensureSigintHandler() {
+    if (sigintHandlerInstalled)
+        return;
+    sigintHandlerInstalled = true;
+    process.on("SIGINT", handleSigint);
+}
+/**
+ * Creates an interactive spinner or a static status line for non-TTY output.
+ *
+ * @param message - Status message to display.
+ * @param interruptMessage - Message shown when the user interrupts the wait.
+ */
+function createSpinner(message, interruptMessage) {
+    const frames = unicode ? ["◒", "◐", "◓", "◑"] : ["•", "o", "O", "0"];
+    let frameIndex = 0;
+    let interval;
+    let previousOutput;
+    let wroteGuide = false;
+    let active = true;
+    /** Removes the previously rendered spinner frame from the terminal. */
+    function clearPreviousOutput() {
+        if (previousOutput === undefined)
+            return;
+        const lines = previousOutput.split("\n");
+        if (lines.length > 1)
+            moveCursor(process.stderr, 0, -(lines.length - 1));
+        cursorTo(process.stderr, 0);
+        clearScreenDown(process.stderr);
+    }
+    /** Renders the next spinner frame. */
+    function render() {
+        clearPreviousOutput();
+        previousOutput = `${yellow(frames[frameIndex] ?? frames[0])}  ${message}`;
+        process.stderr.write(previousOutput);
+        frameIndex = frameIndex + 1 < frames.length ? frameIndex + 1 : 0;
+    }
+    /** Stops animation and removes all spinner output. */
+    function clear() {
+        if (!active)
+            return;
+        active = false;
+        if (interval)
+            clearInterval(interval);
+        clearPreviousOutput();
+        if (wroteGuide) {
+            moveCursor(process.stderr, 0, -1);
+            cursorTo(process.stderr, 0);
+            clearScreenDown(process.stderr);
+        }
+    }
+    if (!process.stderr.isTTY || isCI()) {
+        log.message(message, { output: process.stderr, symbol: "-" });
+        return { clear, interruptMessage, message };
+    }
+    if (settings.withGuide) {
+        wroteGuide = true;
+        process.stderr.write(`${gray(S_BAR)}\n`);
+    }
+    render();
+    interval = setInterval(render, unicode ? 80 : 120);
+    return { clear, interruptMessage, message };
+}

package/dist/cli/usage.d.ts

@@ -0,0 +1,9 @@
+import type { RunMainOptions } from "citty";
+/**
+ * Prints CLI help with Automate.ax's own accent color and grouped root commands.
+ *
+ * @param cmd - Command definition to render.
+ * @param parent - Parent definition for a nested command.
+ */
+export declare const showUsage: NonNullable<RunMainOptions["showUsage"]>;
+//# sourceMappingURL=usage.d.ts.map

package/dist/cli/usage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage.d.ts","sourceRoot":"","sources":["../../src/cli/usage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAMV,cAAc,EAEf,MAAM,OAAO,CAAA;AA8Bd;;;;;GAKG;AACH,eAAO,MAAM,SAAS,EAAE,WAAW,CAAC,cAAc,CAAC,WAAW,CAAC,CAO9D,CAAA"}