@cat-indev/catops-cli 0.0.1-alpha.10

package/dist/core/prompt.js

@@ -0,0 +1,87 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ask = ask;
+exports.confirm = confirm;
+exports.select = select;
+const readline = __importStar(require("readline"));
+function createInterface() {
+    return readline.createInterface({
+        input: process.stdin,
+        output: process.stdout
+    });
+}
+async function ask(question, options = {}) {
+    const { defaultValue } = options;
+    const rl = createInterface();
+    const suffix = defaultValue !== undefined
+        ? ` (${defaultValue}) `
+        : " ";
+    try {
+        const answer = await new Promise(resolve => {
+            rl.question(`${question}${suffix}`, resolve);
+        });
+        return answer.trim() || defaultValue;
+    }
+    finally {
+        rl.close();
+    }
+}
+async function confirm(question, options = {}) {
+    const { defaultValue = true } = options;
+    const hint = defaultValue ? "Y/n" : "y/N";
+    const answer = await ask(`${question} [${hint}]`);
+    if (!answer)
+        return defaultValue;
+    return ["y", "yes", "s", "si", "sí"].includes(answer.toLowerCase());
+}
+async function select(title, choices) {
+    const entries = Array.isArray(choices)
+        ? choices.map((label, i) => [String(i), label])
+        : Object.entries(choices);
+    console.log(`\n${title}`);
+    entries.forEach(([, label], index) => {
+        console.log(`  ${index + 1}) ${label}`);
+    });
+    const answer = await ask("Selecciona una opción:");
+    const index = parseInt(answer ?? "", 10) - 1;
+    const entry = entries[index];
+    if (Number.isNaN(index) || !entry) {
+        console.log("Opción inválida, intenta de nuevo.");
+        return select(title, choices);
+    }
+    return entry[0];
+}
+//# sourceMappingURL=prompt.js.map

package/dist/core/prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.js","sourceRoot":"","sources":["../../src/core/prompt.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAaA,kBAsBC;AAMD,0BAYC;AAID,wBAyBC;AAlFD,mDAAqC;AAErC,SAAS,eAAe;IACpB,OAAO,QAAQ,CAAC,eAAe,CAAC;QAC5B,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,MAAM,EAAE,OAAO,CAAC,MAAM;KACzB,CAAC,CAAC;AACP,CAAC;AAMM,KAAK,UAAU,GAAG,CAAC,QAAgB,EAAE,UAAsB,EAAE;IAEhE,MAAM,EAAE,YAAY,EAAE,GAAG,OAAO,CAAC;IAEjC,MAAM,EAAE,GAAG,eAAe,EAAE,CAAC;IAE7B,MAAM,MAAM,GAAG,YAAY,KAAK,SAAS;QACrC,CAAC,CAAC,KAAK,YAAY,IAAI;QACvB,CAAC,CAAC,GAAG,CAAC;IAEV,IAAI,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,IAAI,OAAO,CAAS,OAAO,CAAC,EAAE;YAC/C,EAAE,CAAC,QAAQ,CAAC,GAAG,QAAQ,GAAG,MAAM,EAAE,EAAE,OAAO,CAAC,CAAC;QACjD,CAAC,CAAC,CAAC;QAEH,OAAO,MAAM,CAAC,IAAI,EAAE,IAAI,YAAY,CAAC;IAEzC,CAAC;YAAS,CAAC;QACP,EAAE,CAAC,KAAK,EAAE,CAAC;IACf,CAAC;AAEL,CAAC;AAMM,KAAK,UAAU,OAAO,CAAC,QAAgB,EAAE,UAA0B,EAAE;IAExE,MAAM,EAAE,YAAY,GAAG,IAAI,EAAE,GAAG,OAAO,CAAC;IAExC,MAAM,IAAI,GAAG,YAAY,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC;IAE1C,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,GAAG,QAAQ,KAAK,IAAI,GAAG,CAAC,CAAC;IAElD,IAAI,CAAC,MAAM;QAAE,OAAO,YAAY,CAAC;IAEjC,OAAO,CAAC,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC,CAAC;AAExE,CAAC;AAIM,KAAK,UAAU,MAAM,CAAC,KAAa,EAAE,OAAsB;IAE9D,MAAM,OAAO,GAAuB,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC;QACtD,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,CAAC,EAAoB,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;QACjE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAE9B,OAAO,CAAC,GAAG,CAAC,KAAK,KAAK,EAAE,CAAC,CAAC;IAE1B,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,KAAK,EAAE,EAAE;QACjC,OAAO,CAAC,GAAG,CAAC,KAAK,KAAK,GAAG,CAAC,KAAK,KAAK,EAAE,CAAC,CAAC;IAC5C,CAAC,CAAC,CAAC;IAEH,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,wBAAwB,CAAC,CAAC;IAEnD,MAAM,KAAK,GAAG,QAAQ,CAAC,MAAM,IAAI,EAAE,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC;IAE7C,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;IAE7B,IAAI,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;QAChC,OAAO,CAAC,GAAG,CAAC,oCAAoC,CAAC,CAAC;QAClD,OAAO,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IAClC,CAAC;IAED,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC;AAEpB,CAAC"}

package/dist/core/senders.d.ts

@@ -0,0 +1,27 @@
+import type { NotificationEvent, Sender } from "./types";
+export declare function log(): Sender;
+export interface FileSenderOptions {
+    path: string;
+}
+export declare function file({ path }: FileSenderOptions): Sender;
+export interface HttpSenderOptions {
+    url: string;
+    method?: string;
+    headers?: Record<string, string>;
+    /** Transforma el evento antes de enviarlo. Por defecto se manda tal cual. */
+    formatBody?: (event: NotificationEvent) => Promise<unknown> | unknown;
+}
+export declare function http({ url, method, headers, formatBody }: HttpSenderOptions): Sender;
+export interface WebhookSenderOptions {
+    url: string;
+    headers?: Record<string, string>;
+    /** Formatea el payload del webhook. Por defecto: { text: event.message }. */
+    format?: (event: NotificationEvent) => Promise<unknown> | unknown;
+}
+export declare function webhook({ url, headers, format }: WebhookSenderOptions): Sender;
+export interface WebSocketSenderOptions {
+    url: string;
+    /** Milisegundos a esperar antes de abortar. Default: 5000 */
+    timeout?: number;
+}
+export declare function websocket({ url, timeout }: WebSocketSenderOptions): Sender;

package/dist/core/senders.js

@@ -0,0 +1,109 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.log = log;
+exports.file = file;
+exports.http = http;
+exports.webhook = webhook;
+exports.websocket = websocket;
+const fs = __importStar(require("fs/promises"));
+const logger_1 = require("./logger");
+// ---------------------------------------------------------------------------
+// log — usa el logger interno, sin red ni disco
+// ---------------------------------------------------------------------------
+function log() {
+    return (event) => {
+        if (event.type === "error") {
+            logger_1.logger.error(`[${event.area ?? "?"}] ${event.taskId}: ${event.message}`);
+        }
+        else {
+            logger_1.logger.success(`${event.taskId}: ${event.message}`);
+        }
+    };
+}
+function file({ path }) {
+    return async (event) => {
+        await fs.appendFile(path, `${JSON.stringify(event)}\n`, "utf8");
+    };
+}
+function http({ url, method = "POST", headers = {}, formatBody }) {
+    return async (event) => {
+        const body = formatBody ? await formatBody(event) : event;
+        const response = await fetch(url, {
+            method,
+            headers: {
+                "Content-Type": "application/json",
+                ...headers
+            },
+            body: JSON.stringify(body)
+        });
+        if (!response.ok) {
+            throw new Error(`http sender: ${url} respondió ${response.status} ${response.statusText}`);
+        }
+    };
+}
+function webhook({ url, headers, format }) {
+    const formatBody = format ?? ((event) => ({
+        text: event.type === "error"
+            ? `❌ [${event.area}] ${event.taskId}: ${event.message}`
+            : `✅ ${event.taskId}: ${event.message}`
+    }));
+    return http({ url, headers, formatBody });
+}
+function websocket({ url, timeout = 5000 }) {
+    return (event) => new Promise((resolve, reject) => {
+        if (typeof WebSocket === "undefined") {
+            reject(new Error("El global WebSocket no está disponible en este runtime de Node. " +
+                "Usa Node >=22, o instala 'ws' en tu proyecto y arma tu propio sender con él."));
+            return;
+        }
+        const socket = new WebSocket(url);
+        const timer = setTimeout(() => {
+            socket.close();
+            reject(new Error(`websocket sender: timeout conectando a ${url}`));
+        }, timeout);
+        socket.addEventListener("open", () => {
+            socket.send(JSON.stringify(event));
+            clearTimeout(timer);
+            socket.close();
+            resolve();
+        });
+        socket.addEventListener("error", () => {
+            clearTimeout(timer);
+            reject(new Error(`websocket sender: error conectando a ${url}`));
+        });
+    });
+}
+//# sourceMappingURL=senders.js.map

package/dist/core/senders.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"senders.js","sourceRoot":"","sources":["../../src/core/senders.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAQA,kBAYC;AAUD,oBAMC;AAcD,oBAqBC;AAcD,0BAUC;AAaD,8BAiCC;AA7ID,gDAAkC;AAClC,qCAAkC;AAGlC,8EAA8E;AAC9E,gDAAgD;AAChD,8EAA8E;AAE9E,SAAgB,GAAG;IAEf,OAAO,CAAC,KAAwB,EAAE,EAAE;QAEhC,IAAI,KAAK,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;YACzB,eAAM,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,IAAI,IAAI,GAAG,KAAK,KAAK,CAAC,MAAM,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;QAC7E,CAAC;aAAM,CAAC;YACJ,eAAM,CAAC,OAAO,CAAC,GAAG,KAAK,CAAC,MAAM,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;QACxD,CAAC;IAEL,CAAC,CAAC;AAEN,CAAC;AAUD,SAAgB,IAAI,CAAC,EAAE,IAAI,EAAqB;IAE5C,OAAO,KAAK,EAAE,KAAwB,EAAE,EAAE;QACtC,MAAM,EAAE,CAAC,UAAU,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACpE,CAAC,CAAC;AAEN,CAAC;AAcD,SAAgB,IAAI,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,OAAO,GAAG,EAAE,EAAE,UAAU,EAAqB;IAEtF,OAAO,KAAK,EAAE,KAAwB,EAAE,EAAE;QAEtC,MAAM,IAAI,GAAG,UAAU,CAAC,CAAC,CAAC,MAAM,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;QAE1D,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;YAC9B,MAAM;YACN,OAAO,EAAE;gBACL,cAAc,EAAE,kBAAkB;gBAClC,GAAG,OAAO;aACb;YACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;SAC7B,CAAC,CAAC;QAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CAAC,gBAAgB,GAAG,cAAc,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAC;QAC/F,CAAC;IAEL,CAAC,CAAC;AAEN,CAAC;AAcD,SAAgB,OAAO,CAAC,EAAE,GAAG,EAAE,OAAO,EAAE,MAAM,EAAwB;IAElE,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,CAAC,KAAwB,EAAE,EAAE,CAAC,CAAC;QACzD,IAAI,EAAE,KAAK,CAAC,IAAI,KAAK,OAAO;YACxB,CAAC,CAAC,MAAM,KAAK,CAAC,IAAI,KAAK,KAAK,CAAC,MAAM,KAAK,KAAK,CAAC,OAAO,EAAE;YACvD,CAAC,CAAC,KAAK,KAAK,CAAC,MAAM,KAAK,KAAK,CAAC,OAAO,EAAE;KAC9C,CAAC,CAAC,CAAC;IAEJ,OAAO,IAAI,CAAC,EAAE,GAAG,EAAE,OAAO,EAAE,UAAU,EAAE,CAAC,CAAC;AAE9C,CAAC;AAaD,SAAgB,SAAS,CAAC,EAAE,GAAG,EAAE,OAAO,GAAG,IAAI,EAA0B;IAErE,OAAO,CAAC,KAAwB,EAAE,EAAE,CAAC,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QAEvE,IAAI,OAAO,SAAS,KAAK,WAAW,EAAE,CAAC;YACnC,MAAM,CAAC,IAAI,KAAK,CACZ,kEAAkE;gBAClE,8EAA8E,CACjF,CAAC,CAAC;YACH,OAAO;QACX,CAAC;QAED,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC,GAAG,CAAC,CAAC;QAElC,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;YAC1B,MAAM,CAAC,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,IAAI,KAAK,CAAC,0CAA0C,GAAG,EAAE,CAAC,CAAC,CAAC;QACvE,CAAC,EAAE,OAAO,CAAC,CAAC;QAEZ,MAAM,CAAC,gBAAgB,CAAC,MAAM,EAAE,GAAG,EAAE;YACjC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;YACnC,YAAY,CAAC,KAAK,CAAC,CAAC;YACpB,MAAM,CAAC,KAAK,EAAE,CAAC;YACf,OAAO,EAAE,CAAC;QACd,CAAC,CAAC,CAAC;QAEH,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,GAAG,EAAE;YAClC,YAAY,CAAC,KAAK,CAAC,CAAC;YACpB,MAAM,CAAC,IAAI,KAAK,CAAC,wCAAwC,GAAG,EAAE,CAAC,CAAC,CAAC;QACrE,CAAC,CAAC,CAAC;IAEP,CAAC,CAAC,CAAC;AAEP,CAAC"}

package/dist/core/types.d.ts

@@ -0,0 +1,135 @@
+import type { Context } from "./Context";
+export interface ExecResult {
+    code: number | null;
+    stdout: string;
+    stderr: string;
+    dryRun?: boolean;
+    timedOut?: boolean;
+    /** Comando ejecutado, útil para clasificar errores por área de TI. */
+    command?: string;
+    args?: string[];
+}
+export interface ExecOptions {
+    /** Número total de intentos (1 = sin retry). Default: 1 */
+    retry?: number;
+    /** Milisegundos de espera entre reintentos. Default: 1000 */
+    retryDelay?: number;
+    /** Milisegundos antes de matar el proceso con SIGTERM. Default: 0 (sin límite) */
+    timeout?: number;
+    /** Si es true, solo loguea el comando y no lo ejecuta. Default: false */
+    dryRun?: boolean;
+    /** Si se quiere ejecutar comandos en el shell del sistema directamente. Default: false */
+    shell?: boolean;
+}
+/**
+ * Error generado por `ctx.wrap()` cuando un servicio falla. Enriches el error
+ * original con el nombre del servicio, el método invocado y los argumentos,
+ * para que classifiers y formatters puedan resolver el área y el mensaje
+ * humano a partir de esa metadata.
+ *
+ * La propiedad `cause` contiene el error original (puede ser un ExecResult,
+ * un HttpError, un Error nativo, etc.).
+ */
+export declare class ServiceError extends Error {
+    readonly service: string;
+    readonly method: string;
+    readonly args: unknown[];
+    readonly cause: unknown;
+    constructor(service: string, method: string, args: unknown[], cause: unknown);
+}
+export type SuccessCallback<T = unknown> = (result: T, ctx: Context) => unknown | Promise<unknown>;
+export type ErrorCallback = (error: unknown, ctx: Context) => unknown | Promise<unknown>;
+export interface TaskHooks<T = unknown> {
+    onSuccess?: SuccessCallback<T>;
+    onError?: ErrorCallback;
+}
+export interface NotificationEvent {
+    type: "success" | "error";
+    /** Id de la tarea (taskId de ctx.run(), o el label del item de menú). */
+    taskId: string;
+    /** Área de TI a la que se enrutó el error (solo en eventos de error). */
+    area?: string;
+    error?: unknown;
+    result?: unknown;
+    message: string;
+    timestamp: string;
+    /** Servicio que falló (solo en errores de servicios envueltos con ctx.wrap). */
+    service?: string;
+    /** Método del servicio que falló. */
+    method?: string;
+    /** Argumentos pasados al método. */
+    args?: unknown[];
+}
+/**
+ * Determina a qué área de TI corresponde un error. Devuelve el nombre del
+ * área (usado luego para buscar los senders registrados en esa área vía
+ * notifier.channel(area, ...senders)), o `undefined` si esta función no
+ * sabe clasificar ese error (se prueba el siguiente classifier registrado).
+ */
+export type ErrorClassifier = (error: unknown, ctx: Context) => string | undefined;
+/** Un sender recibe el evento ya armado y lo entrega por el medio que sea. */
+export type Sender = (event: NotificationEvent) => unknown | Promise<unknown>;
+/** Una task ejecutable de un item de menú. Recibe el Context activo. */
+export type MenuTask = (ctx: Context) => unknown | Promise<unknown>;
+/**
+ * Forma "larga" de un item de menú, usada cuando necesitas asociarle un
+ * selector (para poder elegirlo automáticamente vía flag), callbacks de
+ * éxito/error, o ambos, además de su acción o submenú.
+ *
+ * Ejemplo:
+ *   Build: {
+ *       selector: "build",
+ *       action: async (ctx) => {...},
+ *       onSuccess: (result, ctx) => {...},
+ *       onError: (error, ctx) => {...}
+ *   }
+ *   Docker: { selector: "docker", menu: dockerMenu }
+ */
+export interface MenuOptionWithSelector {
+    /** Valor que debe matchear el flag definido en "flag-selector" del menú padre. */
+    selector?: string;
+    /** Task a ejecutar si este item es una hoja. */
+    action?: MenuTask;
+    /** Submenú a renderizar si este item lleva a otro nivel. */
+    menu?: MenuDefinition;
+    /** Se llama si `action` resuelve exitosamente. */
+    onSuccess?: SuccessCallback;
+    /** Se llama si `action` lanza un error (además de reportarse al notifier). */
+    onError?: ErrorCallback;
+}
+/**
+ * Valor de un item de menú. Puede ser:
+ *   - una función (task directa, sin selector ni callbacks)
+ *   - un MenuDefinition (submenú directo, sin selector)
+ *   - un MenuOptionWithSelector (para poder asignarle selector y/o callbacks)
+ */
+export type MenuOptionValue = MenuTask | MenuDefinition | MenuOptionWithSelector;
+export interface MenuDefinition {
+    title: string;
+    /**
+     * Nombre del flag (con o sin "--") que, al recibir un valor que matchee
+     * el "selector" de alguno de los items, selecciona esa opción de forma
+     * automática y no interactiva.
+     *
+     * Ejemplo: "flag-selector": "--menu-selector"
+     * Uso:     catops-cli --menu-selector=build
+     */
+    "flag-selector"?: string;
+    options: Record<string, MenuOptionValue>;
+}
+export interface ResolvedMenuEntry {
+    kind: "task" | "menu";
+    selector?: string;
+    run?: MenuTask;
+    menu?: MenuDefinition;
+    onSuccess?: SuccessCallback;
+    onError?: ErrorCallback;
+}
+/**
+ * Igual que ErrorClassifier, pero en vez de decidir el área, devuelve el
+ * mensaje humano que se va a reportar (reemplazando el stderr/mensaje crudo
+ * del error). Devuelve `undefined` si no sabe describir ese error (se
+ * prueba el siguiente formatter registrado, y si ninguno matchea se usa el
+ * mensaje crudo del error como antes).
+ */
+export type ErrorMessageFormatter = (error: unknown, ctx: Context) => string | undefined;

package/dist/core/types.js

@@ -0,0 +1,33 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ServiceError = void 0;
+// ---------------------------------------------------------------------------
+// ServiceError — error enriquecido con metadata del servicio
+// ---------------------------------------------------------------------------
+/**
+ * Error generado por `ctx.wrap()` cuando un servicio falla. Enriches el error
+ * original con el nombre del servicio, el método invocado y los argumentos,
+ * para que classifiers y formatters puedan resolver el área y el mensaje
+ * humano a partir de esa metadata.
+ *
+ * La propiedad `cause` contiene el error original (puede ser un ExecResult,
+ * un HttpError, un Error nativo, etc.).
+ */
+class ServiceError extends Error {
+    constructor(service, method, args, cause) {
+        const originalMessage = cause instanceof Error
+            ? cause.message
+            : cause?.message ?? String(cause);
+        super(`${service}.${method}: ${originalMessage}`);
+        this.name = "ServiceError";
+        this.service = service;
+        this.method = method;
+        this.args = args;
+        this.cause = cause;
+        if (cause instanceof Error && cause.stack) {
+            this.stack = `${this.message}\n\n--- Original stack ---\n${cause.stack}`;
+        }
+    }
+}
+exports.ServiceError = ServiceError;
+//# sourceMappingURL=types.js.map

package/dist/core/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":";;;AA8BA,8EAA8E;AAC9E,6DAA6D;AAC7D,8EAA8E;AAE9E;;;;;;;;GAQG;AACH,MAAa,YAAa,SAAQ,KAAK;IAMnC,YAAY,OAAe,EAAE,MAAc,EAAE,IAAe,EAAE,KAAc;QACxE,MAAM,eAAe,GAAG,KAAK,YAAY,KAAK;YAC1C,CAAC,CAAC,KAAK,CAAC,OAAO;YACf,CAAC,CAAE,KAA8B,EAAE,OAAO,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC;QAEhE,KAAK,CAAC,GAAG,OAAO,IAAI,MAAM,KAAK,eAAe,EAAE,CAAC,CAAC;QAElD,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;QAC3B,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QAEnB,IAAI,KAAK,YAAY,KAAK,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;YACxC,IAAI,CAAC,KAAK,GAAG,GAAG,IAAI,CAAC,OAAO,+BAA+B,KAAK,CAAC,KAAK,EAAE,CAAC;QAC7E,CAAC;IACL,CAAC;CACJ;AAvBD,oCAuBC"}

package/dist/index.d.ts

@@ -0,0 +1,20 @@
+export { Context } from "./core/Context";
+export type { FlagValue } from "./core/Context";
+export { Menu } from "./core/Menu";
+export { logger } from "./core/logger";
+export type { Logger } from "./core/logger";
+export * as prompt from "./core/prompt";
+export { services } from "./services";
+export type { ServicesRegistry } from "./services";
+export { PipelineRegistry, Pipeline, PipelineStage, PipelineJob, PipelineTask, PipelineResultsAccessor } from "./services/pipeline";
+export type { PipelineConfig, PipelineStageConfig, PipelineJobConfig, PipelineTaskConfig, PipelineTaskBase, CallbackTaskConfig, PipelineRunResult, PipelineEntityStatus } from "./services/pipeline";
+export { http, HttpService, HttpRegistry } from "./services/http";
+export type { HttpMethod, HttpRequest, HttpResponse, HttpServiceConfig, RequestInterceptor, ResponseInterceptor, RequestContext, ResponseContext } from "./services/http-types";
+export { AzureDevOpsApi } from "./services/azdo-api";
+export type { AzureDevOpsApiConfig, AzdoRequestOptions, AzdoProject, AzdoGitRepository, AzdoGitBranch, AzdoGitCommitRef, AzdoGitAuthor, AzdoGitPullRequest, AzdoBuildDefinition, AzdoBuild, AzdoPipeline, AzdoWorkItem, AzdoListResponse } from "./services/azdo-api";
+export { Notifier } from "./core/Notifier";
+export * as senders from "./core/senders";
+export * as classifiers from "./core/classifiers";
+export * as messages from "./core/messages";
+export type { ExecOptions, ExecResult, MenuTask, MenuOptionWithSelector, MenuOptionValue, MenuDefinition, ResolvedMenuEntry, TaskHooks, SuccessCallback, ErrorCallback, NotificationEvent, ErrorClassifier, ErrorMessageFormatter, Sender } from "./core/types";
+export { ServiceError } from "./core/types";

package/dist/index.js

@@ -0,0 +1,66 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ServiceError = exports.messages = exports.classifiers = exports.senders = exports.Notifier = exports.AzureDevOpsApi = exports.HttpRegistry = exports.HttpService = exports.http = exports.PipelineResultsAccessor = exports.PipelineTask = exports.PipelineJob = exports.PipelineStage = exports.Pipeline = exports.PipelineRegistry = exports.services = exports.prompt = exports.logger = exports.Menu = exports.Context = void 0;
+var Context_1 = require("./core/Context");
+Object.defineProperty(exports, "Context", { enumerable: true, get: function () { return Context_1.Context; } });
+var Menu_1 = require("./core/Menu");
+Object.defineProperty(exports, "Menu", { enumerable: true, get: function () { return Menu_1.Menu; } });
+var logger_1 = require("./core/logger");
+Object.defineProperty(exports, "logger", { enumerable: true, get: function () { return logger_1.logger; } });
+exports.prompt = __importStar(require("./core/prompt"));
+var services_1 = require("./services");
+Object.defineProperty(exports, "services", { enumerable: true, get: function () { return services_1.services; } });
+var pipeline_1 = require("./services/pipeline");
+Object.defineProperty(exports, "PipelineRegistry", { enumerable: true, get: function () { return pipeline_1.PipelineRegistry; } });
+Object.defineProperty(exports, "Pipeline", { enumerable: true, get: function () { return pipeline_1.Pipeline; } });
+Object.defineProperty(exports, "PipelineStage", { enumerable: true, get: function () { return pipeline_1.PipelineStage; } });
+Object.defineProperty(exports, "PipelineJob", { enumerable: true, get: function () { return pipeline_1.PipelineJob; } });
+Object.defineProperty(exports, "PipelineTask", { enumerable: true, get: function () { return pipeline_1.PipelineTask; } });
+Object.defineProperty(exports, "PipelineResultsAccessor", { enumerable: true, get: function () { return pipeline_1.PipelineResultsAccessor; } });
+var http_1 = require("./services/http");
+Object.defineProperty(exports, "http", { enumerable: true, get: function () { return http_1.http; } });
+Object.defineProperty(exports, "HttpService", { enumerable: true, get: function () { return http_1.HttpService; } });
+Object.defineProperty(exports, "HttpRegistry", { enumerable: true, get: function () { return http_1.HttpRegistry; } });
+var azdo_api_1 = require("./services/azdo-api");
+Object.defineProperty(exports, "AzureDevOpsApi", { enumerable: true, get: function () { return azdo_api_1.AzureDevOpsApi; } });
+var Notifier_1 = require("./core/Notifier");
+Object.defineProperty(exports, "Notifier", { enumerable: true, get: function () { return Notifier_1.Notifier; } });
+exports.senders = __importStar(require("./core/senders"));
+exports.classifiers = __importStar(require("./core/classifiers"));
+exports.messages = __importStar(require("./core/messages"));
+var types_1 = require("./core/types");
+Object.defineProperty(exports, "ServiceError", { enumerable: true, get: function () { return types_1.ServiceError; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,0CAAyC;AAAhC,kGAAA,OAAO,OAAA;AAGhB,oCAAmC;AAA1B,4FAAA,IAAI,OAAA;AAEb,wCAAuC;AAA9B,gGAAA,MAAM,OAAA;AAGf,wDAAwC;AAExC,uCAAsC;AAA7B,oGAAA,QAAQ,OAAA;AAGjB,gDAAoI;AAA3H,4GAAA,gBAAgB,OAAA;AAAE,oGAAA,QAAQ,OAAA;AAAE,yGAAA,aAAa,OAAA;AAAE,uGAAA,WAAW,OAAA;AAAE,wGAAA,YAAY,OAAA;AAAE,mHAAA,uBAAuB,OAAA;AAYtG,wCAAkE;AAAzD,4FAAA,IAAI,OAAA;AAAE,mGAAA,WAAW,OAAA;AAAE,oGAAA,YAAY,OAAA;AAYxC,gDAAqD;AAA5C,0GAAA,cAAc,OAAA;AAiBvB,4CAA2C;AAAlC,oGAAA,QAAQ,OAAA;AACjB,0DAA0C;AAC1C,kEAAkD;AAClD,4DAA4C;AAmB5C,sCAA4C;AAAnC,qGAAA,YAAY,OAAA"}

package/dist/services/ansible.d.ts

@@ -0,0 +1,12 @@
+import type { ExecOptions, ExecResult } from "../core/types";
+export interface AnsiblePlaybookOptions {
+    inventory?: string;
+    extraVars?: Record<string, string>;
+    tags?: string;
+    exec?: ExecOptions;
+}
+export declare function playbook(playbookPath: string, { inventory, extraVars, tags, exec }?: AnsiblePlaybookOptions): Promise<ExecResult>;
+export declare function adhoc(host: string, module: string, moduleArgs?: string, exec?: ExecOptions): Promise<ExecResult>;
+export declare function vaultEncrypt(file: string, exec?: ExecOptions): Promise<ExecResult>;
+export declare function vaultDecrypt(file: string, exec?: ExecOptions): Promise<ExecResult>;
+export declare function galaxyInstall(requirementsFile: string, exec?: ExecOptions): Promise<ExecResult>;

package/dist/services/ansible.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.playbook = playbook;
+exports.adhoc = adhoc;
+exports.vaultEncrypt = vaultEncrypt;
+exports.vaultDecrypt = vaultDecrypt;
+exports.galaxyInstall = galaxyInstall;
+const shell_1 = require("./shell");
+function playbook(playbookPath, { inventory, extraVars = {}, tags, exec } = {}) {
+    const args = ["-i", inventory || "inventory.ini", playbookPath];
+    Object.entries(extraVars).forEach(([k, v]) => {
+        args.push("--extra-vars", `${k}=${v}`);
+    });
+    if (tags) {
+        args.push("--tags", tags);
+    }
+    return shell_1.shell.exec("ansible-playbook", ...(0, shell_1.withExecOptions)(args, exec));
+}
+function adhoc(host, module, moduleArgs, exec) {
+    const args = [host, "-m", module];
+    if (moduleArgs) {
+        args.push("-a", moduleArgs);
+    }
+    return shell_1.shell.exec("ansible", ...(0, shell_1.withExecOptions)(args, exec));
+}
+function vaultEncrypt(file, exec) {
+    return shell_1.shell.exec("ansible-vault", ...(0, shell_1.withExecOptions)(["encrypt", file], exec));
+}
+function vaultDecrypt(file, exec) {
+    return shell_1.shell.exec("ansible-vault", ...(0, shell_1.withExecOptions)(["decrypt", file], exec));
+}
+function galaxyInstall(requirementsFile, exec) {
+    return shell_1.shell.exec("ansible-galaxy", ...(0, shell_1.withExecOptions)(["install", "-r", requirementsFile], exec));
+}
+//# sourceMappingURL=ansible.js.map

package/dist/services/ansible.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ansible.js","sourceRoot":"","sources":["../../src/services/ansible.ts"],"names":[],"mappings":";;AAUA,4BAcC;AAED,sBAUC;AAED,oCAEC;AAED,oCAEC;AAED,sCAEC;AAhDD,mCAAiD;AAUjD,SAAgB,QAAQ,CAAC,YAAoB,EAAE,EAAE,SAAS,EAAE,SAAS,GAAG,EAAE,EAAE,IAAI,EAAE,IAAI,KAA6B,EAAE;IAEjH,MAAM,IAAI,GAAG,CAAC,IAAI,EAAE,SAAS,IAAI,eAAe,EAAE,YAAY,CAAC,CAAC;IAEhE,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE;QACzC,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC3C,CAAC,CAAC,CAAC;IAEH,IAAI,IAAI,EAAE,CAAC;QACP,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;IAC9B,CAAC;IAED,OAAO,aAAK,CAAC,IAAI,CAAC,kBAAkB,EAAE,GAAG,IAAA,uBAAe,EAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;AAE1E,CAAC;AAED,SAAgB,KAAK,CAAC,IAAY,EAAE,MAAc,EAAE,UAAmB,EAAE,IAAkB;IAEvF,MAAM,IAAI,GAAG,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;IAElC,IAAI,UAAU,EAAE,CAAC;QACb,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IAChC,CAAC;IAED,OAAO,aAAK,CAAC,IAAI,CAAC,SAAS,EAAE,GAAG,IAAA,uBAAe,EAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;AAEjE,CAAC;AAED,SAAgB,YAAY,CAAC,IAAY,EAAE,IAAkB;IACzD,OAAO,aAAK,CAAC,IAAI,CAAC,eAAe,EAAE,GAAG,IAAA,uBAAe,EAAC,CAAC,SAAS,EAAE,IAAI,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC;AACpF,CAAC;AAED,SAAgB,YAAY,CAAC,IAAY,EAAE,IAAkB;IACzD,OAAO,aAAK,CAAC,IAAI,CAAC,eAAe,EAAE,GAAG,IAAA,uBAAe,EAAC,CAAC,SAAS,EAAE,IAAI,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC;AACpF,CAAC;AAED,SAAgB,aAAa,CAAC,gBAAwB,EAAE,IAAkB;IACtE,OAAO,aAAK,CAAC,IAAI,CAAC,gBAAgB,EAAE,GAAG,IAAA,uBAAe,EAAC,CAAC,SAAS,EAAE,IAAI,EAAE,gBAAgB,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC;AACvG,CAAC"}

package/dist/services/archive.d.ts

@@ -0,0 +1,4 @@
+import type { ExecOptions, ExecResult } from "../core/types";
+export declare function zip(source: string, target: string, exec?: ExecOptions): Promise<ExecResult>;
+export declare function unzip(file: string, target: string, exec?: ExecOptions): Promise<ExecResult>;
+export declare function tar(source: string, target: string, exec?: ExecOptions): Promise<ExecResult>;

package/dist/services/archive.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.zip = zip;
+exports.unzip = unzip;
+exports.tar = tar;
+const shell_1 = require("./shell");
+function zip(source, target, exec) {
+    return shell_1.shell.exec("zip", ...(0, shell_1.withExecOptions)(["-r", target, source], exec));
+}
+function unzip(file, target, exec) {
+    return shell_1.shell.exec("unzip", ...(0, shell_1.withExecOptions)([file, "-d", target], exec));
+}
+function tar(source, target, exec) {
+    return shell_1.shell.exec("tar", ...(0, shell_1.withExecOptions)(["-czf", target, source], exec));
+}
+//# sourceMappingURL=archive.js.map

package/dist/services/archive.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"archive.js","sourceRoot":"","sources":["../../src/services/archive.ts"],"names":[],"mappings":";;AAGA,kBAEC;AAED,sBAEC;AAED,kBAEC;AAbD,mCAAiD;AAGjD,SAAgB,GAAG,CAAC,MAAc,EAAE,MAAc,EAAE,IAAkB;IAClE,OAAO,aAAK,CAAC,IAAI,CAAC,KAAK,EAAE,GAAG,IAAA,uBAAe,EAAC,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC;AAC/E,CAAC;AAED,SAAgB,KAAK,CAAC,IAAY,EAAE,MAAc,EAAE,IAAkB;IAClE,OAAO,aAAK,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,IAAA,uBAAe,EAAC,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC;AAC/E,CAAC;AAED,SAAgB,GAAG,CAAC,MAAc,EAAE,MAAc,EAAE,IAAkB;IAClE,OAAO,aAAK,CAAC,IAAI,CAAC,KAAK,EAAE,GAAG,IAAA,uBAAe,EAAC,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC;AACjF,CAAC"}

package/dist/services/argocd.d.ts

@@ -0,0 +1,23 @@
+import type { ExecOptions, ExecResult } from "../core/types";
+export interface ArgoLoginOptions {
+    server: string;
+    username: string;
+    password: string;
+    insecure?: boolean;
+    exec?: ExecOptions;
+}
+export interface ArgoSyncOptions {
+    prune?: boolean;
+    exec?: ExecOptions;
+}
+export interface ArgoWaitOptions {
+    timeout?: number;
+    exec?: ExecOptions;
+}
+export declare function login({ server, username, password, insecure, exec }: ArgoLoginOptions): Promise<ExecResult>;
+export declare function appSync(name: string, { prune, exec }?: ArgoSyncOptions): Promise<ExecResult>;
+export declare function appGet(name: string, exec?: ExecOptions): Promise<ExecResult>;
+export declare function appWait(name: string, { timeout, exec }?: ArgoWaitOptions): Promise<ExecResult>;
+export declare function appSet(name: string, params?: Record<string, string>, exec?: ExecOptions): Promise<ExecResult>;
+export declare function appList(exec?: ExecOptions): Promise<ExecResult>;
+export declare function appRollback(name: string, revisionId: string, exec?: ExecOptions): Promise<ExecResult>;