pax8-cta 0.1.0

package/dist/index.js

@@ -0,0 +1,258 @@
+#!/usr/bin/env node
+/**
+ * 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.
+ */
+// Set default log level for CLI
+process.env.LOG_LEVEL = process.env.LOG_LEVEL || "error";
+// Load .env file from CWD (if it exists) so commands can find PARTNER_CLIENT_SECRET etc.
+// Skip keys the CLI manages independently (demo mode via ~/.pax8-cta/cli-config.json,
+// log level set above, and web-app-only keys).
+import { readFileSync, existsSync } from "node:fs";
+import { resolve } from "node:path";
+const ENV_SKIP_KEYS = new Set([
+    "DEMO_MODE",
+    "NEXT_PUBLIC_DEMO_MODE",
+    "LOG_LEVEL",
+    "NODE_ENV",
+    "NEXTAUTH_URL",
+    "NEXTAUTH_SECRET",
+]);
+const envPath = resolve(process.cwd(), ".env");
+if (existsSync(envPath)) {
+    const envContent = readFileSync(envPath, "utf-8");
+    for (const line of envContent.split(/\r?\n/)) {
+        const trimmed = line.trim();
+        if (!trimmed || trimmed.startsWith("#"))
+            continue;
+        const eqIdx = trimmed.indexOf("=");
+        if (eqIdx === -1)
+            continue;
+        const key = trimmed.slice(0, eqIdx).trim();
+        if (ENV_SKIP_KEYS.has(key))
+            continue;
+        const value = trimmed
+            .slice(eqIdx + 1)
+            .trim()
+            .replace(/^["']|["']$/g, "");
+        if (!process.env[key]) {
+            process.env[key] = value;
+        }
+    }
+}
+// Detect TTY early so subcommands can read getDefaultFormat() consistently.
+// Unit tests run in non-TTY vitest workers but should still default to "table";
+// only set this when actually invoked as a CLI binary subprocess.
+if (!process.env.PAX8_CTA_DEFAULT_FORMAT) {
+    process.env.PAX8_CTA_DEFAULT_FORMAT = process.stdout.isTTY ? "table" : "json";
+}
+import { Command } from "commander";
+import { exportCommand } from "./commands/export.js";
+import { importCommand } from "./commands/import.js";
+import { analyzeCommand } from "./commands/analyze.js";
+import { deployCommand } from "./commands/deploy.js";
+import { tenantsCommand } from "./commands/tenants/index.js";
+import { deploymentsCommand } from "./commands/deployments/index.js";
+import { solutionsCommand } from "./commands/solutions/index.js";
+import { initCommand } from "./commands/init.js";
+import { demoCommand } from "./commands/demo.js";
+import { telemetryCommand } from "./commands/telemetry.js";
+import { configCommand } from "./commands/config.js";
+import { setupCommand } from "./commands/setup.js";
+import { authCommand } from "./commands/auth.js";
+import { validateCommand } from "./commands/validate.js";
+import { statusCommand } from "./commands/status.js";
+import { showBanner, showWelcome } from "./lib/banner.js";
+import { startRepl } from "./lib/repl.js";
+import { isTelemetryEnabled, hasShownFirstRunNotice, markFirstRunNoticeShown, getFirstRunNotice, trackCommand, trackFirstRun, shutdownTelemetry, } from "./lib/telemetry.js";
+import { isQuietMode } from "./lib/spinner.js";
+import chalk from "chalk";
+const VERSION = "0.1.0";
+// Factory function to create a program instance
+export function createProgram() {
+    const program = new Command();
+    program
+        .name("pax8-cta")
+        .description("Pax8 CTA - Deploy and manage Power Platform agents across tenants")
+        .version(VERSION)
+        .option("--verbose", "Enable verbose output for debugging")
+        .option("--json", "Output as JSON (default when stdout is not a TTY)")
+        .option("--quiet", "Suppress all output (exit code only)")
+        .option("--ids-only", "Print one ID per line (for shell pipelines and LLM agent flows)")
+        .hook("preAction", (thisCommand) => {
+        if (thisCommand.opts().verbose) {
+            process.env.LOG_LEVEL = "debug";
+        }
+        // --ids-only is mutually exclusive with --json and --csv
+        const opts = thisCommand.optsWithGlobals();
+        if (opts.idsOnly) {
+            if (opts.json) {
+                console.error("Error: --ids-only and --json are mutually exclusive");
+                process.exit(1);
+            }
+            if (opts.csv) {
+                console.error("Error: --ids-only and --csv are mutually exclusive");
+                process.exit(1);
+            }
+        }
+    });
+    // Getting started
+    program.addCommand(initCommand);
+    program.addCommand(authCommand);
+    program.addCommand(validateCommand);
+    // Day-to-day workflow
+    program.addCommand(solutionsCommand);
+    program.addCommand(exportCommand);
+    program.addCommand(importCommand);
+    program.addCommand(deployCommand);
+    program.addCommand(deploymentsCommand);
+    program.addCommand(statusCommand);
+    // Environment management
+    program.addCommand(tenantsCommand);
+    program.addCommand(setupCommand);
+    program.addCommand(analyzeCommand);
+    // Utilities
+    program.addCommand(demoCommand);
+    program.addCommand(telemetryCommand);
+    program.addCommand(configCommand);
+    return program;
+}
+// Strip a leading "--" token from argv. POSIX shells already drop the first
+// "--", but `pnpm cli -- <args>` (and similar nested-script wrappers) forward
+// the literal "--" through to us, where Commander would otherwise treat it as
+// an unknown command (issue #383).
+if (process.argv[2] === "--") {
+    process.argv.splice(2, 1);
+}
+// Show banner if no arguments provided OR showing top-level help (not command-specific help)
+const args = process.argv.slice(2);
+const knownCommands = createProgram().commands.flatMap((cmd) => [cmd.name(), ...cmd.aliases()]);
+const hasCommand = args.some((arg) => knownCommands.includes(arg));
+const isTopLevelHelp = (args.includes("--help") || args.includes("-h")) && !hasCommand;
+const shouldShowBanner = args.length === 0 || isTopLevelHelp;
+if (shouldShowBanner) {
+    showBanner(VERSION);
+    if (args.length === 0) {
+        showWelcome();
+    }
+}
+// Show first-run telemetry notice (once, unless in quiet mode or no args).
+if (args.length > 0 && !isQuietMode()) {
+    let shouldShowFirstRunNotice = false;
+    try {
+        shouldShowFirstRunNotice = !hasShownFirstRunNotice();
+    }
+    catch {
+        // If config storage is not writable/readable, skip persistence without crashing.
+        shouldShowFirstRunNotice = false;
+    }
+    if (shouldShowFirstRunNotice) {
+        console.log(chalk.gray(getFirstRunNotice()));
+        try {
+            markFirstRunNoticeShown();
+        }
+        catch {
+            // Non-fatal: telemetry preference persistence should never break CLI usage.
+        }
+        if (isTelemetryEnabled()) {
+            trackFirstRun();
+        }
+    }
+}
+// Graceful shutdown handling
+let isShuttingDown = false;
+async function gracefulShutdown(signal) {
+    if (isShuttingDown)
+        return;
+    isShuttingDown = true;
+    console.log(chalk.gray(`\n${signal} received. Shutting down gracefully...`));
+    try {
+        // Flush telemetry before exit
+        await shutdownTelemetry();
+    }
+    catch {
+        // Ignore errors during shutdown
+    }
+    process.exit(0);
+}
+// Register signal handlers for graceful shutdown
+process.on("SIGINT", () => gracefulShutdown("SIGINT"));
+if (process.platform !== "win32") {
+    process.on("SIGTERM", () => gracefulShutdown("SIGTERM"));
+}
+// If no arguments provided, enter interactive mode
+if (args.length === 0) {
+    await startRepl(createProgram);
+}
+else {
+    const startTime = Date.now();
+    const program = createProgram();
+    // Track command execution
+    program.hook("postAction", (thisCommand) => {
+        const durationMs = Date.now() - startTime;
+        const command = thisCommand.parent?.name() || thisCommand.name();
+        const subcommand = thisCommand.parent ? thisCommand.name() : undefined;
+        // Extract flags (without values for privacy)
+        const flags = Object.keys(thisCommand.opts());
+        trackCommand({
+            command,
+            subcommand,
+            flags,
+            success: true,
+            durationMs,
+            demoMode: process.env.DEMO_MODE === "true",
+        });
+    });
+    // Handle exit for telemetry tracking
+    process.on("exit", (code) => {
+        if (code !== 0 && !isShuttingDown) {
+            const durationMs = Date.now() - startTime;
+            const command = args[0] || "unknown";
+            trackCommand({
+                command,
+                success: false,
+                durationMs,
+                errorType: "exit_code_" + code,
+                demoMode: process.env.DEMO_MODE === "true",
+            });
+        }
+    });
+    // Handle uncaught errors gracefully
+    process.on("uncaughtException", async (error) => {
+        console.error(chalk.red("\nUnexpected error:"), error.message);
+        trackCommand({
+            command: args[0] || "unknown",
+            success: false,
+            durationMs: Date.now() - startTime,
+            errorType: "uncaught_exception",
+            demoMode: process.env.DEMO_MODE === "true",
+        });
+        await shutdownTelemetry();
+        process.exit(1);
+    });
+    process.on("unhandledRejection", async (reason) => {
+        console.error(chalk.red("\nUnhandled promise rejection:"), reason);
+        trackCommand({
+            command: args[0] || "unknown",
+            success: false,
+            durationMs: Date.now() - startTime,
+            errorType: "unhandled_rejection",
+            demoMode: process.env.DEMO_MODE === "true",
+        });
+        await shutdownTelemetry();
+        process.exit(1);
+    });
+    program.parse();
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/lib/auth.d.ts

@@ -0,0 +1,51 @@
+/**
+ * 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 type { DeviceCodeLoginResult } from "@pax8-cta/core";
+export type InteractiveLoginResult = DeviceCodeLoginResult;
+/**
+ * Perform interactive device code login for Microsoft authentication
+ * Opens user's browser for authentication
+ */
+export declare function interactiveLogin(options?: {
+    clientId?: string;
+    tenantId?: string;
+    scopes?: string[];
+    openBrowser?: boolean;
+}): Promise<InteractiveLoginResult>;
+/**
+ * Store credentials securely in the OS keychain.
+ *
+ * Writes the client secret to the canonical keychain entry used by
+ * `getClientSecretWithFallback()` (via `storeSecret` from credentials.ts)
+ * as well as the per-clientId entry for tenant-specific lookup.
+ */
+export declare function storeCredentials(clientId: string, clientSecret: string, tenantId?: string): Promise<void>;
+/**
+ * Retrieve stored credentials from the OS keychain
+ */
+export declare function getStoredCredentials(clientId: string): Promise<{
+    clientSecret: string;
+    tenantId?: string;
+} | null>;
+/**
+ * Remove credentials from the OS keychain
+ */
+export declare function clearCredentials(clientId: string): Promise<void>;
+/**
+ * Check if credentials exist in the keychain
+ */
+export declare function hasStoredCredentials(clientId: string): Promise<boolean>;
+//# sourceMappingURL=auth.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../src/lib/auth.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAGH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAsC5D,MAAM,MAAM,sBAAsB,GAAG,qBAAqB,CAAC;AAE3D;;;GAGG;AACH,wBAAsB,gBAAgB,CAAC,OAAO,CAAC,EAAE;IAC/C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB,GAAG,OAAO,CAAC,sBAAsB,CAAC,CA2BlC;AAED;;;;;;GAMG;AACH,wBAAsB,gBAAgB,CACpC,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,MAAM,EACpB,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC,IAAI,CAAC,CAqBf;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CACxC,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC;IAAE,YAAY,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAAC,CAqB7D;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAStE;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAO7E"}

package/dist/lib/auth.js

@@ -0,0 +1,153 @@
+/**
+ * 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 { deviceCodeLogin } from "@pax8-cta/core";
+import open from "open";
+import chalk from "chalk";
+import { storeSecret } from "./credentials.js";
+const KEYTAR_SERVICE = "pax8-cta-cli";
+async function getKeytar() {
+    try {
+        const mod = (await import("keytar"));
+        const keytar = (mod.default || mod);
+        if (typeof keytar.getPassword === "function" &&
+            typeof keytar.setPassword === "function" &&
+            typeof keytar.deletePassword === "function") {
+            return keytar;
+        }
+        return null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Open a URL in the default browser
+ */
+function openBrowser(url) {
+    open(url);
+}
+/**
+ * Perform interactive device code login for Microsoft authentication
+ * Opens user's browser for authentication
+ */
+export async function interactiveLogin(options) {
+    const shouldOpenBrowser = options?.openBrowser ?? false;
+    try {
+        return await deviceCodeLogin({
+            clientId: options?.clientId,
+            tenantId: options?.tenantId,
+            scopes: options?.scopes,
+            deviceCodeCallback: (response) => {
+                if (shouldOpenBrowser) {
+                    openBrowser(response.verificationUri);
+                    console.log(`  ✓ Browser opened`);
+                    console.log(`  Enter code: ${chalk.bold(response.userCode)}`);
+                }
+                else {
+                    console.log(`  1. Open: ${response.verificationUri}`);
+                    console.log(`  2. Enter code: ${chalk.bold(response.userCode)}`);
+                }
+                console.log();
+                console.log("  Waiting for you to sign in...");
+            },
+        });
+    }
+    catch (error) {
+        if (error instanceof Error) {
+            throw new Error(`Authentication failed: ${error.message}`);
+        }
+        throw error;
+    }
+}
+/**
+ * Store credentials securely in the OS keychain.
+ *
+ * Writes the client secret to the canonical keychain entry used by
+ * `getClientSecretWithFallback()` (via `storeSecret` from credentials.ts)
+ * as well as the per-clientId entry for tenant-specific lookup.
+ */
+export async function storeCredentials(clientId, clientSecret, tenantId) {
+    // Store in the canonical location so getClientSecretWithFallback() can find it
+    await storeSecret(clientSecret);
+    const keytar = await getKeytar();
+    if (keytar) {
+        try {
+            // Also store per-clientId for tenant-specific retrieval
+            await keytar.setPassword(KEYTAR_SERVICE, `clientSecret:${clientId}`, clientSecret);
+            // Store tenant ID if provided
+            if (tenantId) {
+                await keytar.setPassword(KEYTAR_SERVICE, `tenantId:${clientId}`, tenantId);
+            }
+        }
+        catch (error) {
+            if (error instanceof Error) {
+                throw new Error(`Failed to store credentials: ${error.message}`);
+            }
+            throw error;
+        }
+    }
+}
+/**
+ * Retrieve stored credentials from the OS keychain
+ */
+export async function getStoredCredentials(clientId) {
+    try {
+        const keytar = await getKeytar();
+        if (!keytar)
+            return null;
+        const clientSecret = await keytar.getPassword(KEYTAR_SERVICE, `clientSecret:${clientId}`);
+        if (!clientSecret) {
+            return null;
+        }
+        const tenantId = await keytar.getPassword(KEYTAR_SERVICE, `tenantId:${clientId}`);
+        return {
+            clientSecret,
+            tenantId: tenantId || undefined,
+        };
+    }
+    catch {
+        // Return null if keychain is not available (e.g., in some CI environments)
+        return null;
+    }
+}
+/**
+ * Remove credentials from the OS keychain
+ */
+export async function clearCredentials(clientId) {
+    try {
+        const keytar = await getKeytar();
+        if (!keytar)
+            return;
+        await keytar.deletePassword(KEYTAR_SERVICE, `clientSecret:${clientId}`);
+        await keytar.deletePassword(KEYTAR_SERVICE, `tenantId:${clientId}`);
+    }
+    catch {
+        // Ignore errors when clearing (credential may not exist)
+    }
+}
+/**
+ * Check if credentials exist in the keychain
+ */
+export async function hasStoredCredentials(clientId) {
+    try {
+        const creds = await getStoredCredentials(clientId);
+        return creds !== null;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=auth.js.map

package/dist/lib/auth.js.map

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

package/dist/lib/banner.d.ts

@@ -0,0 +1,19 @@
+/**
+ * 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 declare function showBanner(version?: string): void;
+export declare function showWelcome(): void;
+export declare function showCompactBanner(): void;
+//# sourceMappingURL=banner.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"banner.d.ts","sourceRoot":"","sources":["../../src/lib/banner.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAIH,wBAAgB,UAAU,CAAC,OAAO,GAAE,MAAgB,QA6CnD;AAED,wBAAgB,WAAW,SAY1B;AAED,wBAAgB,iBAAiB,SAWhC"}

package/dist/lib/banner.js

@@ -0,0 +1,78 @@
+/**
+ * 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";
+export function showBanner(version = "0.1.0") {
+    const W = 63;
+    const border = chalk.cyan.bold("═".repeat(W));
+    const row = (text, visibleLen, color) => chalk.cyan.bold("║") + color(text) + " ".repeat(W - visibleLen) + chalk.cyan.bold("║");
+    const empty = row("", 0, (s) => s);
+    const pax8Art = [
+        ["     ██████╗  █████╗ ██╗  ██╗ █████╗", 36],
+        ["     ██╔══██╗██╔══██╗╚██╗██╔╝██╔══██╗", 37],
+        ["     ██████╔╝███████║ ╚███╔╝ ╚█████╔╝", 37],
+        ["     ██╔═══╝ ██╔══██║ ██╔██╗ ██╔══██╗", 37],
+        ["     ██║     ██║  ██║██╔╝ ██╗╚█████╔╝", 37],
+        ["     ╚═╝     ╚═╝  ╚═╝╚═╝  ╚═╝ ╚════╝", 36],
+    ];
+    const ctaArt = [
+        ["         ██████╗████████╗ █████╗", 32],
+        ["        ██╔════╝╚══██╔══╝██╔══██╗", 33],
+        ["        ██║        ██║   ███████║", 33],
+        ["        ██║        ██║   ██╔══██║", 33],
+        ["        ╚██████╗   ██║   ██║  ██║", 33],
+        ["         ╚═════╝   ╚═╝   ╚═╝  ╚═╝", 33],
+    ];
+    const subtitle = "                     Cross Tenant Agents";
+    const tagline = "   Deploy Copilot Studio agents to customer tenants via GDAP";
+    const versionLine = `   Version ${version}`;
+    const lines = [
+        chalk.cyan.bold("╔" + border + "╗"),
+        empty,
+        ...pax8Art.map(([text, len]) => row(text, len, chalk.blue.bold)),
+        empty,
+        ...ctaArt.map(([text, len]) => row(text, len, chalk.magenta.bold)),
+        empty,
+        row(subtitle, subtitle.length, chalk.white.bold),
+        empty,
+        row(tagline, tagline.length, chalk.white),
+        row(versionLine, versionLine.length, chalk.gray),
+        empty,
+        chalk.cyan.bold("╚" + border + "╝"),
+    ];
+    console.log("\n" + lines.join("\n"));
+}
+export function showWelcome() {
+    console.log();
+    console.log(chalk.cyan.bold("🚀 Quick Start:"));
+    console.log();
+    console.log(chalk.white("  Deploy to all tenants:    ") + chalk.gray("deploy --all --solution ./agent.zip"));
+    console.log(chalk.white("  View deployment history:  ") + chalk.gray("deployments list"));
+    console.log(chalk.white("  List your tenants:        ") + chalk.gray("tenants list"));
+    console.log();
+    console.log(chalk.cyan("  Need help? ") + chalk.gray("Type: help"));
+    console.log();
+}
+export function showCompactBanner() {
+    console.log();
+    console.log(chalk.cyan.bold("  ╔═══════════════════════════════════════╗"));
+    console.log(chalk.cyan.bold("  ║  ") +
+        chalk.blue.bold("Pax8") +
+        chalk.magenta.bold(" CTA") +
+        chalk.cyan.bold(" • Multi-Tenant Deployment  ║"));
+    console.log(chalk.cyan.bold("  ╚═══════════════════════════════════════╝"));
+    console.log();
+}
+//# sourceMappingURL=banner.js.map

package/dist/lib/banner.js.map

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

package/dist/lib/command-wrapper.d.ts

@@ -0,0 +1,56 @@
+/**
+ * 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 { loadConfig, type TenantConfig } from "@pax8-cta/core";
+/**
+ * Check if demo mode is active from any source (CLI config, env var, or core).
+ * Consolidates the two checks (`isDemoModeEnabled() || isDemoModeCore()`) that
+ * were scattered across every command.
+ */
+export declare function isDemo(): boolean;
+/**
+ * Execute `demoHandler` when demo mode is active, otherwise `realHandler`.
+ *
+ * Usage:
+ * ```ts
+ * .action(async (options) => {
+ *   await withDemoMode(
+ *     () => runDemo(options),
+ *     () => runReal(options),
+ *   );
+ * });
+ * ```
+ */
+export declare function withDemoMode<T>(demoHandler: () => T | Promise<T>, realHandler: () => T | Promise<T>): Promise<T>;
+export type LoadedConfig = Awaited<ReturnType<typeof loadConfig>>;
+export interface ConfigOptions {
+    config?: string;
+}
+export interface TenantSelectionOptions extends ConfigOptions {
+    all?: boolean;
+    tag?: string[];
+}
+/**
+ * Resolve config once and branch by mode in a shared wrapper.
+ */
+export declare function withResolvedConfig<T>(options: ConfigOptions, demoHandler: () => T | Promise<T>, realHandler: (config: LoadedConfig) => T | Promise<T>): Promise<T>;
+/**
+ * Resolve destinations once and pass the resolved context to command handlers.
+ */
+export declare function withResolvedDestinations<T>(options: TenantSelectionOptions, demoHandler: (destinations: TenantConfig[]) => T | Promise<T>, realHandler: (context: {
+    config: LoadedConfig;
+    destinations: TenantConfig[];
+}) => T | Promise<T>): Promise<T>;
+//# sourceMappingURL=command-wrapper.d.ts.map

package/dist/lib/command-wrapper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-wrapper.d.ts","sourceRoot":"","sources":["../../src/lib/command-wrapper.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAGH,OAAO,EAGL,UAAU,EACV,KAAK,YAAY,EAClB,MAAM,gBAAgB,CAAC;AAGxB;;;;GAIG;AACH,wBAAgB,MAAM,IAAI,OAAO,CAEhC;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,YAAY,CAAC,CAAC,EAClC,WAAW,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,EACjC,WAAW,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,GAChC,OAAO,CAAC,CAAC,CAAC,CAKZ;AAED,MAAM,MAAM,YAAY,GAAG,OAAO,CAAC,UAAU,CAAC,OAAO,UAAU,CAAC,CAAC,CAAC;AAElE,MAAM,WAAW,aAAa;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,sBAAuB,SAAQ,aAAa;IAC3D,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,EAAE,CAAC;CAChB;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,CAAC,EACxC,OAAO,EAAE,aAAa,EACtB,WAAW,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,EACjC,WAAW,EAAE,CAAC,MAAM,EAAE,YAAY,KAAK,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,GACpD,OAAO,CAAC,CAAC,CAAC,CAQZ;AAED;;GAEG;AACH,wBAAsB,wBAAwB,CAAC,CAAC,EAC9C,OAAO,EAAE,sBAAsB,EAC/B,WAAW,EAAE,CAAC,YAAY,EAAE,YAAY,EAAE,KAAK,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,EAC7D,WAAW,EAAE,CAAC,OAAO,EAAE;IAAE,MAAM,EAAE,YAAY,CAAC;IAAC,YAAY,EAAE,YAAY,EAAE,CAAA;CAAE,KAAK,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,GAC/F,OAAO,CAAC,CAAC,CAAC,CAYZ"}