ptechcore_ui 1.0.25 → 1.0.27

package/dist/index.d.cts

@@ -249,6 +249,7 @@ interface Vendor {
 interface SessionContextType {
     isAuthenticated: boolean;
     token: string | null;
+    setToken: (token: string | null) => void;
     activeBusinessEntity: Entity | null;
     setActiveBusinessEntity: (entity: Entity | null) => void;
     loggedUser: User | null;
@@ -852,17 +853,437 @@ interface FileManagerContextValue {
     allowMultiSelect: boolean;
     texts: Required<FileManagerTexts>;
 }
+/**
+ * Types d'entités supportées par la GED.
+ *
+ * Chaque type correspond à un modèle Django backend :
+ * - CLIENT → accounting.models.Client
+ * - VENDOR → accounting.models.Vendor
+ * - RFQ → procurement.models.RFQ
+ * - DEPT → core.models.Departments
+ * - PROJECT → core.models.Project
+ *
+ * POUR AJOUTER UN NOUVEAU TYPE :
+ * 1. Ajouter le type ici
+ * 2. Mettre à jour ENTITY_MODEL_MAP dans fileManagerApi.ts
+ * 3. Mettre à jour getRootName dans EntityFileManager.tsx
+ */
+type EntityType = 'CLIENT' | 'VENDOR' | 'RFQ' | 'DEPT' | 'PROJECT';
+/**
+ * Structure d'un dossier retourné par l'API backend.
+ * Correspond au FolderTreeSerializer Django.
+ */
+interface BackendFolder {
+    id: number;
+    code: string;
+    name: string;
+    folder_type: string;
+    folder_type_display: string;
+    category_type?: string;
+    is_system_folder: boolean;
+    file_count: number;
+    total_size?: number;
+    children?: BackendFolder[];
+    files?: BackendFile[];
+}
+/**
+ * Structure d'un fichier retourné par l'API backend.
+ * Correspond au FileListSerializer Django.
+ */
+interface BackendFile {
+    id: number;
+    code: string;
+    name: string;
+    file_url: string;
+    size: number;
+    mime_type: string;
+    extension: string;
+    folder: number;
+    folder_name?: string;
+    created_at: string;
+    updated_at?: string;
+    created_by?: string;
+}
+/**
+ * Props pour le composant EntityFileManager.
+ *
+ * Ce composant est un wrapper qui intègre FileManager avec l'API backend GED.
+ * Il charge automatiquement les dossiers de l'entité et gère les opérations CRUD.
+ *
+ * EXEMPLE D'UTILISATION :
+ * ```tsx
+ * <EntityFileManager
+ *   entityType="VENDOR"
+ *   entityId={vendor.id}
+ *   businessEntityId={businessEntity.id}
+ *   onFileSelect={(files) => console.log('Sélection:', files)}
+ * />
+ * ```
+ */
+interface EntityFileManagerProps {
+    /** Type d'entité (CLIENT, VENDOR, RFQ, DEPT, PROJECT) */
+    entityType: EntityType;
+    /** ID de l'entité */
+    entityId: number | string;
+    /** ID du BusinessEntity (pour le contexte) */
+    businessEntityId: number | string;
+    /** Classes CSS additionnelles */
+    className?: string;
+    /** Hauteur du composant (défaut: '600px') */
+    height?: string;
+    /** Autoriser l'upload de fichiers (défaut: true) */
+    allowUpload?: boolean;
+    /** Autoriser la création de dossiers (défaut: true) */
+    allowCreateFolder?: boolean;
+    /** Autoriser le renommage (défaut: true) */
+    allowRename?: boolean;
+    /** Autoriser la suppression (défaut: true) */
+    allowDelete?: boolean;
+    /** Autoriser le téléchargement (défaut: true) */
+    allowDownload?: boolean;
+    /** Appelé quand l'utilisateur sélectionne des fichiers */
+    onFileSelect?: (files: FileItem[]) => void;
+    /** Appelé quand l'utilisateur ouvre un fichier */
+    onFileOpen?: (file: FileItem) => void;
+    /** Appelé après un upload réussi */
+    onUploadSuccess?: (files: FileItem[]) => void;
+    /** Appelé en cas d'erreur */
+    onError?: (error: Error) => void;
+}
+/**
+ * Valeur retournée par le hook useFileManagerApi.
+ */
+interface UseFileManagerApiReturn {
+    /** Données transformées pour FileManager */
+    data: FileItem[];
+    /** État de chargement */
+    loading: boolean;
+    /** Erreur éventuelle */
+    error: Error | null;
+    /** Code du dossier racine de l'entité */
+    rootFolderCode: string | null;
+    /** Rafraîchir les données */
+    refresh: () => Promise<void>;
+    /** Handlers pour FileManager */
+    handlers: {
+        onCreateFolder: (name: string, parentId: string) => Promise<FileItem | void>;
+        onUploadFiles: (files: File[], parentId: string) => Promise<FileItem[] | void>;
+        onRename: (item: FileItem, newName: string) => Promise<void>;
+        onDelete: (item: FileItem) => Promise<void>;
+        onDownload: (item: FileItem) => void;
+    };
+}
 
 declare const FileManager: React$1.FC<FileManagerProps>;
 
+/**
+ * EntityFileManager - FileManager scopé à une entité métier.
+ *
+ * Ce composant encapsule le FileManager générique et l'intègre avec l'API
+ * backend GED pour afficher les documents d'une entité spécifique
+ * (Client, Vendor, RFQ, Département, Projet).
+ *
+ * FONCTIONNALITÉS :
+ * =================
+ * - Charge automatiquement les dossiers de l'entité au montage
+ * - Navigation limitée au dossier racine de l'entité (scopé)
+ * - Gestion des états loading/error/empty
+ * - Opérations CRUD complètes (upload, création, renommage, suppression)
+ * - Permissions configurables
+ *
+ * ARCHITECTURE :
+ * ==============
+ * EntityFileManager
+ *   └── useFileManagerApi (hook)
+ *         └── fileManagerApi (service)
+ *               └── API Backend Django
+ *
+ * EXEMPLE D'UTILISATION :
+ * =======================
+ * ```tsx
+ * // Dans la vue d'un Vendor
+ * <EntityFileManager
+ *   entityType="VENDOR"
+ *   entityId={vendor.id}
+ *   businessEntityId={businessEntity.id}
+ * />
+ *
+ * // Avec permissions limitées (lecture seule)
+ * <EntityFileManager
+ *   entityType="CLIENT"
+ *   entityId={client.id}
+ *   businessEntityId={businessEntity.id}
+ *   allowUpload={false}
+ *   allowCreateFolder={false}
+ *   allowRename={false}
+ *   allowDelete={false}
+ * />
+ *
+ * // Avec callbacks personnalisés
+ * <EntityFileManager
+ *   entityType="RFQ"
+ *   entityId={rfq.id}
+ *   businessEntityId={businessEntity.id}
+ *   onFileSelect={(files) => console.log('Sélection:', files)}
+ *   onFileOpen={(file) => openPreview(file)}
+ * />
+ * ```
+ */
+
+/**
+ * FileManager scopé à une entité métier.
+ *
+ * Ce composant charge automatiquement les dossiers de l'entité et fournit
+ * une interface complète pour la gestion des documents.
+ */
+declare const EntityFileManager: React$1.FC<EntityFileManagerProps>;
+
 declare const useFileManager: () => FileManagerContextValue;
 interface FileManagerProviderProps extends FileManagerProps {
     children: React$1.ReactNode;
 }
 declare const FileManagerProvider: React$1.FC<FileManagerProviderProps>;
 
+/**
+ * Hook pour intégrer le FileManager avec l'API backend GED.
+ *
+ * Ce hook gère :
+ * - Le chargement des données depuis l'API
+ * - La transformation des données backend → frontend
+ * - Les opérations CRUD (création, renommage, suppression, upload)
+ * - Le rafraîchissement des données après mutation
+ *
+ * ARCHITECTURE :
+ * ==============
+ * 1. Chargement initial :
+ *    - Récupère les dossiers de l'entité via /folders/for_entity/
+ *    - Trouve le dossier ENTITY (racine de l'entité)
+ *    - Charge l'arborescence complète via /folders/{code}/tree/
+ *
+ * 2. Transformation :
+ *    - Convertit BackendFolder/BackendFile → FileItem
+ *    - Construit les chemins (path) récursivement
+ *    - Aplatit la structure pour le FileManager
+ *
+ * 3. Mutations :
+ *    - Chaque mutation rafraîchit les données après succès
+ *    - Les erreurs sont capturées et exposées via l'état error
+ *
+ * EXEMPLE D'UTILISATION :
+ * =======================
+ * ```tsx
+ * const { data, loading, error, handlers } = useFileManagerApi(
+ *   'VENDOR',
+ *   vendor.id,
+ *   businessEntity.id
+ * );
+ *
+ * if (loading) return <Spinner />;
+ * if (error) return <Error message={error.message} />;
+ *
+ * return (
+ *   <FileManager
+ *     data={data}
+ *     onCreateFolder={handlers.onCreateFolder}
+ *     onUploadFiles={handlers.onUploadFiles}
+ *     ...
+ *   />
+ * );
+ * ```
+ */
+
+/**
+ * Hook pour gérer l'intégration FileManager avec l'API GED.
+ *
+ * @param entityType - Type d'entité (CLIENT, VENDOR, RFQ, DEPT, PROJECT)
+ * @param entityId - ID de l'entité
+ * @param businessEntityId - ID du BusinessEntity
+ * @returns État et handlers pour le FileManager
+ */
+declare function useFileManagerApi(entityType: EntityType, entityId: string | number, businessEntityId: string | number): UseFileManagerApiReturn;
+
+/**
+ * Service API pour la GED (Gestion Électronique de Documents).
+ *
+ * Ce service gère toutes les communications avec le backend Django files_manager.
+ *
+ * ENDPOINTS UTILISÉS :
+ * ====================
+ * - GET  /api/files_manager/folders/for_entity/?model=...&id=...  → Dossiers d'une entité
+ * - GET  /api/files_manager/folders/{code}/tree/                  → Arborescence d'un dossier
+ * - GET  /api/files_manager/folders/{code}/                       → Détails d'un dossier
+ * - POST /api/files_manager/folders/                              → Créer un dossier
+ * - PUT  /api/files_manager/folders/{code}/                       → Modifier un dossier
+ * - DELETE /api/files_manager/folders/{code}/                     → Supprimer un dossier
+ * - GET  /api/files_manager/files/                                → Liste des fichiers
+ * - POST /api/files_manager/files/                                → Upload un fichier
+ * - PUT  /api/files_manager/files/{code}/                         → Modifier un fichier
+ * - DELETE /api/files_manager/files/{code}/                       → Supprimer un fichier
+ *
+ * POUR AJOUTER UN NOUVEAU TYPE D'ENTITÉ :
+ * =======================================
+ * 1. Ajouter le type dans EntityType (types.ts)
+ * 2. Ajouter le mapping dans ENTITY_MODEL_MAP ci-dessous
+ */
+
+/**
+ * Récupère les dossiers d'une entité.
+ *
+ * Utilise l'endpoint /folders/for_entity/ pour récupérer tous les dossiers
+ * associés à une entité spécifique (Client, Vendor, RFQ, etc.).
+ *
+ * @param entityType - Type d'entité (CLIENT, VENDOR, etc.)
+ * @param entityId - ID de l'entité
+ * @param folderType - Optionnel: filtrer par type de dossier
+ * @returns Liste des dossiers
+ *
+ * @example
+ * const folders = await fileManagerApi.getEntityFolders('VENDOR', 123);
+ */
+declare function getEntityFolders(entityType: EntityType, entityId: string | number, folderType?: string): Promise<BackendFolder[]>;
+/**
+ * Récupère l'arborescence complète d'un dossier.
+ *
+ * Retourne le dossier avec tous ses sous-dossiers et fichiers
+ * de manière récursive.
+ *
+ * @param folderCode - Code du dossier (ex: 'FO000001')
+ * @returns Structure hiérarchique du dossier
+ *
+ * @example
+ * const tree = await fileManagerApi.getFolderTree('FO000001');
+ */
+declare function getFolderTree(folderCode: string): Promise<BackendFolder>;
+/**
+ * Récupère les détails d'un dossier.
+ *
+ * @param folderCode - Code du dossier
+ * @returns Détails du dossier
+ */
+declare function getFolder(folderCode: string): Promise<BackendFolder>;
+/**
+ * Crée un nouveau dossier.
+ *
+ * @param name - Nom du dossier
+ * @param parentCode - Code du dossier parent
+ * @param businessEntityId - ID du BusinessEntity
+ * @returns Dossier créé
+ *
+ * @example
+ * const folder = await fileManagerApi.createFolder('Mon dossier', 'FO000001', 1);
+ */
+declare function createFolder(name: string, parentCode: string, businessEntityId: string | number): Promise<BackendFolder>;
+/**
+ * Renomme un dossier.
+ *
+ * @param folderCode - Code du dossier
+ * @param newName - Nouveau nom
+ * @returns Dossier mis à jour
+ */
+declare function renameFolder(folderCode: string, newName: string): Promise<BackendFolder>;
+/**
+ * Supprime un dossier.
+ *
+ * Note: Un dossier système (is_system_folder=true) ne peut pas être supprimé.
+ *
+ * @param folderCode - Code du dossier à supprimer
+ */
+declare function deleteFolder(folderCode: string): Promise<void>;
+/**
+ * Récupère les fichiers d'un dossier.
+ *
+ * @param folderId - ID du dossier
+ * @returns Liste des fichiers
+ */
+declare function getFolderFiles(folderId: number | string): Promise<BackendFile[]>;
+/**
+ * Upload un fichier dans un dossier.
+ *
+ * @param file - Fichier à uploader
+ * @param folderCode - Code du dossier de destination
+ * @param options - Options additionnelles (nom, description, tags)
+ * @returns Fichier créé
+ *
+ * @example
+ * const uploadedFile = await fileManagerApi.uploadFile(
+ *   file,
+ *   'FO000001',
+ *   { name: 'Mon document.pdf', description: 'Contrat 2024' }
+ * );
+ */
+declare function uploadFile(file: File, folderCode: string, options?: {
+    name?: string;
+    description?: string;
+    tags?: string[];
+}): Promise<BackendFile>;
+/**
+ * Upload plusieurs fichiers dans un dossier.
+ *
+ * @param files - Fichiers à uploader
+ * @param folderCode - Code du dossier de destination
+ * @returns Liste des fichiers créés
+ */
+declare function uploadFiles(files: File[], folderCode: string): Promise<BackendFile[]>;
+/**
+ * Renomme un fichier.
+ *
+ * @param fileCode - Code du fichier
+ * @param newName - Nouveau nom
+ * @returns Fichier mis à jour
+ */
+declare function renameFile(fileCode: string, newName: string): Promise<BackendFile>;
+/**
+ * Supprime un fichier.
+ *
+ * @param fileCode - Code du fichier à supprimer
+ */
+declare function deleteFile(fileCode: string): Promise<void>;
+/**
+ * Construit l'URL de téléchargement d'un fichier.
+ *
+ * @param fileCode - Code du fichier
+ * @returns URL de téléchargement
+ */
+declare function getDownloadUrl(fileCode: string): string;
+/**
+ * Construit l'URL directe d'un fichier.
+ *
+ * @param fileUrl - URL relative du fichier depuis l'API
+ * @returns URL complète
+ */
+declare function getFileUrl(fileUrl: string): string;
+/**
+ * Service API pour la GED.
+ *
+ * @example
+ * // Récupérer les dossiers d'un vendor
+ * const folders = await fileManagerApi.getEntityFolders('VENDOR', vendorId);
+ *
+ * // Récupérer l'arborescence
+ * const tree = await fileManagerApi.getFolderTree(folders[0].code);
+ *
+ * // Uploader un fichier
+ * const file = await fileManagerApi.uploadFile(myFile, 'FO000001');
+ */
+declare const fileManagerApi: {
+    getEntityFolders: typeof getEntityFolders;
+    getFolderTree: typeof getFolderTree;
+    getFolder: typeof getFolder;
+    createFolder: typeof createFolder;
+    renameFolder: typeof renameFolder;
+    deleteFolder: typeof deleteFolder;
+    getFolderFiles: typeof getFolderFiles;
+    uploadFile: typeof uploadFile;
+    uploadFiles: typeof uploadFiles;
+    renameFile: typeof renameFile;
+    deleteFile: typeof deleteFile;
+    getDownloadUrl: typeof getDownloadUrl;
+    getFileUrl: typeof getFileUrl;
+    ENTITY_MODEL_MAP: Record<EntityType, string>;
+};
+
 declare const getFileIcon: (mimeType?: string, isFolder?: boolean, isOpen?: boolean) => LucideIcon;
 declare const formatFileSize: (bytes?: number) => string;
 declare const formatDate: (date?: Date | string) => string;
 
-export { Alert, AlertProvider, ApprovalAnswerModal, ApprovalAnswerPage, ApprovalPreviewAnswer, ApprovalServices, ApprovalWorkflow, AuthServices, CHOICES, type ConfirmOptions, CountrySelector, DateInput, FDrawer, FetchApi, FileInput, type FileItem, FileManager, type FileManagerProps, FileManagerProvider, type FileManagerTexts, ForeignCurrencySelector, InputField, InvoiceTypeSelector, LegalFormSelector, type MenuItem, Modal, NumberInput, Pages, PaymentMethodSelector, PrimaryButton, RewiseLayout, SecondaryButton, SelectCostCenter, SelectDepartment, SelectInput, SelectUser, SelectVendor, SessionProvider, TaxSelector, TemplateFNESelector, TextInput, ThemeProvider, ToastContainer, ToastProvider, type User, UserServices, type ViewMode, formatDate, formatFileSize, getFileIcon, useAlert, useFileManager, useSession, useToast };
+export { Alert, AlertProvider, ApprovalAnswerModal, ApprovalAnswerPage, ApprovalPreviewAnswer, ApprovalServices, ApprovalWorkflow, AuthServices, type BackendFile, type BackendFolder, CHOICES, type ConfirmOptions, CountrySelector, DateInput, EntityFileManager, type EntityFileManagerProps, type EntityType, FDrawer, FetchApi, FileInput, type FileItem, FileManager, type FileManagerProps, FileManagerProvider, type FileManagerTexts, ForeignCurrencySelector, InputField, InvoiceTypeSelector, LegalFormSelector, type MenuItem, Modal, NumberInput, Pages, PaymentMethodSelector, PrimaryButton, RewiseLayout, SecondaryButton, SelectCostCenter, SelectDepartment, SelectInput, SelectUser, SelectVendor, SessionProvider, TaxSelector, TemplateFNESelector, TextInput, ThemeProvider, ToastContainer, ToastProvider, type UseFileManagerApiReturn, type User, UserServices, type ViewMode, fileManagerApi, formatDate, formatFileSize, getFileIcon, useAlert, useFileManager, useFileManagerApi, useSession, useToast };