@credithub/harlan-components 1.125.0 → 1.127.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;
@@ -66,17 +66,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
@@ -222,6 +212,7 @@ 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);

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,8 @@ 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; });
     // ------------------------------------------------------------------
     // CCFs
     // ------------------------------------------------------------------
@@ -112,14 +137,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/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' });
 };