@credithub/harlan-components 1.129.0 → 1.131.0

package/dist/components/webservice.js

@@ -3,13 +3,19 @@ import { Client } from '@credithub/webservice';
 import React, { createContext, useCallback, useContext, useEffect, useMemo, useState } from 'react';
 import Section from './section';
 import { RequestStatus } from './requestContextTypes';
+import { classifyRequestError, isErrorWithPushFlag } from '../utils/classifyRequestError';
 export * from './requestContextTypes';
 export var WebService = createContext(new Client.WebService());
+/** Marcador enviado em todas as consultas do shell Harlan (`harlan` como boolean). */
+export var HARLAN_WS_MARKER = { harlan: true };
 export var RequestDefaultsContext = createContext({});
 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 Client.WebService(credential, {}, 5, webserviceOptions !== null && webserviceOptions !== void 0 ? webserviceOptions : {}) },
-        React.createElement(RequestDefaultsContext.Provider, { value: { data: defaultData, urlData: defaultUrlData } }, children)));
+        React.createElement(RequestDefaultsContext.Provider, { value: {
+                data: __assign(__assign({}, (defaultData !== null && defaultData !== void 0 ? defaultData : {})), HARLAN_WS_MARKER),
+                urlData: defaultUrlData
+            } }, children)));
 };
 var isDocument = function (value) {
     return typeof Document !== 'undefined' && value instanceof Document;
@@ -77,12 +83,20 @@ var extractExceptionFromDocument = function (document) {
     }
     return null;
 };
-var isErrorWithPush = function (error) {
-    if (error && typeof error === 'object') {
-        return (error === null || error === void 0 ? void 0 : error.push) === true;
-    }
-    return false;
-};
+function pushNoticeFromError(requestError) {
+    var _a;
+    var err = requestError;
+    var trimmed = (_a = err === null || err === void 0 ? void 0 : err.message) === null || _a === void 0 ? void 0 : _a.trim();
+    var code = typeof (err === null || err === void 0 ? void 0 : err.code) === 'number' && !Number.isNaN(err.code)
+        ? err.code
+        : undefined;
+    var notice = {};
+    if (trimmed)
+        notice.message = trimmed;
+    if (code != null)
+        notice.code = code;
+    return notice;
+}
 export function CustomProvider(Provider, query) {
     return function (_a) {
         var children = _a.children, data = _a.data, urlData = _a.urlData, _b = _a.depends, depends = _b === void 0 ? [] : _b;
@@ -96,6 +110,7 @@ export function CustomProvider(Provider, query) {
         var _j = useState(false), showLoadingBar = _j[0], setShowLoadingBar = _j[1];
         var _k = useState(false), shouldRetry = _k[0], setShouldRetry = _k[1];
         var _l = useState(false), requestCompleted = _l[0], setRequestCompleted = _l[1];
+        var _m = useState(null), pushNotice = _m[0], setPushNotice = _m[1];
         var dependentRequestsCompleted = useMemo(function () {
             return depends === null || depends === void 0 ? void 0 : depends.every(function (request) {
                 return (request === null || request === void 0 ? void 0 : request.type) === RequestStatus.Success ||
@@ -121,6 +136,7 @@ export function CustomProvider(Provider, query) {
                 return;
             setLoading(true);
             setError(null);
+            setPushNotice(null);
             setShowLoadingBar(true);
             simulateProgress();
             var requestId = Date.now();
@@ -137,17 +153,18 @@ export function CustomProvider(Provider, query) {
                 .then(function (parsedResponse) {
                 setResponse(parsedResponse);
                 setError(null);
+                setPushNotice(null);
                 setRequestCompleted(true);
             })
                 .catch(function (requestError) {
-                if (requestError.name !== 'AbortError') {
-                    // Se o erro tem push === true, não tratar como erro (caso esperado)
-                    if (isErrorWithPush(requestError)) {
-                        // Tratar como sucesso (sem erro)
+                if (classifyRequestError(requestError) !== 'aborted') {
+                    if (isErrorWithPushFlag(requestError)) {
                         setError(null);
+                        setPushNotice(pushNoticeFromError(requestError));
                         setRequestCompleted(true);
                     }
                     else {
+                        setPushNotice(null);
                         setError(requestError instanceof Error
                             ? requestError
                             : new Error(String(requestError)));
@@ -193,7 +210,8 @@ export function CustomProvider(Provider, query) {
                 !loading &&
                 requestsMap.size === 0 &&
                 !requestCompleted &&
-                dependentRequestsCompleted) {
+                dependentRequestsCompleted &&
+                !shouldRetry) {
                 fetchData();
             }
         }, [
@@ -202,7 +220,8 @@ export function CustomProvider(Provider, query) {
             loading,
             requestsMap,
             requestCompleted,
-            dependentRequestsCompleted
+            dependentRequestsCompleted,
+            shouldRetry
         ]);
         useEffect(function () {
             if (shouldRetry) {
@@ -214,6 +233,10 @@ export function CustomProvider(Provider, query) {
         var contextValue = useMemo(function () {
             var activeRequestsCount = requestsMap.size;
             var warningMessage = extractWarningFromDocument(response === null || response === void 0 ? void 0 : response.document);
+            var terminalPushSuccess = requestCompleted &&
+                !error &&
+                !response &&
+                pushNotice != null;
             return {
                 type: error
                     ? RequestStatus.Error
@@ -221,7 +244,9 @@ export function CustomProvider(Provider, query) {
                         ? RequestStatus.Success
                         : loading
                             ? RequestStatus.Loading
-                            : RequestStatus.Empty,
+                            : terminalPushSuccess
+                                ? RequestStatus.Success
+                                : RequestStatus.Empty,
                 error: error,
                 data: mergedData,
                 urlData: mergedUrlData,
@@ -235,7 +260,8 @@ export function CustomProvider(Provider, query) {
                 progress: progress,
                 activeRequests: activeRequestsCount,
                 showLoadingBar: showLoadingBar,
-                warningMessage: warningMessage
+                warningMessage: warningMessage,
+                pushNotice: pushNotice
             };
         }, [
             error,
@@ -245,7 +271,9 @@ export function CustomProvider(Provider, query) {
             loading,
             progress,
             requestsMap,
-            showLoadingBar
+            showLoadingBar,
+            pushNotice,
+            requestCompleted
         ]);
         return (React.createElement(Provider.Provider, { value: contextValue }, children));
     };
@@ -256,9 +284,10 @@ export function useQuery(query, data, enabled) {
     var _a = useContext(RequestDefaultsContext), defaultData = _a.data, defaultUrlData = _a.urlData;
     var _b = useState(null), response = _b[0], setResponse = _b[1];
     var _c = useState(null), error = _c[0], setError = _c[1];
-    var _d = useState(false), isLoading = _d[0], setIsLoading = _d[1];
-    var _e = useState(true), shouldFetch = _e[0], setShouldFetch = _e[1];
-    var _f = useState(0), loadingProgress = _f[0], setProgress = _f[1];
+    var _d = useState(null), pushNotice = _d[0], setPushNotice = _d[1];
+    var _e = useState(false), isLoading = _e[0], setIsLoading = _e[1];
+    var _f = useState(true), shouldFetch = _f[0], setShouldFetch = _f[1];
+    var _g = useState(0), loadingProgress = _g[0], setProgress = _g[1];
     var memoizedData = useMemo(function () { return data; }, [JSON.stringify(data)]);
     var mergedData = useMemo(function () { return (__assign(__assign({}, (defaultData !== null && defaultData !== void 0 ? defaultData : {})), (memoizedData !== null && memoizedData !== void 0 ? memoizedData : {}))); }, [defaultData, memoizedData]);
     var simulateProgress = useCallback(function () {
@@ -277,6 +306,7 @@ export function useQuery(query, data, enabled) {
             return;
         setIsLoading(true);
         simulateProgress();
+        setPushNotice(null);
         var abortController = new AbortController();
         client
             .request(query, mergedData, defaultUrlData, abortController.signal)
@@ -289,17 +319,18 @@ export function useQuery(query, data, enabled) {
             .then(function (parsedResponse) {
             setResponse(parsedResponse);
             setError(null);
+            setPushNotice(null);
             setProgress(100);
         })
             .catch(function (requestError) {
-            if (requestError.name !== 'AbortError') {
-                // Se o erro tem push === true, não tratar como erro (caso esperado)
-                if (isErrorWithPush(requestError)) {
-                    // Tratar como sucesso (sem erro)
+            if (classifyRequestError(requestError) !== 'aborted') {
+                if (isErrorWithPushFlag(requestError)) {
                     setError(null);
+                    setPushNotice(pushNoticeFromError(requestError));
                     setProgress(100);
                 }
                 else {
+                    setPushNotice(null);
                     setError(requestError instanceof Error
                         ? requestError
                         : new Error(String(requestError)));
@@ -340,6 +371,7 @@ export function useQuery(query, data, enabled) {
     return {
         response: response,
         error: error,
+        pushNotice: pushNotice,
         isLoading: isLoading,
         loadingProgress: loadingProgress,
         refetch: refetch
@@ -365,10 +397,8 @@ export function useMutation(query, data) {
         })
             .then(function (document) { return setResponse(document); })
             .catch(function (requestError) {
-            if (requestError.name !== 'AbortError') {
-                // Se o erro tem push === true, não tratar como erro (caso esperado)
-                if (isErrorWithPush(requestError)) {
-                    // Tratar como sucesso (sem erro)
+            if (classifyRequestError(requestError) !== 'aborted') {
+                if (isErrorWithPushFlag(requestError)) {
                     setError(null);
                 }
                 else {
@@ -406,10 +436,8 @@ export function useFetch(query) {
                     return document;
                 })
                     .catch(function (requestError) {
-                    if (requestError.name !== 'AbortError') {
-                        // Se o erro tem push === true, não tratar como erro (caso esperado)
-                        if (isErrorWithPush(requestError)) {
-                            // Tratar como sucesso (sem erro)
+                    if (classifyRequestError(requestError) !== 'aborted') {
+                        if (isErrorWithPushFlag(requestError)) {
                             setError(null);
                         }
                         else {
@@ -442,7 +470,8 @@ export function query(query) {
         progress: 0,
         activeRequests: 0,
         showLoadingBar: false,
-        warningMessage: null
+        warningMessage: null,
+        pushNotice: null
     });
     return Object.assign(RequestContext, {
         Request: CustomProvider(RequestContext, query)

package/dist/dev/manualPushSectionPreview.d.ts

@@ -0,0 +1,2 @@
+import React from 'react';
+export declare function ManualPushSectionPreview(): React.JSX.Element;

package/dist/dev/manualPushSectionPreview.js

@@ -0,0 +1,42 @@
+import React, { useContext } from 'react';
+import { ThemeProvider } from 'styled-components';
+import GlobalStyle from '../styles/globalStyle';
+import theme from '../styles/theme';
+import Section from '../components/section';
+import { Queries, RequestDefaultsContext, WebService } from '../components/webservice';
+function readMockMessage() {
+    var _a;
+    var q = new URLSearchParams(window.location.search);
+    return (((_a = q.get('devPushMsg')) === null || _a === void 0 ? void 0 : _a.trim()) ||
+        'Exceção simulada com push=true (teste manual).');
+}
+function buildMockWebService() {
+    var message = readMockMessage();
+    return {
+        request: function () {
+            return Promise.reject(Object.assign(new Error(message), { push: true }));
+        }
+    };
+}
+function FinderMockSection() {
+    var ctx = useContext(Queries.Finder);
+    if (!ctx)
+        return null;
+    return (React.createElement(Section, { ctx: ctx, title: "Finder \u2014 mock push=true", subtitle: "Query real: FINDER.BILLING; resposta: reject com push (s\u00F3 dev)" }));
+}
+export function ManualPushSectionPreview() {
+    return (React.createElement(ThemeProvider, { theme: theme },
+        React.createElement(GlobalStyle, null),
+        React.createElement("div", { style: { padding: 24, maxWidth: 720 } },
+            React.createElement("p", { style: { marginBottom: 16, fontSize: 14, opacity: 0.85 } },
+                "Par\u00E2metros: ",
+                React.createElement("code", null, "?devPushSection=1"),
+                " e opcionalmente",
+                ' ',
+                React.createElement("code", null, "devPushMsg=..."),
+                " (mensagem na exce\u00E7\u00E3o)."),
+            React.createElement(WebService.Provider, { value: buildMockWebService() },
+                React.createElement(RequestDefaultsContext.Provider, { value: {} },
+                    React.createElement(Queries.Finder.Request, { data: { documento: '00000000000100' } },
+                        React.createElement(FinderMockSection, null)))))));
+}

package/dist/hooks/useSafeQuery.d.ts

@@ -1,6 +1,7 @@
 export declare function useSafeQuery<T>(query: string, params: Record<string, any>, skip?: boolean): {
     response: import("../components/webservice").ParsedResponse<T> | null;
     error: Error | null;
+    pushNotice: import("../components/webservice").PushNotice | null;
     isLoading: boolean;
     loadingProgress: number;
     refetch: () => void;

package/dist/utils/classifyRequestError.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Classificação única de erros de request (transporte / webservice).
+ * Mantém semântica alinhada ao contrato Credithub (ex.: `push=true` = exceção esperada).
+ */
+export type RequestErrorKind = 'aborted' | 'push_expected' | 'real_error';
+export declare function isErrorWithPushFlag(error: unknown): boolean;
+export declare function classifyRequestError(error: unknown): RequestErrorKind;
+/** True quando o upstream deve bloquear refetch automático (erro real, não push nem abort). */
+export declare function isRealRequestFailure(error: unknown): boolean;

package/dist/utils/classifyRequestError.js

@@ -0,0 +1,26 @@
+/**
+ * Classificação única de erros de request (transporte / webservice).
+ * Mantém semântica alinhada ao contrato Credithub (ex.: `push=true` = exceção esperada).
+ */
+export function isErrorWithPushFlag(error) {
+    if (error && typeof error === 'object') {
+        return error.push === true;
+    }
+    return false;
+}
+export function classifyRequestError(error) {
+    if (error &&
+        typeof error === 'object' &&
+        'name' in error &&
+        error.name === 'AbortError') {
+        return 'aborted';
+    }
+    if (isErrorWithPushFlag(error)) {
+        return 'push_expected';
+    }
+    return 'real_error';
+}
+/** True quando o upstream deve bloquear refetch automático (erro real, não push nem abort). */
+export function isRealRequestFailure(error) {
+    return classifyRequestError(error) === 'real_error';
+}