pax8-cta 0.1.0

package/dist/lib/command-wrapper.js

@@ -0,0 +1,71 @@
+/**
+ * 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 { resolve } from "node:path";
+import { filterTenantsByTags, isDemoMode as isDemoModeCore, loadConfig, } from "@pax8-cta/core";
+import { getDemoTenants, isDemoModeEnabled } from "../commands/demo.js";
+/**
+ * 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 function isDemo() {
+    return isDemoModeEnabled() || isDemoModeCore();
+}
+/**
+ * Execute `demoHandler` when demo mode is active, otherwise `realHandler`.
+ *
+ * Usage:
+ * ```ts
+ * .action(async (options) => {
+ *   await withDemoMode(
+ *     () => runDemo(options),
+ *     () => runReal(options),
+ *   );
+ * });
+ * ```
+ */
+export async function withDemoMode(demoHandler, realHandler) {
+    if (isDemo()) {
+        return demoHandler();
+    }
+    return realHandler();
+}
+/**
+ * Resolve config once and branch by mode in a shared wrapper.
+ */
+export async function withResolvedConfig(options, demoHandler, realHandler) {
+    if (isDemo()) {
+        return demoHandler();
+    }
+    const configPath = resolve(process.cwd(), options.config ?? "./config/tenants.yaml");
+    const config = await loadConfig(configPath);
+    return realHandler(config);
+}
+/**
+ * Resolve destinations once and pass the resolved context to command handlers.
+ */
+export async function withResolvedDestinations(options, demoHandler, realHandler) {
+    if (isDemo()) {
+        return demoHandler(getDemoTenants(options));
+    }
+    const configPath = resolve(process.cwd(), options.config ?? "./config/tenants.yaml");
+    const config = await loadConfig(configPath);
+    const destinations = options.all
+        ? config.tenants.filter((tenant) => tenant.enabled)
+        : filterTenantsByTags(config, options.tag ?? []);
+    return realHandler({ config, destinations });
+}
+//# sourceMappingURL=command-wrapper.js.map

package/dist/lib/command-wrapper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-wrapper.js","sourceRoot":"","sources":["../../src/lib/command-wrapper.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EACL,mBAAmB,EACnB,UAAU,IAAI,cAAc,EAC5B,UAAU,GAEX,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAExE;;;;GAIG;AACH,MAAM,UAAU,MAAM;IACpB,OAAO,iBAAiB,EAAE,IAAI,cAAc,EAAE,CAAC;AACjD,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,WAAiC,EACjC,WAAiC;IAEjC,IAAI,MAAM,EAAE,EAAE,CAAC;QACb,OAAO,WAAW,EAAE,CAAC;IACvB,CAAC;IACD,OAAO,WAAW,EAAE,CAAC;AACvB,CAAC;AAaD;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,OAAsB,EACtB,WAAiC,EACjC,WAAqD;IAErD,IAAI,MAAM,EAAE,EAAE,CAAC;QACb,OAAO,WAAW,EAAE,CAAC;IACvB,CAAC;IAED,MAAM,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,OAAO,CAAC,MAAM,IAAI,uBAAuB,CAAC,CAAC;IACrF,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,UAAU,CAAC,CAAC;IAC5C,OAAO,WAAW,CAAC,MAAM,CAAC,CAAC;AAC7B,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAC5C,OAA+B,EAC/B,WAA6D,EAC7D,WAAgG;IAEhG,IAAI,MAAM,EAAE,EAAE,CAAC;QACb,OAAO,WAAW,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC,CAAC;IAC9C,CAAC;IAED,MAAM,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,OAAO,CAAC,MAAM,IAAI,uBAAuB,CAAC,CAAC;IACrF,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,UAAU,CAAC,CAAC;IAC5C,MAAM,YAAY,GAAG,OAAO,CAAC,GAAG;QAC9B,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC;QACnD,CAAC,CAAC,mBAAmB,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,EAAE,CAAC,CAAC;IAEnD,OAAO,WAAW,CAAC,EAAE,MAAM,EAAE,YAAY,EAAE,CAAC,CAAC;AAC/C,CAAC"}

package/dist/lib/credentials.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.
+ */
+/**
+ * Get stored secret from OS keychain
+ */
+export declare function getStoredSecret(): Promise<string | null>;
+/**
+ * Probe whether the OS keychain is available without revealing the secret.
+ *
+ * Useful for status / config commands that need to report whether a stored
+ * credential exists. Returns one of:
+ *   - "set"         — keychain available and a secret is stored
+ *   - "not-set"     — keychain available but no secret stored
+ *   - "unavailable" — keytar not installed or keychain unreadable
+ *
+ * Never returns or logs the secret value.
+ */
+export declare function probeStoredSecret(): Promise<"set" | "not-set" | "unavailable">;
+/**
+ * Store secret in OS keychain
+ */
+export declare function storeSecret(secret: string): Promise<void>;
+/**
+ * Remove secret from OS keychain
+ */
+export declare function deleteSecret(): Promise<void>;
+/**
+ * Resolve the client secret using a single, well-defined fallback chain.
+ *
+ * Priority:
+ *   1. Environment variables (PARTNER_CLIENT_SECRET, then PAX8_CTA_CLIENT_SECRET).
+ *      These are populated either by the shell environment or by the .env loader
+ *      in index.ts — so .env file values are included here automatically.
+ *   2. OS keychain (stored via `pax8-cta auth login`).
+ *
+ * Every CLI command that needs a client secret MUST call this function
+ * rather than reading process.env directly.
+ *
+ * @returns The client secret
+ * @throws Error if secret not found in any location
+ */
+export declare function getClientSecretWithFallback(): Promise<string>;
+//# sourceMappingURL=credentials.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"credentials.d.ts","sourceRoot":"","sources":["../../src/lib/credentials.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AA6BH;;GAEG;AACH,wBAAsB,eAAe,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAS9D;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,KAAK,GAAG,SAAS,GAAG,aAAa,CAAC,CASpF;AAED;;GAEG;AACH,wBAAsB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAoB/D;AAED;;GAEG;AACH,wBAAsB,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC,CAQlD;AAUD;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,2BAA2B,IAAI,OAAO,CAAC,MAAM,CAAC,CAoBnE"}

package/dist/lib/credentials.js

@@ -0,0 +1,146 @@
+/**
+ * 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.
+ */
+const SERVICE_NAME = "pax8-cta";
+const ACCOUNT_NAME = "client-secret";
+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;
+    }
+}
+/**
+ * Get stored secret from OS keychain
+ */
+export async function getStoredSecret() {
+    try {
+        const keytar = await getKeytar();
+        if (!keytar)
+            return null;
+        return await keytar.getPassword(SERVICE_NAME, ACCOUNT_NAME);
+    }
+    catch {
+        // If keytar fails (e.g., on unsupported platforms), return null
+        return null;
+    }
+}
+/**
+ * Probe whether the OS keychain is available without revealing the secret.
+ *
+ * Useful for status / config commands that need to report whether a stored
+ * credential exists. Returns one of:
+ *   - "set"         — keychain available and a secret is stored
+ *   - "not-set"     — keychain available but no secret stored
+ *   - "unavailable" — keytar not installed or keychain unreadable
+ *
+ * Never returns or logs the secret value.
+ */
+export async function probeStoredSecret() {
+    const keytar = await getKeytar();
+    if (!keytar)
+        return "unavailable";
+    try {
+        const value = await keytar.getPassword(SERVICE_NAME, ACCOUNT_NAME);
+        return value ? "set" : "not-set";
+    }
+    catch {
+        return "unavailable";
+    }
+}
+/**
+ * Store secret in OS keychain
+ */
+export async function storeSecret(secret) {
+    if (!secret || secret.trim().length === 0) {
+        throw new Error("Secret cannot be empty");
+    }
+    const keytar = await getKeytar();
+    if (!keytar) {
+        const hint = process.platform === "win32"
+            ? "OS keychain is unavailable (keytar not installed — requires Visual Studio Build Tools on Windows).\n  Set the PARTNER_CLIENT_SECRET environment variable or add it to .env instead."
+            : "OS keychain is unavailable (keytar not installed).\n  Set the PARTNER_CLIENT_SECRET environment variable or add it to .env instead.";
+        throw new Error(hint);
+    }
+    try {
+        await keytar.setPassword(SERVICE_NAME, ACCOUNT_NAME, secret);
+    }
+    catch (error) {
+        const msg = error instanceof Error ? error.message : String(error);
+        throw new Error(`Failed to store secret in keychain: ${msg}`);
+    }
+}
+/**
+ * Remove secret from OS keychain
+ */
+export async function deleteSecret() {
+    try {
+        const keytar = await getKeytar();
+        if (!keytar)
+            return;
+        await keytar.deletePassword(SERVICE_NAME, ACCOUNT_NAME);
+    }
+    catch {
+        // Ignore errors when deleting (secret may not exist)
+    }
+}
+/**
+ * Canonical environment variable names checked for the client secret,
+ * in priority order.  PARTNER_CLIENT_SECRET is the primary name used
+ * in .env files and documentation; PAX8_CTA_CLIENT_SECRET is kept as
+ * a supported alias for backwards compatibility.
+ */
+const CLIENT_SECRET_ENV_VARS = ["PARTNER_CLIENT_SECRET", "PAX8_CTA_CLIENT_SECRET"];
+/**
+ * Resolve the client secret using a single, well-defined fallback chain.
+ *
+ * Priority:
+ *   1. Environment variables (PARTNER_CLIENT_SECRET, then PAX8_CTA_CLIENT_SECRET).
+ *      These are populated either by the shell environment or by the .env loader
+ *      in index.ts — so .env file values are included here automatically.
+ *   2. OS keychain (stored via `pax8-cta auth login`).
+ *
+ * Every CLI command that needs a client secret MUST call this function
+ * rather than reading process.env directly.
+ *
+ * @returns The client secret
+ * @throws Error if secret not found in any location
+ */
+export async function getClientSecretWithFallback() {
+    // 1. Check environment variables (covers both shell env and .env file)
+    for (const envVar of CLIENT_SECRET_ENV_VARS) {
+        const value = process.env[envVar];
+        if (value) {
+            return value;
+        }
+    }
+    // 2. Fall back to OS keychain
+    const keychainSecret = await getStoredSecret();
+    if (keychainSecret) {
+        return keychainSecret;
+    }
+    throw new Error(`Client secret not found. Either:\n` +
+        `  1. Set the PARTNER_CLIENT_SECRET environment variable (or add it to .env), OR\n` +
+        `  2. Store it securely using: auth login`);
+}
+//# sourceMappingURL=credentials.js.map

package/dist/lib/credentials.js.map

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

package/dist/lib/demo-banner.d.ts

@@ -0,0 +1,15 @@
+/**
+ * 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
+ */
+export declare function showDemoBanner(): void;
+/**
+ * Reset the once-per-process flag. For tests only.
+ */
+export declare function resetDemoBannerForTests(): void;
+//# sourceMappingURL=demo-banner.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"demo-banner.d.ts","sourceRoot":"","sources":["../../src/lib/demo-banner.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAeH,wBAAgB,cAAc,IAAI,IAAI,CAIrC;AAED;;GAEG;AACH,wBAAgB,uBAAuB,IAAI,IAAI,CAE9C"}

package/dist/lib/demo-banner.js

@@ -0,0 +1,33 @@
+/**
+ * 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
+ */
+import chalk from "chalk";
+import { isQuietMode } from "./spinner.js";
+/**
+ * One-shot demo banner.
+ *
+ * In a long-lived process (the REPL especially) we don't want every
+ * command to repeat "⚠️  DEMO MODE - …" — once per process is enough
+ * to set context. Banners go to stderr so JSON / quiet stdout stays
+ * clean for tooling.
+ */
+let bannerShown = false;
+export function showDemoBanner() {
+    if (bannerShown || isQuietMode())
+        return;
+    bannerShown = true;
+    console.error(chalk.yellow("\n⚠️  DEMO MODE — using mock data\n"));
+}
+/**
+ * Reset the once-per-process flag. For tests only.
+ */
+export function resetDemoBannerForTests() {
+    bannerShown = false;
+}
+//# sourceMappingURL=demo-banner.js.map

package/dist/lib/demo-banner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"demo-banner.js","sourceRoot":"","sources":["../../src/lib/demo-banner.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAE3C;;;;;;;GAOG;AACH,IAAI,WAAW,GAAG,KAAK,CAAC;AAExB,MAAM,UAAU,cAAc;IAC5B,IAAI,WAAW,IAAI,WAAW,EAAE;QAAE,OAAO;IACzC,WAAW,GAAG,IAAI,CAAC;IACnB,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,qCAAqC,CAAC,CAAC,CAAC;AACrE,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,uBAAuB;IACrC,WAAW,GAAG,KAAK,CAAC;AACtB,CAAC"}

package/dist/lib/error-handler.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.
+ */
+/**
+ * Structured CLI error with recovery guidance.
+ *
+ * This wraps any error (typed or untyped) into a presentation-friendly
+ * format with causes, recovery steps, and context for the CLI output.
+ */
+export declare class CtaError extends Error {
+    readonly code: string;
+    readonly causes: string[];
+    readonly recovery: string[];
+    readonly context?: {
+        environmentUrl?: string;
+        tenantName?: string;
+        solutionName?: string;
+        clientId?: string;
+    } | undefined;
+    constructor(code: string, message: string, causes: string[], recovery: string[], context?: {
+        environmentUrl?: string;
+        tenantName?: string;
+        solutionName?: string;
+        clientId?: string;
+    } | undefined);
+}
+/**
+ * Maps any error to a structured CtaError with recovery guidance.
+ *
+ * 1. If the error is a typed CtaError from @pax8-cta/core, the
+ *    error code is used to select the appropriate guidance (no regex).
+ * 2. Otherwise, falls back to regex matching on the error message.
+ */
+export declare function formatError(error: unknown): CtaError;
+/**
+ * Prints a formatted error message with recovery guidance
+ */
+export declare function printError(error: CtaError): void;
+//# sourceMappingURL=error-handler.d.ts.map

package/dist/lib/error-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-handler.d.ts","sourceRoot":"","sources":["../../src/lib/error-handler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AA6BH;;;;;GAKG;AACH,qBAAa,QAAS,SAAQ,KAAK;aAEf,IAAI,EAAE,MAAM;aAEZ,MAAM,EAAE,MAAM,EAAE;aAChB,QAAQ,EAAE,MAAM,EAAE;aAClB,OAAO,CAAC,EAAE;QACxB,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB;gBATe,IAAI,EAAE,MAAM,EAC5B,OAAO,EAAE,MAAM,EACC,MAAM,EAAE,MAAM,EAAE,EAChB,QAAQ,EAAE,MAAM,EAAE,EAClB,OAAO,CAAC,EAAE;QACxB,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,YAAA;CAKJ;AA8eD;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,QAAQ,CAWpD;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI,CAyChD"}