@sinoia/hubdoc-tools 1.0.3 → 1.2.0

package/dist/services/hubdoc-import-service.js

@@ -1,374 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.HubDocImportService = void 0;
-const fs_extra_1 = __importDefault(require("fs-extra"));
-const csv_parser_1 = __importDefault(require("csv-parser"));
-const path_1 = __importDefault(require("path"));
-const hubdoc_client_1 = require("./hubdoc-client");
-const concurrent_processor_1 = require("../utils/concurrent-processor");
-const chalk_1 = __importDefault(require("chalk"));
-/**
- * Service for importing documents to HubDoc using CSV mapping files
- */
-class HubDocImportService {
-    constructor(config) {
-        this.config = config;
-        this.client = new hubdoc_client_1.HubDocClient(config);
-    }
-    /**
-     * Test connection to HubDoc API
-     */
-    async testConnection() {
-        return await this.client.testConnection();
-    }
-    /**
-     * Parse CSV mapping file into DocumentMapping objects
-     */
-    async parseMappingFile(filePath, baseDir) {
-        if (!await fs_extra_1.default.pathExists(filePath)) {
-            throw new Error(`Mapping file not found: ${filePath}`);
-        }
-        console.log(chalk_1.default.blue(`📋 Parsing mapping file: ${filePath}`));
-        return new Promise((resolve, reject) => {
-            const mappings = [];
-            const errors = [];
-            fs_extra_1.default.createReadStream(filePath)
-                .pipe((0, csv_parser_1.default)())
-                .on('data', (row, index) => {
-                try {
-                    const mapping = this.parseRowToMapping(row, index + 1, baseDir);
-                    if (mapping) {
-                        mappings.push(mapping);
-                    }
-                }
-                catch (error) {
-                    errors.push(`Row ${index + 2}: ${error.message}`);
-                }
-            })
-                .on('end', () => {
-                if (errors.length > 0) {
-                    console.error(chalk_1.default.red('❌ CSV parsing errors:'));
-                    errors.forEach(error => console.error(chalk_1.default.red(`  ${error}`)));
-                    reject(new Error(`${errors.length} errors found in CSV file`));
-                }
-                else {
-                    console.log(chalk_1.default.green(`✅ Parsed ${mappings.length} mappings from CSV`));
-                    resolve(mappings);
-                }
-            })
-                .on('error', reject);
-        });
-    }
-    /**
-     * Parse CSV row into DocumentMapping object
-     */
-    parseRowToMapping(row, rowNumber, baseDir) {
-        // Skip empty rows
-        if (!row.filePath && !row.file_path && !row.sourcePath && !row.source_path) {
-            return null;
-        }
-        // Get file path (support multiple column names)
-        const filePath = row.filePath || row.file_path || row.sourcePath || row.source_path;
-        if (!filePath) {
-            throw new Error('Missing file path column (expected: filePath, file_path, sourcePath, or source_path)');
-        }
-        // Resolve full path
-        const fullFilePath = path_1.default.isAbsolute(filePath) ? filePath :
-            path_1.default.resolve(baseDir || process.cwd(), filePath);
-        // Build mapping object
-        const mapping = {
-            filePath: fullFilePath,
-            workspace: row.workspace || row.workspaceName || row.workspace_name,
-            targetFolder: row.targetFolder || row.target_folder || row.folderPath || row.folder_path,
-            domain: row.domain,
-            metadata: {}
-        };
-        // Parse metadata from additional columns
-        const metadataColumns = ['title', 'description', 'category', 'tags', 'author', 'project', 'client'];
-        metadataColumns.forEach(col => {
-            if (row[col]) {
-                mapping.metadata[col] = row[col];
-            }
-        });
-        // Parse custom metadata (JSON columns)
-        if (row.metadata) {
-            try {
-                mapping.metadata = { ...mapping.metadata, ...JSON.parse(row.metadata) };
-            }
-            catch (error) {
-                console.warn(chalk_1.default.yellow(`⚠️ Row ${rowNumber}: Invalid JSON in metadata column, ignoring`));
-            }
-        }
-        // Parse permissions
-        if (row.permissions) {
-            try {
-                mapping.permissions = JSON.parse(row.permissions);
-            }
-            catch (error) {
-                console.warn(chalk_1.default.yellow(`⚠️ Row ${rowNumber}: Invalid JSON in permissions column, ignoring`));
-            }
-        }
-        else {
-            // Build permissions from individual columns
-            const permissions = {};
-            if (row.readUsers || row.read_users) {
-                permissions.read = {
-                    users: (row.readUsers || row.read_users).split(',').map((u) => u.trim())
-                };
-            }
-            if (row.writeUsers || row.write_users) {
-                permissions.write = {
-                    users: (row.writeUsers || row.write_users).split(',').map((u) => u.trim())
-                };
-            }
-            if (row.readGroups || row.read_groups) {
-                permissions.read = {
-                    ...permissions.read,
-                    groups: (row.readGroups || row.read_groups).split(',').map((g) => g.trim())
-                };
-            }
-            if (row.writeGroups || row.write_groups) {
-                permissions.write = {
-                    ...permissions.write,
-                    groups: (row.writeGroups || row.write_groups).split(',').map((g) => g.trim())
-                };
-            }
-            if (Object.keys(permissions).length > 0) {
-                mapping.permissions = permissions;
-            }
-        }
-        return mapping;
-    }
-    /**
-     * Validate mapping file and mappings
-     */
-    async validateMappings(mappings) {
-        const result = {
-            valid: true,
-            errors: [],
-            warnings: [],
-            mappingCount: mappings.length
-        };
-        console.log(chalk_1.default.blue(`🔍 Validating ${mappings.length} mappings...`));
-        for (let i = 0; i < mappings.length; i++) {
-            const mapping = mappings[i];
-            const rowNum = i + 1;
-            // Check if file exists
-            if (!await fs_extra_1.default.pathExists(mapping.filePath)) {
-                result.errors.push(`Row ${rowNum}: File not found: ${mapping.filePath}`);
-                result.valid = false;
-                continue;
-            }
-            // Check file size
-            try {
-                const stats = await fs_extra_1.default.stat(mapping.filePath);
-                if (stats.size === 0) {
-                    result.warnings.push(`Row ${rowNum}: File is empty: ${mapping.filePath}`);
-                }
-                else if (stats.size > 100 * 1024 * 1024) { // 100MB
-                    result.warnings.push(`Row ${rowNum}: Large file (${Math.round(stats.size / 1024 / 1024)}MB): ${mapping.filePath}`);
-                }
-            }
-            catch (error) {
-                result.errors.push(`Row ${rowNum}: Cannot read file: ${mapping.filePath}`);
-                result.valid = false;
-            }
-            // Validate workspace name
-            if (mapping.workspace && mapping.workspace.length > 255) {
-                result.errors.push(`Row ${rowNum}: Workspace name too long (max 255 chars): ${mapping.workspace}`);
-                result.valid = false;
-            }
-            // Validate folder path
-            if (mapping.targetFolder) {
-                if (mapping.targetFolder.length > 1000) {
-                    result.errors.push(`Row ${rowNum}: Folder path too long (max 1000 chars): ${mapping.targetFolder}`);
-                    result.valid = false;
-                }
-                // Check for invalid characters
-                const invalidChars = /[<>:"|?*]/;
-                if (invalidChars.test(mapping.targetFolder)) {
-                    result.errors.push(`Row ${rowNum}: Invalid characters in folder path: ${mapping.targetFolder}`);
-                    result.valid = false;
-                }
-            }
-            // Validate domain
-            if (mapping.domain && mapping.domain.length > 100) {
-                result.errors.push(`Row ${rowNum}: Domain name too long (max 100 chars): ${mapping.domain}`);
-                result.valid = false;
-            }
-        }
-        // Summary
-        if (result.valid) {
-            console.log(chalk_1.default.green(`✅ Validation passed for ${mappings.length} mappings`));
-        }
-        else {
-            console.log(chalk_1.default.red(`❌ Validation failed with ${result.errors.length} errors`));
-        }
-        if (result.warnings.length > 0) {
-            console.log(chalk_1.default.yellow(`⚠️ ${result.warnings.length} warnings found`));
-        }
-        return result;
-    }
-    /**
-     * Import documents using mappings
-     */
-    async importDocuments(mappings, options = {}) {
-        const startTime = Date.now();
-        console.log(chalk_1.default.blue(`📦 Starting import of ${mappings.length} documents`));
-        // Filter mappings if needed
-        let filteredMappings = mappings;
-        if (options.domain) {
-            filteredMappings = mappings.filter(m => m.domain === options.domain);
-            console.log(chalk_1.default.gray(`🔍 Filtered to ${filteredMappings.length} mappings for domain: ${options.domain}`));
-        }
-        const results = [];
-        if (options.dryRun) {
-            console.log(chalk_1.default.yellow('🧪 DRY RUN MODE - No files will be uploaded'));
-            // Simulate dry run results
-            for (const mapping of filteredMappings) {
-                results.push({
-                    success: true,
-                    filePath: mapping.filePath,
-                    document: undefined // No actual upload in dry run
-                });
-            }
-        }
-        else {
-            // Actual import
-            if (options.concurrency && options.concurrency > 1) {
-                // Concurrent import
-                const processingResult = await concurrent_processor_1.ConcurrentProcessor.processWithProgress(filteredMappings, async (mapping) => {
-                    return await this.client.importDocument(mapping);
-                }, {
-                    concurrency: options.concurrency,
-                    operation: 'Import',
-                    itemName: 'documents'
-                });
-                results.push(...processingResult.results.filter(r => r !== undefined));
-                // Add error results
-                const errorResults = processingResult.errors.map(({ item, error }) => ({
-                    success: false,
-                    filePath: item.filePath,
-                    error: error.message
-                }));
-                results.push(...errorResults);
-            }
-            else {
-                // Sequential import
-                for (let i = 0; i < filteredMappings.length; i++) {
-                    const mapping = filteredMappings[i];
-                    const progress = `(${i + 1}/${filteredMappings.length})`;
-                    console.log(chalk_1.default.cyan(`${progress} Importing: ${path_1.default.basename(mapping.filePath)}`));
-                    try {
-                        const result = await this.client.importDocument(mapping);
-                        results.push(result);
-                    }
-                    catch (error) {
-                        results.push({
-                            success: false,
-                            filePath: mapping.filePath,
-                            error: error.message
-                        });
-                    }
-                    // Progress update every 10 documents
-                    if ((i + 1) % 10 === 0) {
-                        console.log(chalk_1.default.blue(`📊 Progress: ${i + 1}/${filteredMappings.length} processed`));
-                    }
-                }
-            }
-        }
-        const endTime = Date.now();
-        const duration = endTime - startTime;
-        const summary = {
-            total: filteredMappings.length,
-            successful: results.filter(r => r.success).length,
-            failed: results.filter(r => !r.success).length,
-            skipped: mappings.length - filteredMappings.length,
-            results,
-            duration
-        };
-        this.printImportSummary(summary, options.dryRun);
-        return summary;
-    }
-    /**
-     * Bulk import with CSV file
-     */
-    async bulkImportFromCsv(options) {
-        console.log(chalk_1.default.blue(`🚀 Starting bulk import from: ${options.mappingFile}`));
-        // Step 1: Parse CSV
-        const mappings = await this.parseMappingFile(options.mappingFile, options.baseDir);
-        // Step 2: Validate mappings
-        if (!options.dryRun) {
-            const validation = await this.validateMappings(mappings);
-            if (!validation.valid) {
-                throw new Error(`Validation failed with ${validation.errors.length} errors. Fix the issues and try again.`);
-            }
-            if (validation.warnings.length > 0 && options.interactive) {
-                console.log(chalk_1.default.yellow('\n⚠️ Warnings found:'));
-                validation.warnings.forEach(warning => console.log(chalk_1.default.yellow(`  ${warning}`)));
-                // In a real interactive scenario, you'd prompt the user here
-                console.log(chalk_1.default.blue('Continuing with import...'));
-            }
-        }
-        if (options.validateOnly) {
-            console.log(chalk_1.default.green('✅ Validation complete. Use --no-validate-only to proceed with import.'));
-            return {
-                total: mappings.length,
-                successful: 0,
-                failed: 0,
-                skipped: 0,
-                results: [],
-                duration: 0,
-                mappingFile: options.mappingFile
-            };
-        }
-        // Step 3: Test connection
-        if (!options.dryRun) {
-            console.log(chalk_1.default.blue('🔗 Testing API connection...'));
-            const connected = await this.testConnection();
-            if (!connected) {
-                throw new Error('Failed to connect to HubDoc API. Check your configuration.');
-            }
-        }
-        // Step 4: Import documents
-        return await this.importDocuments(mappings, options);
-    }
-    /**
-     * Print import summary
-     */
-    printImportSummary(summary, isDryRun = false) {
-        const durationStr = (summary.duration / 1000).toFixed(1);
-        console.log('\n' + chalk_1.default.bold(`📊 Import Summary ${isDryRun ? '(DRY RUN)' : ''}`));
-        console.log(chalk_1.default.green(`✅ Successful: ${summary.successful}`));
-        if (summary.failed > 0) {
-            console.log(chalk_1.default.red(`❌ Failed: ${summary.failed}`));
-            const failedResults = summary.results.filter(r => !r.success);
-            if (failedResults.length > 0 && failedResults.length <= 10) {
-                console.log('\n' + chalk_1.default.red('Failed imports:'));
-                failedResults.forEach(result => {
-                    console.log(chalk_1.default.red(`  • ${path_1.default.basename(result.filePath)}: ${result.error}`));
-                });
-            }
-            else if (failedResults.length > 10) {
-                console.log('\n' + chalk_1.default.red('Failed imports (showing first 10):'));
-                failedResults.slice(0, 10).forEach(result => {
-                    console.log(chalk_1.default.red(`  • ${path_1.default.basename(result.filePath)}: ${result.error}`));
-                });
-                console.log(chalk_1.default.red(`  ... and ${failedResults.length - 10} more`));
-            }
-        }
-        if (summary.skipped > 0) {
-            console.log(chalk_1.default.gray(`⏭️  Skipped: ${summary.skipped}`));
-        }
-        console.log(chalk_1.default.blue(`\n📈 Total processed: ${summary.total} documents in ${durationStr}s`));
-        if (summary.total > 0 && summary.duration > 0) {
-            const rate = (summary.total / (summary.duration / 1000)).toFixed(1);
-            console.log(chalk_1.default.gray(`⚡ Rate: ${rate} docs/second`));
-        }
-    }
-}
-exports.HubDocImportService = HubDocImportService;
-//# sourceMappingURL=hubdoc-import-service.js.map

package/dist/services/hubdoc-import-service.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"hubdoc-import-service.js","sourceRoot":"","sources":["../../src/services/hubdoc-import-service.ts"],"names":[],"mappings":"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"}

package/docs/README.md

@@ -1,65 +0,0 @@
-# Documentation des Connecteurs
-
-Cette section contient la documentation détaillée pour chaque connecteur supporté par hubdoc-tools.
-
-## 📁 Connecteurs disponibles
-
-### Cloud Storage
-- **[Box](./connectors/box.md)** - Box Cloud Storage
-- **[AWS S3](./connectors/aws-s3.md)** - Amazon S3 et services compatibles
-- **[Azure Blob](./connectors/azure-blob.md)** - Azure Blob Storage
-
-### ECM/GED (Enterprise Content Management)
-- **[Alfresco](./connectors/alfresco.md)** - Alfresco Content Services
-- **[Nuxeo](./connectors/nuxeo.md)** - Nuxeo Platform
-- **[OpenText](./connectors/opentext.md)** - OpenText Content Server
-
-### Microsoft 365 / SharePoint
-- **[SharePoint](./connectors/sharepoint.md)** - SharePoint Online via Microsoft Graph
-
-## 🚀 Utilisation générale
-
-Tous les connecteurs supportent les opérations suivantes :
-
-### Scan
-Parcourir et lister les documents disponibles dans la source.
-
-### Import  
-Télécharger les documents depuis la source vers le système local.
-
-### Export
-Uploader des documents locaux vers la source externe.
-
-## ⚙️ Configuration commune
-
-Chaque connecteur peut être configuré via :
-
-1. **Mode interactif** : `hubdoc-tool --engine [nom] --interactive`
-2. **Fichier de configuration** : `[nom]-config.json`
-3. **Variables d'environnement** : selon le connecteur
-
-## 🔍 Filtres supportés
-
-Tous les connecteurs supportent les filtres suivants :
-
-- **Taille** : `maxSize` - Taille maximale des fichiers
-- **Date** : `dateRange` - Plage de dates de modification
-- **Type MIME** : `mimeTypes` - Types de fichiers acceptés
-- **Limite** : `limit` - Nombre maximum de documents
-
-## 📊 Métadonnées
-
-Chaque connecteur extrait et préserve les métadonnées spécifiques à sa plateforme :
-
-- Métadonnées standard (nom, taille, dates)
-- Métadonnées spécifiques à la plateforme
-- Informations d'audit (créateur, modificateur)
-- Tags et classifications selon disponibilité
-
-## 🛠️ Développement
-
-Pour ajouter un nouveau connecteur, consulter l'architecture des plugins existants et implémenter l'interface `DocumentSourcePlugin`.
-
-## 📞 Support
-
-Pour les problèmes spécifiques à un connecteur, consulter la section "Troubleshooting" de sa documentation respective.

package/docs/connectors/alfresco.md

@@ -1,211 +0,0 @@
-# Alfresco ECM Connector
-
-Plugin pour importer/exporter des documents depuis/vers Alfresco Content Management.
-
-## Configuration
-
-### Paramètres requis
-- `baseUrl` : URL de base Alfresco (ex: http://localhost:8080/alfresco)
-- `username` : Nom d'utilisateur Alfresco
-- `password` : Mot de passe Alfresco
-
-### Paramètres optionnels
-- `siteId` : ID du site Alfresco à scanner (optionnel)
-- `folderId` : ID du dossier de départ (optionnel)
-- `includeFolders` : Inclure les sous-dossiers (défaut: true)
-- `limit` : Nombre maximum de documents à scanner
-
-## Configuration Alfresco
-
-### Prérequis
-- Alfresco Community ou Enterprise 5.2+
-- API REST Alfresco activée
-- Utilisateur avec permissions de lecture/écriture appropriées
-
-### Vérification de l'API
-1. Tester l'accès à l'API : `http://your-alfresco/alfresco/api/-default-/public/alfresco/versions/1/people/-me-`
-2. Vérifier que l'authentification fonctionne
-3. Tester l'accès aux contenus avec votre utilisateur
-
-## Structure Alfresco
-
-### Sites Alfresco
-Si vous utilisez Alfresco Share avec des sites :
-```json
-{
-  "baseUrl": "http://localhost:8080/alfresco",
-  "username": "admin", 
-  "password": "admin",
-  "siteId": "my-site"
-}
-```
-
-### Dossier spécifique
-Pour scanner à partir d'un dossier spécifique :
-```json
-{
-  "baseUrl": "http://localhost:8080/alfresco",
-  "username": "admin",
-  "password": "admin", 
-  "folderId": "workspace://SpacesStore/uuid-of-folder"
-}
-```
-
-### Repository racine (défaut)
-Sans siteId ni folderId, scan depuis `-root-` :
-```json
-{
-  "baseUrl": "http://localhost:8080/alfresco",
-  "username": "admin",
-  "password": "admin"
-}
-```
-
-## Utilisation
-
-```bash
-# Mode interactif
-hubdoc-tool --engine alfresco
-
-# Avec limite de documents
-hubdoc-tool --engine alfresco --limit 50
-```
-
-## Fichier de configuration
-
-Créer `alfresco-config.json` :
-
-```json
-{
-  "baseUrl": "https://alfresco.example.com/alfresco",
-  "username": "jdoe",
-  "password": "password123", 
-  "siteId": "project-documents",
-  "includeFolders": true,
-  "limit": 200
-}
-```
-
-## Fonctionnalités supportées
-
-### Scan (✅)
-- Parcours récursif des dossiers et sous-dossiers
-- Support des sites Alfresco Share
-- Métadonnées complètes Alfresco (aspects, propriétés)
-- Types de contenu personnalisés
-- Filtrage par taille, date, type MIME
-
-### Import (✅)
-- Téléchargement du contenu binaire
-- Préservation de la structure de dossiers
-- Conservation des métadonnées Alfresco
-- Gestion des versions de documents
-
-### Export (✅)
-- Upload multipart pour gros fichiers
-- Création automatique de l'arborescence
-- Assignment du type de contenu `cm:content`
-- Métadonnées de base (titre, description)
-
-## Métadonnées Alfresco
-
-### Propriétés standard extraites
-- **Dublin Core** : title, description, creator, created, modified
-- **Content Model** : name, type, parent, version
-- **Audit** : created_by, modified_by, creation date
-- **Custom Properties** : aspects et propriétés personnalisés
-
-### Types de contenu supportés
-- `cm:content` : Documents standards
-- `cm:folder` : Dossiers
-- Types personnalisés définis dans votre modèle de contenu
-
-## API Alfresco utilisée
-
-### Version API
-- **API REST** : Alfresco REST API v1
-- **Base Path** : `/api/-default-/public/alfresco/versions/1`
-- **Documentation** : [Alfresco REST API](https://docs.alfresco.com/content-services/latest/develop/rest-api-guide/)
-
-### Endpoints utilisés
-- `GET /nodes/{nodeId}/children` : Liste le contenu d'un nœud
-- `GET /nodes/{nodeId}/content` : Télécharge le contenu d'un fichier
-- `POST /nodes/{nodeId}/children` : Crée un nouveau document/dossier
-- `GET /sites/{siteId}/containers` : Accède aux conteneurs de site
-
-## Structure des nœuds
-
-### Identifiants Alfresco
-- **NodeRef** : `workspace://SpacesStore/uuid`
-- **Node ID** : uuid court utilisé dans l'API REST
-- **Path** : Chemin depuis Company Home
-
-### Hiérarchie standard
-```
-Company Home/
-├── Data Dictionary/
-├── Sites/
-│   └── my-site/
-│       └── documentLibrary/
-└── User Homes/
-```
-
-## Limitations
-
-### Alfresco Community
-- Pas de clustering avancé
-- Limitations sur certains aspects enterprise
-
-### Alfresco Enterprise
-- Fonctionnalités complètes
-- Support des transformations avancées
-- Workflows complexes
-
-### API REST
-- Pagination max : 100 items par défaut
-- Timeout par défaut : 30 secondes
-- Pas de support des transactions
-
-## Troubleshooting
-
-### Erreur 401: Authentication failed
-- Vérifier username/password
-- Vérifier que l'utilisateur existe et est actif
-- Tester la connexion via navigateur
-
-### Erreur 403: Access denied
-- Vérifier les permissions sur le site/dossier
-- S'assurer que l'utilisateur a les rôles appropriés
-- Vérifier les ACL sur les contenus
-
-### Erreur 404: Node not found
-- Vérifier que le siteId ou folderId existe
-- Contrôler l'orthographe des identifiants
-- Tester l'accès via Share interface
-
-### Erreur 500: Internal server error
-- Vérifier les logs Alfresco (alfresco.log, catalina.out)
-- Contrôler l'espace disque disponible
-- Vérifier la configuration de la base de données
-
-## Bonnes pratiques
-
-### Performance
-- Limiter la profondeur de scan pour les gros repositories
-- Utiliser des filtres appropriés (date, taille)
-- Planifier les imports/exports en dehors des heures de pointe
-
-### Sécurité
-- Utiliser HTTPS pour les connexions
-- Créer un utilisateur dédié avec permissions minimales
-- Auditer les accès aux contenus sensibles
-
-### Maintenance
-- Surveiller l'utilisation de l'espace disque
-- Configurer des règles de rétention appropriées
-- Sauvegarder régulièrement le repository et la DB
-
-### Modèle de contenu
-- Définir des aspects personnalisés pour vos métadonnées
-- Utiliser des contraintes sur les propriétés
-- Implémenter des règles d'auto-classification