@credithub/harlan-components 1.128.0 → 1.130.0

package/dist/components/chart/chartSystem.js

@@ -14,7 +14,8 @@ import { ConsultasComplementaresContext } from '../consultasComplementares';
 import { ButtonsSummary, SummaryButton } from '../dossie/summary/styles';
 import { getProductsPrices } from '../dossie/summary/utils';
 import StatusMessage from '../interface/statusMessage';
-import Section from '../section';
+import Section, { pushExceptionDescription } from '../section';
+import { isErrorWithPushFlag } from '../../utils/classifyRequestError';
 import { RequestStatus } from '../webservice';
 import ChartContent from './chartContent';
 import useChartData from './hooks/useChartData';
@@ -90,7 +91,7 @@ var ChartSystem = function (_a) {
             });
         }); };
     }, [loadingButtons, hasCredits, productsPrices, setConsultasComplementares]);
-    var _p = useChartData(consultaSerasa, consultaBoaVista), chartData = _p.data, isLoadingChart = _p.isLoading, errorChart = _p.error, refetchChart = _p.refetch, chartDataProgress = _p.loadingProgress;
+    var _p = useChartData(consultaSerasa, consultaBoaVista), chartData = _p.data, isLoadingChart = _p.isLoading, errorChart = _p.error, chartUpstreamFailed = _p.upstreamRequestFailed, refetchChart = _p.refetch, chartDataProgress = _p.loadingProgress;
     var _q = useDividasPublicas(), quantidadeDividas = _q.quantidade, valorTotalDividas = _q.valorTotal, ultimaOcorrenciaDividas = _q.ultimaOcorrencia, dividasProgress = _q.loadingProgress;
     var lastComplementary = useRef({
         serasa: null,
@@ -99,7 +100,14 @@ var ChartSystem = function (_a) {
     // Evita escrever documentHistory repetidamente com o mesmo conteúdo
     var lastDocHistorySigRef = useRef('');
     // (refetch de histórico por mudança complementar centralizado no hook useChartData)
-    var errorMessage = typeof errorChart === 'string' ? new Error(errorChart) : errorChart;
+    var chartHasError = chartUpstreamFailed || errorChart != null;
+    var errorMessage = errorChart instanceof Error
+        ? errorChart
+        : typeof errorChart === 'string'
+            ? new Error(errorChart)
+            : chartUpstreamFailed
+                ? new Error()
+                : null;
     var isOpen = useToggle(true)[0];
     // Usa valores já calculados de globalData.protestosData (calculados uma única vez em protestos.tsx)
     var quantidadeProtestos = (_g = (_f = globalData === null || globalData === void 0 ? void 0 : globalData.protestosData) === null || _f === void 0 ? void 0 : _f.totalProtestos) !== null && _g !== void 0 ? _g : 0;
@@ -231,10 +239,10 @@ var ChartSystem = function (_a) {
             response: undefined,
             type: isLoadingChart
                 ? RequestStatus.Loading
-                : errorChart
+                : chartHasError
                     ? RequestStatus.Error
                     : RequestStatus.Success,
-            error: errorMessage || null,
+            error: errorMessage,
             refetch: refetchChart,
             document: chartData,
             progress: loadingProgress,
@@ -267,13 +275,21 @@ var ChartSystem = function (_a) {
                         : undefined, ultimaOcorrenciaPefinSerasa: Array.isArray(chartData === null || chartData === void 0 ? void 0 : chartData.serasa) && chartData.serasa.length > 0
                         ? (ultimaOcorrenciaSerasa !== null && ultimaOcorrenciaSerasa !== void 0 ? ultimaOcorrenciaSerasa : undefined)
                         : undefined })));
-        }, isError: function (err) { return ({
-            children: React.createElement(React.Fragment, null),
-            description: (React.createElement(StatusMessage, { type: "error" },
-                "Erro ao realizar a an\u00E1lise: ",
-                err.message)),
-            variant: 'error'
-        }); } }));
+        }, isError: function (err) {
+            return isErrorWithPushFlag(err)
+                ? {
+                    children: React.createElement(React.Fragment, null),
+                    description: pushExceptionDescription(err),
+                    variant: 'default'
+                }
+                : {
+                    children: React.createElement(React.Fragment, null),
+                    description: (React.createElement(StatusMessage, { type: "error" },
+                        "Erro ao realizar a an\u00E1lise: ",
+                        err.message)),
+                    variant: 'error'
+                };
+        } }));
 };
 export default ChartSystem;
 var templateObject_1;

package/dist/components/chart/hooks/useChartData.d.ts

@@ -2,7 +2,9 @@ import { DataInput } from '../../../components/chart/types/iChart';
 declare const useChartData: (consultaSerasa: any, consultaBoaVista: any) => {
     data: DataInput | null;
     isLoading: boolean;
-    error: string | null;
+    error: Error | null;
+    /** True quando Histórico/Protestos/CCF estão em Error (mesmo sem mensagem no Error). */
+    upstreamRequestFailed: boolean;
     refetch: () => void;
     loadingProgress: number;
 };

package/dist/components/chart/hooks/useChartData.js

@@ -37,7 +37,11 @@ var useChartData = function (consultaSerasa, consultaBoaVista) {
     var _g = useState(false), isProcessing = _g[0], setIsProcessing = _g[1];
     var _h = useState(false), dataReady = _h[0], setDataReady = _h[1];
     var lastProgress = useRef(0);
-    /** Evita reprocessar o mesmo JSON + mesmos totais ao vivo; totais/PJ mudam → nova chave. */
+    /**
+     * Evita reprocessar em vão. Inclui totais do IEPTB (globalData) para atualizar o pie
+     * quando o JSON do DOCUMENTHISTORY for o mesmo; a série `protestos` do gráfico vem
+     * só do histórico em `processData` (sem override com IEPTB).
+     */
     var lastProcessSnapshotKey = useRef(null);
     var processingTimeout = useRef(null);
     var ctxHistory = useContext(Queries.GraficosAnaliticos);
@@ -155,6 +159,7 @@ var useChartData = function (consultaSerasa, consultaBoaVista) {
         boaVista: null
     });
     useEffect(function () {
+        var _a;
         var serasaChanged = consultaSerasa !== lastComplementary.current.serasa;
         var boaVistaChanged = consultaBoaVista !== lastComplementary.current.boaVista;
         if (serasaChanged || boaVistaChanged) {
@@ -162,7 +167,12 @@ var useChartData = function (consultaSerasa, consultaBoaVista) {
                 serasa: consultaSerasa,
                 boaVista: consultaBoaVista
             };
-            ctxHistory.refetch();
+            if (ctxHistory.type !== RequestStatus.Error) {
+                ctxHistory.refetch();
+            }
+            else if ((_a = import.meta.env) === null || _a === void 0 ? void 0 : _a.DEV) {
+                console.debug('[useChartData] refetch de histórico ignorado: consulta anterior em erro');
+            }
         }
         // eslint-disable-next-line react-hooks/exhaustive-deps
     }, [consultaSerasa, consultaBoaVista]);
@@ -172,8 +182,12 @@ var useChartData = function (consultaSerasa, consultaBoaVista) {
             ctxProtestos.type === RequestStatus.Success &&
             ctxCCF.type === RequestStatus.Success;
     }, [ctxHistory.type, ctxProtestos.type, ctxCCF.type]);
+    var upstreamRequestFailed = useMemo(function () {
+        return ctxHistory.type === RequestStatus.Error ||
+            ctxProtestos.type === RequestStatus.Error ||
+            ctxCCF.type === RequestStatus.Error;
+    }, [ctxHistory.type, ctxProtestos.type, ctxCCF.type]);
     useEffect(function () {
-        var _a;
         // Limpa timeout anterior se existir
         if (processingTimeout.current) {
             clearTimeout(processingTimeout.current);
@@ -189,8 +203,13 @@ var useChartData = function (consultaSerasa, consultaBoaVista) {
             setIsProcessing(false);
             return;
         }
-        if (ctxHistory.type === RequestStatus.Error) {
-            setErrorState(((_a = ctxHistory.error) === null || _a === void 0 ? void 0 : _a.message) || 'Erro ao consultar histórico');
+        if (upstreamRequestFailed) {
+            var err = ctxHistory.type === RequestStatus.Error
+                ? ctxHistory.error
+                : ctxProtestos.type === RequestStatus.Error
+                    ? ctxProtestos.error
+                    : ctxCCF.error;
+            setErrorState(err !== null && err !== void 0 ? err : null);
             setIsProcessing(false);
             setDataReady(false);
             lastProcessSnapshotKey.current = null;
@@ -232,7 +251,7 @@ var useChartData = function (consultaSerasa, consultaBoaVista) {
                 }
                 catch (error) {
                     console.error('[useChartData] Erro ao processar dados:', error);
-                    setErrorState('Erro ao processar os dados');
+                    setErrorState(error instanceof Error ? error : new Error(String(error)));
                     setIsProcessing(false);
                     setDataReady(false);
                     lastProcessSnapshotKey.current = null;
@@ -264,11 +283,15 @@ var useChartData = function (consultaSerasa, consultaBoaVista) {
     // Verifica se está carregando - aguarda TODOS os contextos necessários terminarem
     // E aguarda o processamento E renderização dos dados estar completo
     // Só sai de loading quando dataReady === true (todos os contextos prontos + dados processados)
-    var isLoading = !dataReady || isProcessing || !allContextsReady;
+    var isLoading = !upstreamRequestFailed &&
+        errorState == null &&
+        (!dataReady || isProcessing || !allContextsReady);
     return {
         data: data,
         isLoading: isLoading,
         error: errorState,
+        /** True quando Histórico/Protestos/CCF estão em Error (mesmo sem mensagem no Error). */
+        upstreamRequestFailed: upstreamRequestFailed,
         refetch: ctxHistory.refetch,
         loadingProgress: loadingProgress
     };

package/dist/components/chart/utils/dataProcessing.js

@@ -75,13 +75,6 @@ export var processData = function (data, quantidadeProcessosJuridicos, totalProt
         .filter(removeSameAsNext)
         .map(function (info) { return (__assign(__assign({}, info), { data: parseProtestStringToDate(info.data) })); })
         .filter(function (info) { return !Number.isNaN(info.data.getTime()); }), function (info) { return info.data; });
-    /** Alinha o último ponto (data da consulta mais recente no histórico) com os totais ao vivo (mesma fonte que o pie). */
-    if (totalProtestos !== undefined && data.protestos.length > 0) {
-        var i = data.protestos.length - 1;
-        data.protestos[i] = __assign(__assign(__assign({}, data.protestos[i]), { quantidade: totalProtestos }), (valorTotalProtestos !== undefined
-            ? { valorTotal: valorTotalProtestos }
-            : {}));
-    }
     // ------------------------------------------------------------------
     // CCFs
     // ------------------------------------------------------------------

package/dist/components/dossie/generativeAi/generativeAi.js

@@ -70,12 +70,16 @@ var GenerativeAI = function (_a) {
     var _o = useStreamQuery("SELECT FROM 'LlamaApi'.'Consulta'", summaryQueryData, streamMode === 'summary' && !!summaryQueryData), summaryIterator = _o.responseIterator, summaryError = _o.error, summaryLoading = _o.isLoading, refetchSummary = _o.refetch, abortSummary = _o.abort;
     // Configura a query chat
     var _p = useStreamQuery("SELECT FROM 'LlamaApi'.'Consulta'", chatQueryData, streamMode === 'chat' && !!chatQueryData), chatIterator = _p.responseIterator, chatError = _p.error, chatLoading = _p.isLoading, refetchChat = _p.refetch, abortChat = _p.abort;
-    // Dispara o refetch inicial quando summaryQueryData estiver definido
+    // Dispara o refetch quando summaryQueryData mudar, exceto após erro real (evita loop de crédito)
     useEffect(function () {
-        if (summaryQueryData) {
+        var _a;
+        if (summaryQueryData && !summaryError) {
             refetchSummary();
         }
-    }, [summaryQueryData, refetchSummary]);
+        else if (summaryQueryData && summaryError && ((_a = import.meta.env) === null || _a === void 0 ? void 0 : _a.DEV)) {
+            console.debug('[GenerativeAI] refetch summary ignorado: erro na consulta anterior');
+        }
+    }, [summaryQueryData, refetchSummary, summaryError]);
     // Detecta a transição de refreshQuery de false para true para reiniciar a consulta
     var prevRefreshQueryRef = useRef(refreshQuery);
     useEffect(function () {
@@ -90,9 +94,11 @@ var GenerativeAI = function (_a) {
             }
             // Incrementa o refreshKey para forçar a atualização da query
             setRefreshKey(function (prev) { return prev + 1; });
+            // Retry explícito (refresh externo), mesmo se houve erro antes
+            refetchSummary();
         }
         prevRefreshQueryRef.current = refreshQuery;
-    }, [refreshQuery, abortSummary, streamMode]);
+    }, [refreshQuery, abortSummary, streamMode, refetchSummary]);
     // Processa o stream da consulta summary (apenas uma vez)
     var processedSummaryRef = useRef(false);
     useEffect(function () {

package/dist/components/liminar/liminar.js

@@ -246,21 +246,43 @@ var Liminar = function (_a) {
             return;
         var fetch = function () { return __awaiter(void 0, void 0, void 0, function () {
             var dossie, processosJuridicos, depsLoaded, newIds, hash, sourceApi, sourceProcessos, _a, possuiIndiciosDeLiminarProtestosDoPassado, protestosIds, sourceProtestos, combined, finalStatus;
-            var _b;
-            return __generator(this, function (_c) {
-                switch (_c.label) {
+            var _b, _c, _d;
+            return __generator(this, function (_e) {
+                switch (_e.label) {
                     case 0:
                         dossie = globalData === null || globalData === void 0 ? void 0 : globalData.dossie;
                         processosJuridicos = globalData === null || globalData === void 0 ? void 0 : globalData.processosJuridicosData;
                         depsLoaded = !!(processosJuridicos === null || processosJuridicos === void 0 ? void 0 : processosJuridicos.isLoaded) && !!(dossie === null || dossie === void 0 ? void 0 : dossie.carousel);
                         if (!depsLoaded || ctx.type === RequestStatus.Loading)
                             return [2 /*return*/];
+                        if (ctx.type === RequestStatus.Error ||
+                            (processosJuridicos === null || processosJuridicos === void 0 ? void 0 : processosJuridicos.error) ||
+                            ((_b = globalData === null || globalData === void 0 ? void 0 : globalData.protestosData) === null || _b === void 0 ? void 0 : _b.error)) {
+                            if ((_c = import.meta.env) === null || _c === void 0 ? void 0 : _c.DEV) {
+                                console.debug('[Liminar] consulta complementar ignorada: upstream em erro');
+                            }
+                            if (!processedRef.current) {
+                                setData(function (prev) { return (__assign(__assign({}, prev), { liminar: {
+                                        indiciosDeLiminar: false,
+                                        message: 'Não encontrado',
+                                        isLoaded: true,
+                                        processosComLiminarIds: [],
+                                        indiciosDeLiminarProtestosDoPassado: false,
+                                        protestosDoPassadoIds: '',
+                                        invertedProcessos: [],
+                                        origensLiminar: [],
+                                        descricaoLiminar: 'Não encontrado'
+                                    } })); });
+                                processedRef.current = true;
+                            }
+                            return [2 /*return*/];
+                        }
                         newIds = foundBusinessEntity
                             ? processosComAssuntoValido.map(function (p) { return p.id; })
                             : [];
                         hash = JSON.stringify({
                             t: ctx.type,
-                            indicios: (_b = ctx.document) === null || _b === void 0 ? void 0 : _b.indiciosDeLiminar,
+                            indicios: (_d = ctx.document) === null || _d === void 0 ? void 0 : _d.indiciosDeLiminar,
                             carousel: dossie.carousel,
                             empresas: processosJuridicos.empresa
                         });
@@ -273,7 +295,7 @@ var Liminar = function (_a) {
                         setIsLoadingLiminarProtestosDoPassado(true);
                         return [4 /*yield*/, fetchLiminarProtestosDoPassado()];
                     case 1:
-                        _a = _c.sent(), possuiIndiciosDeLiminarProtestosDoPassado = _a.possuiIndiciosDeLiminarProtestosDoPassado, protestosIds = _a.protestosDoPassadoIds;
+                        _a = _e.sent(), possuiIndiciosDeLiminarProtestosDoPassado = _a.possuiIndiciosDeLiminarProtestosDoPassado, protestosIds = _a.protestosDoPassadoIds;
                         setIsLoadingLiminarProtestosDoPassado(false);
                         sourceProtestos = detectLiminarFromProtestosDoPassado(possuiIndiciosDeLiminarProtestosDoPassado, protestosIds);
                         combined = combineLiminarSources([

package/dist/components/protestos/protestosSp.js

@@ -1,5 +1,4 @@
 import ProtestosIcon from '../../assets/icones/protestos';
-import { useGlobalData } from '../../contexts/globalDataContext';
 import { formatMoney } from '../../utils/number';
 import React, { useContext, useEffect, useMemo, useRef, useState } from 'react';
 import AddItemField from '../common/addItem';
@@ -9,7 +8,6 @@ import Section from '../section';
 import { Queries, RequestStatus } from '../webservice';
 var ProtestosSP = function () {
     var ctxLiminar = useContext(Queries.Liminar);
-    var setData = useGlobalData().setData;
     var _a = useState(false), dataUpdated = _a[0], setDataUpdated = _a[1];
     var _b = useState(false), hideSection = _b[0], setHideSection = _b[1];
     var prevCtxTypeRef = useRef(null);
@@ -28,7 +26,7 @@ var ProtestosSP = function () {
             setHideSection(true);
         }
         prevCtxTypeRef.current = ctxLiminar.type;
-    }, [ctxLiminar.type, ctxLiminar.document, dataUpdated, setData]);
+    }, [ctxLiminar.type, ctxLiminar.document, dataUpdated]);
     var possuiProtestosSp = useMemo(function () {
         var _a;
         if ((ctxLiminar === null || ctxLiminar === void 0 ? void 0 : ctxLiminar.type) === RequestStatus.Success)

package/dist/components/requestContextTypes.d.ts

@@ -11,6 +11,11 @@ export type ParsedResponse<T> = {
     response: Response;
     document: T;
 };
+/** Aviso de exceção esperada (`push=true` no XML); só exibe UI se houver `message` ou `code`. */
+export type PushNotice = {
+    message?: string;
+    code?: number;
+};
 export type RequestContext<R> = {
     data?: Client.Form;
     urlData?: Client.Form;
@@ -24,6 +29,8 @@ export type RequestContext<R> = {
     activeRequests?: number;
     showLoadingBar?: boolean;
     warningMessage?: string | null;
+    /** Presente quando o backend sinalizou `push=true` (situação esperada, fluxo segue). */
+    pushNotice?: PushNotice | null;
 };
 export type HeaderReplaceResponse = {
     children: ReactNode;

package/dist/components/scoreSerasa/scoreSerasa.js

@@ -5,14 +5,12 @@ import { useSafeQuery } from '../../hooks/useSafeQuery';
 import { isDocumentoPF } from '../../utils/string';
 import React, { useContext, useEffect, useMemo, useRef, useState } from 'react';
 import AddItemField from '../common/addItem';
+import { formatInadPercentDisplay, inadCountPer100, resolveSerasaInadPercent } from './scoreSerasaProbUtils';
 import { ConsultasComplementaresContext } from '../consultasComplementares';
 import { Result, ResultContent } from '../interface/result';
 import StatusMessage from '../interface/statusMessage';
 import Section from '../section';
 import { RequestStatus } from '../webservice';
-var parseProb = function (raw) {
-    return typeof raw === 'number' ? raw : Number(String(raw).replace(',', '.')) || 0;
-};
 var ConsultaScoreSerasa = function (_a) {
     var _b, _c, _d, _e, _f, _g;
     var documento = _a.documento;
@@ -21,7 +19,14 @@ var ConsultaScoreSerasa = function (_a) {
     var _h = useState(false), dataUpdated = _h[0], setDataUpdated = _h[1];
     var _j = useSafeQuery("SELECT FROM 'ScoreSerasa'.'Consulta'", { documento: documento }, (_c = (_b = consultasComplementaresContext === null || consultasComplementaresContext === void 0 ? void 0 : consultasComplementaresContext.consultasComplementares) === null || _b === void 0 ? void 0 : _b.scoreSerasa) === null || _c === void 0 ? void 0 : _c.consultaRealizada), response = _j.response, isLoading = _j.isLoading, error = _j.error, loadingProgress = _j.loadingProgress;
     var scoreData = (_e = (_d = response === null || response === void 0 ? void 0 : response.document) === null || _d === void 0 ? void 0 : _d.dados) === null || _e === void 0 ? void 0 : _e.score;
-    var inadProb = parseProb(scoreData === null || scoreData === void 0 ? void 0 : scoreData.probabilidade_inadimplencia);
+    var inadResolvido = useMemo(function () {
+        return (scoreData === null || scoreData === void 0 ? void 0 : scoreData.score_calculado) === 'S'
+            ? resolveSerasaInadPercent({
+                pontuacao: scoreData.pontuacao,
+                probabilidade_inadimplencia: scoreData.probabilidade_inadimplencia
+            })
+            : null;
+    }, [scoreData]);
     var scoreRef = useRef(null);
     var consultaRealizada = useMemo(function () {
         var _a, _b;
@@ -61,8 +66,12 @@ var ConsultaScoreSerasa = function (_a) {
             progress: loadingProgress
         }, title: "Score Serasa", subtitle: "Consulta de Score", icon: ScoreBoaVistaIcon, description: !error && (React.createElement(StatusMessage, { type: scoreData ? 'success' : 'default' }, description)), onSuccess: function () { return (React.createElement(Result, null, scoreData && (React.createElement(ResultContent, { desktop: "repeat(4, 1fr)", tablet: "repeat(3, 1fr)", mobile: "1fr 1fr" },
             React.createElement(AddItemField, { name: "Score", value: String(scoreData.pontuacao) }),
-            React.createElement(AddItemField, { name: "Probabilidade de Inadimpl\u00EAncia", value: "".concat(scoreData.probabilidade_inadimplencia, "%") }),
-            React.createElement(AddItemField, { name: "An\u00E1lise", value: "DE CADA 100 ".concat(isDocumentoPF(documento) ? 'PESSOAS' : 'EMPRESAS', " CLASSIFICADAS NESTA CLASSE DE SCORE, \u00C9 PROV\u00C1VEL QUE ").concat(Math.floor(inadProb), " APRESENTEM D\u00C9BITOS NO MERCADO NOS PR\u00D3XIMOS 6 MESES.") }))))); }, isError: function (err) { return ({
+            React.createElement(AddItemField, { name: "Probabilidade de Inadimpl\u00EAncia", value: inadResolvido
+                    ? formatInadPercentDisplay(inadResolvido.percent0to100)
+                    : '—' }),
+            React.createElement(AddItemField, { name: "An\u00E1lise", value: inadResolvido
+                    ? "DE CADA 100 ".concat(isDocumentoPF(documento) ? 'PESSOAS' : 'EMPRESAS', " CLASSIFICADAS NESTA CLASSE DE SCORE, \u00C9 PROV\u00C1VEL QUE ").concat(inadCountPer100(inadResolvido.percent0to100), " APRESENTEM D\u00C9BITOS NO MERCADO NOS PR\u00D3XIMOS 6 MESES.")
+                    : '—' }))))); }, isError: function (err) { return ({
             children: React.createElement(React.Fragment, null),
             description: (React.createElement(StatusMessage, { type: "error" },
                 "Erro ao realizar a consulta: ",

package/dist/components/scoreSerasa/scoreSerasaProbUtils.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Escala 0–1000 do Score Serasa; fora de faixa é ajustada (clamp).
+ */
+export declare function parsePonto1000(pontuacao: unknown): number;
+/**
+ * A API preenche probabilidade (0–100) ou vem vazia.
+ */
+export declare function isProbFromApiValid(raw: unknown): boolean;
+export declare function inadFromFallbackPontuacao(p: number): number;
+/**
+ * Número inteiro 0–100 na frase "de cada 100" (arredondamento do % resolvido).
+ */
+export declare function inadCountPer100(percent0to100: number): number;
+/**
+ * "99,80%" com duas decimais (formato local).
+ */
+export declare function formatInadPercentDisplay(percent0to100: number): string;
+export declare function resolveSerasaInadPercent(rules: {
+    pontuacao: unknown;
+    probabilidade_inadimplencia: unknown;
+}): {
+    percent0to100: number;
+    fromApi: boolean;
+};

package/dist/components/scoreSerasa/scoreSerasaProbUtils.js

@@ -0,0 +1,66 @@
+var SCORE_MAX = 1000;
+var parseNumberFlexible = function (raw) {
+    if (raw === null || raw === undefined)
+        return null;
+    if (typeof raw === 'number') {
+        return Number.isFinite(raw) ? raw : null;
+    }
+    var s = String(raw).trim();
+    if (s === '')
+        return null;
+    var n = Number(s.replace(',', '.'));
+    return Number.isFinite(n) ? n : null;
+};
+/**
+ * Escala 0–1000 do Score Serasa; fora de faixa é ajustada (clamp).
+ */
+export function parsePonto1000(pontuacao) {
+    var n = parseNumberFlexible(pontuacao);
+    if (n === null)
+        return 0;
+    return Math.min(SCORE_MAX, Math.max(0, n));
+}
+/**
+ * A API preenche probabilidade (0–100) ou vem vazia.
+ */
+export function isProbFromApiValid(raw) {
+    if (raw === null || raw === undefined)
+        return false;
+    if (typeof raw === 'string' && raw.trim() === '')
+        return false;
+    var n = parseNumberFlexible(raw);
+    return n !== null;
+}
+var parseApiProbPercent = function (raw) {
+    var n = parseNumberFlexible(raw);
+    return n === null ? 0 : n;
+};
+export function inadFromFallbackPontuacao(p) {
+    return ((SCORE_MAX - p) / SCORE_MAX) * 100;
+}
+/**
+ * Número inteiro 0–100 na frase "de cada 100" (arredondamento do % resolvido).
+ */
+export function inadCountPer100(percent0to100) {
+    return Math.min(100, Math.max(0, Math.round(percent0to100)));
+}
+var percentFormatter = new Intl.NumberFormat('pt-BR', {
+    minimumFractionDigits: 2,
+    maximumFractionDigits: 2
+});
+/**
+ * "99,80%" com duas decimais (formato local).
+ */
+export function formatInadPercentDisplay(percent0to100) {
+    return "".concat(percentFormatter.format(percent0to100), "%");
+}
+export function resolveSerasaInadPercent(rules) {
+    var p = parsePonto1000(rules.pontuacao);
+    if (isProbFromApiValid(rules.probabilidade_inadimplencia)) {
+        return {
+            percent0to100: parseApiProbPercent(rules.probabilidade_inadimplencia),
+            fromApi: true
+        };
+    }
+    return { percent0to100: inadFromFallbackPontuacao(p), fromApi: false };
+}

package/dist/components/section.d.ts

@@ -1,5 +1,7 @@
 import React from 'react';
 import { ISectionProps, RequestStatus } from './requestContextTypes';
+/** Aviso no header para exceção esperada (`push=true`): só a mensagem do backend. */
+export declare function pushExceptionDescription(err: Error): React.ReactNode;
 declare const Section: React.ForwardRefExoticComponent<Omit<ISectionProps<unknown>, "ref"> & React.RefAttributes<HTMLDivElement>>;
 export declare const headerStatus: Record<RequestStatus, string>;
 export default Section;

package/dist/components/section.js

@@ -14,6 +14,7 @@ import { PrintSectionWrapper } from './common/printSectionWrapper';
 import Header from './interface/header';
 import StatusMessage from './interface/statusMessage';
 import { RequestStatus } from './requestContextTypes';
+import { isErrorWithPushFlag } from '../utils/classifyRequestError';
 var ButtonWrapper = styled.div(templateObject_1 || (templateObject_1 = __makeTemplateObject(["\n  justify-content: center;\n  width: 100%;\n  height: 40%;\n  max-height: 52px;\n  max-width: 300px;\n  margin: 0 auto;\n"], ["\n  justify-content: center;\n  width: 100%;\n  height: 40%;\n  max-height: 52px;\n  max-width: 300px;\n  margin: 0 auto;\n"])));
 var sectionIdCounter = 0;
 var nextSectionId = function () {
@@ -49,12 +50,22 @@ var useSectionPrintBlocker = function (ctx, title, enabled, registerBlocker, res
         }
     }, [ctx, enabled, registerBlocker, resolveBlocker, title]);
 };
+/** Aviso no header para exceção esperada (`push=true`): só a mensagem do backend. */
+export function pushExceptionDescription(err) {
+    var _a;
+    var message = (_a = err.message) === null || _a === void 0 ? void 0 : _a.trim();
+    if (!message)
+        return undefined;
+    return React.createElement(StatusMessage, { type: "warning" }, message);
+}
 var Section = forwardRef(function (_a, ref) {
     var onSuccess = _a.onSuccess, _b = _a.isError, isError = _b === void 0 ? function (err, ctx) {
-        var shouldPush = (err === null || err === void 0 ? void 0 : err.push) === true;
-        // Se push === true, não exibir erro (caso esperado, tratar como sucesso)
-        if (shouldPush) {
-            return null;
+        if (isErrorWithPushFlag(err)) {
+            return {
+                children: React.createElement(React.Fragment, null),
+                description: pushExceptionDescription(err),
+                variant: 'default'
+            };
         }
         var message = 'Problemas de comunicação, tente novamente.';
         return {
@@ -72,10 +83,18 @@ var Section = forwardRef(function (_a, ref) {
     useSectionPrintBlocker(ctx, headerProps === null || headerProps === void 0 ? void 0 : headerProps.title, readinessEnabled, printReadiness.registerBlocker, printReadiness.resolveBlocker);
     if (!ctx)
         return null;
-    var type = ctx.type, progress = ctx.progress, warningMessage = ctx.warningMessage;
+    var type = ctx.type, progress = ctx.progress, warningMessage = ctx.warningMessage, pushNotice = ctx.pushNotice;
     var renderResponse = useCallback(function () {
         switch (type) {
             case RequestStatus.Success:
+                if (pushNotice &&
+                    (ctx.document === undefined || ctx.document === null)) {
+                    return {
+                        children: React.createElement(React.Fragment, null),
+                        description: undefined,
+                        variant: 'default'
+                    };
+                }
                 return onSuccess === null || onSuccess === void 0 ? void 0 : onSuccess(ctx.document, ctx);
             case RequestStatus.Error: {
                 var errorResult = isError(ctx.error, ctx);
@@ -92,21 +111,30 @@ var Section = forwardRef(function (_a, ref) {
             default:
                 return null;
         }
-    }, [type, onSuccess, isError, onLoading, ctx, printMode]);
+    }, [type, onSuccess, isError, onLoading, ctx, printMode, pushNotice]);
     var renderedResponse = renderResponse();
-    var descriptionWithWarning = useCallback(function (description) {
-        if (!warningMessage)
-            return description;
-        return (React.createElement(React.Fragment, null,
-            React.createElement(StatusMessage, { type: "warning" }, warningMessage),
-            description));
-    }, [warningMessage]);
+    var descriptionWithAlerts = useCallback(function (description) {
+        var _a;
+        var out = description;
+        if (warningMessage) {
+            out = (React.createElement(React.Fragment, null,
+                React.createElement(StatusMessage, { type: "warning" }, warningMessage),
+                out));
+        }
+        var pushMessage = (_a = pushNotice === null || pushNotice === void 0 ? void 0 : pushNotice.message) === null || _a === void 0 ? void 0 : _a.trim();
+        if (pushMessage) {
+            out = (React.createElement(React.Fragment, null,
+                React.createElement(StatusMessage, { type: "warning" }, pushMessage),
+                out));
+        }
+        return out;
+    }, [warningMessage, pushNotice]);
     var defaultHeaderActions = useMemo(function () {
         return !printMode ? (React.createElement(BtnWrapper, { hidden: type === RequestStatus.Loading, onClick: toggleOpen }, isOpen ? React.createElement(ChevronUp, null) : React.createElement(ChevronDown, null))) : null;
     }, [type, isOpen, toggleOpen, printMode]);
     var renderHeader = function (props) {
         var description = props.description, actions = props.actions, rest = __rest(props, ["description", "actions"]);
-        return (React.createElement(Header, __assign({ printBar: renderedResponse !== null && isOpen }, rest, { description: descriptionWithWarning(description), className: cn(className, type !== undefined && headerStatus[type]
+        return (React.createElement(Header, __assign({ printBar: renderedResponse !== null && isOpen }, rest, { description: descriptionWithAlerts(description), className: cn(className, type !== undefined && headerStatus[type]
                 ? headerStatus[type]
                 : '', props.className), variant: type === RequestStatus.Loading ? 'loading' : props.variant, loadingProps: {
                 percentage: progress !== null && progress !== void 0 ? progress : 0,

package/dist/components/streamQuery.js

@@ -214,16 +214,26 @@ export function useStreamQuery(query, data, enabled) {
             !abortControllerRef.current.signal.aborted) {
             abortControllerRef.current.abort();
             abortControllerRef.current = null;
-            setIsLoading(false);
-            hasStreamStartedRef.current = false;
-            setResponseIterator(null);
         }
+        setIsLoading(false);
+        hasStreamStartedRef.current = false;
+        setResponseIterator(null);
     }, []);
+    /**
+     * Invariante anti-loop: após falha, mantemos `responseIterator` não-nulo até `abortStream`
+     * (o `useEffect` abaixo só dispara novo fetch quando `!responseIterator`). Limpar o iterator
+     * em todo erro sem esse contrato faria o efeito reabrir HTTP em ciclo.
+     */
     useEffect(function () {
-        if (enabled && !responseIterator) {
-            fetchStream();
+        if (!enabled) {
+            abortStream();
+            return;
         }
-    }, [enabled, fetchStream, responseIterator]);
+        if (responseIterator)
+            return;
+        fetchStream();
+    }, [enabled, responseIterator, fetchStream, abortStream]);
+    useEffect(function () { return function () { return abortStream(); }; }, [abortStream]);
     return {
         responseIterator: responseIterator,
         error: error,

package/dist/components/webservice.d.ts

@@ -1,7 +1,7 @@
 import { EditalResponse, LiminarResponse, PDFProtestoDiscoverResponse, ProcessosJuridicosState } from '../@types/domain';
 import { Client } from '@credithub/webservice';
 import React, { Context, FC, PropsWithChildren } from 'react';
-import { type ParsedResponse, type RequestContext } from './requestContextTypes';
+import { type ParsedResponse, type PushNotice, type RequestContext } from './requestContextTypes';
 export * from './requestContextTypes';
 export declare const WebService: React.Context<Client.WebService>;
 type RequestDefaults = {
@@ -25,6 +25,7 @@ export declare function CustomProvider<T extends Client.Form = Client.Form, R =
 export declare function useQuery<R = unknown, T extends Client.Form = Client.Form>(query: string, data?: T, enabled?: boolean): {
     response: ParsedResponse<R> | null;
     error: Error | null;
+    pushNotice: PushNotice | null;
     isLoading: boolean;
     loadingProgress: number;
     refetch: () => void;