/** * Post-condición por campos (epic #209): después de una escritura, comparar lo * que pidió el llamador contra lo que el servidor devuelve como persistido. Un * 200 sobre un campo que la API no aplicó es un error, nunca `updated`. * * `sent` son SOLO los campos que pidió el llamador, no el payload completo que * una tool reenvía para no borrar lo demás (modyo/modyo#20249): comparar lo * reenviado sin cambio no aporta nada y puede dar falsos positivos. * * Los árboles tienen su propio comprobador (`checkPersistedTree` en * `customers-datasets-manage`); este es para campos planos. */ export interface FieldCheck { field: string; sent: unknown; readBack: unknown; } export interface FieldCheckResult { /** Campos pedidos que el servidor devuelve con el valor enviado. */ persisted: string[]; /** Campos pedidos que no quedaron como se enviaron. */ mismatched: FieldCheck[]; } export interface FieldCheckOptions { /** Nombre público -> nombre en la respuesta (`loadAsModule` -> `load_as_module`). */ map?: Record; /** Igualdad por campo. Por defecto: estricta, con `null` y `undefined` equivalentes. */ compare?: (sent: unknown, readBack: unknown) => boolean; } /** * Compara cada campo definido en `sent` contra `readBack`. Los campos con valor * `undefined` no se pidieron y no se comparan. */ export declare function checkPersistedFields(sent: Record, readBack: object, options?: FieldCheckOptions): FieldCheckResult; /** * Mensaje para el agente cuando algún campo pedido no quedó persistido: qué se * envió, qué quedó y que el servidor sí aplicó la escritura. En inglés, como * los demás mensajes de `src/tools`. */ export declare function describeFieldLoss(entity: string, mismatched: FieldCheck[]): string; /** * Redacta los valores de cada diferencia antes de que salgan en un mensaje o * en el detalle del error (#276). La clave sensible puede ser un segmento del * nombre del campo (`question q.options.api_key`), que `redactSecrets` no ve * porque no es una clave del objeto: si algún segmento de la ruta (lo que * sigue al primer punto) es sensible, se redactan todos los strings del * valor. Si no, se redacta por clave dentro del valor, en modo estricto: * los valores son datos enviados, así que una clave `errors` no es un * diagnóstico de la plataforma y no queda exenta. */ export declare function redactFieldChecks(mismatched: FieldCheck[]): FieldCheck[]; //# sourceMappingURL=postcondition.d.ts.map