@hostwebhook/platform-contracts 0.21.1 → 0.23.0

package/dist/servicios/formas-compartidas.d.ts

@@ -54,4 +54,81 @@ export interface PasoEjecutado {
     metadata?: Record<string, unknown>;
     /** Cómo se disparó la corrida. Ausente = producción. */
     modo?: 'pipeline';
+    /**
+     * La configuración con la que corrió el nodo [2026-09-29].
+     *
+     * Hace falta porque la versión del flujo NO cambia cuando cambia la
+     * configuración —su huella sólo mira nodos y aristas, a propósito—, así que
+     * la foto de la versión no dice con qué umbral, qué prompt o qué hoja corrió
+     * este paso si alguien los tocó después. Y la foto usa la proyección del
+     * lienzo, que ni siquiera trae lo pesado (el body, el prompt).
+     *
+     * Ya viene SIN secretos, sin estado de ejecución y sin lo que cambia en
+     * cada corrida: la saca `configuracionDelPaso` de `@hostwebhook/node-sdk`.
+     * Quien graba la guarda UNA vez por configuración distinta (por huella) y
+     * el paso apunta a ella; no se repite en cada paso.
+     *
+     * Ausente cuando quien anota no tiene la entidad a mano, y en las corridas
+     * de antes: la pantalla cae a la de la versión, avisando.
+     */
+    configuracion?: Record<string, unknown>;
+    /**
+     * Cómo decidió un conditional [2026-09-29]: cada rama, cada condición con
+     * lo que valió cada lado, y cuál ganó. Sólo lo llevan los pasos de un
+     * conditional; ver `EvaluacionDeRamas`.
+     */
+    evaluacion?: EvaluacionDeRamas;
+}
+/**
+ * Una condición de una rama, tal como se evaluó.
+ *
+ * `actual` y `esperado` son los dos lados YA RESUELTOS —lo que salió de
+ * `{{payload.amount}}` y de lo que se escribió como valor—, recortados para
+ * que un payload grande no infle el paso. `actual` AUSENTE quiere decir que
+ * el campo no resolvió (`undefined`), que es justo lo que más se busca al
+ * mirar por qué una rama no casó; salvo cuando el payload era una lista, que
+ * entonces no hay un valor sino muchos y lo que va es `items`.
+ */
+export interface CondicionEvaluada {
+    /** El campo tal como se escribió: `{{payload.amount}}` o `amount`. */
+    campo: string;
+    operador: string;
+    /** El valor tal como se escribió, sin resolver. */
+    valor?: string;
+    /** No cuenta: desactivada, o sin campo. Ver `condicionPuesta`. */
+    ignorada?: true;
+    /** Si se cumplió. Ausente si está ignorada, si la rama no llegó a evaluarse o si el payload era una lista. */
+    paso?: boolean;
+    actual?: unknown;
+    esperado?: unknown;
+    /** Payload iterable: cuántos ítems la cumplieron, de cuántos. */
+    items?: {
+        total: number;
+        pasan: number;
+    };
+}
+/**
+ * - `casa`: se cumplió y es la que se tomó (la primera que casa gana).
+ * - `no-casa`: se evaluó y no se cumplió.
+ * - `sin-condiciones`: no tiene ninguna, y el conditional se la salta.
+ * - `no-evaluada`: una anterior ya había casado, así que ésta ni se miró.
+ */
+export type ResultadoDeRama = 'casa' | 'no-casa' | 'sin-condiciones' | 'no-evaluada';
+export interface RamaEvaluada {
+    id: string;
+    nombre: string;
+    modo: 'and' | 'or';
+    resultado: ResultadoDeRama;
+    condiciones: CondicionEvaluada[];
+    /** Payload iterable: cuántos ítems cumplieron la rama entera. */
+    items?: {
+        total: number;
+        pasan: number;
+    };
+}
+/** La decisión de un conditional, en el orden en que se evaluaron sus ramas. */
+export interface EvaluacionDeRamas {
+    ramas: RamaEvaluada[];
+    /** El id de la rama que ganó; `null` = ninguna, se fue por el `else`. */
+    ganadora: string | null;
 }

package/dist/servicios/index.d.ts

@@ -26,7 +26,7 @@
  * que está diseñada justo para que los secretos NO crucen a lo bruto. Ningún
  * secreto vive aquí.
  */
-export type { FileRef, ChunkingStrategy, RunStepStatus, PasoEjecutado as PasoEjecutadoDelSdk, } from './formas-compartidas';
+export type { FileRef, ChunkingStrategy, RunStepStatus, PasoEjecutado as PasoEjecutadoDelSdk, CondicionEvaluada, ResultadoDeRama, RamaEvaluada, EvaluacionDeRamas, } from './formas-compartidas';
 export * from './almacenes-vectoriales';
 export * from './aprobaciones-pendientes';
 export * from './avisos-en-vivo';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hostwebhook/platform-contracts",
-  "version": "0.21.1",
+  "version": "0.23.0",
   "description": "Contratos compartidos entre los servicios de HostWebhook: addons del plan, identidad interna, y las formas que cruzan una frontera de red",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",