@credithub/harlan-components 1.126.0 → 1.128.0

package/README.md

@@ -30,3 +30,18 @@ Para começar a usar o **Harlan Components** em seu projeto, siga estes passos:
    ```
 
 3. **Implementação:** Integre os componentes importados em sua aplicação.
+
+## Consumindo sem tag API
+
+Quando a aplicação injeta a chave em código (em vez de repassar só via URL), envolva a árvore com `WebServiceProvider` e, se o backend exigir resolução Jurischain (challenges HTTP 402), aumente o tempo de espera com `webserviceOptions`:
+
+```tsx
+import { WebServiceProvider } from '@credithub/harlan-components';
+
+<WebServiceProvider
+  credential={apiKey}
+  webserviceOptions={{ jurischain: { solveTimeout: 120_000 } }}
+>
+  {children}
+</WebServiceProvider>
+```

package/dist/components/chart/chartSystem.js

@@ -2,7 +2,7 @@ import { __assign, __awaiter, __generator, __makeTemplateObject } from "tslib";
 import ResumoDeNegativacoesIcon from '../../assets/icones/resumoNegativacoes';
 import { useGlobalData } from '../../contexts/globalDataContext';
 import { useConsultasComplementares } from '../../hooks/useConsultasComplementares';
-import { converterParaFormatoValido } from '../../utils/date';
+import { converterParaFormatoValido, parseProtestHistoryRowToTime } from '../../utils/date';
 import { areModulesLoaded } from '../../utils/isGlobalReady';
 import { formatMoney } from '../../utils/number';
 import { isCpf } from '../../utils/string';
@@ -133,13 +133,23 @@ var ChartSystem = function (_a) {
         if (!dataUpdated && chartData && modulesReady) {
             var protestoHistory_1 = (_b = (_a = chartData.protestos) === null || _a === void 0 ? void 0 : _a.map(function (p) {
                 var _a, _b;
-                return ({
+                var t = parseProtestHistoryRowToTime(p);
+                var dataStr = t
+                    ? new Date(t).toISOString()
+                    : typeof p.data === 'string'
+                        ? p.data
+                        : p.data instanceof Date
+                            ? p.data.toISOString()
+                            : '';
+                return {
                     documento: documento,
-                    data: typeof p.data === 'string' ? p.data : p.data.toISOString(),
+                    data: dataStr,
                     quantidade: (_a = p.quantidade) !== null && _a !== void 0 ? _a : 0,
                     valorTotal: (_b = p.valorTotal) !== null && _b !== void 0 ? _b : 0
-                });
-            }).sort(function (a, b) { return new Date(a.data).getTime() - new Date(b.data).getTime(); })) !== null && _b !== void 0 ? _b : [];
+                };
+            }).sort(function (a, b) {
+                return parseProtestHistoryRowToTime(a) - parseProtestHistoryRowToTime(b);
+            })) !== null && _b !== void 0 ? _b : [];
             var protestoLiminar_1 = calcularProtestoLiminar(protestoHistory_1);
             // Cria assinatura estável para evitar setState repetido
             var signature = JSON.stringify({

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

@@ -1,8 +1,8 @@
 import { Queries, RequestStatus } from '../../../components/webservice';
 import { useGlobalData } from '../../../contexts/globalDataContext';
-import { converterParaFormatoValido, formatDatePtBrToDate } from '../../../utils/date';
+import { formatDatePtBrToDate, parseProtestDateToTime } from '../../../utils/date';
 import { useContext, useEffect, useMemo, useRef, useState } from 'react';
-import { processData, processProtestData } from '../utils/dataProcessing';
+import { normalizeRawProtestosFirstSeen, processData, processProtestData } from '../utils/dataProcessing';
 function getLastQuantidadeProcessosFromHistory(parsed) {
     var _a;
     var arr = parsed === null || parsed === void 0 ? void 0 : parsed.processosJuridicos;
@@ -37,7 +37,8 @@ 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);
-    var lastProcessedDocument = useRef(null);
+    /** Evita reprocessar o mesmo JSON + mesmos totais ao vivo; totais/PJ mudam → nova chave. */
+    var lastProcessSnapshotKey = useRef(null);
     var processingTimeout = useRef(null);
     var ctxHistory = useContext(Queries.GraficosAnaliticos);
     var ctxProtestos = useContext(Queries.Protestos);
@@ -66,17 +67,7 @@ var useChartData = function (consultaSerasa, consultaBoaVista) {
                     return null;
                 var datas = protestos
                     .map(function (p) {
-                    try {
-                        var dataStr = p.dataProtesto || '';
-                        if (!dataStr)
-                            return null;
-                        var formattedDate = converterParaFormatoValido(dataStr);
-                        var date = new Date(formattedDate);
-                        return isNaN(date.getTime()) ? null : date.getTime();
-                    }
-                    catch (_a) {
-                        return null;
-                    }
+                    return parseProtestDateToTime(p.dataProtesto || p.firstSeen);
                 })
                     .filter(function (d) { return d !== null; });
                 return datas.length
@@ -192,6 +183,7 @@ var useChartData = function (consultaSerasa, consultaBoaVista) {
         if (ctxHistory.type === RequestStatus.Loading ||
             ctxProtestos.type === RequestStatus.Loading ||
             ctxCCF.type === RequestStatus.Loading) {
+            lastProcessSnapshotKey.current = null;
             setDataReady(false);
             setErrorState(null);
             setIsProcessing(false);
@@ -201,20 +193,25 @@ var useChartData = function (consultaSerasa, consultaBoaVista) {
             setErrorState(((_a = ctxHistory.error) === null || _a === void 0 ? void 0 : _a.message) || 'Erro ao consultar histórico');
             setIsProcessing(false);
             setDataReady(false);
-            lastProcessedDocument.current = null;
+            lastProcessSnapshotKey.current = null;
             return;
         }
         // Só processa quando TODOS os contextos estiverem prontos
         if (allContextsReady && ctxHistory.document) {
             var documentSnapshot_1 = ctxHistory.document;
-            // Evita processar o mesmo documento múltiplas vezes
-            if (lastProcessedDocument.current === documentSnapshot_1) {
+            var processSnapshotKey_1 = JSON.stringify({
+                doc: documentSnapshot_1,
+                totalProtestos: totalProtestos !== null && totalProtestos !== void 0 ? totalProtestos : null,
+                valorTotalProtestos: valorTotalProtestos !== null && valorTotalProtestos !== void 0 ? valorTotalProtestos : null,
+                ultimaOcorrenciaProtestos: ultimaOcorrenciaProtestos !== null && ultimaOcorrenciaProtestos !== void 0 ? ultimaOcorrenciaProtestos : null,
+                quantidadeProcessosFromPJ: quantidadeProcessosFromPJ !== null && quantidadeProcessosFromPJ !== void 0 ? quantidadeProcessosFromPJ : null
+            });
+            if (lastProcessSnapshotKey.current === processSnapshotKey_1) {
                 return;
             }
             // Marca como processando
             setIsProcessing(true);
             setDataReady(false);
-            lastProcessedDocument.current = documentSnapshot_1;
             // Usa setTimeout para permitir que a UI atualize o estado de loading
             processingTimeout.current = setTimeout(function () {
                 try {
@@ -222,10 +219,12 @@ var useChartData = function (consultaSerasa, consultaBoaVista) {
                         throw new Error('Document is undefined');
                     }
                     var parsed = JSON.parse(documentSnapshot_1);
+                    normalizeRawProtestosFirstSeen(parsed);
                     parsed.protestosCategory = dadosProtestos;
                     var quantidadeProcessos = quantidadeProcessosFromPJ !== null && quantidadeProcessosFromPJ !== void 0 ? quantidadeProcessosFromPJ : getLastQuantidadeProcessosFromHistory(parsed);
                     var processed = processData(structuredClone(parsed), quantidadeProcessos, totalProtestos, valorTotalProtestos, ultimaOcorrenciaProtestos);
                     setData(processed);
+                    lastProcessSnapshotKey.current = processSnapshotKey_1;
                     setIsProcessing(false);
                     setDataReady(true);
                     // Garante que o progresso chegue a 100% quando dados estão prontos
@@ -236,6 +235,7 @@ var useChartData = function (consultaSerasa, consultaBoaVista) {
                     setErrorState('Erro ao processar os dados');
                     setIsProcessing(false);
                     setDataReady(false);
+                    lastProcessSnapshotKey.current = null;
                 }
                 processingTimeout.current = null;
             }, 0);

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

@@ -1,12 +1,20 @@
 import { REGEX_PROTESTOS_DE_CREDITO, REGEX_PROTESTOS_DE_IMPOSTO } from '../../../constants/regex';
-import { formatDatePtBrToDate } from '../../../utils/date';
+import { parseProtestDateToTime } from '../../../utils/date';
+import { xmlFirstSeenFromNode } from '../../../utils/parseProtesto';
 import XPathUtils from '../../../utils/xpath';
 import { useMemo } from 'react';
 // Função de ordenação por data
+var protestoEffectiveDate = function (node) {
+    var _a;
+    var dp = XPathUtils.select('string(./dataProtesto)', node);
+    if (typeof dp === 'string' && dp.trim())
+        return dp.trim();
+    return (_a = xmlFirstSeenFromNode(node)) !== null && _a !== void 0 ? _a : '';
+};
 var byDate = function (protesto, protesto2) {
     var _a, _b;
-    var v0 = ((_a = formatDatePtBrToDate(XPathUtils.select('string(./dataProtesto)', protesto2))) === null || _a === void 0 ? void 0 : _a.getTime()) || 0;
-    var v1 = ((_b = formatDatePtBrToDate(XPathUtils.select('string(./dataProtesto)', protesto))) === null || _b === void 0 ? void 0 : _b.getTime()) || 0;
+    var v0 = (_a = parseProtestDateToTime(protestoEffectiveDate(protesto2))) !== null && _a !== void 0 ? _a : 0;
+    var v1 = (_b = parseProtestDateToTime(protestoEffectiveDate(protesto))) !== null && _b !== void 0 ? _b : 0;
     return v0 - v1;
 };
 export function classifyProtestos(document, iaOverrides) {

package/dist/components/chart/types/iChart.d.ts

@@ -6,6 +6,8 @@ export interface Consulta {
     creation?: string | Date;
     valorTotal?: number | null;
     total?: number | null;
+    /** Fallback de data quando `data` vem vazia (datalake `toArray()`: `firstSeen`; JSON cru pode vir como `first_seen` — normalizado em useChartData). */
+    firstSeen?: string;
 }
 export interface DataInput {
     ccfs: Consulta[];

package/dist/components/chart/utils/dataProcessing.d.ts

@@ -1,4 +1,6 @@
 import { DataInput } from '../../../components/chart/types/iChart';
+/** JSON cru pode trazer `first_seen`; unifica em `firstSeen` antes de processData. */
+export declare function normalizeRawProtestosFirstSeen(data: DataInput): void;
 /**
  * Normaliza todos os datasets do DataInput.
  */

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

@@ -1,6 +1,6 @@
-import { __assign } from "tslib";
+import { __assign, __rest } from "tslib";
 import { classifyProtestos } from '../../../hooks/useProtestosClassification';
-import { converterParaFormatoValido, formatDatePtBrToDate } from '../../../utils/date';
+import { formatDatePtBrToDate, parseProtestDateToTime, parseProtestStringToDate } from '../../../utils/date';
 import { parseProtesto } from '../../../utils/parseProtesto';
 import XPathUtils from '../../../utils/xpath';
 import { groupBy, sortBy, unique } from 'underscore';
@@ -19,10 +19,29 @@ var removeSameAsNext = function (current, index, arr) {
         return true;
     return current.quantidade !== arr[index - 1].quantidade;
 };
-/** Converte chave de agrupamento (string) em timestamp ordenável. */
-var keyToTime = function (key) {
-    return new Date(formatDatePtBrToDate(key)).getTime();
+var protestoHistoricoDataEfetiva = function (e) {
+    if (typeof e.data === 'string' && e.data.trim())
+        return e.data.trim();
+    if (e.data instanceof Date && !Number.isNaN(e.data.getTime())) {
+        return e.data.toISOString().slice(0, 10);
+    }
+    var fs = e.firstSeen;
+    return typeof fs === 'string' && fs.trim() ? fs.trim() : '';
 };
+/** JSON cru pode trazer `first_seen`; unifica em `firstSeen` antes de processData. */
+export function normalizeRawProtestosFirstSeen(data) {
+    data.protestos = data.protestos.map(function (row) {
+        var extra = row;
+        var merged = (typeof extra.firstSeen === 'string' && extra.firstSeen.trim()) ||
+            (typeof extra.first_seen === 'string' && extra.first_seen.trim()) ||
+            undefined;
+        var _snake = extra.first_seen, rest = __rest(extra, ["first_seen"]);
+        if (!merged)
+            return rest;
+        return __assign(__assign({}, rest), { firstSeen: merged });
+    });
+}
+var protestoKeyToTime = function (key) { var _a; return (_a = parseProtestDateToTime(key)) !== null && _a !== void 0 ? _a : 0; };
 /**
  * Normaliza todos os datasets do DataInput.
  */
@@ -30,12 +49,18 @@ export var processData = function (data, quantidadeProcessosJuridicos, totalProt
     // ------------------------------------------------------------------
     // PROTESTOS
     // ------------------------------------------------------------------
+    data.protestos = data.protestos.map(function (e) {
+        var merged = protestoHistoricoDataEfetiva(e);
+        if (!merged)
+            return e;
+        return __assign(__assign({}, e), { data: merged });
+    });
     var grouped = groupBy(data.protestos, function (e) { return e.data; });
     // transforma em array ordenado por data asc
     var groupedOrdered = Object.entries(grouped).sort(function (_a, _b) {
         var kA = _a[0];
         var kB = _b[0];
-        return keyToTime(kA) - keyToTime(kB);
+        return protestoKeyToTime(kA) - protestoKeyToTime(kB);
     });
     data.protestos = groupedOrdered
         .map(function (_a) {
@@ -48,8 +73,15 @@ export var processData = function (data, quantidadeProcessosJuridicos, totalProt
     data.protestos = sortBy(unique(data.protestos, function (x) { return x.data; })
         .filter(removeZeros)
         .filter(removeSameAsNext)
-        .map(function (info) { return (__assign(__assign({}, info), { data: formatDatePtBrToDate(info.data) // normaliza p/ ISO local
-     })); }), function (info) { return info.data; });
+        .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
     // ------------------------------------------------------------------
@@ -112,14 +144,12 @@ export function processProtestData(document, iaOverrides) {
     // Converte Node[] para Protesto[]
     var protestos = XPathUtils.selectArray('//body//protesto', document).map(parseProtesto);
     var _a = classifyProtestos(protestos, iaOverrides), protestosDeCredito = _a.protestosDeCredito, protestosDeImposto = _a.protestosDeImposto, protestosGerais = _a.protestosGerais;
-    var obterUltimaData = function (protestos) {
-        if (!protestos.length)
+    var obterUltimaData = function (lista) {
+        if (!lista.length)
             return null;
-        var datas = protestos
-            .map(function (p) {
-            return new Date(converterParaFormatoValido(p.dataProtesto)).getTime();
-        })
-            .filter(function (d) { return !isNaN(d); });
+        var datas = lista
+            .map(function (p) { return parseProtestDateToTime(p.dataProtesto || p.firstSeen); })
+            .filter(function (d) { return d !== null; });
         return datas.length
             ? new Date(Math.max.apply(Math, datas)).toLocaleDateString('pt-BR')
             : null;

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

@@ -1,5 +1,6 @@
 import { __assign, __rest, __spreadArray } from "tslib";
 /* eslint-disable @typescript-eslint/no-explicit-any */
+import { parseProtestHistoryRowToTime } from '../../../utils/date';
 import { normalizeName, similarNames } from '../../../utils/similarNames';
 import { safeStringify } from './responseUtils';
 // -----------------------------------------------------------------------------
@@ -86,7 +87,9 @@ export var selectRelevantData = function (data) {
     var ultimaOcorrenciaProtestos = ResumoSafe === null || ResumoSafe === void 0 ? void 0 : ResumoSafe.ultimaOcorrenciaProtestos;
     if (Array.isArray(ResumoSafe === null || ResumoSafe === void 0 ? void 0 : ResumoSafe.protestoHistory) &&
         ResumoSafe.protestoHistory.length) {
-        var latest = __spreadArray([], ResumoSafe.protestoHistory, true).sort(function (a, b) { return new Date(b.data).getTime() - new Date(a.data).getTime(); })[0];
+        var latest = __spreadArray([], ResumoSafe.protestoHistory, true).sort(function (a, b) {
+            return parseProtestHistoryRowToTime(b) - parseProtestHistoryRowToTime(a);
+        })[0];
         var latestWithCorrectDate = ultimaOcorrenciaProtestos
             ? __assign(__assign({}, latest), { data: ultimaOcorrenciaProtestos }) : latest;
         protestosData = [latestWithCorrectDate];

package/dist/components/liminar/useLiminarProtestosDoPassado.js

@@ -20,7 +20,7 @@ var useLiminarProtestosDoPassado = function (_a) {
     var posthog = useContext(PostHogContext).posthog;
     var _c = useGlobalData(), globalData = _c.data, setData = _c.setData;
     var fetch = useCallback(function () { return __awaiter(void 0, void 0, void 0, function () {
-        var data, parsedData, _a, _b, normalizedData, numerosChave, protestosDoPassado, ocultos;
+        var data, parsedData, _a, _b, normalizedData, protestosDoPassado, instrumentosParaEvento, idsSomenteComChave;
         return __generator(this, function (_c) {
             switch (_c.label) {
                 case 0: return [4 /*yield*/, client.request("SELECT FROM 'Protestos'.'History'", {
@@ -36,25 +36,27 @@ var useLiminarProtestosDoPassado = function (_a) {
                         var _a;
                         return (__assign(__assign({}, item), { cpfCnpj: (_a = item.cpfCnpj) !== null && _a !== void 0 ? _a : documento }));
                     });
-                    numerosChave = normalizedData
-                        .filter(function (item) { return item.missingAt; })
-                        .map(function (item) { return item.chave; });
                     protestosDoPassado = normalizedData.filter(function (item) { return item.missingAt; });
-                    ocultos = protestosDoPassado.map(function (item) { return item.chave; });
+                    instrumentosParaEvento = protestosDoPassado.map(function (item) {
+                        return item.chave != null && String(item.chave).trim() !== ''
+                            ? String(item.chave)
+                            : '(sem chave)';
+                    });
+                    idsSomenteComChave = instrumentosParaEvento.filter(function (c) { return c !== '(sem chave)'; });
                     setData(function (prev) { return (__assign(__assign({}, prev), { protestosPagosBaixados: {
                             isLoaded: true,
                             protestos: protestosDoPassado
                         } })); });
-                    if (ocultos.length > 0 && posthog) {
+                    if (protestosDoPassado.length > 0 && posthog) {
                         posthog.capture('liminar_protestos_ocultos', {
                             documento: documento,
-                            quantidade: ocultos.length,
-                            instrumentos: ocultos
+                            quantidade: protestosDoPassado.length,
+                            instrumentos: instrumentosParaEvento
                         });
                     }
                     return [2 /*return*/, {
-                            possuiIndiciosDeLiminarProtestosDoPassado: ocultos.length > 0,
-                            protestosDoPassadoIds: ocultos
+                            possuiIndiciosDeLiminarProtestosDoPassado: protestosDoPassado.length > 0,
+                            protestosDoPassadoIds: idsSomenteComChave
                         }];
             }
         });

package/dist/components/protestosPagosBaixados/adaptToChart.d.ts

@@ -1,4 +1,8 @@
 import type { ProtestoHistoricoItem } from '@/@types/domain/protestosPagosBaixadosTypes';
 import type { Consulta } from '../../components/chart/types/iChart';
-export declare function adaptToUI(items: ProtestoHistoricoItem[]): ProtestoHistoricoItem[];
+/** Linha já normalizada para UI, com `rowId` único para listas React. */
+export type ProtestoHistoricoUiRow = ProtestoHistoricoItem & {
+    rowId: string;
+};
+export declare function adaptToUI(items: ProtestoHistoricoItem[]): ProtestoHistoricoUiRow[];
 export declare function buildChartSeries(items: ProtestoHistoricoItem[]): Consulta[];

package/dist/components/protestosPagosBaixados/adaptToChart.js

@@ -2,16 +2,31 @@ import { __assign } from "tslib";
 // Pré-compila regexes fora do hot path
 var ISO_RE = /^\d{4}-\d{2}-\d{2}/;
 var BR_RE = /^(\d{2})\/(\d{2})\/(\d{4})/;
+function assignStableRowIds(items) {
+    var baseKeys = items.map(function (i, idx) {
+        var c = i.chave;
+        if (c != null && String(c).trim() !== '')
+            return String(c);
+        return "protesto-historico-".concat(idx);
+    });
+    var counts = new Map();
+    var rowIds = baseKeys.map(function (base) {
+        var _a;
+        var n = ((_a = counts.get(base)) !== null && _a !== void 0 ? _a : 0) + 1;
+        counts.set(base, n);
+        return n === 1 ? base : "".concat(base, "__").concat(n);
+    });
+    return { rowIds: rowIds };
+}
 export function adaptToUI(items) {
-    // Se realmente não quiser adaptar nada, pode remover esta função e usar items direto.
-    // Aqui normalizo datas vazias para string vazia e default para campos opcionais.
-    return items.map(function (i) {
+    var rowIds = assignStableRowIds(items).rowIds;
+    return items.map(function (i, idx) {
         var _a, _b, _c, _d, _e;
         return (__assign(__assign({}, i), { dataProtesto: (_b = (_a = i.dataProtesto) !== null && _a !== void 0 ? _a : i.data) !== null && _b !== void 0 ? _b : '', nomeCedente: (_c = i.nomeCedente) !== null && _c !== void 0 ? _c : '', nomeApresentante: (_d = i.nomeApresentante) !== null && _d !== void 0 ? _d : '', valor: Number.isFinite(i.valor)
                 ? i.valor
                 : safeNumber((_e = i.valor) !== null && _e !== void 0 ? _e : i.valorProtestado), custas: Number.isFinite(i.custas)
                 ? i.custas
-                : safeNumber(i.custas) }));
+                : safeNumber(i.custas), rowId: rowIds[idx] }));
     });
 }
 export function buildChartSeries(items) {

package/dist/components/protestosPagosBaixados/index.js

@@ -77,7 +77,7 @@ var ProtestosPagosBaixados = function (_a) {
                 : "Foram encontrados ".concat((_l = (_k = data === null || data === void 0 ? void 0 : data.protestosPagosBaixados) === null || _k === void 0 ? void 0 : _k.protestos) === null || _l === void 0 ? void 0 : _l.length, " protestos")), variant: ((_o = (_m = data === null || data === void 0 ? void 0 : data.protestosPagosBaixados) === null || _m === void 0 ? void 0 : _m.protestos) === null || _o === void 0 ? void 0 : _o.length) ? 'error' : 'default', icon: ProtestosIcon, onSuccess: function () {
             var protestosAdaptados = adaptToUI(items);
             var totalProtestos = protestosAdaptados.length;
-            var children = totalProtestos ? (React.createElement(Result, null, protestosAdaptados.map(function (protesto) { return (React.createElement(ProtestoHistoricoItemComponent, { key: protesto.chave, protesto: protesto })); }))) : null;
+            var children = totalProtestos ? (React.createElement(Result, null, protestosAdaptados.map(function (protesto) { return (React.createElement(ProtestoHistoricoItemComponent, { key: protesto.rowId, protesto: protesto })); }))) : null;
             return {
                 children: children
             };

package/dist/components/webservice.d.ts

@@ -9,18 +9,12 @@ type RequestDefaults = {
     urlData?: Client.Form;
 };
 export declare const RequestDefaultsContext: React.Context<RequestDefaults>;
-/** Alinhado ao `WebServiceOptions` do `@credithub/webservice` com Jurischain (4.º arg. do construtor). Em runtime exige pacote com fluxo HTTP 402; tipos npm antigos não declaram o 4.º parâmetro. */
-export type WebServiceProviderOptions = {
-    jurischain?: {
-        enabled?: boolean;
-        solveTimeout?: number;
-    };
-};
+export type WebServiceProviderOptions = Client.WebServiceOptions;
 export declare const WebServiceProvider: FC<PropsWithChildren<{
     credential: string;
     defaultData?: Client.Form;
     defaultUrlData?: Client.Form;
-    /** Ex.: `{ jurischain: { solveTimeout: 120_000 } }` quando usar `@credithub/webservice` com Jurischain. */
+    /** Jurischain (challenges HTTP 402). Ex.: `{ jurischain: { solveTimeout: 120_000 } }`. */
     webserviceOptions?: WebServiceProviderOptions;
 }>>;
 export declare function CustomProvider<T extends Client.Form = Client.Form, R = unknown>(Provider: Context<RequestContext<R>>, query: string): FC<PropsWithChildren<{

package/dist/components/webservice.js

@@ -6,10 +6,9 @@ import { RequestStatus } from './requestContextTypes';
 export * from './requestContextTypes';
 export var WebService = createContext(new Client.WebService());
 export var RequestDefaultsContext = createContext({});
-var WebServiceClient = Client.WebService;
 export var WebServiceProvider = function (_a) {
     var credential = _a.credential, defaultData = _a.defaultData, defaultUrlData = _a.defaultUrlData, webserviceOptions = _a.webserviceOptions, children = _a.children;
-    return (React.createElement(WebService.Provider, { value: new WebServiceClient(credential, {}, 5, webserviceOptions !== null && webserviceOptions !== void 0 ? webserviceOptions : {}) },
+    return (React.createElement(WebService.Provider, { value: new Client.WebService(credential, {}, 5, webserviceOptions !== null && webserviceOptions !== void 0 ? webserviceOptions : {}) },
         React.createElement(RequestDefaultsContext.Provider, { value: { data: defaultData, urlData: defaultUrlData } }, children)));
 };
 var isDocument = function (value) {

package/dist/hooks/useProtestosClassification.js

@@ -1,11 +1,11 @@
 import { REGEX_PROTESTOS_DE_CREDITO, REGEX_PROTESTOS_DE_IMPOSTO } from '../constants/regex';
-import { formatDatePtBrToDate } from '../utils/date';
+import { parseProtestDateToTime } from '../utils/date';
 import { useMemo } from 'react';
 // Função de ordenação por data
 var byDate = function (a, b) {
     var _a, _b;
-    var v0 = ((_a = formatDatePtBrToDate(b.dataProtesto)) === null || _a === void 0 ? void 0 : _a.getTime()) || 0;
-    var v1 = ((_b = formatDatePtBrToDate(a.dataProtesto)) === null || _b === void 0 ? void 0 : _b.getTime()) || 0;
+    var v0 = (_a = parseProtestDateToTime(b.dataProtesto || b.firstSeen)) !== null && _a !== void 0 ? _a : 0;
+    var v1 = (_b = parseProtestDateToTime(a.dataProtesto || a.firstSeen)) !== null && _b !== void 0 ? _b : 0;
     return v0 - v1;
 };
 export function classifyProtestos(protestos, iaOverrides) {

package/dist/utils/date.d.ts

@@ -2,3 +2,14 @@ export declare function isDate(date: string | Date): boolean;
 export declare function parseDate(dateStr: string): Date;
 export declare function converterParaFormatoValido(data: string): string;
 export declare function formatDatePtBrToDate(date: string): Date;
+/**
+ * Parses protest-related date strings (ISO `yyyy-MM-dd` or pt-BR `dd/MM/yyyy`).
+ * Used for `dataProtesto` / `data` e fallback `firstSeen` (ex.: XML `first_seen` → objeto com `firstSeen`).
+ */
+export declare function parseProtestDateToTime(value: string | undefined | null): number | null;
+/** Converte string de protesto/histórico (ISO ou pt-BR) em `Date` para armazenar em `Consulta.data`. */
+export declare function parseProtestStringToDate(value: string | Date | undefined | null): Date;
+/** Timestamp a partir de `data` já materializada (histórico gravado / pós-processData). */
+export declare function parseProtestHistoryRowToTime(row: {
+    data?: string | Date;
+}): number;

package/dist/utils/date.js

@@ -18,3 +18,40 @@ export function formatDatePtBrToDate(date) {
     var b = (x === null || x === void 0 ? void 0 : x.join('-')) + 'T00:00';
     return new Date(b);
 }
+/**
+ * Parses protest-related date strings (ISO `yyyy-MM-dd` or pt-BR `dd/MM/yyyy`).
+ * Used for `dataProtesto` / `data` e fallback `firstSeen` (ex.: XML `first_seen` → objeto com `firstSeen`).
+ */
+export function parseProtestDateToTime(value) {
+    if (value == null)
+        return null;
+    var s = String(value).trim();
+    if (!s)
+        return null;
+    if (/^\d{4}-\d{2}-\d{2}/.test(s)) {
+        var t_1 = new Date(s).getTime();
+        return Number.isNaN(t_1) ? null : t_1;
+    }
+    if (s.includes('/')) {
+        var t_2 = formatDatePtBrToDate(s).getTime();
+        return Number.isNaN(t_2) ? null : t_2;
+    }
+    var t = new Date(s).getTime();
+    return Number.isNaN(t) ? null : t;
+}
+/** Converte string de protesto/histórico (ISO ou pt-BR) em `Date` para armazenar em `Consulta.data`. */
+export function parseProtestStringToDate(value) {
+    if (value instanceof Date)
+        return value;
+    var t = parseProtestDateToTime(value);
+    return t == null ? new Date(NaN) : new Date(t);
+}
+/** Timestamp a partir de `data` já materializada (histórico gravado / pós-processData). */
+export function parseProtestHistoryRowToTime(row) {
+    var _a;
+    if (row.data instanceof Date && !Number.isNaN(row.data.getTime())) {
+        return row.data.getTime();
+    }
+    var s = typeof row.data === 'string' && row.data.trim() ? row.data.trim() : '';
+    return (_a = parseProtestDateToTime(s)) !== null && _a !== void 0 ? _a : 0;
+}

package/dist/utils/parseProtesto.d.ts

@@ -1,9 +1,13 @@
+/** Data da primeira vez que o protesto apareceu na base (XML datalake: `./first_seen`). */
+export declare function xmlFirstSeenFromNode(node: Node): string | undefined;
 export interface Protesto {
     nm_chave: string;
     cpfCnpj: string;
     nomeCedente: string;
     nomeApresentante: string;
     dataProtesto: string;
+    /** Primeira vez que o protesto apareceu na base (XML `first_seen` → mesmo nome que `toArray()` PHP: `firstSeen`). */
+    firstSeen?: string;
     valor: string;
     vl_custas?: string;
     temAnuencia: boolean;

package/dist/utils/parseProtesto.js

@@ -1,14 +1,14 @@
+import { __assign } from "tslib";
 import XPathUtils from '../utils/xpath';
+/** Data da primeira vez que o protesto apareceu na base (XML datalake: `./first_seen`). */
+export function xmlFirstSeenFromNode(node) {
+    var raw = XPathUtils.select('string(./first_seen)', node);
+    if (typeof raw === 'string' && raw.trim())
+        return raw.trim();
+    return undefined;
+}
 export var parseProtesto = function (node) {
     var $ = function (xp) { return XPathUtils.select("string(".concat(xp, ")"), node); };
-    return {
-        nm_chave: $('./nm_chave'),
-        cpfCnpj: $('./cpfCnpj'),
-        nomeCedente: $('./nomeCedente'),
-        nomeApresentante: $('./nomeApresentante'),
-        dataProtesto: $('./dataProtesto'),
-        valor: $('./valor'),
-        vl_custas: $('./vl_custas') || undefined,
-        temAnuencia: $('./temAnuencia') === 'true'
-    };
+    var firstSeen = xmlFirstSeenFromNode(node);
+    return __assign(__assign({ nm_chave: $('./nm_chave'), cpfCnpj: $('./cpfCnpj'), nomeCedente: $('./nomeCedente'), nomeApresentante: $('./nomeApresentante'), dataProtesto: $('./dataProtesto') }, (firstSeen ? { firstSeen: firstSeen } : {})), { valor: $('./valor'), vl_custas: $('./vl_custas') || undefined, temAnuencia: $('./temAnuencia') === 'true' });
 };