pax8-cta 0.1.0

package/dist/lib/errors.js

@@ -0,0 +1,168 @@
+/**
+ * Copyright 2024 Pax8, Inc.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import chalk from "chalk";
+import { formatError, printError, CtaError } from "./error-handler.js";
+/**
+ * Base CLI error with exit code.
+ * Exit code 1 = runtime error (config not found, network failure, etc.)
+ */
+export class CliError extends Error {
+    exitCode;
+    constructor(message, exitCode = 1) {
+        super(message);
+        this.exitCode = exitCode;
+        this.name = "CliError";
+    }
+}
+/**
+ * Usage error — invalid options, missing required args, etc.
+ * Exit code 2.
+ */
+export class UsageError extends CliError {
+    constructor(message) {
+        super(message, 2);
+        this.name = "UsageError";
+    }
+}
+/**
+ * Detect whether JSON output mode is active.
+ *
+ * Two signals (OR'd):
+ *   1. `--json` is present anywhere in process.argv (simple substring check).
+ *   2. stdout is not a TTY (piped/redirected).
+ *
+ * Exported so that issue #345 (proper Commander-driven --json flag) can replace
+ * this with a single authoritative source of truth once that flag lands.
+ */
+export function isJsonOutputMode() {
+    return process.argv.includes("--json") || !process.stdout.isTTY;
+}
+/**
+ * Build the JSON error payload from any error value.
+ *
+ * Schema:
+ * ```json
+ * {
+ *   "error": {
+ *     "code": "...",
+ *     "message": "...",
+ *     "causes": [...],
+ *     "recovery": [...],
+ *     "context": { ... }
+ *   }
+ * }
+ * ```
+ *
+ * Plain `Error` / unknown become `{ error: { message } }`.
+ * Stack traces are never included.
+ */
+function buildJsonError(error) {
+    // ZodError — duck-typed so we don't need to import zod directly in the CLI package.
+    // ZodError instances always have an `errors` array of `{ path, message }` objects.
+    if (error instanceof Error && error.name === "ZodError" && Array.isArray(error.errors)) {
+        const zodErrors = error.errors;
+        return {
+            error: {
+                code: "ERROR_VALIDATION",
+                message: "Validation failed",
+                causes: zodErrors.map((e) => `${e.path.join(".")}: ${e.message}`),
+                recovery: ["Check the input values and retry"],
+            },
+        };
+    }
+    // CtaError (CLI structured error) — emit all fields directly
+    if (error instanceof CtaError) {
+        const payload = {
+            code: error.code,
+            message: error.message,
+            causes: error.causes,
+            recovery: error.recovery,
+        };
+        if (error.context && Object.keys(error.context).length > 0) {
+            payload.context = error.context;
+        }
+        return { error: payload };
+    }
+    // CliError / UsageError — already actionable (message authored by the
+    // caller). Emit the message verbatim instead of running it through the
+    // regex formatter, which can mis-classify "X not found" messages as a
+    // generic ERROR_CONFIG_NOT_FOUND. (Issue #360.)
+    if (error instanceof CliError) {
+        return {
+            error: {
+                code: error.exitCode === 2 ? "ERROR_USAGE" : "ERROR_CLI",
+                message: error.message,
+            },
+        };
+    }
+    // For any other error, run through the structured formatter and emit result
+    try {
+        const structured = formatError(error);
+        const payload = {
+            code: structured.code,
+            message: structured.message,
+            causes: structured.causes,
+            recovery: structured.recovery,
+        };
+        if (structured.context && Object.keys(structured.context).length > 0) {
+            payload.context = structured.context;
+        }
+        return { error: payload };
+    }
+    catch {
+        // Ultimate fallback — plain Error or unknown
+        const message = error instanceof Error ? error.message : String(error);
+        return { error: { message } };
+    }
+}
+/**
+ * Standard error handler for CLI commands.
+ *
+ * - Stops the spinner with a fail message
+ * - When JSON mode is active (--json flag or piped stdout), emits a single JSON
+ *   object to stderr with structured `code`, `message`, `causes`, and `recovery`
+ *   fields — suitable for LLM-agent consumption.
+ * - Otherwise, uses the human-formatted handler (formatError/printError).
+ * - Exits with the appropriate code (1=runtime, 2=usage).
+ */
+export function handleCommandError(error, spinner, failMessage) {
+    // Stop the spinner before any output
+    if (spinner) {
+        spinner.fail(failMessage ? chalk.red(failMessage) : chalk.red("Command failed"));
+    }
+    if (isJsonOutputMode()) {
+        // JSON mode: emit structured payload to stderr, no human-formatted text
+        const payload = buildJsonError(error);
+        process.stderr.write(JSON.stringify(payload) + "\n");
+        process.exit(error instanceof CliError ? error.exitCode : 1);
+    }
+    // Human-readable mode (original behaviour preserved exactly)
+    if (error instanceof CliError) {
+        if (!spinner && failMessage) {
+            console.error(chalk.red(failMessage));
+        }
+        // CliError messages are already actionable — print directly
+        console.error(chalk.red(`\nError: ${error.message}`));
+        process.exit(error.exitCode);
+    }
+    if (!spinner && failMessage) {
+        console.error(chalk.red(failMessage));
+    }
+    const structured = formatError(error);
+    printError(structured);
+    process.exit(1);
+}
+//# sourceMappingURL=errors.js.map

package/dist/lib/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/lib/errors.ts"],"names":[],"mappings":"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"}

package/dist/lib/formatters.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Copyright 2024 Pax8, Inc.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+/**
+ * Shared formatting utilities for CLI output
+ */
+/**
+ * Format a date string as a human-readable "time ago" string
+ */
+export declare function formatTimeAgo(dateString: string): string;
+/**
+ * Format a duration in milliseconds as a human-readable string
+ */
+export declare function formatDuration(ms: number): string;
+/**
+ * Calculate and format duration between two date strings
+ */
+export declare function calculateDuration(startedAt?: string, completedAt?: string): string;
+/**
+ * Deployment status type
+ */
+export type DeploymentStatus = "completed" | "failed" | "in_progress" | "pending" | "scheduled" | "awaiting_approval" | "approved" | "rejected" | "cancelled" | "rolling_back" | "rolled_back";
+/**
+ * Format a deployment status with color and icon
+ * @param status - The deployment status
+ * @param style - 'default' for standard labels, 'tracking' for the per-deployment
+ *               tracking view (slightly different verbiage / icons for the
+ *               progress-oriented status table)
+ */
+export declare function formatStatus(status: string, style?: "default" | "tracking"): string;
+/**
+ * Truncate a string to a maximum length, adding ellipsis if needed
+ */
+export declare function truncate(str: string, maxLength: number): string;
+/**
+ * Truncate an ID string (defaults to 15 chars for UUIDs)
+ */
+export declare function truncateId(id: string, maxLength?: number): string;
+/**
+ * Safely format an error to a string
+ */
+export declare function formatError(error: unknown): string;
+//# sourceMappingURL=formatters.d.ts.map

package/dist/lib/formatters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatters.d.ts","sourceRoot":"","sources":["../../src/lib/formatters.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAIH;;GAEG;AAMH;;GAEG;AACH,wBAAgB,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAexD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAMjD;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,CAQlF;AAMD;;GAEG;AACH,MAAM,MAAM,gBAAgB,GACxB,WAAW,GACX,QAAQ,GACR,aAAa,GACb,SAAS,GACT,WAAW,GACX,mBAAmB,GACnB,UAAU,GACV,UAAU,GACV,WAAW,GACX,cAAc,GACd,aAAa,CAAC;AAElB;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,GAAE,SAAS,GAAG,UAAsB,GAAG,MAAM,CAyD9F;AAMD;;GAEG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAG/D;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,SAAS,GAAE,MAAW,GAAG,MAAM,CAGrE;AAMD;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAIlD"}

package/dist/lib/formatters.js

@@ -0,0 +1,163 @@
+/**
+ * Copyright 2024 Pax8, Inc.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import chalk from "chalk";
+/**
+ * Shared formatting utilities for CLI output
+ */
+// ============================================================================
+// Time Formatting
+// ============================================================================
+/**
+ * Format a date string as a human-readable "time ago" string
+ */
+export function formatTimeAgo(dateString) {
+    const now = Date.now();
+    const then = new Date(dateString).getTime();
+    const diffMs = now - then;
+    const seconds = Math.floor(diffMs / 1000);
+    const minutes = Math.floor(seconds / 60);
+    const hours = Math.floor(minutes / 60);
+    const days = Math.floor(hours / 24);
+    if (days > 0)
+        return `${days}d ago`;
+    if (hours > 0)
+        return `${hours}h ago`;
+    if (minutes > 0)
+        return `${minutes}m ago`;
+    if (seconds > 0)
+        return `${seconds}s ago`;
+    return "just now";
+}
+/**
+ * Format a duration in milliseconds as a human-readable string
+ */
+export function formatDuration(ms) {
+    if (ms < 1000)
+        return `${ms}ms`;
+    if (ms < 60000)
+        return `${Math.round(ms / 1000)}s`;
+    const minutes = Math.floor(ms / 60000);
+    const seconds = Math.round((ms % 60000) / 1000);
+    return `${minutes}m ${seconds}s`;
+}
+/**
+ * Calculate and format duration between two date strings
+ */
+export function calculateDuration(startedAt, completedAt) {
+    if (!startedAt)
+        return "-";
+    const start = new Date(startedAt).getTime();
+    const end = completedAt ? new Date(completedAt).getTime() : Date.now();
+    const durationMs = end - start;
+    return formatDuration(durationMs);
+}
+/**
+ * Format a deployment status with color and icon
+ * @param status - The deployment status
+ * @param style - 'default' for standard labels, 'tracking' for the per-deployment
+ *               tracking view (slightly different verbiage / icons for the
+ *               progress-oriented status table)
+ */
+export function formatStatus(status, style = "default") {
+    if (style === "tracking") {
+        switch (status) {
+            case "completed":
+                return chalk.green("✓ Completed");
+            case "failed":
+                return chalk.red("✗ Failed");
+            case "in_progress":
+                return chalk.yellow("● In Progress");
+            case "pending":
+                return chalk.gray("○ Queued");
+            case "scheduled":
+                return chalk.cyan("◷ Scheduled");
+            case "awaiting_approval":
+                return chalk.magenta("⊙ Awaiting Approval");
+            case "approved":
+                return chalk.green("✓ Approved");
+            case "rejected":
+                return chalk.red("✗ Rejected");
+            case "cancelled":
+                return chalk.gray("⊘ Cancelled");
+            case "rolling_back":
+                return chalk.yellow("↩ Rolling Back");
+            case "rolled_back":
+                return chalk.blue("↩ Rolled Back");
+            default:
+                return status;
+        }
+    }
+    // Default style
+    switch (status) {
+        case "completed":
+            return chalk.green("✓ Completed");
+        case "failed":
+            return chalk.red("✗ Failed");
+        case "in_progress":
+            return chalk.yellow("● In Progress");
+        case "pending":
+            return chalk.gray("○ Pending");
+        case "scheduled":
+            return chalk.cyan("◷ Scheduled");
+        case "awaiting_approval":
+            return chalk.magenta("⊙ Awaiting Approval");
+        case "approved":
+            return chalk.green("✓ Approved");
+        case "rejected":
+            return chalk.red("✗ Rejected");
+        case "cancelled":
+            return chalk.gray("⊘ Cancelled");
+        case "rolling_back":
+            return chalk.yellow("↩ Rolling Back");
+        case "rolled_back":
+            return chalk.blue("↩ Rolled Back");
+        default:
+            return status;
+    }
+}
+// ============================================================================
+// String Truncation
+// ============================================================================
+/**
+ * Truncate a string to a maximum length, adding ellipsis if needed
+ */
+export function truncate(str, maxLength) {
+    if (str.length <= maxLength)
+        return str;
+    return str.slice(0, maxLength - 3) + "...";
+}
+/**
+ * Truncate an ID string (defaults to 15 chars for UUIDs)
+ */
+export function truncateId(id, maxLength = 15) {
+    if (id.length <= maxLength)
+        return id;
+    return id.slice(0, maxLength) + "...";
+}
+// ============================================================================
+// Error Formatting
+// ============================================================================
+/**
+ * Safely format an error to a string
+ */
+export function formatError(error) {
+    if (error instanceof Error)
+        return error.message;
+    if (typeof error === "string")
+        return error;
+    return String(error);
+}
+//# sourceMappingURL=formatters.js.map

package/dist/lib/formatters.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatters.js","sourceRoot":"","sources":["../../src/lib/formatters.ts"],"names":[],"mappings":"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"}

package/dist/lib/graph-client.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Copyright 2024 Pax8, Inc.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+export interface AppRegistration {
+    id: string;
+    appId: string;
+    displayName: string;
+    signInAudience: string;
+}
+export interface ClientSecretResult {
+    secretId: string;
+    secretText: string;
+    displayName: string;
+    endDateTime: string;
+}
+export interface GraphClientConfig {
+    accessToken: string;
+}
+/**
+ * Microsoft Graph API client for managing Azure AD app registrations
+ */
+export declare class GraphClient {
+    private accessToken;
+    private readonly baseUrl;
+    constructor(config: GraphClientConfig);
+    /**
+     * Create a new app registration in Azure AD
+     */
+    createAppRegistration(displayName: string): Promise<AppRegistration>;
+    /**
+     * Find existing app registration by display name
+     */
+    findExistingApp(displayName: string): Promise<AppRegistration | null>;
+    /**
+     * List all app registrations the user owns or has access to
+     */
+    listAppRegistrations(): Promise<AppRegistration[]>;
+    /**
+     * Add Dynamics CRM API permission to an app
+     */
+    addDynamicsPermission(appObjectId: string): Promise<void>;
+    /**
+     * Grant admin consent for app permissions
+     * Note: This requires admin privileges and may not work for all users
+     */
+    grantAdminConsent(appId: string): Promise<void>;
+    /**
+     * Create a new client secret for the app
+     */
+    createClientSecret(appObjectId: string, description: string, validityMonths?: number): Promise<ClientSecretResult>;
+    /**
+     * Get service principal for an app (needed for some operations)
+     */
+    getServicePrincipal(appId: string): Promise<{
+        id: string;
+    } | null>;
+    /**
+     * Create service principal for an app if it doesn't exist
+     */
+    ensureServicePrincipal(appId: string): Promise<string>;
+}
+//# sourceMappingURL=graph-client.d.ts.map

package/dist/lib/graph-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph-client.d.ts","sourceRoot":"","sources":["../../src/lib/graph-client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,iBAAiB;IAChC,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAsC;gBAElD,MAAM,EAAE,iBAAiB;IAIrC;;OAEG;IACG,qBAAqB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;IAmC1E;;OAEG;IACG,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC;IAmB3E;;OAEG;IACG,oBAAoB,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC;IAmBxD;;OAEG;IACG,qBAAqB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAqE/D;;;OAGG;IACG,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAUrD;;OAEG;IACG,kBAAkB,CACtB,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,EACnB,cAAc,GAAE,MAAW,GAC1B,OAAO,CAAC,kBAAkB,CAAC;IAsC9B;;OAEG;IACG,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IAexE;;OAEG;IACG,sBAAsB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CAyB7D"}