@topconsultnpm/sdkui-react 6.21.0-dev2.6 → 6.21.0-dev2.60

package/lib/helper/TMPdfViewer.js

@@ -154,11 +154,11 @@ const TMPdfViewer = (props) => {
                 // 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 },
+                    { 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 },
+                    { 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();) >>
@@ -258,11 +258,11 @@ const TMPdfViewer = (props) => {
                 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 _jsx("strong", { style: { color: '#e65100', 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: [normalizedContext.substring(0, normalizedIndex), _jsx("strong", { style: { color: '#e65100', fontWeight: 'bold', background: '#fff3e0' }, 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)] }));
+            return (_jsxs(_Fragment, { children: [context.substring(0, matchIndex), _jsx("strong", { style: { color: '#e65100', fontWeight: 'bold', background: '#fff3e0' }, children: context.substring(matchIndex, matchIndex + matchText.length) }), context.substring(matchIndex + matchText.length)] }));
         };
         TMMessageBoxManager.show({
             title: `${SDKUI_Localizator.Attention}: ${SDKUI_Localizator.PotentiallyUnsafeContent}`,
@@ -273,8 +273,8 @@ const TMPdfViewer = (props) => {
             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',
+                            background: '#fff8e1',
+                            border: '1px solid #ffe0b2',
                             borderRadius: '6px',
                             fontSize: '14px',
                             wordBreak: 'normal',
@@ -282,22 +282,22 @@ const TMPdfViewer = (props) => {
                         }, 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',
+                            border: '1px solid #ffe0b2',
                             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'
+                                    borderBottom: '2px solid #ffb74d'
                                 }, children: _jsxs("strong", { style: {
-                                        color: '#d32f2f',
+                                        color: '#e65100',
                                         fontSize: '15px',
                                         display: 'flex',
                                         alignItems: 'center',
                                         gap: '8px'
                                     }, children: [_jsx("span", { style: {
-                                                background: '#f44336',
+                                                background: '#ff9800',
                                                 color: '#fff',
                                                 borderRadius: '50%',
                                                 width: '24px',
@@ -311,7 +311,7 @@ const TMPdfViewer = (props) => {
                                         background: '#f5f5f5',
                                         padding: '10px',
                                         borderRadius: '4px',
-                                        borderLeft: '3px solid #f44336',
+                                        borderLeft: '3px solid #ff9800',
                                         fontFamily: 'Consolas, Monaco, monospace',
                                         fontSize: '12px',
                                         wordBreak: 'break-all',
@@ -408,23 +408,24 @@ const TMPdfViewer = (props) => {
                         display: 'flex',
                         justifyContent: 'center',
                         alignItems: 'center',
-                        padding: '12px 20px',
-                        background: '#fff3cd',
-                        borderTop: '2px solid #ffc107',
-                        gap: '8px',
+                        padding: '8px 16px',
+                        background: '#fff8e1',
+                        borderTop: '1px solid #ffe0b2',
+                        gap: '5px',
                         flexShrink: 0
-                    }, children: [_jsxs("span", { style: {
+                    }, children: [jsMatches.length > 0 && (_jsx("span", { className: "dx-icon-info", style: {
+                                fontSize: '18px',
+                                color: '#e65100',
+                                cursor: 'pointer',
+                                transition: 'color 0.2s',
+                                flexShrink: 0
+                            }, onClick: showMatchDetails, title: "Clicca per vedere i dettagli", onMouseEnter: (e) => e.currentTarget.style.color = '#bf360c', onMouseLeave: (e) => e.currentTarget.style.color = '#e65100' })), _jsxs("span", { style: {
                                 color: '#856404',
+                                fontSize: '13px',
                                 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' }))] }))] }) }));
+                            }, children: [_jsx("strong", { children: "Attenzione:" }), " Questo documento contiene contenuti potenzialmente non sicuri."] })] }))] }) }));
 };
 export default TMPdfViewer;

package/lib/helper/TMUtils.d.ts

@@ -53,4 +53,24 @@ type DcmtFormToolbarVisibility = {
     tmDcmtTasks: boolean;
 };
 export declare const getDcmtFormToolbarVisibility: (appModuleID: AppModules) => DcmtFormToolbarVisibility;
+export type MergePdfManagerType = {
+    merge: (files: File[], options?: {
+        onProgress?: (current: number, total: number, file: File) => void;
+    }) => Promise<{
+        bytes: Uint8Array;
+        blob: Blob;
+        pageCount: number;
+    }>;
+    mergeToFile: (files: File[], fileName?: string, options?: {
+        onProgress?: (current: number, total: number, file: File) => void;
+    }) => Promise<File>;
+    mergeAndDownload: (files: File[], fileName?: string, options?: {
+        onProgress?: (current: number, total: number, file: File) => void;
+    }) => Promise<{
+        bytes: Uint8Array;
+        blob: Blob;
+        pageCount: number;
+    }>;
+};
+export declare const isConvertibleToPdfExt: (ext: string | undefined | null) => boolean;
 export {};

package/lib/helper/TMUtils.js

@@ -358,3 +358,20 @@ export const getDcmtFormToolbarVisibility = (appModuleID) => {
             };
     }
 };
+// ---- Helper per file convertibili in PDF ----
+export const isConvertibleToPdfExt = (ext) => {
+    if (!ext)
+        return false;
+    // Rimuove le estensioni di firma digitale (P7M, M7M, TSR, TSD, TS) prima di normalizzare
+    const normalized = ext.toString().trim().toUpperCase()
+        .replace(/\.P7M/g, '').replace(/\.M7M/g, '').replace(/\.TSR/g, '').replace(/\.TSD/g, '').replace(/\.TS/g, '')
+        .toLowerCase().replace(/^\./, '').split('.').pop() ?? '';
+    return [
+        'doc', 'docx', 'dot', 'dotx', 'docm', 'dotm', 'odt', 'rtf', 'txt',
+        'csv', 'xls', 'xlsx',
+        'ppt', 'pptx', 'ppsx',
+        'htm', 'html', 'xml',
+        'bmp', 'jpg', 'jpeg', 'tif', 'tiff',
+        'eml', 'msg'
+    ].includes(normalized);
+};

package/lib/helper/ZipManager.d.ts

@@ -0,0 +1,56 @@
+/** File da aggiungere allo ZIP */
+export interface ZipFileEntry {
+    /** Nome/percorso nello ZIP (es. "docs/file.txt") */
+    filename: string;
+    /** Contenuto: string, File, Blob, ArrayBuffer o Uint8Array */
+    data: File | Blob | string | ArrayBuffer | Uint8Array;
+    /** Commento opzionale */
+    comment?: string;
+    /** Data modifica (default: ora) */
+    lastModDate?: Date;
+}
+/** Opzioni creazione ZIP */
+export interface ZipCreateOptions {
+    /** Password AES (opzionale) */
+    password?: string;
+    /** Compressione 0-9 (default: 6) */
+    compressionLevel?: number;
+    /** Cifratura: 1=128bit, 2=192bit, 3=256bit (default: 3) */
+    encryptionStrength?: 1 | 2 | 3;
+    /** Commento globale ZIP */
+    comment?: string;
+    /** Callback progresso: (indice, totale, nomeFile) */
+    onProgress?: (index: number, total: number, filename: string) => void;
+    /** Callback progresso singolo file: (bytesElaborati, bytesTotali) */
+    onEntryProgress?: (progress: number, total: number) => void;
+    /** AbortSignal per annullare */
+    signal?: AbortSignal;
+}
+/**
+ * Utility per creare file ZIP con password opzionale (AES-256).
+ * Tutti i metodi sono statici.
+ */
+export declare class ZipManager {
+    /** Configura zip.js (useWebWorkers, maxWorkers) */
+    static configure(options: {
+        useWebWorkers?: boolean;
+        maxWorkers?: number;
+    }): Promise<void>;
+    /** Crea ZIP da array di file */
+    static createZip(files: ZipFileEntry[], options?: ZipCreateOptions): Promise<Blob>;
+    /** Crea ZIP da singolo file */
+    static createZipFromFile(filename: string, data: File | Blob | string | ArrayBuffer | Uint8Array, options?: ZipCreateOptions): Promise<Blob>;
+    /** Crea ZIP da oggetto { nomeFile: contenuto } */
+    static createZipFromMap(filesMap: Record<string, File | Blob | string | ArrayBuffer | Uint8Array>, options?: ZipCreateOptions): Promise<Blob>;
+    /** Crea ZIP e avvia download */
+    static createAndDownload(files: ZipFileEntry[], downloadFilename: string, options?: ZipCreateOptions): Promise<void>;
+    /** Scarica un Blob come file */
+    static downloadBlob(blob: Blob, filename: string): void;
+    /** Crea URL temporaneo per Blob (ricordarsi revokeObjectURL!) */
+    static createObjectURL(blob: Blob): string;
+    /** Rilascia URL creato con createObjectURL */
+    static revokeObjectURL(url: string): void;
+    /** Converte data nel reader appropriato per zip.js */
+    private static createReader;
+}
+export default ZipManager;

package/lib/helper/ZipManager.js

@@ -0,0 +1,127 @@
+// ============================================================================
+// LAZY LOADING
+// ============================================================================
+/** Flag per tracciare se la libreria è stata caricata */
+let zipJsLoaded = false;
+/** Carica @zip.js/zip.js on-demand */
+const loadZipJs = async () => {
+    // if (!zipJsLoaded) {
+    //     console.log('[ZipManager] 📦 Caricamento lazy di @zip.js/zip.js...');
+    //     console.time('[ZipManager] Tempo caricamento');
+    // }
+    const module = await import("@zip.js/zip.js");
+    // if (!zipJsLoaded) {
+    //     console.timeEnd('[ZipManager] Tempo caricamento');
+    //     console.log('[ZipManager] ✅ Libreria caricata!');
+    //     zipJsLoaded = true;
+    // }
+    zipJsLoaded = true;
+    return module;
+};
+// ============================================================================
+// ZIP MANAGER CLASS
+// ============================================================================
+/**
+ * Utility per creare file ZIP con password opzionale (AES-256).
+ * Tutti i metodi sono statici.
+ */
+export class ZipManager {
+    /** Configura zip.js (useWebWorkers, maxWorkers) */
+    static async configure(options) {
+        const { configure } = await loadZipJs();
+        configure(options);
+    }
+    // ========================================================================
+    // CREAZIONE ZIP
+    // ========================================================================
+    /** Crea ZIP da array di file */
+    static async createZip(files, options = {}) {
+        const { password, compressionLevel = 6, encryptionStrength = 3, comment, onProgress, onEntryProgress, signal } = options;
+        // Validazione password: stringa vuota = nessuna cifratura
+        const usePassword = typeof password === "string" && password.length > 0 ? password : undefined;
+        // Lazy load della libreria
+        const { BlobWriter, ZipWriter, BlobReader, TextReader, Uint8ArrayReader } = await loadZipJs();
+        const blobWriter = new BlobWriter("application/zip");
+        const zipWriter = new ZipWriter(blobWriter, { password: usePassword, zipCrypto: true });
+        try {
+            const total = files.length;
+            for (let i = 0; i < files.length; i++) {
+                if (signal?.aborted) {
+                    throw new DOMException("Operazione annullata", "AbortError");
+                }
+                const file = files[i];
+                onProgress?.(i + 1, total, file.filename);
+                const reader = this.createReader(file.data, { BlobReader, TextReader, Uint8ArrayReader });
+                await zipWriter.add(file.filename, reader, {
+                    comment: file.comment,
+                    lastModDate: file.lastModDate,
+                    signal,
+                    password: usePassword,
+                    encryptionStrength,
+                    onprogress: onEntryProgress ? (progress, total) => onEntryProgress(progress, total) : undefined
+                });
+            }
+            const commentBytes = comment ? new TextEncoder().encode(comment) : undefined;
+            return await zipWriter.close(commentBytes);
+        }
+        catch (error) {
+            try {
+                await zipWriter.close();
+            }
+            catch { /* ignora */ }
+            throw error;
+        }
+    }
+    /** Crea ZIP da singolo file */
+    static async createZipFromFile(filename, data, options = {}) {
+        return this.createZip([{ filename, data }], options);
+    }
+    /** Crea ZIP da oggetto { nomeFile: contenuto } */
+    static async createZipFromMap(filesMap, options = {}) {
+        const files = Object.entries(filesMap).map(([filename, data]) => ({ filename, data }));
+        return this.createZip(files, options);
+    }
+    // ========================================================================
+    // DOWNLOAD
+    // ========================================================================
+    /** Crea ZIP e avvia download */
+    static async createAndDownload(files, downloadFilename, options = {}) {
+        const blob = await this.createZip(files, options);
+        this.downloadBlob(blob, downloadFilename);
+    }
+    /** Scarica un Blob come file */
+    static downloadBlob(blob, filename) {
+        const url = URL.createObjectURL(blob);
+        const link = document.createElement("a");
+        link.href = url;
+        link.download = filename;
+        link.style.display = "none";
+        document.body.appendChild(link);
+        link.click();
+        document.body.removeChild(link);
+        setTimeout(() => URL.revokeObjectURL(url), 100);
+    }
+    /** Crea URL temporaneo per Blob (ricordarsi revokeObjectURL!) */
+    static createObjectURL(blob) {
+        return URL.createObjectURL(blob);
+    }
+    /** Rilascia URL creato con createObjectURL */
+    static revokeObjectURL(url) {
+        URL.revokeObjectURL(url);
+    }
+    // ========================================================================
+    // PRIVATE
+    // ========================================================================
+    /** Converte data nel reader appropriato per zip.js */
+    static createReader(data, readers) {
+        const { BlobReader, TextReader, Uint8ArrayReader } = readers;
+        if (typeof data === "string")
+            return new TextReader(data);
+        if (data instanceof Uint8Array)
+            return new Uint8ArrayReader(data);
+        if (data instanceof ArrayBuffer)
+            return new Uint8ArrayReader(new Uint8Array(data));
+        return new BlobReader(data);
+    }
+}
+export default ZipManager;

package/lib/helper/index.d.ts

@@ -15,3 +15,4 @@ export * from './GlobalStyles';
 export * from './checkinCheckoutManager';
 export * from './workItemsHelper';
 export * from './devextremeCustomMessages';
+export * from './ZipManager';

package/lib/helper/index.js

@@ -15,3 +15,4 @@ export * from './GlobalStyles';
 export * from './checkinCheckoutManager';
 export * from './workItemsHelper';
 export * from './devextremeCustomMessages';
+export * from './ZipManager';

package/lib/hooks/useDataUserIdItem.js

@@ -15,7 +15,7 @@ export const useDataUserIdItem = () => {
         if (userIDs.size === 0)
             return;
         try {
-            const results = await Promise.all(Array.from(userIDs).map(id => UserListCacheService.GetAsync(id).then(user => ({ id, user }))
+            const results = await Promise.all(Array.from(userIDs).filter(id => id > 0).map(id => UserListCacheService.GetAsync(id).then(user => ({ id, user }))
                 .catch(() => ({ id, user: undefined }))));
             const newCache = new Map();
             results.forEach(({ id, user }) => {
@@ -70,17 +70,19 @@ export const useDataUserIdItem = () => {
      * @returns Elemento React per visualizzare l'utente
      */
     const renderUserIdViewer = useCallback((userId, showIcon = false, showTitile = true) => {
-        const ud = userId && userId > 0 ? getUserItem(userId) : undefined;
+        const ud = userId !== undefined && userId > 0 ? getUserItem(userId) : undefined;
         const getIcon = () => {
             if (!showIcon)
                 return null;
-            if (!userId)
+            if (userId === undefined)
                 return null;
             return ud ? _jsx(TMUserIcon, { ud: ud }) : _jsx("span", { title: showTitile ? SDKUI_Localizator.ValueNotPresent : undefined, style: { display: 'inline-flex', alignItems: 'center' }, children: _jsx(IconWarning, { color: TMColors.warning }) });
         };
         const getDescription = () => {
-            if (!userId)
+            if (userId == null)
                 return undefined;
+            if (userId === 0)
+                return SDKUI_Localizator.SystemUser;
             return ud ? getCompleteUserName(ud.domain, ud.name) : userId.toString() ?? SDKUI_Localizator.NoneSelection;
         };
         return (_jsxs("span", { style: { display: 'inline-flex', alignItems: 'center', gap: '4px', lineHeight: 1 }, children: [getIcon(), _jsx("span", { style: { lineHeight: 'normal' }, children: getDescription() })] }));

package/lib/hooks/useDcmtOperations.d.ts

@@ -1,5 +1,12 @@
-import { RetrieveFileOptions, FileDescriptor } from '@topconsultnpm/sdk-ts';
+import { RetrieveFileOptions, DcmtOpers, FileDescriptor, GeneralRetrieveFormats, InvoiceRetrieveFormats, OrderRetrieveFormats, FileFormats } from '@topconsultnpm/sdk-ts';
 import { DcmtInfo, DcmtOperationTypes, DownloadModes, DownloadTypes } from '../ts';
+export interface RetrieveFormatOptions {
+    retrieveReason?: DcmtOpers;
+    cvtFormat?: FileFormats;
+    generalRetrieveFormat?: GeneralRetrieveFormats;
+    invoiceRetrieveFormat?: InvoiceRetrieveFormats;
+    orderRetrieveFormat?: OrderRetrieveFormats;
+}
 export interface UseDcmtOperationsReturn {
     abortController: AbortController;
     showWaitPanel: boolean;
@@ -12,7 +19,7 @@ export interface UseDcmtOperationsReturn {
     waitPanelTextSecondary: string;
     waitPanelValueSecondary: number;
     waitPanelMaxValueSecondary: number;
-    downloadDcmtsAsync: (inputDcmts: DcmtInfo[] | undefined, downloadType?: DownloadTypes, downloadMode?: DownloadModes, onFileDownloaded?: (dcmtFile: File) => void, confirmAttachments?: (list: FileDescriptor[]) => Promise<string[] | undefined>, skipConfirmation?: boolean) => Promise<void>;
+    downloadDcmtsAsync: (inputDcmts: DcmtInfo[] | undefined, downloadType?: DownloadTypes, downloadMode?: DownloadModes, onFileDownloaded?: (dcmtFile: File, dcmtInfo: DcmtInfo) => void | Promise<void>, confirmAttachments?: (list: FileDescriptor[]) => Promise<string[] | undefined>, skipConfirmation?: boolean, retrieveOptions?: RetrieveFormatOptions, useCache?: boolean, showSuccessAlert?: boolean) => Promise<void>;
     getDcmtFileAsync: (inputDcmt: DcmtInfo | undefined, rfo: RetrieveFileOptions, operationTitle: string, keepWaitPanelPrimary: boolean, bypassCache?: boolean) => Promise<{
         file: File | undefined;
         isFromCache: boolean;

package/lib/hooks/useDcmtOperations.js

@@ -18,16 +18,49 @@ const isScannerLicenseConfigured = () => {
 };
 let abortController = new AbortController();
 const downloadCountMap = new Map();
-const getDownloadFileName = (fileName) => {
-    const firstDot = fileName.indexOf('.');
-    const lastDot = fileName.lastIndexOf('.');
-    if (firstDot === -1 || firstDot === lastDot)
-        return fileName;
-    const count = downloadCountMap.get(fileName) ?? 0;
-    downloadCountMap.set(fileName, count + 1);
-    if (count === 0)
-        return fileName;
-    return `${fileName.slice(0, firstDot)}(${count})${fileName.slice(firstDot)}`;
+/**
+ * Genera il nome file per il download con fallback: backend → fileName → DID.
+ * Aggiunge estensione se mancante e gestisce duplicati per file multi-estensione.
+ */
+const getDownloadFileName = (file, dcmtInfo) => {
+    // === FASE 1: Costruzione nome base con fallback ===
+    // Determina l'estensione con fallback
+    const fileExtFromBackend = file?.name?.split('.').pop()?.toLowerCase();
+    const fileExtFromDcmt = dcmtInfo.FILEEXT?.toLowerCase();
+    const fileExtension = fileExtFromBackend ?? fileExtFromDcmt ?? '';
+    let baseFileName;
+    // 1. Priorità massima: nome dal backend
+    if (file?.name) {
+        baseFileName = file.name;
+    }
+    // 2. Seconda priorità: nome salvato nel documento
+    else if (dcmtInfo.fileName) {
+        const hasExtension = dcmtInfo.fileName.includes('.');
+        baseFileName = hasExtension
+            ? dcmtInfo.fileName
+            : (fileExtension ? `${dcmtInfo.fileName}.${fileExtension}` : dcmtInfo.fileName);
+    }
+    // 3. Fallback finale: ID documento con estensione
+    else {
+        baseFileName = fileExtension ? `${dcmtInfo.DID}.${fileExtension}` : `${dcmtInfo.DID}`;
+    }
+    // === FASE 2: Gestione duplicati per file con estensioni multiple ===
+    const firstDot = baseFileName.indexOf('.');
+    const lastDot = baseFileName.lastIndexOf('.');
+    // Se non ci sono punti o c'è una sola estensione, ritorna il nome così com'è
+    if (firstDot === -1 || firstDot === lastDot) {
+        return baseFileName;
+    }
+    // Gestisce il contatore per evitare sovrascritture
+    const count = downloadCountMap.get(baseFileName) ?? 0;
+    downloadCountMap.set(baseFileName, count + 1);
+    // Prima occorrenza: nome originale
+    if (count === 0) {
+        return baseFileName;
+    }
+    // Download successivi: inserisce contatore dopo il nome base
+    // Es: "file.pdf.p7m" -> "file(1).pdf.p7m"
+    return `${baseFileName.slice(0, firstDot)}(${count})${baseFileName.slice(firstDot)}`;
 };
 export const useDcmtOperations = () => {
     const [showWaitPanel, setShowWaitPanel] = useState(false);
@@ -42,7 +75,7 @@ export const useDcmtOperations = () => {
     const [waitPanelMaxValueSecondary, setWaitPanelMaxValueSecondary] = useState(0);
     const { OpenFileDialog } = useFileDialog();
     const [selectFileSource, FileSourceDialog] = useFileSourceDialog();
-    const _downloadDcmtsAsync = async (inputDcmts, downloadMode = "download", onFileDownloaded, skipConfirmation = false) => {
+    const _downloadDcmtsAsync = async (inputDcmts, downloadMode = "download", onFileDownloaded, skipConfirmation = false, retrieveOptions, useCache = true, showSuccessAlert = true) => {
         if (inputDcmts === undefined)
             return;
         if (inputDcmts.length <= 0)
@@ -72,9 +105,13 @@ export const useDcmtOperations = () => {
         setWaitPanelTitle(operationTitle);
         abortController = new AbortController();
         const rfo = new RetrieveFileOptions();
-        rfo.retrieveReason = DcmtOpers.ShowFile;
-        rfo.invoiceRetrieveFormat = SDKUI_Globals.userSettings.searchSettings.invoiceRetrieveFormat;
-        rfo.orderRetrieveFormat = SDKUI_Globals.userSettings.searchSettings.orderRetrieveFormat;
+        rfo.retrieveReason = retrieveOptions?.retrieveReason ?? DcmtOpers.ShowFile;
+        if (retrieveOptions?.cvtFormat !== undefined)
+            rfo.cvtFormat = retrieveOptions.cvtFormat;
+        if (retrieveOptions?.generalRetrieveFormat !== undefined)
+            rfo.generalRetrieveFormat = retrieveOptions.generalRetrieveFormat;
+        rfo.invoiceRetrieveFormat = retrieveOptions?.invoiceRetrieveFormat ?? SDKUI_Globals.userSettings.searchSettings.invoiceRetrieveFormat;
+        rfo.orderRetrieveFormat = retrieveOptions?.orderRetrieveFormat ?? SDKUI_Globals.userSettings.searchSettings.orderRetrieveFormat;
         let result = [];
         setWaitPanelMaxValuePrimary(inputDcmts.length);
         let firstBlock = true;
@@ -88,7 +125,7 @@ export const useDcmtOperations = () => {
                 setWaitPanelTextPrimary(`Download file ${i + 1} di ${inputDcmts.length}`);
                 let file;
                 const cacheKey = `${inputDcmts[i].TID}-${inputDcmts[i].DID}`;
-                if (dcmtsFileCacheDownload.has(cacheKey)) {
+                if (useCache && dcmtsFileCacheDownload.has(cacheKey)) {
                     file = dcmtsFileCacheDownload.get(cacheKey);
                 }
                 else {
@@ -112,23 +149,29 @@ export const useDcmtOperations = () => {
                 const fileURL = window.URL.createObjectURL(file);
                 if (downloadMode === "openInNewWindow") {
                     (onFileDownloaded && file)
-                        ? onFileDownloaded(file)
+                        ? onFileDownloaded(file, inputDcmts[i])
                         : window.open(fileURL, '_blank', 'noopener');
                 }
                 else {
-                    const alink2 = document.createElement('a');
-                    alink2.href = fileURL;
-                    const baseFileName = inputDcmts[i].fileName ?? (inputDcmts[i].FILEEXT ? `${inputDcmts[i].DID}.${inputDcmts[i].FILEEXT}` : file?.name);
-                    alink2.download = getDownloadFileName(baseFileName);
-                    alink2.target = "_blank";
-                    alink2.rel = "noreferrer";
-                    alink2.click();
+                    if (onFileDownloaded && file) {
+                        await onFileDownloaded(file, inputDcmts[i]);
+                    }
+                    else {
+                        const alink2 = document.createElement('a');
+                        alink2.href = fileURL;
+                        alink2.download = getDownloadFileName(file, inputDcmts[i]);
+                        alink2.target = "_blank";
+                        alink2.rel = "noreferrer";
+                        alink2.click();
+                    }
                 }
-                if (dcmtsFileCacheDownload.size >= CACHE_SIZE_LIMIT) {
-                    const oldestKey = dcmtsFileCacheDownload.keys().next().value;
-                    dcmtsFileCacheDownload.delete(oldestKey);
+                if (useCache) {
+                    if (dcmtsFileCacheDownload.size >= CACHE_SIZE_LIMIT) {
+                        const oldestKey = dcmtsFileCacheDownload.keys().next().value;
+                        dcmtsFileCacheDownload.delete(oldestKey);
+                    }
+                    dcmtsFileCacheDownload.set(cacheKey, file);
                 }
-                dcmtsFileCacheDownload.set(cacheKey, file);
                 result.push({ rowIndex: i, id1: inputDcmts[i].TID, id2: inputDcmts[i].DID, resultType: ResultTypes.SUCCESS });
             }
             catch (ex) {
@@ -146,9 +189,9 @@ export const useDcmtOperations = () => {
         setWaitPanelMaxValueSecondary(0);
         setWaitPanelValueSecondary(0);
         setShowWaitPanel(false);
-        TMResultManager.show(result, operationTitle, "TID", "DID");
+        TMResultManager.show(result, operationTitle, "TID", "DID", undefined, undefined, showSuccessAlert);
     };
-    const _downloadAttachmentsAsync = async (inputDcmts, confirmAttachments) => {
+    const _downloadAttachmentsAsync = async (inputDcmts, confirmAttachments, showSuccessAlert = true) => {
         if (inputDcmts === undefined)
             return;
         if (inputDcmts.length !== 1)
@@ -196,7 +239,7 @@ export const useDcmtOperations = () => {
                     }
                 }
             }
-            TMResultManager.show(result, operationTitle, "TID", "DID");
+            TMResultManager.show(result, operationTitle, "TID", "DID", undefined, undefined, showSuccessAlert);
         }
         catch (ex) {
             TMSpinner.hide();
@@ -208,11 +251,11 @@ export const useDcmtOperations = () => {
                 TMExceptionBoxManager.show({ exception: err });
         }
     };
-    const downloadDcmtsAsync = async (inputDcmts, downloadType = DownloadTypes.Attachment, downloadMode = "download", onFileDownloaded, confirmAttachments, skipConfirmation = false) => {
+    const downloadDcmtsAsync = async (inputDcmts, downloadType = DownloadTypes.Attachment, downloadMode = "download", onFileDownloaded, confirmAttachments, skipConfirmation = false, retrieveOptions, useCache = true, showSuccessAlert = true) => {
         switch (downloadType) {
-            case DownloadTypes.Dcmt: return await _downloadDcmtsAsync(inputDcmts, downloadMode, onFileDownloaded, skipConfirmation);
-            case DownloadTypes.Attachment: return await _downloadAttachmentsAsync(inputDcmts, confirmAttachments);
-            default: return await _downloadDcmtsAsync(inputDcmts, undefined, undefined, skipConfirmation);
+            case DownloadTypes.Dcmt: return await _downloadDcmtsAsync(inputDcmts, downloadMode, onFileDownloaded, skipConfirmation, retrieveOptions, useCache, showSuccessAlert);
+            case DownloadTypes.Attachment: return await _downloadAttachmentsAsync(inputDcmts, confirmAttachments, showSuccessAlert);
+            default: return await _downloadDcmtsAsync(inputDcmts, undefined, undefined, skipConfirmation, retrieveOptions, useCache, showSuccessAlert);
         }
     };
     const uploadDcmtsAsync = async (inputDcmts, operationTitle, operType, actionAfterOperationAsync) => {

package/lib/hooks/useDocumentOperations.d.ts

@@ -6,6 +6,7 @@ import { DcmtInfo, MetadataValueDescriptorEx, SearchResultContext, TaskContext }
 import { UseCheckInOutOperationsReturn } from "./useCheckInOutOperations";
 import { UseDcmtOperationsReturn } from "./useDcmtOperations";
 import { UseRelatedDocumentsReturn } from "./useRelatedDocuments";
+import { MergePdfManagerType } from '../helper';
 export interface DocumentDataProps {
     dtd: DcmtTypeDescriptor | undefined;
     selectedItems: Array<any>;
@@ -38,6 +39,8 @@ export interface DocumentDataProps {
         s4TViewerDialogComponent?: React.ReactNode;
     };
 }
+export type TMCopyToFolderMode = 'onlySelected' | 'customized';
+export type TMCopyToFolderOperationType = 'copyToFolder' | 'mergeToPdf';
 export interface ExportDataProps {
     dataColumns?: Array<IColumnProps>;
     dataSource?: Array<any>;
@@ -97,6 +100,7 @@ interface UseDocumentOperationsProps {
     tasks: TasksProps;
     callbacks: OperationCallbacks;
     exportData?: ExportDataProps;
+    mergePdfManager?: MergePdfManagerType;
 }
 export interface UseDocumentOperationsResult {
     operationItems: Array<TMContextMenuItemProps>;
@@ -110,6 +114,7 @@ export interface UseDocumentOperationsResult {
         isOpenBatchUpdate: boolean;
         isModifiedBatchUpdate: boolean;
         updateBatchUpdateForm: (value: boolean) => void;
+        closeDcmtFormHandler: () => void;
         handleSignApprove: () => void;
         showSearchTMDatagrid: boolean;
         showExportForm: boolean;