@cat-indev/catops-cli 0.0.1-alpha.11 → 0.0.1-alpha.12

package/README.md

@@ -5,7 +5,7 @@ Framework para pipelines DevOps, escrito en **TypeScript** (100% usable desde Ja
 Trae:
 
 - Un **ExecutionContext** compartido (`flags`, `params`, `env`, `vars`, `results`, `logger`, `services`, `notifier`) para que ninguna task tenga que recibir parámetros manualmente.
-- **15 servicios** listos (`shell`, `docker`, `git`, `kubectl`, `helm`, `npm`, `archive`, `terraform`, `ansible`, `argocd`, `tekton`, `oc`, `az`, `azdo`, `http`) + un **cliente REST API** para Azure DevOps (`AzureDevOpsApi`) + un **motor de pipelines** declarativo con dependencias (`Pipeline`).
+- **16 servicios** listos (`shell`, `docker`, `git`, `kubectl`, `helm`, `npm`, `archive`, `terraform`, `ansible`, `argocd`, `tekton`, `oc`, `az`, `azdo`, `http`, `yaml`) + un **cliente REST API** para Azure DevOps (`AzureDevOpsApi`) + un **motor de pipelines** declarativo con dependencias (`Pipeline`).
 - **Servicio HTTP** con interceptores de request/response, registry de agentes nombrados, configuración global, query params, dry-run y timeout.
 - **Menús interactivos** con navegación anidada y **selección automática por flag** (para correr pipelines sin prompts, ideal para CI).
 - **retry / timeout / dryRun** en cada comando de shell.
@@ -52,10 +52,10 @@ Cualquiera de las 4 deja disponibles dos cosas en el proyecto consumidor:
 
 1. La librería, tanto desde TS como desde JS puro:
    ```typescript
-   import { Context, Menu, services, type MenuDefinition } from "catops-cli";
+   import { Context, Menu, services, YamlService, type MenuDefinition } from "catops-cli";
    ```
    ```javascript
-   const { Context, Menu, services } = require("catops-cli");
+   const { Context, Menu, services, YamlService } = require("catops-cli");
    ```
 2. El binario: `npx catops-cli` (o `catops-cli` si lo instalaste global con `-g`).
 
@@ -89,7 +89,8 @@ src/
     http.ts           -> cliente HTTP con interceptores de request/response, múltiples instancias
     http-types.ts     -> tipos del servicio HTTP (HttpRequest, HttpResponse, interceptors, ...)
     docker.ts, git.ts, kubectl.ts, helm.ts, npm.ts, archive.ts
-    terraform.ts, ansible.ts, argocd.ts, tekton.ts, oc.ts,     az.ts, azdo.ts, azdo-api.ts, pipeline.ts
+    terraform.ts, ansible.ts, argocd.ts, tekton.ts, oc.ts, az.ts, azdo.ts, azdo-api.ts, pipeline.ts
+    yaml.ts              -> YamlService: manipulación de archivos YAML con prepare(), multidocument, comentarios
     index.ts           -> registra todos los servicios anteriores (ServicesRegistry)
   index.ts             -> entry point público: Context, Menu, Notifier, senders, classifiers, messages, services, http, tipos
   bin/
@@ -100,8 +101,8 @@ test/
     context.test.js, shell.test.js, services.test.js, menu-selector.test.js,
   notifier.test.js, senders.test.js, hooks-integration.test.js,
   http.test.js, kubectl.test.js, oc.test.js, deployment-group.test.js,
-  exec-options-passthrough.test.js, azdo-api.test.js, pipeline.test.js,
-  service-notify.test.js
+  exec-options-passthrough.test.js,   azdo-api.test.js, pipeline.test.js,
+  service-notify.test.js, yaml.test.js
 ```
 
 ## Uso rápido: menú con `devops.pipeline.js` + el bin
@@ -1223,6 +1224,170 @@ const docker = ctx.wrap(ctx.services.docker, "docker");
 docker.version; // pasa directo, sin proxy
 ```
 
+## Servicio YAML: manipulación de archivos de configuración (`ctx.services.yaml`)
+
+Un servicio para leer, modificar y serializar archivos YAML con soporte para operaciones declarativas, comentarios, y documentos múltiples.
+
+### Uso básico
+
+```typescript
+// Parsear YAML desde string
+ctx.services.yaml.fromYaml(`
+apiVersion: v1
+kind: ConfigMap
+metadata:
+  name: app-config
+data:
+  ENV: production
+`);
+
+// Obtener valores
+ctx.services.yaml.yamlGet("metadata.name");            // "app-config"
+ctx.services.yaml.yamlGet("data.ENV", "default");     // "production"
+
+// Asignar valores (crea paths nuevos si no existen)
+ctx.services.yaml.yamlSet(["data", "DEBUG"], "false");
+
+// Serializar a YAML
+const yamlString = ctx.services.yaml.yamlify();
+
+// Serializar a JSON
+const jsonString = ctx.services.yaml.stringify();
+```
+
+### Trabajar con JSON
+
+```typescript
+// Convertir JSON a YAML interno
+ctx.services.yaml.fromJson({
+    apiVersion: "v1",
+    kind: "Service",
+    metadata: { name: "api-service" }
+});
+
+// Obtener como objeto JSON
+const obj = ctx.services.yaml.jsonify();
+```
+
+### Arrays y omisión de keys
+
+```typescript
+// Agregar elementos a un array
+ctx.services.yaml.yamlPush(["data", "ALLOWED_HOSTS"], ["host1.example.com", "host2.example.com"]);
+
+// Concatenar al inicio de un string
+ctx.services.yaml.yamlConcatInitAndSet(["data", "PREFIX"], "prod-");  // "prod-valor-anterior"
+
+// Eliminar paths del documento
+ctx.services.yaml.yamlOmit(["data", "DEBUG", "data", "TEMP"]);
+```
+
+### Comentarios
+
+```typescript
+// Agregar commentBefore a un nodo específico
+ctx.services.yaml.comment("Configuración del backend", ["data", "BACKEND_URL"]);
+```
+
+### Declaraciones batch con `prepare()`
+
+`prepare()` permite aplicar múltiples mutaciones en una sola llamada — ideal para transformaciones complejas:
+
+```typescript
+ctx.services.yaml.prepare({
+    // Asignar valores por path
+    $set: [
+        { path: "apiVersion", value: "v1" },
+        { path: "metadata.labels.env", value: "production" }
+    ],
+
+    // Agregar a arrays
+    $push: [
+        { path: "spec.containers", value: { name: "sidecar", image: "proxy:v1" } }
+    ],
+
+    // Fusionar objetos existentes
+    $spread: [
+        { path: "metadata.labels", value: { version: "v2", team: "platform" } }
+    ],
+
+    // Asignar el mismo valor a múltiples paths
+    $superSet: {
+        value: "true",
+        $set: ["data.ENABLE_FEATURE_A", "data.ENABLE_FEATURE_B"],
+        $init: ["data.PREFIX"]  // concatena al inicio en vez de reemplazar
+    },
+
+    // Asignar valores por path (shorthand)
+    $merge: {
+        "data.RETRY_COUNT": "3",
+        "data.TIMEOUT": "30000"
+    },
+
+    // Eliminar keys
+    $delete: ["data.DEBUG", "data.TEMP"]
+});
+```
+
+### Documentos múltiples
+
+Para archivos YAML con múltiples documentos separados por `---`:
+
+```typescript
+// Crear documentos múltiples
+ctx.services.yaml.multidocument(
+    { yaml: "kind: Deployment\nmetadata:\n  name: api", name: "deployment" },
+    { replicas: 3 }  // apply extra values sobre el nuevo doc
+);
+
+ctx.services.yaml.multidocument(
+    { yaml: "kind: Service\nmetadata:\n  name: api-svc", name: "service" }
+);
+
+// Cambiar entre documentos
+ctx.services.yaml.use("deployment");
+console.log(ctx.services.yaml.yamlify());  // imprime el doc "deployment"
+
+ctx.services.yaml.use("service");
+console.log(ctx.services.yaml.yamlify());  // imprime el doc "service"
+
+// Verificar si un documento existe
+ctx.services.yaml.existDocument("deployment");  // true
+```
+
+### Clonar
+
+```typescript
+const clone = ctx.services.yaml.clone();
+// clone es independiente — modificar uno no afecta al otro
+```
+
+### Parsear YAML vacío
+
+```typescript
+ctx.services.yaml.fromYaml("");  // crea documento vacío, no lanza error
+```
+
+### Ejemplo completo: modificar un Deployment de Kubernetes
+
+```typescript
+ctx.services.yaml.fromYaml(readFileSync("deployment.yaml", "utf8"));
+
+ctx.services.yaml.prepare({
+    $set: [
+        { path: "spec.template.metadata.labels.version", value: "v2.1.0" },
+        { path: "spec.template.spec.containers.0.image", value: "registry/app:v2.1.0" }
+    ],
+    $spread: [
+        { path: "spec.template.metadata.annotations", value: { "deployed-at": new Date().toISOString() } }
+    ],
+    $delete: ["spec.template.spec.initContainers"]
+});
+
+const updatedYaml = ctx.services.yaml.yamlify();
+writeFileSync("deployment.yaml", updatedYaml);
+```
+
 ## Tests
 
 ```bash
@@ -1245,6 +1410,7 @@ npm test
 - `azdo-api.test.js` — AzureDevOpsApi contra mock server: proyectos, repos, branches, commits, PRs, builds, pipelines, work items, overrides
 - `pipeline.test.js` — Pipeline motor: stages/jobs/tasks, dependencias cross-level con paths dotted, resultados jerárquicos (stage.job.task), fluent API, registry, reset, ctx access, detección de tipo por propiedad, PipelineResultsAccessor
 - `service-notify.test.js` — ServiceError, ctx.wrap(), Notifier con service/method/args, classifiers.byService/messages.byService, unwrap de ServiceError en byCommand/byPattern/byRule, integración completa, backward compat
+- `yaml.test.js` — YamlService: fromYaml/fromJson, yamlGet/yamlSet/yamlPush/yamlOmit, comment(), prepare() con $set/$push/$spread/$superSet/$merge/$delete, multidocument/use/clone
 
 ## Siguientes pasos posibles
 
@@ -1252,3 +1418,4 @@ npm test
 - Agregar más plugins (`ansible-lint`, `trivy`, `sonar-scanner`) con el mismo patrón que `terraform.ts`/`docker.ts`.
 - CI propio (GitHub Actions/Azure Pipelines) que corra `npm test` en cada PR antes de `npm publish`.
 - `--catch=throw` (o similar) para que un item de menú fallido mate el proceso completo en vez de solo loguear y seguir — útil corriendo vía `--menu-selector` dentro de un step de Azure Pipelines.
+- Exportar tipos YAML (`YamlPrepareActions`) y crear helpers para templates comunes (Kubernetes manifests, Helm values, etc.).

package/dist/index.d.ts

@@ -8,6 +8,8 @@ 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 { YamlService } from "./services/yaml";
+export type { YamlPrepareActions } from "./services/yaml";
 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";

package/dist/index.js

@@ -33,7 +33,7 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 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;
+exports.ServiceError = exports.messages = exports.classifiers = exports.senders = exports.Notifier = exports.AzureDevOpsApi = exports.HttpRegistry = exports.HttpService = exports.http = exports.YamlService = 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");
@@ -50,6 +50,8 @@ Object.defineProperty(exports, "PipelineStage", { enumerable: true, get: functio
 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 yaml_1 = require("./services/yaml");
+Object.defineProperty(exports, "YamlService", { enumerable: true, get: function () { return yaml_1.YamlService; } });
 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; } });

package/dist/index.js.map

@@ -1 +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;AA6BvB,4CAA2C;AAAlC,oGAAA,QAAQ,OAAA;AACjB,0DAA0C;AAC1C,kEAAkD;AAClD,4DAA4C;AAmB5C,sCAA4C;AAAnC,qGAAA,YAAY,OAAA"}
+{"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,wCAA8C;AAArC,mGAAA,WAAW,OAAA;AAGpB,wCAAkE;AAAzD,4FAAA,IAAI,OAAA;AAAE,mGAAA,WAAW,OAAA;AAAE,oGAAA,YAAY,OAAA;AAYxC,gDAAqD;AAA5C,0GAAA,cAAc,OAAA;AA6BvB,4CAA2C;AAAlC,oGAAA,QAAQ,OAAA;AACjB,0DAA0C;AAC1C,kEAAkD;AAClD,4DAA4C;AAmB5C,sCAA4C;AAAnC,qGAAA,YAAY,OAAA"}

package/dist/services/index.d.ts

@@ -14,6 +14,7 @@ import * as az from "./az";
 import * as azdo from "./azdo";
 import * as http from "./http";
 import { PipelineRegistry } from "./pipeline";
+import { YamlService } from "./yaml";
 export declare const services: {
     shell: import("./shell").Shell;
     docker: typeof docker;
@@ -31,7 +32,10 @@ export declare const services: {
     azdo: typeof azdo;
     http: typeof http;
     pipeline: PipelineRegistry;
+    yaml: YamlService;
 };
 export type ServicesRegistry = typeof services;
 export { shell, docker, git, kubectl, helm, npm, archive, terraform, ansible, argocd, tekton, oc, az, azdo, http };
 export { PipelineRegistry } from "./pipeline";
+export { YamlService } from "./yaml";
+export type { YamlPrepareActions } from "./yaml";

package/dist/services/index.js

@@ -33,7 +33,7 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.PipelineRegistry = exports.http = exports.azdo = exports.az = exports.oc = exports.tekton = exports.argocd = exports.ansible = exports.terraform = exports.archive = exports.npm = exports.helm = exports.kubectl = exports.git = exports.docker = exports.shell = exports.services = void 0;
+exports.YamlService = exports.PipelineRegistry = exports.http = exports.azdo = exports.az = exports.oc = exports.tekton = exports.argocd = exports.ansible = exports.terraform = exports.archive = exports.npm = exports.helm = exports.kubectl = exports.git = exports.docker = exports.shell = exports.services = void 0;
 const shell_1 = require("./shell");
 Object.defineProperty(exports, "shell", { enumerable: true, get: function () { return shell_1.shell; } });
 const docker = __importStar(require("./docker"));
@@ -65,6 +65,7 @@ exports.azdo = azdo;
 const http = __importStar(require("./http"));
 exports.http = http;
 const pipeline_1 = require("./pipeline");
+const yaml_1 = require("./yaml");
 exports.services = {
     shell: shell_1.shell,
     docker,
@@ -81,8 +82,11 @@ exports.services = {
     az,
     azdo,
     http,
-    pipeline: new pipeline_1.PipelineRegistry()
+    pipeline: new pipeline_1.PipelineRegistry(),
+    yaml: new yaml_1.YamlService()
 };
 var pipeline_2 = require("./pipeline");
 Object.defineProperty(exports, "PipelineRegistry", { enumerable: true, get: function () { return pipeline_2.PipelineRegistry; } });
+var yaml_2 = require("./yaml");
+Object.defineProperty(exports, "YamlService", { enumerable: true, get: function () { return yaml_2.YamlService; } });
 //# sourceMappingURL=index.js.map

package/dist/services/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/services/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,mCAAgC;AAuC5B,sFAvCK,aAAK,OAuCL;AAtCT,iDAAmC;AAuC/B,wBAAM;AAtCV,2CAA6B;AAuCzB,kBAAG;AAtCP,mDAAqC;AAuCjC,0BAAO;AAtCX,6CAA+B;AAuC3B,oBAAI;AAtCR,2CAA6B;AAuCzB,kBAAG;AAtCP,mDAAqC;AAuCjC,0BAAO;AAtCX,uDAAyC;AAuCrC,8BAAS;AAtCb,mDAAqC;AAuCjC,0BAAO;AAtCX,iDAAmC;AAuC/B,wBAAM;AAtCV,iDAAmC;AAuC/B,wBAAM;AAtCV,yCAA2B;AAuCvB,gBAAE;AAtCN,yCAA2B;AAuCvB,gBAAE;AAtCN,6CAA+B;AAuC3B,oBAAI;AAtCR,6CAA+B;AAuC3B,oBAAI;AAtCR,yCAA8C;AAEjC,QAAA,QAAQ,GAAG;IACpB,KAAK,EAAL,aAAK;IACL,MAAM;IACN,GAAG;IACH,OAAO;IACP,IAAI;IACJ,GAAG;IACH,OAAO;IACP,SAAS;IACT,OAAO;IACP,MAAM;IACN,MAAM;IACN,EAAE;IACF,EAAE;IACF,IAAI;IACJ,IAAI;IACJ,QAAQ,EAAE,IAAI,2BAAgB,EAAE;CACnC,CAAC;AAsBF,uCAA8C;AAArC,4GAAA,gBAAgB,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/services/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,mCAAgC;AAyC5B,sFAzCK,aAAK,OAyCL;AAxCT,iDAAmC;AAyC/B,wBAAM;AAxCV,2CAA6B;AAyCzB,kBAAG;AAxCP,mDAAqC;AAyCjC,0BAAO;AAxCX,6CAA+B;AAyC3B,oBAAI;AAxCR,2CAA6B;AAyCzB,kBAAG;AAxCP,mDAAqC;AAyCjC,0BAAO;AAxCX,uDAAyC;AAyCrC,8BAAS;AAxCb,mDAAqC;AAyCjC,0BAAO;AAxCX,iDAAmC;AAyC/B,wBAAM;AAxCV,iDAAmC;AAyC/B,wBAAM;AAxCV,yCAA2B;AAyCvB,gBAAE;AAxCN,yCAA2B;AAyCvB,gBAAE;AAxCN,6CAA+B;AAyC3B,oBAAI;AAxCR,6CAA+B;AAyC3B,oBAAI;AAxCR,yCAA8C;AAC9C,iCAAqC;AAExB,QAAA,QAAQ,GAAG;IACpB,KAAK,EAAL,aAAK;IACL,MAAM;IACN,GAAG;IACH,OAAO;IACP,IAAI;IACJ,GAAG;IACH,OAAO;IACP,SAAS;IACT,OAAO;IACP,MAAM;IACN,MAAM;IACN,EAAE;IACF,EAAE;IACF,IAAI;IACJ,IAAI;IACJ,QAAQ,EAAE,IAAI,2BAAgB,EAAE;IAChC,IAAI,EAAE,IAAI,kBAAW,EAAE;CAC1B,CAAC;AAsBF,uCAA8C;AAArC,4GAAA,gBAAgB,OAAA;AACzB,+BAAqC;AAA5B,mGAAA,WAAW,OAAA"}

package/dist/services/yaml.d.ts

@@ -0,0 +1,47 @@
+import * as yamlLib from "yaml";
+export interface YamlPrepareActions {
+    $set?: Array<{
+        path: string | string[];
+        value: any;
+    }>;
+    $push?: Array<{
+        path: string | string[];
+        value: any;
+    }>;
+    $spread?: Array<{
+        path: string | string[];
+        value: Record<string, any>;
+    }>;
+    $superSet?: Array<{
+        value: any;
+        $set?: Array<string | string[]>;
+        $init?: Array<string | string[]>;
+    }>;
+    $merge?: Record<string, any>;
+    $delete?: string[];
+}
+export declare class YamlService {
+    metadata: yamlLib.Document;
+    documents: Record<string, yamlLib.Document>;
+    using: string;
+    fromYaml(yaml?: string): yamlLib.Document;
+    fromJson(json?: Record<string, any>): yamlLib.Document;
+    yamlify(json?: Record<string, any>): string;
+    jsonify(): any;
+    stringify(): string;
+    yamlGet(propPath: string, defaultValue?: any): any;
+    yamlSet(path: string[], value: any): void;
+    yamlPush(path: string[], value: any): void;
+    yamlConcatInitAndSet(path: string[], value: any): void;
+    yamlOmit(paths?: string[]): void;
+    comment(text: string, afterPath?: string[]): void;
+    prepare(actions: YamlPrepareActions): void;
+    multidocument(params: {
+        yaml?: string;
+        json?: Record<string, any>;
+        name: string;
+    }, extra?: Record<string, any>): void;
+    use(name: string): yamlLib.Document;
+    existDocument(name: string): boolean;
+    clone(): YamlService;
+}

package/dist/services/yaml.js

@@ -0,0 +1,146 @@
+"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.YamlService = void 0;
+const yamlLib = __importStar(require("yaml"));
+const lodash_1 = require("lodash");
+class YamlService {
+    constructor() {
+        this.metadata = new yamlLib.Document();
+        this.documents = {};
+        this.using = "default";
+    }
+    fromYaml(yaml) {
+        this.metadata = yamlLib.parseDocument(yaml || "");
+        return this.metadata;
+    }
+    fromJson(json) {
+        return this.fromYaml(this.yamlify(json));
+    }
+    yamlify(json) {
+        return json ? yamlLib.stringify(json) : this.metadata.toString();
+    }
+    jsonify() {
+        return this.metadata.toJSON();
+    }
+    stringify() {
+        return JSON.stringify(this.jsonify(), null, 2);
+    }
+    yamlGet(propPath, defaultValue) {
+        return (0, lodash_1.get)(this.jsonify(), propPath) || defaultValue;
+    }
+    yamlSet(path, value) {
+        this.metadata.setIn(path, value);
+    }
+    yamlPush(path, value) {
+        const original = this.yamlGet(path.join("."), []);
+        original.push(...(Array.isArray(value) ? value : [value]));
+        this.yamlSet(path, original);
+    }
+    yamlConcatInitAndSet(path, value) {
+        const original = this.yamlGet(path.join("."));
+        this.yamlSet(path, `${value}${original}`);
+    }
+    yamlOmit(paths) {
+        const data = this.jsonify();
+        this.fromJson((0, lodash_1.omit)(data, paths || []));
+    }
+    comment(text, afterPath) {
+        let actualProp = this.metadata;
+        for (const prop of afterPath || []) {
+            actualProp = actualProp.get(prop, true);
+        }
+        actualProp.commentBefore = `##!!COMMENT!!## ${text}`;
+    }
+    prepare(actions) {
+        for (const sa of actions.$set || []) {
+            const key = typeof sa.path === "string" ? sa.path.split(".") : sa.path;
+            this.yamlSet(key, sa.value);
+        }
+        for (const pa of actions.$push || []) {
+            const key = typeof pa.path === "string" ? pa.path.split(".") : pa.path;
+            this.yamlPush(key, pa.value);
+        }
+        for (const spa of actions.$spread || []) {
+            const key = typeof spa.path === "string" ? spa.path.split(".") : spa.path;
+            this.yamlSet(key, { ...this.yamlGet(key.join(".")), ...spa.value });
+        }
+        for (const ssa of actions.$superSet || []) {
+            for (const ssaKey of ssa.$set || []) {
+                const key = typeof ssaKey === "string" ? ssaKey.split(".") : ssaKey;
+                this.yamlSet(key, ssa.value);
+            }
+            for (const ssaKey of ssa.$init || []) {
+                const key = typeof ssaKey === "string" ? ssaKey.split(".") : ssaKey;
+                this.yamlConcatInitAndSet(key, ssa.value);
+            }
+        }
+        for (const [key, value] of Object.entries(actions.$merge || {})) {
+            this.yamlSet(key.split("."), value);
+        }
+        this.yamlOmit(actions.$delete);
+    }
+    multidocument(params, extra) {
+        (0, lodash_1.set)(this.documents, this.using, this.metadata);
+        this.using = params.name;
+        if (params.yaml)
+            this.fromYaml(params.yaml);
+        else if (params.json)
+            this.fromJson(params.json);
+        if (extra)
+            this.prepare({ $merge: { ...extra } });
+        (0, lodash_1.set)(this.documents, params.name, this.metadata);
+    }
+    use(name) {
+        (0, lodash_1.set)(this.documents, this.using, this.metadata);
+        this.metadata = (0, lodash_1.get)(this.documents, name);
+        this.using = name;
+        return this.metadata;
+    }
+    existDocument(name) {
+        return (0, lodash_1.has)(this.documents, name);
+    }
+    clone() {
+        const clone = new YamlService();
+        clone.metadata = yamlLib.parseDocument(this.metadata.toString());
+        clone.using = this.using;
+        for (const [key, doc] of Object.entries(this.documents)) {
+            clone.documents[key] = yamlLib.parseDocument(doc.toString());
+        }
+        return clone;
+    }
+}
+exports.YamlService = YamlService;
+//# sourceMappingURL=yaml.js.map

package/dist/services/yaml.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cat-indev/catops-cli",
-  "version": "0.0.1-alpha.11",
+  "version": "0.0.1-alpha.12",
   "description": "Framework CLI para pipelines DevOps (shell, docker, git, kubectl, helm, npm, terraform, ansible, argocd, tekton, oc, az) sobre un ExecutionContext compartido, con menus interactivos y selectores automaticos por flag. Escrito en TypeScript, 100% usable desde JavaScript.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -51,8 +51,13 @@
     "node": ">=18"
   },
   "devDependencies": {
+    "@types/lodash": "^4.17.25",
     "@types/node": "^20.14.0",
     "typescript": "^5.5.0"
   },
-  "license": "MIT"
+  "license": "MIT",
+  "dependencies": {
+    "lodash": "^4.18.1",
+    "yaml": "^2.9.0"
+  }
 }