@hostwebhook/platform-contracts 0.22.0 → 0.23.0

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

@@ -72,4 +72,63 @@ export interface PasoEjecutado {
      * 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.22.0",
+  "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",