@topconsultnpm/sdkui-react 6.20.0-dev1.6 → 6.20.0-dev1.60

package/lib/helper/TMPdfViewer.js

@@ -0,0 +1,368 @@
+import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
+import { useEffect, useState, useRef, useCallback } from "react";
+import styled from "styled-components";
+import { LoadIndicator } from 'devextreme-react/load-indicator';
+import { IconCloseOutline } from "./TMIcons";
+import { SDKUI_Localizator } from "./SDKUI_Localizator";
+import { TMColors } from "../utils/theme";
+import { TMMessageBoxManager, ButtonNames } from "../components/base/TMPopUp";
+// Dynamic imports for optional dependencies
+let pdfjs;
+let Document;
+let Page;
+let isReactPdfAvailable = false;
+try {
+    const reactPdf = require('react-pdf');
+    pdfjs = reactPdf.pdfjs;
+    Document = reactPdf.Document;
+    Page = reactPdf.Page;
+    // Configura il worker PDF.js PRIMA del rendering
+    pdfjs.GlobalWorkerOptions.workerSrc = `https://unpkg.com/pdfjs-dist@${pdfjs.version}/build/pdf.worker.min.mjs`;
+    isReactPdfAvailable = true;
+}
+catch (error) {
+    // react-pdf not available - will use iframe fallback
+    // console.warn('react-pdf is not installed. TMPdfViewer will use iframe fallback.');
+}
+const PDFViewerContainer = styled.div `
+  width: 100%;
+  height: 100%;
+  overflow-y: auto;
+  overflow-x: hidden;
+  background-color: #f5f5f5;
+  position: relative;
+  
+  .react-pdf__Document {
+    display: flex;
+    flex-direction: column;
+    align-items: center;
+    gap: 10px;
+    padding: 10px 0;
+  }
+  
+  .react-pdf__Page {
+    box-shadow: 0 2px 8px rgba(0, 0, 0, 0.1);
+    margin: 0 auto;
+  }
+  
+  .react-pdf__Page__canvas {
+    max-width: 100%;
+    height: auto !important;
+  }
+`;
+const LoadingOverlay = styled.div `
+  position: absolute;
+  top: 0;
+  left: 0;
+  width: 100%;
+  height: 100%;
+  background-color: rgba(245, 245, 245, 0.95);
+  display: flex;
+  justify-content: center;
+  align-items: center;
+  z-index: 1000;
+`;
+const TMPdfViewer = (props) => {
+    const { pdfBlob, title = "Anteprima PDF", isResizingActive, enableFitToWidth = false } = props;
+    const [isMobile, setIsMobile] = useState(false);
+    const [totalPagesNumber, setTotalPagesNumber] = useState(0);
+    const [loadedPagesNumber, setLoadedPagesNumber] = useState(0);
+    const [visiblePages, setVisiblePages] = useState(new Set([1]));
+    const [pdfUrl, setPdfUrl] = useState("");
+    const [hasUnsafeContent, setHasUnsafeContent] = useState(false);
+    const [isCheckingPdf, setIsCheckingPdf] = useState(true);
+    const [jsMatches, setJsMatches] = useState([]);
+    const observerRef = useRef(null);
+    useEffect(() => {
+        const checkIsMobile = () => {
+            const userAgent = navigator.userAgent || navigator.vendor || window.opera;
+            // Detect actual mobile/tablet devices
+            const isMobileDevice = 
+            // User agent detection (phones and tablets)
+            /android|webos|iphone|ipad|ipod|blackberry|iemobile|opera mini/i.test(userAgent) ||
+                // Media query for touch devices with coarse pointer (more reliable than screen width)
+                (window.matchMedia?.('(hover: none) and (pointer: coarse)').matches ?? false) ||
+                // Touch-capable devices excluding desktop OS
+                (navigator.maxTouchPoints > 1 && !/Win|Mac|Linux x86_64/i.test(userAgent));
+            setIsMobile(isMobileDevice);
+        };
+        const checkPdfForJavaScript = async () => {
+            setIsCheckingPdf(true);
+            try {
+                // Legge il PDF come testo per cercare pattern di JavaScript
+                const arrayBuffer = await pdfBlob.arrayBuffer();
+                const uint8Array = new Uint8Array(arrayBuffer);
+                const text = new TextDecoder('latin1').decode(uint8Array);
+                // Pattern specifici per rilevare JavaScript effettivo nelle strutture PDF
+                const jsPatterns = [
+                    // Esempio: /JavaScript [ (app.alert('Hello');) ]
+                    { name: 'JavaScript Dictionary Entry', pattern: /\/JavaScript\s*[(\[<][\s\S]*?[)\]>]/i },
+                    // Esempio: /JS 15 0 R (riferimento a un oggetto JavaScript)
+                    { name: 'JavaScript Object Reference', pattern: /\/JS\s+\d+\s+\d+\s+R/i },
+                    // Esempio: /JS (app.alert('Click');) o /JS <hexstring>
+                    { name: 'Inline JavaScript Code', pattern: /\/JS\s*[(<][\s\S]*?[)>]/i },
+                    // Esempio: /AA << /O << /S /JavaScript /JS (app.alert('Open');) >> >>
+                    { name: 'Additional Actions (AA) with JavaScript', pattern: /\/AA\s*<<[\s\S]*?\/JS[\s\S]*?>>/is },
+                    // Esempio: /OpenAction << /S /JavaScript /JS (this.print();) >>
+                    { name: 'Document Open Action with JavaScript', pattern: /\/OpenAction\s*<<[\s\S]*?\/JS[\s\S]*?>>/is },
+                    // Esempio: /Names << /JavaScript [ (MyScript) 12 0 R ] >>
+                    { name: 'Named JavaScript Functions', pattern: /\/Names\s*<<[\s\S]*?\/JavaScript[\s\S]*?>>/is },
+                ];
+                let foundJS = false;
+                const matches = [];
+                jsPatterns.forEach(({ name, pattern }) => {
+                    const match = text.match(pattern);
+                    if (match) {
+                        foundJS = true;
+                        const matchIndex = match.index || 0;
+                        const contextStart = Math.max(0, matchIndex - 50);
+                        const contextEnd = Math.min(text.length, matchIndex + match[0].length + 50);
+                        const context = text.substring(contextStart, contextEnd);
+                        matches.push({
+                            name,
+                            pattern: pattern.toString(),
+                            match: match[0],
+                            context: context.replace(/[\r\n]+/g, ' ').trim()
+                        });
+                    }
+                });
+                setHasUnsafeContent(foundJS);
+                setJsMatches(matches);
+            }
+            catch (error) {
+                // console.error('Errore nella validazione del PDF:', error);
+                // In caso di errore, permetti la visualizzazione
+                setHasUnsafeContent(false);
+            }
+            finally {
+                setIsCheckingPdf(false);
+            }
+        };
+        checkIsMobile();
+        checkPdfForJavaScript();
+        // Create URL for iframe
+        const url = URL.createObjectURL(pdfBlob);
+        setPdfUrl(url);
+        return () => {
+            if (url) {
+                URL.revokeObjectURL(url);
+            }
+        };
+    }, [pdfBlob]);
+    /**
+     * Callback per l'Intersection Observer che gestisce il lazy loading delle pagine PDF.
+     * Viene chiamato ogni volta che una pagina entra o esce dal viewport (area visibile).
+     *
+     * - Monitora quando gli elementi (pagine) diventano visibili
+     * - Aggiunge il numero di pagina al Set delle pagine visibili quando entra nel viewport
+     * - Il rootMargin di 500px carica le pagine prima che siano effettivamente visibili (preloading)
+     */
+    const pageObserverCallback = useCallback((entries) => {
+        entries.forEach(entry => {
+            const pageNum = parseInt(entry.target.getAttribute('data-page-number') || '0');
+            if (entry.isIntersecting) {
+                // Aggiunge la pagina al Set di quelle da renderizzare
+                setVisiblePages(prev => new Set([...prev, pageNum]));
+            }
+        });
+    }, []);
+    /**
+     * Crea e configura l'Intersection Observer per il lazy loading.
+     *
+     * Configurazione:
+     * - root: null → osserva rispetto al viewport del browser
+     * - rootMargin: '500px' → inizia il caricamento 500px prima che la pagina sia visibile (buffer)
+     * - threshold: 0.01 → trigger quando anche solo l'1% dell'elemento è visibile
+     *
+     * Benefici:
+     * - Non blocca l'UI durante il rendering
+     * - Carica solo le pagine necessarie
+     * - Migliora le performance su PDF con molte pagine
+     */
+    useEffect(() => {
+        observerRef.current = new IntersectionObserver(pageObserverCallback, {
+            root: null,
+            rootMargin: '500px',
+            threshold: 0.01
+        });
+        return () => {
+            // Cleanup: disconnette l'observer quando il componente viene smontato
+            observerRef.current?.disconnect();
+        };
+    }, [pageObserverCallback]);
+    const showMatchDetails = () => {
+        const highlightMatch = (context, matchText) => {
+            const matchIndex = context.indexOf(matchText);
+            if (matchIndex === -1) {
+                // Se non trova il match esatto, prova con una versione normalizzata
+                const normalizedContext = context.replace(/\s+/g, ' ');
+                const normalizedMatch = matchText.replace(/\s+/g, ' ');
+                const normalizedIndex = normalizedContext.indexOf(normalizedMatch);
+                if (normalizedIndex === -1) {
+                    // Se ancora non trova, mostra tutto in grassetto rosso
+                    return _jsx("strong", { style: { color: '#d32f2f', fontWeight: 'bold' }, children: context });
+                }
+                return (_jsxs(_Fragment, { children: [normalizedContext.substring(0, normalizedIndex), _jsx("strong", { style: { color: '#d32f2f', fontWeight: 'bold', background: '#ffebee' }, children: normalizedContext.substring(normalizedIndex, normalizedIndex + normalizedMatch.length) }), normalizedContext.substring(normalizedIndex + normalizedMatch.length)] }));
+            }
+            return (_jsxs(_Fragment, { children: [context.substring(0, matchIndex), _jsx("strong", { style: { color: '#d32f2f', fontWeight: 'bold', background: '#ffebee' }, children: context.substring(matchIndex, matchIndex + matchText.length) }), context.substring(matchIndex + matchText.length)] }));
+        };
+        TMMessageBoxManager.show({
+            title: `${SDKUI_Localizator.Attention}: ${SDKUI_Localizator.PotentiallyUnsafeContent}`,
+            buttons: [ButtonNames.OK],
+            showToppy: false,
+            resizable: true,
+            initialWidth: !isMobile ? '800px' : undefined,
+            message: (_jsxs("div", { style: { maxHeight: '500px', overflowY: 'auto', padding: '10px', lineHeight: '1.6' }, children: [_jsxs("div", { style: {
+                            marginBottom: '20px',
+                            padding: '12px',
+                            background: '#fff3cd',
+                            border: '1px solid #ffc107',
+                            borderRadius: '6px',
+                            fontSize: '14px',
+                            wordBreak: 'normal',
+                            hyphens: 'none'
+                        }, children: [_jsxs("strong", { children: [SDKUI_Localizator.Attention, ":"] }), " ", SDKUI_Localizator.PotentiallyUnsafeCodePatternsDetected.replaceParams(jsMatches.length.toString())] }), jsMatches.length > 0 ? (jsMatches.map((match, index) => (_jsxs("div", { style: {
+                            marginBottom: '16px',
+                            padding: '16px',
+                            border: '1px solid #ffcdd2',
+                            borderRadius: '8px',
+                            background: '#fff',
+                            boxShadow: '0 1px 3px rgba(0,0,0,0.1)'
+                        }, children: [_jsx("div", { style: {
+                                    marginBottom: '12px',
+                                    paddingBottom: '8px',
+                                    borderBottom: '2px solid #f44336'
+                                }, children: _jsxs("strong", { style: {
+                                        color: '#d32f2f',
+                                        fontSize: '15px',
+                                        display: 'flex',
+                                        alignItems: 'center',
+                                        gap: '8px'
+                                    }, children: [_jsx("span", { style: {
+                                                background: '#f44336',
+                                                color: '#fff',
+                                                borderRadius: '50%',
+                                                width: '24px',
+                                                height: '24px',
+                                                display: 'inline-flex',
+                                                alignItems: 'center',
+                                                justifyContent: 'center',
+                                                fontSize: '13px',
+                                                fontWeight: 'bold'
+                                            }, children: index + 1 }), match.name] }) }), _jsx("div", { style: { fontSize: '13px' }, children: _jsx("div", { style: {
+                                        background: '#f5f5f5',
+                                        padding: '10px',
+                                        borderRadius: '4px',
+                                        borderLeft: '3px solid #f44336',
+                                        fontFamily: 'Consolas, Monaco, monospace',
+                                        fontSize: '12px',
+                                        wordBreak: 'break-all',
+                                        color: '#333',
+                                        maxHeight: '200px',
+                                        overflowY: 'auto',
+                                        userSelect: 'text'
+                                    }, children: highlightMatch(match.context, match.match) }) })] }, index)))) : (_jsx("div", { style: { textAlign: 'center', padding: '20px', color: '#999' }, children: "Nessun dettaglio disponibile" }))] }))
+        });
+    };
+    // Mostra loading durante la validazione
+    if (isCheckingPdf) {
+        return (_jsx(PDFViewerContainer, { children: _jsxs("div", { style: {
+                    display: 'flex',
+                    justifyContent: 'center',
+                    alignItems: 'center',
+                    height: '100%',
+                    flexDirection: 'column',
+                    gap: '10px'
+                }, children: [_jsx(LoadIndicator, { height: 60, width: 60 }), _jsx("div", { children: "Validazione PDF in corso..." })] }) }));
+    }
+    /**
+     * Usa <iframe> nei seguenti casi:
+     * 1. react-pdf non è disponibile (libreria non installata)
+     * 2. Desktop E nessun contenuto JavaScript rilevato (visualizzazione nativa del browser più performante)
+     *
+     * L'iframe sfrutta il visualizzatore PDF nativo del browser, ma non può prevenire
+     * l'esecuzione di JavaScript embedded nel PDF.
+     */
+    if (!isReactPdfAvailable || (!isMobile && !hasUnsafeContent && pdfUrl)) {
+        return (_jsx(PDFViewerContainer, { children: _jsx("iframe", { src: `${pdfUrl}#${enableFitToWidth ? 'view=FitH&' : ''}scrollbar=1`, title: title, style: {
+                    width: '100%',
+                    height: '100%',
+                    border: 'none',
+                    zIndex: 0,
+                    pointerEvents: isResizingActive === true ? "none" : "auto"
+                } }, pdfUrl) }));
+    }
+    /**
+     * Usa react-pdf nei seguenti casi:
+     * 1. Dispositivo mobile (migliore esperienza utente con lazy loading)
+     * 2. Desktop con contenuto JavaScript rilevato (rendering sicuro senza esecuzione di script)
+     *
+     * react-pdf renderizza il PDF come canvas, prevenendo l'esecuzione di JavaScript embedded,
+     * ma è meno performante dell'iframe nativo su desktop.
+     */
+    return _jsxs(PDFViewerContainer, { style: { display: 'flex', flexDirection: 'column' }, children: [loadedPagesNumber === 0 && totalPagesNumber > 0 && _jsx(LoadingOverlay, { children: _jsxs("div", { style: {
+                        display: 'flex',
+                        justifyContent: 'center',
+                        alignItems: 'center',
+                        flexDirection: 'column',
+                        gap: '10px'
+                    }, children: [_jsx(LoadIndicator, { height: 60, width: 60 }), _jsxs("div", { children: [SDKUI_Localizator.Loading, "..."] })] }) }), _jsx("div", { style: {
+                    display: loadedPagesNumber > 0 && totalPagesNumber > 0 ? 'block' : 'none',
+                    flex: 1,
+                    overflow: 'auto'
+                }, children: _jsx(Document, { file: pdfBlob, onLoadSuccess: ({ numPages }) => {
+                        setTotalPagesNumber(numPages);
+                        setLoadedPagesNumber(0);
+                    }, loading: _jsxs("div", { style: {
+                            display: 'flex',
+                            justifyContent: 'center',
+                            alignItems: 'center',
+                            height: '100%',
+                            flexDirection: 'column',
+                            gap: '10px'
+                        }, children: [_jsx(LoadIndicator, { height: 60, width: 60 }), _jsxs("div", { children: [SDKUI_Localizator.Loading, "..."] })] }), error: _jsxs("div", { style: {
+                            display: 'flex',
+                            justifyContent: 'center',
+                            alignItems: 'center',
+                            height: '100%',
+                            flexDirection: 'column',
+                            gap: '10px'
+                        }, children: [_jsx(IconCloseOutline, { fontSize: 64, color: TMColors.error }), _jsx("div", { children: "Errore nel caricamento del PDF" })] }), children: Array.from(new Array(totalPagesNumber), (el, index) => {
+                        const pageNumber = index + 1;
+                        const shouldRender = visiblePages.has(pageNumber);
+                        return (_jsx("div", { "data-page-number": pageNumber, ref: (el) => {
+                                if (el && observerRef.current) {
+                                    observerRef.current.observe(el);
+                                }
+                            }, style: {
+                                minHeight: shouldRender ? 'auto' : '1000px',
+                                display: 'flex',
+                                justifyContent: 'center',
+                                alignItems: 'center'
+                            }, children: shouldRender && (_jsx(Page, { pageNumber: pageNumber, renderTextLayer: false, renderAnnotationLayer: false, width: Math.min(window.innerWidth - 40, 1200), loading: _jsx("div", { style: { padding: '20px' }, children: _jsx(LoadIndicator, { height: 40, width: 40 }) }), onLoadSuccess: () => {
+                                    setLoadedPagesNumber(prev => prev + 1);
+                                } })) }, `page_${pageNumber}`));
+                    }) }) }), hasUnsafeContent && (_jsxs("div", { style: {
+                    display: 'flex',
+                    justifyContent: 'center',
+                    alignItems: 'center',
+                    padding: '12px 20px',
+                    background: '#fff3cd',
+                    borderTop: '2px solid #ffc107',
+                    gap: '8px',
+                    flexShrink: 0
+                }, children: [_jsxs("span", { style: {
+                            color: '#856404',
+                            whiteSpace: 'nowrap',
+                            overflow: 'hidden',
+                            textOverflow: 'ellipsis',
+                            flex: 1
+                        }, children: [_jsx("strong", { children: "Attenzione:" }), " Questo documento contiene contenuti potenzialmente non sicuri."] }), jsMatches.length > 0 && (_jsx("span", { className: "dx-icon-info", style: {
+                            fontSize: '20px',
+                            color: '#d32f2f',
+                            cursor: 'pointer',
+                            transition: 'color 0.2s',
+                            marginLeft: '4px'
+                        }, onClick: showMatchDetails, title: "Clicca per vedere i dettagli", onMouseEnter: (e) => e.currentTarget.style.color = '#b71c1c', onMouseLeave: (e) => e.currentTarget.style.color = '#d32f2f' }))] }))] });
+};
+export default TMPdfViewer;

package/lib/helper/checkinCheckoutManager.d.ts

@@ -1,11 +1,20 @@
 import React from "react";
-import { DcmtTypeDescriptor, FileDescriptor, UserDescriptor } from "@topconsultnpm/sdk-ts";
+import { AccessLevels, DcmtTypeDescriptor, FileDescriptor, UserDescriptor } from "@topconsultnpm/sdk-ts";
 import { DcmtInfo, DownloadModes, DownloadTypes } from "../ts/types";
 import { FileItem } from "../components";
 /**
  * Check-in/Check-out Manager
  * Questo modulo gestisce tutte le operazioni di check-in e check-out
  * dei documenti e delle bozze dei gruppi di lavoro.
+ *
+ * Operazioni gestite:
+ * - Generazione nomi file per download e checkout con timestamp e identificatori univoci
+ * - Download di documenti in modalità checkout
+ * - Gestione dello storage locale delle informazioni di checkout (aggiunta, aggiornamento, rimozione)
+ * - Validazione dei nomi file secondo le convenzioni di naming CICO
+ * - Rendering dell'interfaccia utente per conferma check-in con visualizzazione anomalie
+ * - Determinazione dello stato di check-out dei documenti (editMode/lockMode)
+ * - Verifica permessi e abilitazione funzionalità CICO per tipo documento
  */
 export interface CheckoutInfo {
     DID: string;
@@ -18,6 +27,7 @@ interface CheckoutStatusResult {
     mode: 'editMode' | 'lockMode' | '';
     version: number;
     icon: React.ReactNode | null;
+    editLockTooltipText: React.ReactNode | null;
 }
 export type DownloadSource = {
     type: 'fileItem';
@@ -29,7 +39,7 @@ export type DownloadSource = {
 };
 export declare const getCicoDownloadFileName: (source: DownloadSource, checkout: boolean, withTimestampAndExt: boolean) => string;
 export declare const cicoDownloadFilesCallback: (sources: Array<DownloadSource>, checkout: boolean, downloadDcmtsAsync: (inputDcmts: Array<DcmtInfo> | undefined, downloadType?: DownloadTypes, downloadMode?: DownloadModes, onFileDownloaded?: (dcmtFile: File) => void, confirmAttachments?: (list: FileDescriptor[]) => Promise<string[] | undefined>, skipConfirmation?: boolean) => Promise<void>) => Promise<void>;
-export declare const updateCheckoutItem: (item: CheckoutInfo, type: "fileItem" | "dcmtInfo", action?: "addOrUpdate" | "remove") => void;
+export declare const updateCicoCheckoutStorageItem: (item: CheckoutInfo, type: "fileItem" | "dcmtInfo", action?: "addOrUpdate" | "remove") => void;
 export declare const validateCicoFileName: (source: DownloadSource, fileName: string) => FileNameValidation;
 type ValidationResult = {
     expected: string | number | undefined;
@@ -48,6 +58,26 @@ type FileNameValidation = {
     validationResults?: FileNameValidationItems;
 };
 export declare const renderCicoCheckInContent: (source: DownloadSource, selectedFilename: File, isValid: boolean, validationItems: FileNameValidationItems | undefined, color?: string) => React.ReactNode;
+interface CheckInCheckOutDcmtInfo {
+    CICO: number;
+    CanCICO: AccessLevels;
+    CanDelChronology: AccessLevels;
+    UserID_MID: number;
+    Date_MID: number;
+    Ver_MID: number;
+    UserID_CanViewOrUpdate: AccessLevels;
+    Date_CanViewOrUpdate: AccessLevels;
+    Ver_CanViewOrUpdate: AccessLevels;
+}
+export declare const getDcmtCicoInfo: (dtd: DcmtTypeDescriptor | undefined) => CheckInCheckOutDcmtInfo;
+/**
+ * Determina lo stato di check-in/check-out di un documento
+ *
+ * @param dcmt - Il documento in formato array (MetadataValueDescriptorEx[]) o oggetto piatto
+ * @param allUsers - Lista di tutti gli utenti per risolvere i nomi
+ * @param dtd - Descrittore del tipo documento contenente le definizioni dei metadati CICO
+ * @returns Oggetto con cicoEnabled (se CICO è abilitato) e checkoutStatus (dettagli dello stato)
+ */
 export declare const getDcmtCicoStatus: (dcmt: any, allUsers: Array<UserDescriptor>, dtd: DcmtTypeDescriptor | undefined) => {
     cicoEnabled: boolean;
     checkoutStatus: CheckoutStatusResult;