@topconsultnpm/sdkui-react 6.21.0-dev2.9 → 6.21.0-dev3.11

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

@@ -1,6 +1,29 @@
 import React from 'react';
 import { FileItem } from '../components';
 import { AppModules, DataColumnDescriptor, DcmtTypeDescriptor, PdGs, SearchResultDescriptor } from '@topconsultnpm/sdk-ts';
+/**
+ * Estensioni di firma/marca temporale note che possono avvolgere altre estensioni.
+ * Es: file.pdf.p7m, file.xml.p7m, file.docx.p7m, file.xml.p7m.ts
+ */
+export declare const SIGNATURE_EXTENSIONS: Set<string>;
+/**
+ * Estrae l'estensione completa da un nome file, gestendo estensioni composite
+ * a più livelli come .PDF.P7M, .XML.P7M.TS, etc.
+ *
+ * Esempi:
+ * - "documento.pdf" -> ".pdf"
+ * - "DCMT_123.PDF.P7M" -> ".PDF.P7M"
+ * - "fattura.xml.p7m" -> ".xml.p7m"
+ * - "example.XML.P7M.TS" -> ".XML.P7M.TS"
+ * - "file.tar.gz" -> ".gz" (tar.gz non è gestito come firma)
+ * - "file" -> ""
+ */
+export declare const getFullFileExtension: (fileName: string, depth?: number) => string;
+/**
+ * Estrae l'estensione base da un'estensione che può includere firme digitali.
+ * Es: pdf.p7m.tsd → pdf, pdf.p7m → pdf, pdf → pdf
+ */
+export declare const getBaseExtension: (ext: string) => string;
 export declare const getFileIcon: (fileExtension: string | undefined, fileCount: number | undefined, tooltipContent?: JSX.Element | string) => import("react/jsx-runtime").JSX.Element;
 export declare function formatBytes(bytes: number | undefined, decimalPlaces?: number): string;
 export interface RowData {
@@ -53,4 +76,5 @@ type DcmtFormToolbarVisibility = {
     tmDcmtTasks: boolean;
 };
 export declare const getDcmtFormToolbarVisibility: (appModuleID: AppModules) => DcmtFormToolbarVisibility;
+export declare const isConvertibleToPdfExt: (ext: string | undefined | null) => boolean;
 export {};

package/lib/helper/TMUtils.js

@@ -4,6 +4,61 @@ import { TMTooltip } from '../components';
 import { IconCADossier, IconKey, IconMenuCAWorkingGroups } from './TMIcons';
 import { AppModules, DataListCacheService, LicenseModuleStatus, MetadataDataDomains, PdGs, SDK_Globals } from '@topconsultnpm/sdk-ts';
 import { SDKUI_Localizator } from './SDKUI_Localizator';
+/**
+ * Estensioni di firma/marca temporale note che possono avvolgere altre estensioni.
+ * Es: file.pdf.p7m, file.xml.p7m, file.docx.p7m, file.xml.p7m.ts
+ */
+export const SIGNATURE_EXTENSIONS = new Set(['p7m', 'p7s', 'm7m', 'tsd', 'tsr', 'ts']);
+/** Profondità massima di ricorsione per la ricerca di estensioni composite */
+const MAX_EXTENSION_DEPTH = 5;
+/**
+ * Estrae l'estensione completa da un nome file, gestendo estensioni composite
+ * a più livelli come .PDF.P7M, .XML.P7M.TS, etc.
+ *
+ * Esempi:
+ * - "documento.pdf" -> ".pdf"
+ * - "DCMT_123.PDF.P7M" -> ".PDF.P7M"
+ * - "fattura.xml.p7m" -> ".xml.p7m"
+ * - "example.XML.P7M.TS" -> ".XML.P7M.TS"
+ * - "file.tar.gz" -> ".gz" (tar.gz non è gestito come firma)
+ * - "file" -> ""
+ */
+export const getFullFileExtension = (fileName, depth = 0) => {
+    if (!fileName || depth > MAX_EXTENSION_DEPTH)
+        return '';
+    const lastDotIndex = fileName.lastIndexOf('.');
+    if (lastDotIndex <= 0)
+        return '';
+    const lastExtension = fileName.substring(lastDotIndex + 1).toLowerCase();
+    // Se l'ultima estensione è una firma/marca, cerca ricorsivamente le estensioni precedenti
+    if (SIGNATURE_EXTENSIONS.has(lastExtension)) {
+        const nameWithoutLastExt = fileName.substring(0, lastDotIndex);
+        const innerExtension = getFullFileExtension(nameWithoutLastExt, depth + 1);
+        if (innerExtension) {
+            // Concatena l'estensione interna con quella corrente
+            return innerExtension + fileName.substring(lastDotIndex);
+        }
+    }
+    // Estensione singola (o estensione base dopo le firme)
+    return fileName.substring(lastDotIndex);
+};
+/**
+ * Estrae l'estensione base da un'estensione che può includere firme digitali.
+ * Es: pdf.p7m.tsd → pdf, pdf.p7m → pdf, pdf → pdf
+ */
+export const getBaseExtension = (ext) => {
+    if (!ext)
+        return '';
+    const parts = ext.toLowerCase().split('.');
+    // Trova la prima parte che non è un'estensione di firma
+    for (const part of parts) {
+        if (!SIGNATURE_EXTENSIONS.has(part)) {
+            return part;
+        }
+    }
+    // Se tutte sono firme, ritorna la prima
+    return parts[0] || '';
+};
 const StyledIconFileContainer = styled.div ` 
     height: 22px;
     width: 18px;
@@ -358,3 +413,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/checkinCheckoutManager.d.ts

@@ -1,7 +1,8 @@
 import React from "react";
-import { AccessLevels, DcmtTypeDescriptor, FileDescriptor, UserDescriptor } from "@topconsultnpm/sdk-ts";
-import { DcmtInfo, DownloadModes, DownloadTypes } from "../ts/types";
+import { AccessLevels, DcmtTypeDescriptor, UserDescriptor } from "@topconsultnpm/sdk-ts";
+import { DcmtInfo } from "../ts/types";
 import { FileItem } from "../components";
+import { DownloadDcmtsAsyncParams } from "../hooks/useDcmtOperations";
 /**
  * Check-in/Check-out Manager
  * Questo modulo gestisce tutte le operazioni di check-in e check-out
@@ -42,7 +43,7 @@ export type DownloadSource = {
     originalFileName: string;
 };
 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 cicoDownloadFilesCallback: (sources: Array<DownloadSource>, checkout: boolean, downloadDcmtsAsync: (params: DownloadDcmtsAsyncParams) => Promise<void>) => Promise<void>;
 export declare const updateCicoCheckoutStorageItem: (item: CheckoutInfo, type: "fileItem" | "dcmtInfo", action?: "addOrUpdate" | "remove") => void;
 export declare const validateCicoFileName: (source: DownloadSource, fileName: string, checkoutDate?: string | null) => FileNameValidation;
 type ValidationResult = {

package/lib/helper/checkinCheckoutManager.js

@@ -2,6 +2,7 @@ import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-run
 import { AccessLevels, CICO_MetadataNames, SDK_Globals, SystemMIDsAsNumber } from "@topconsultnpm/sdk-ts";
 import TMTooltip from "../components/base/TMTooltip";
 import { dcmtsFileCachePreview, Globalization, removeDcmtsFileCache, SDKUI_Globals, SDKUI_Localizator } from "./index";
+import { getBaseExtension, getFullFileExtension } from "./TMUtils";
 import { DownloadTypes } from "../ts/types";
 const findCheckOutUserName = (users, checkoutUserId) => {
     let checkOutUser = users.find(user => user.id === checkoutUserId);
@@ -74,7 +75,7 @@ export const cicoDownloadFilesCallback = async (sources, checkout, downloadDcmts
         }
     });
     if (files.length > 0) {
-        await downloadDcmtsAsync(files, DownloadTypes.Dcmt, "download");
+        await downloadDcmtsAsync({ inputDcmts: files, downloadType: DownloadTypes.Dcmt, downloadMode: "download", skipConfirmation: true, useInputFileName: true });
     }
 };
 export const updateCicoCheckoutStorageItem = (item, type, action = "addOrUpdate") => {
@@ -128,13 +129,22 @@ export const validateCicoFileName = (source, fileName, checkoutDate) => {
         did = DID;
         ext = FILEEXT;
     }
-    // Ensure originalName has the extension
-    const normalizedExt = ext?.toLowerCase() ?? '';
-    const name = baseName.toLowerCase().endsWith(`.${normalizedExt}`) ? baseName : `${baseName}.${normalizedExt}`;
+    // Ensure originalName has the extension (use base extension for comparison)
+    const sourceBaseExt = getBaseExtension(ext ?? '');
+    const name = baseName.toLowerCase().endsWith(`.${sourceBaseExt}`) ? baseName : `${baseName}.${sourceBaseExt}`;
     let fileNameToValidate = fileName;
-    const fileExtensionCheck = fileNameToValidate.split('.').pop() ?? '';
-    // Remove extension part
-    fileNameToValidate = fileNameToValidate.slice(0, -fileExtensionCheck.length - 1);
+    // Estrai l'estensione completa (incluse eventuali firme digitali ricorsive es. pdf.p7m.tsd)
+    const fullExtension = getFullFileExtension(fileNameToValidate);
+    let fileExtensionCheck;
+    if (fullExtension) {
+        // Rimuovi l'estensione completa dal nome
+        fileNameToValidate = fileNameToValidate.slice(0, -fullExtension.length);
+        // L'estensione base è la prima parte (es. da ".pdf.p7m.tsd" prendi "pdf")
+        fileExtensionCheck = fullExtension.substring(1).split('.')[0];
+    }
+    else {
+        fileExtensionCheck = '';
+    }
     // Check and remove 'checkout~' prefix if present
     const hasCheckoutPrefix = fileNameToValidate.startsWith('checkout~');
     if (hasCheckoutPrefix) {
@@ -159,7 +169,7 @@ export const validateCicoFileName = (source, fileName, checkoutDate) => {
     const isValidDid = didCheck ? did.toString() === parseInt(didCheck, 10).toString() : false;
     const isValidTid = tidCheck ? tid.toString() === parseInt(tidCheck, 10).toString() : false;
     const isValidArchive = archiveCheck ? archiveCheck === archiveID : false;
-    const isValidExt = ext ? ext.toLowerCase() === fileExtensionCheck.toLowerCase() : false;
+    const isValidExt = sourceBaseExt ? sourceBaseExt === fileExtensionCheck.toLowerCase() : false;
     // First phase validation result
     const isFirstPhaseValid = !!(isValidName && isValidArchive && isValidDid && isValidTid && isValidExt);
     // Second phase: validate checkoutDate timestamp (only if first phase passed and checkoutDate is a valid string)
@@ -177,11 +187,11 @@ export const validateCicoFileName = (source, fileName, checkoutDate) => {
             else {
                 const pad = (n) => n.toString().padStart(2, '0');
                 const expectedTimestamp = `${dt.getFullYear()}${pad(dt.getMonth() + 1)}${pad(dt.getDate())}${pad(dt.getHours())}${pad(dt.getMinutes())}${pad(dt.getSeconds())}`;
-                isSecondPhaseValid = timestampCheck === expectedTimestamp;
                 // Format dates for display: readable date + (raw timestamp)
                 const expectedDisplayDate = Globalization.getDateTimeDisplayValue(dt);
                 // Parse timestampCheck to readable format (YYYYMMDDHHmmss -> Date)
                 let currentDisplayDate = timestampCheck;
+                let parsedDate = null;
                 if (timestampCheck && timestampCheck.length === 14) {
                     const year = parseInt(timestampCheck.substring(0, 4), 10);
                     const month = parseInt(timestampCheck.substring(4, 6), 10) - 1;
@@ -189,9 +199,17 @@ export const validateCicoFileName = (source, fileName, checkoutDate) => {
                     const hours = parseInt(timestampCheck.substring(8, 10), 10);
                     const minutes = parseInt(timestampCheck.substring(10, 12), 10);
                     const seconds = parseInt(timestampCheck.substring(12, 14), 10);
-                    const parsedDate = new Date(year, month, day, hours, minutes, seconds);
+                    parsedDate = new Date(year, month, day, hours, minutes, seconds);
                     currentDisplayDate = Globalization.getDateTimeDisplayValue(parsedDate);
                 }
+                // Validate with ±10 seconds tolerance
+                if (parsedDate && !isNaN(parsedDate.getTime())) {
+                    const diffInSeconds = Math.abs((dt.getTime() - parsedDate.getTime()) / 1000);
+                    isSecondPhaseValid = diffInSeconds <= 10;
+                }
+                else {
+                    isSecondPhaseValid = timestampCheck === expectedTimestamp;
+                }
                 checkoutDateValidation = {
                     expected: `${expectedDisplayDate} (${expectedTimestamp})`,
                     current: `${currentDisplayDate} (${timestampCheck})`,
@@ -229,7 +247,7 @@ export const validateCicoFileName = (source, fileName, checkoutDate) => {
                 isValid: isValidTid
             },
             fileExtension: {
-                expected: ext?.toLowerCase(),
+                expected: sourceBaseExt,
                 current: fileExtensionCheck.toLowerCase(),
                 isValid: isValidExt
             },

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/useCheckInOutOperations.d.ts

@@ -1,5 +1,6 @@
-import { DcmtInfo, DownloadModes, DownloadTypes } from '../ts';
-import { FileDescriptor, SearchResultDescriptor } from '@topconsultnpm/sdk-ts';
+import { DcmtInfo } from '../ts';
+import { SearchResultDescriptor } from '@topconsultnpm/sdk-ts';
+import { DownloadDcmtsAsyncParams } from './useDcmtOperations';
 export interface UseCheckInOutOperationsProps {
     onRefreshPreview: () => Promise<void>;
 }
@@ -17,7 +18,7 @@ export interface UseCheckInOutOperationsReturn {
     };
     hideCommentFormCallback: () => void;
     copyCheckoutPathToClipboardCallback: (dcmt: DcmtInfo, filename: string) => void;
-    handleCheckOutCallback: (dcmt: DcmtInfo, checkout: boolean, filename: string, downloadDcmtsAsync: (inputDcmts: Array<DcmtInfo> | undefined, downloadType?: DownloadTypes, downloadMode?: DownloadModes, onFileDownloaded?: (dcmtFile: File) => void, confirmAttachments?: (list: FileDescriptor[]) => Promise<string[] | undefined>, skipConfirmation?: boolean) => Promise<void>, onRefreshAsync?: (tid: number | undefined, did: number | undefined, refreshUI?: boolean, metadataResult?: SearchResultDescriptor | null) => Promise<void>) => Promise<void>;
+    handleCheckOutCallback: (dcmt: DcmtInfo, checkout: boolean, filename: string, downloadDcmtsAsync: (params: DownloadDcmtsAsyncParams) => Promise<void>, onRefreshAsync?: (tid: number | undefined, did: number | undefined, refreshUI?: boolean, metadataResult?: SearchResultDescriptor | null) => Promise<void>) => Promise<void>;
     handleCheckInCallback: (dcmt: DcmtInfo, checkoutDate?: string | null, onRefreshAsync?: (tid: number | undefined, did: number | undefined, refreshUI?: boolean, metadataResult?: SearchResultDescriptor | null) => Promise<void>) => Promise<void>;
     showCicoWaitPanel: boolean;
     cicoWaitPanelTitle: string;

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 || userId === null)
                 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,29 @@
-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 DownloadDcmtsAsyncParams {
+    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;
+    /**
+     * Controlla la priorità del nome file per il download:
+     * - true: usa il fileName da inputDcmts (dcmtInfo.fileName) come priorità
+     * - false (default): usa il nome file recuperato dal backend (file.name) come priorità
+     */
+    useInputFileName?: boolean;
+}
 export interface UseDcmtOperationsReturn {
     abortController: AbortController;
     showWaitPanel: boolean;
@@ -12,7 +36,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: (params: DownloadDcmtsAsyncParams) => Promise<void>;
     getDcmtFileAsync: (inputDcmt: DcmtInfo | undefined, rfo: RetrieveFileOptions, operationTitle: string, keepWaitPanelPrimary: boolean, bypassCache?: boolean) => Promise<{
         file: File | undefined;
         isFromCache: boolean;