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

package/lib/helper/MergePdfManager.d.ts

@@ -0,0 +1,45 @@
+/** Risultato del merge PDF */
+export interface MergePdfResult {
+    bytes: Uint8Array;
+    blob: Blob;
+    pageCount: number;
+}
+/** Risultato con Base64 incluso */
+export interface MergePdfResultWithBase64 extends MergePdfResult {
+    base64: string;
+}
+/** Opzioni per il merge */
+export interface MergePdfOptions {
+    fileName?: string;
+    onProgress?: (current: number, total: number, file: File) => void;
+}
+export declare class MergePdfManager {
+    /**
+     * Merge principale - Unisce array di File PDF in uno solo
+     */
+    static merge(files: File[], options?: MergePdfOptions): Promise<MergePdfResult>;
+    /**
+     * Merge -> File - Restituisce un oggetto File
+     */
+    static mergeToFile(files: File[], fileName?: string, options?: MergePdfOptions): Promise<File>;
+    /**
+     * Merge + Download - Unisce e scarica automaticamente
+     */
+    static mergeAndDownload(files: File[], fileName?: string, options?: MergePdfOptions): Promise<MergePdfResult>;
+    /**
+     * Blob -> Base64 - Converte un Blob in stringa Base64
+     */
+    static blobToBase64(blob: Blob): Promise<string>;
+    /**
+     * Merge -> Base64 - Unisce e restituisce anche la stringa Base64
+     */
+    static mergeToBase64(files: File[], options?: MergePdfOptions): Promise<MergePdfResultWithBase64>;
+    /**
+     * Merge per Preview - Restituisce solo base64 e pageCount per anteprima
+     */
+    static mergeForPreview(files: File[], options?: MergePdfOptions): Promise<{
+        base64: string;
+        pageCount: number;
+    }>;
+}
+export default MergePdfManager;

package/lib/helper/MergePdfManager.js

@@ -0,0 +1,148 @@
+import { SDKUI_Localizator } from './SDKUI_Localizator';
+// ============================================================================
+// LAZY LOADING - Carica pdf-lib solo quando necessario
+// ============================================================================
+let pdfLibLoaded = false;
+const loadPdfLib = async () => {
+    const module = await import('pdf-lib');
+    pdfLibLoaded = true;
+    return module;
+};
+// ============================================================================
+// MERGE PDF MANAGER - Utility per unire PDF lato client
+// ============================================================================
+export class MergePdfManager {
+    /**
+     * Merge principale - Unisce array di File PDF in uno solo
+     */
+    static async merge(files, options = {}) {
+        if (!files?.length) {
+            throw new Error('MergePdfManager.merge: nessun file fornito.');
+        }
+        try {
+            // Carica pdf-lib on-demand
+            const { PDFDocument } = await loadPdfLib();
+            const mergedPdf = await PDFDocument.create();
+            let totalPages = 0;
+            // Itera su ogni file e copia le pagine nel documento finale
+            for (let i = 0; i < files.length; i++) {
+                const file = files[i];
+                try {
+                    const buffer = await file.arrayBuffer();
+                    const pdf = await PDFDocument.load(buffer);
+                    // Copia tutte le pagine dal PDF sorgente
+                    const pages = await mergedPdf.copyPages(pdf, pdf.getPageIndices());
+                    pages.forEach(page => mergedPdf.addPage(page));
+                    totalPages += pages.length;
+                    // Notifica progresso
+                    options.onProgress?.(i + 1, files.length, file);
+                }
+                catch (fileError) {
+                    const errorMessage = fileError instanceof Error ? fileError.message : String(fileError);
+                    throw new Error(`Errore processamento file "${file.name}" (${i}): ${errorMessage}`);
+                }
+            }
+            if (totalPages === 0) {
+                throw new Error('Nessuna pagina valida trovata.');
+            }
+            // Salva il PDF unito
+            const outBytes = await mergedPdf.save();
+            // Converte Uint8Array in ArrayBuffer per il Blob
+            const pdfBuffer = outBytes.buffer.slice(outBytes.byteOffset, outBytes.byteOffset + outBytes.byteLength);
+            const blob = new Blob([pdfBuffer], { type: 'application/pdf' });
+            return { bytes: outBytes, blob, pageCount: totalPages };
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            throw new Error(`MergePdfManager.merge: ${errorMessage}`);
+        }
+    }
+    /**
+     * Merge -> File - Restituisce un oggetto File
+     */
+    static async mergeToFile(files, fileName, options = {}) {
+        try {
+            const { blob } = await this.merge(files, options);
+            const finalFileName = fileName || `${SDKUI_Localizator.Result.toLowerCase()}.pdf`;
+            return new File([blob], finalFileName, { type: 'application/pdf' });
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            throw new Error(`MergePdfManager.mergeToFile: ${errorMessage}`);
+        }
+    }
+    /**
+     * Merge + Download - Unisce e scarica automaticamente
+     */
+    static async mergeAndDownload(files, fileName, options = {}) {
+        let url = null;
+        const finalFileName = fileName || `${SDKUI_Localizator.Result.toLowerCase()}.pdf`;
+        try {
+            const result = await this.merge(files, options);
+            url = URL.createObjectURL(result.blob);
+            // Crea link temporaneo per download
+            const a = document.createElement('a');
+            a.href = url;
+            a.download = finalFileName;
+            document.body.appendChild(a);
+            a.click();
+            a.remove();
+            return result;
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            throw new Error(`MergePdfManager.mergeAndDownload: ${errorMessage}`);
+        }
+        finally {
+            // Rilascia URL dopo un breve delay
+            if (url)
+                setTimeout(() => URL.revokeObjectURL(url), 1000);
+        }
+    }
+    /**
+     * Blob -> Base64 - Converte un Blob in stringa Base64
+     */
+    static blobToBase64(blob) {
+        return new Promise((resolve, reject) => {
+            const reader = new FileReader();
+            reader.onloadend = () => {
+                if (typeof reader.result === 'string') {
+                    resolve(reader.result);
+                }
+                else {
+                    reject(new Error('Impossibile convertire il blob in base64.'));
+                }
+            };
+            reader.onerror = () => reject(new Error('Errore durante la lettura del blob.'));
+            reader.readAsDataURL(blob);
+        });
+    }
+    /**
+     * Merge -> Base64 - Unisce e restituisce anche la stringa Base64
+     */
+    static async mergeToBase64(files, options = {}) {
+        try {
+            const result = await this.merge(files, options);
+            const base64 = await this.blobToBase64(result.blob);
+            return { ...result, base64 };
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            throw new Error(`MergePdfManager.mergeToBase64: ${errorMessage}`);
+        }
+    }
+    /**
+     * Merge per Preview - Restituisce solo base64 e pageCount per anteprima
+     */
+    static async mergeForPreview(files, options = {}) {
+        try {
+            const result = await this.mergeToBase64(files, options);
+            return { base64: result.base64, pageCount: result.pageCount };
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            throw new Error(`MergePdfManager.mergeForPreview: ${errorMessage}`);
+        }
+    }
+}
+export default MergePdfManager;

package/lib/helper/SDKUI_Globals.d.ts

@@ -1,5 +1,19 @@
 import { InvoiceRetrieveFormats, ObjectClasses, OrderRetrieveFormats } from "@topconsultnpm/sdk-ts";
 import { CheckoutInfo } from "./checkinCheckoutManager";
+export type FileNamingMode = 'onlyDid' | 'documentTypeAndDid' | 'documentTypeAndCustomMetadata' | 'onlyCustomMetadata';
+export type FileExistsMode = 'overwrite' | 'skip' | 'rename';
+export declare class DocumentDownloadSettings {
+    exportMode: 'copy' | 'zip';
+    destinationFolder: string;
+    zipFileName: string;
+    zipPassword: string;
+    fileNamingMode: FileNamingMode;
+    separatorChar: string;
+    invoiceFormat: InvoiceRetrieveFormats;
+    orderFormat: OrderRetrieveFormats;
+    fileExistsMode: FileExistsMode;
+    removeSignature: boolean;
+}
 export declare const dcmtsFileCacheDownload: Map<string, File>;
 export declare const dcmtsFileCachePreview: Map<string, File>;
 export declare const CACHE_SIZE_LIMIT = 10;
@@ -22,6 +36,7 @@ export declare class UserSettings {
     wgDraftCheckoutInfo: CheckoutInfo[];
     dcmtCheckoutInfo: CheckoutInfo[];
     defaultCheckInOutFolder: string;
+    documentDownloadSettings: DocumentDownloadSettings;
     constructor(skipCssUpdate?: boolean);
     /** Load settings from local storage or other sources */
     static LoadSettings(userID: number | undefined, archiveID: string | undefined): UserSettings;

package/lib/helper/SDKUI_Globals.js

@@ -1,6 +1,20 @@
 import { InvoiceRetrieveFormats, LocalStorageService, OrderRetrieveFormats } from "@topconsultnpm/sdk-ts";
 import { FontSize } from "../utils/theme";
-// import { LandingPages } from "./helpers";
+import { SDKUI_Localizator } from "./SDKUI_Localizator";
+export class DocumentDownloadSettings {
+    constructor() {
+        this.exportMode = 'copy';
+        this.destinationFolder = 'Download';
+        this.zipFileName = SDKUI_Localizator.Result.toLowerCase() + '.zip';
+        this.zipPassword = '';
+        this.fileNamingMode = 'documentTypeAndDid';
+        this.separatorChar = '_';
+        this.invoiceFormat = InvoiceRetrieveFormats.ASW_HTML;
+        this.orderFormat = OrderRetrieveFormats.NSO_HTML;
+        this.fileExistsMode = 'overwrite';
+        this.removeSignature = false;
+    }
+}
 export const dcmtsFileCacheDownload = new Map();
 export const dcmtsFileCachePreview = new Map();
 export const CACHE_SIZE_LIMIT = 10;
@@ -24,6 +38,7 @@ export class UserSettings {
         this.wgDraftCheckoutInfo = [];
         this.dcmtCheckoutInfo = [];
         this.defaultCheckInOutFolder = DEFAULT_CHECK_IN_OUT_FOLDER;
+        this.documentDownloadSettings = new DocumentDownloadSettings();
         this.themeSettings = new ThemeSettings(skipCssUpdate);
     }
     /** Load settings from local storage or other sources */