@sinoia/hubdoc-tools 1.0.3 → 1.2.0

package/README.md

@@ -18,12 +18,12 @@ hubdoc-tool --version
 ```
 
 **🚀 Latest Features:**
-- **NPM Package**: Install globally with `npm install -g @sinoia/hubdoc-tools`
-- **API v2 Integration**: Full integration with official HubDoc Swagger API
-- **Plugin System**: Extensible architecture for external sources (OneDrive, Google Drive, Dropbox)
-- **OAuth2 Support**: Modern authentication with client credentials
-- **Enhanced Validation**: Pre-import validation and detailed error reporting
-- **Interactive Mode**: Guided workflows with previews and confirmations
+- **🔐 Automatic OAuth2**: Zero-config authentication with automatic token refresh
+- **📦 NPM Package**: Install globally with `npm install -g @sinoia/hubdoc-tools`
+- **🔌 API Integration**: Full integration with official HubDoc Swagger/OpenAPI API
+- **🧩 Plugin System**: Extensible architecture for external sources (OneDrive, Google Drive, S3, Dropbox)
+- **✅ Enhanced Validation**: Pre-import validation and detailed error reporting
+- **🎯 Interactive Mode**: Guided workflows with previews and confirmations
 
 ### Features
 
@@ -41,10 +41,11 @@ hubdoc-tool --version
 - **Path Customization**: Specify custom target directories for exported files
 
 **⚙️ General Features**
-- **Interactive & CLI Modes**: Both interactive wizard and command-line interface
-- **Configuration Wizard**: First-time setup for API credentials
-- **Folder Management**: Automatic folder creation in HubDoc
-- **Progress Tracking**: Real-time import/export progress with detailed feedback
+- **🔐 Automatic OAuth2**: Zero-config authentication with automatic token refresh and expiration handling
+- **🎯 Interactive & CLI Modes**: Both interactive wizard and command-line interface
+- **📁 Folder Management**: Automatic folder creation in HubDoc
+- **📊 Progress Tracking**: Real-time import/export progress with detailed feedback
+- **🔄 Token Management**: Automatic token refresh before expiration (60s buffer)
 
 ## 🚀 Quick Start
 
@@ -55,27 +56,49 @@ npm install -g @sinoia/hubdoc-tools
 
 ### 2. Configuration
 
-#### Quick Setup (OAuth - Recommended)
+#### Automatic Setup (OAuth2 - Recommended)
+
+**Configuration is now fully automatic!** Simply set environment variables and run any command:
+
 ```bash
-# Get OAuth token automatically
-hubdoc-tool get-token rec.hubdoc.sinoia.cloud --save
+# Set OAuth2 credentials (one time)
+export HUBDOC_API_URL=https://rec.hubdoc.sinoia.cloud
+export HUBDOC_OAUTH_CLIENT_ID=your-client-id
+export HUBDOC_OAUTH_CLIENT_SECRET=your-client-secret
+export HUBDOC_OAUTH_SCOPES="read write"
+
+# Run any command - authentication is automatic!
+hubdoc-tool import --source ./documents
+```
+
+**What happens automatically:**
+1. ✅ CLI checks for valid token
+2. 🔄 Refreshes token if expired (using refresh_token)
+3. 🌐 Opens browser for OAuth authentication if needed
+4. 💾 Saves token to `.hubdoc-config.json`
+5. ▶️ Proceeds with your command
+
+**No manual token management required!**
+
+#### Alternative: Configuration File
+
+Create a `.hubdoc-config.json` file (environment variables override this):
 
-# This will:
-# 1. Open your browser for authentication
-# 2. Retrieve the token automatically
-# 3. Save it to .hubdoc-config.json file
+```json
+{
+  "apiUrl": "https://rec.hubdoc.sinoia.cloud",
+  "clientId": "your-client-id",
+  "clientSecret": "your-client-secret",
+  "scopes": ["read", "write"]
+}
 ```
 
-#### Manual Setup
+Or use `.env` file:
 ```bash
-# Interactive configuration wizard
-hubdoc-tool config
-
-# Or create config file manually
-echo '{
-  "apiUrl": "https://your.hubdoc.instance/api/v1",
-  "token": "your-jwt-token"
-}' > .hubdoc-config.json
+HUBDOC_API_URL=https://rec.hubdoc.sinoia.cloud
+HUBDOC_OAUTH_CLIENT_ID=your-client-id
+HUBDOC_OAUTH_CLIENT_SECRET=your-client-secret
+HUBDOC_OAUTH_SCOPES="read write"
 ```
 
 ### 3. Basic Usage
@@ -83,20 +106,23 @@ echo '{
 # Generate mapping from local directory
 hubdoc-tool generate-mapping ./documents
 
-# Import documents
+# Import documents (authentication is automatic!)
 hubdoc-tool import --source /path/to/documents
 hubdoc-tool import --mapping mapping.csv
+hubdoc-tool import --direct ./invoices
 
 # Export documents
-hubdoc-tool export --scan
+hubdoc-tool export --scan                    # Generate export mapping
 hubdoc-tool export --mapping export-mapping.csv
+hubdoc-tool export --generate-xml-metadata   # With XML metadata
 
 # Interactive mode
 hubdoc-tool --interactive
 
-# OAuth token management
-hubdoc-tool get-token rec.hubdoc.sinoia.cloud --save
-hubdoc-tool revoke-token rec.hubdoc.sinoia.cloud token-id
+# Use different engines for import
+hubdoc-tool --engine onedrive
+hubdoc-tool --engine googledrive
+hubdoc-tool --engine s3
 ```
 
 ### 4. Plugin-based Sources
@@ -215,14 +241,69 @@ Each `*_metadata.xml` file contains:
 </document>
 ```
 
+## 🔐 OAuth2 Authentication
+
+The tool uses **OAuth 2.0 Authorization Code Flow** with automatic token management:
+
+### How It Works
+
+1. **First Run**: If no valid token exists, the CLI automatically:
+   - Starts a local HTTP server on `localhost:8082`
+   - Opens your browser to the OAuth authorization page
+   - Receives the authorization code via callback
+   - Exchanges the code for an access token
+   - Saves the token and refresh token to `.hubdoc-config.json`
+
+2. **Subsequent Runs**: The CLI automatically:
+   - Loads the saved token from config file or environment
+   - Checks if token is expired (with 60s buffer)
+   - Refreshes the token using refresh_token if needed
+   - Proceeds with your command
+
+3. **No Manual Intervention**: You never need to manually manage tokens!
+
+### Environment Variables
+
+Priority order (highest to lowest):
+1. **Environment variables** (override everything)
+2. **`.env` file** (loaded automatically)
+3. **`.hubdoc-config.json`** (saved tokens)
+
+```bash
+# Required for automatic OAuth
+export HUBDOC_API_URL=https://rec.hubdoc.sinoia.cloud
+export HUBDOC_OAUTH_CLIENT_ID=your-client-id
+export HUBDOC_OAUTH_CLIENT_SECRET=your-client-secret
+export HUBDOC_OAUTH_SCOPES="read write admin"
+
+# Optional: provide a valid token directly (skips OAuth flow)
+export HUBDOC_TOKEN=your-existing-token
+```
+
+### Token Expiration
+
+- Tokens typically expire after **2 hours** (7200 seconds)
+- The CLI checks expiration **60 seconds before** actual expiration
+- Automatic refresh using the refresh_token (no browser required)
+- If refresh fails, a new OAuth flow is initiated automatically
+
+### Security Notes
+
+- Tokens are stored in `.hubdoc-config.json` (add to `.gitignore`!)
+- Client secrets should be stored in environment variables or `.env` file
+- The local OAuth callback server only binds to `127.0.0.1` (localhost)
+- Authorization codes are single-use and expire quickly
+
 ### API Configuration
 
 The tool supports HubDoc APIs with endpoints like:
-- `https://demo.hubdoc.sinoia.cloud/api/v1`
+- `https://rec.hubdoc.sinoia.cloud`
+- `https://demo.hubdoc.sinoia.cloud`
 
 Configuration can be stored as:
-- JSON file (`.hubdoc-config.json`)
-- Environment file (`.env`)
+- Environment variables (recommended for credentials)
+- `.env` file (for local development)
+- `.hubdoc-config.json` file (for saved tokens)
 
 ## Plugin Architecture
 

package/dist/__tests__/fixtures/plugins/connection-plugin/index.d.ts

@@ -0,0 +1,15 @@
+import { DocumentSourcePlugin, PluginConfig, ScanResult, ImportResult, DocumentSource } from '../../../../types/plugins';
+declare class ConnectionPlugin implements DocumentSourcePlugin {
+    readonly name = "connection-plugin";
+    readonly version = "1.0.0";
+    readonly description = "Plugin for testing connections";
+    readonly supportedOperations: readonly ["import"];
+    testConnection(config: PluginConfig): Promise<boolean>;
+    scan(config: PluginConfig): Promise<ScanResult>;
+    import(config: PluginConfig, sources: DocumentSource[], targetDir: string): Promise<ImportResult[]>;
+    getConfigSchema(): Record<string, any>;
+    initialize(config: PluginConfig): Promise<void>;
+    destroy(): Promise<void>;
+}
+export default ConnectionPlugin;
+//# sourceMappingURL=index.d.ts.map

package/dist/__tests__/fixtures/plugins/connection-plugin/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/__tests__/fixtures/plugins/connection-plugin/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,YAAY,EAAE,UAAU,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAEzH,cAAM,gBAAiB,YAAW,oBAAoB;IACpD,QAAQ,CAAC,IAAI,uBAAuB;IACpC,QAAQ,CAAC,OAAO,WAAW;IAC3B,QAAQ,CAAC,WAAW,oCAAoC;IACxD,QAAQ,CAAC,mBAAmB,sBAAuB;IAE7C,cAAc,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,OAAO,CAAC;IAKtD,IAAI,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,UAAU,CAAC;IAS/C,MAAM,CAAC,MAAM,EAAE,YAAY,EAAE,OAAO,EAAE,cAAc,EAAE,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAIzG,eAAe,IAAI,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IAShC,UAAU,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAC/C,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAC/B;AAED,eAAe,gBAAgB,CAAC"}

package/dist/__tests__/fixtures/plugins/connection-plugin/index.js

@@ -0,0 +1,37 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+class ConnectionPlugin {
+    constructor() {
+        this.name = 'connection-plugin';
+        this.version = '1.0.0';
+        this.description = 'Plugin for testing connections';
+        this.supportedOperations = ['import'];
+    }
+    async testConnection(config) {
+        // Return true if config.valid is true, false otherwise
+        return config.valid === true;
+    }
+    async scan(config) {
+        return {
+            sources: [],
+            totalCount: 0,
+            totalSize: 0,
+            errors: []
+        };
+    }
+    async import(config, sources, targetDir) {
+        return [];
+    }
+    getConfigSchema() {
+        return {
+            type: 'object',
+            properties: {
+                valid: { type: 'boolean' }
+            }
+        };
+    }
+    async initialize(config) { }
+    async destroy() { }
+}
+exports.default = ConnectionPlugin;
+//# sourceMappingURL=index.js.map

package/dist/__tests__/fixtures/plugins/connection-plugin/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/__tests__/fixtures/plugins/connection-plugin/index.ts"],"names":[],"mappings":";;AAEA,MAAM,gBAAgB;IAAtB;QACW,SAAI,GAAG,mBAAmB,CAAC;QAC3B,YAAO,GAAG,OAAO,CAAC;QAClB,gBAAW,GAAG,gCAAgC,CAAC;QAC/C,wBAAmB,GAAG,CAAC,QAAQ,CAAU,CAAC;IA+BrD,CAAC;IA7BC,KAAK,CAAC,cAAc,CAAC,MAAoB;QACvC,uDAAuD;QACvD,OAAQ,MAAc,CAAC,KAAK,KAAK,IAAI,CAAC;IACxC,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,MAAoB;QAC7B,OAAO;YACL,OAAO,EAAE,EAAE;YACX,UAAU,EAAE,CAAC;YACb,SAAS,EAAE,CAAC;YACZ,MAAM,EAAE,EAAE;SACX,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,MAAoB,EAAE,OAAyB,EAAE,SAAiB;QAC7E,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,eAAe;QACb,OAAO;YACL,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,KAAK,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;aAC3B;SACF,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,MAAoB,IAAkB,CAAC;IACxD,KAAK,CAAC,OAAO,KAAmB,CAAC;CAClC;AAED,kBAAe,gBAAgB,CAAC"}

package/dist/__tests__/fixtures/plugins/scan-plugin/index.d.ts

@@ -0,0 +1,15 @@
+import { DocumentSourcePlugin, PluginConfig, ScanResult, ImportResult, DocumentSource, PluginImportOptions } from '../../../../types/plugins';
+declare class ScanPlugin implements DocumentSourcePlugin {
+    readonly name = "scan-plugin";
+    readonly version = "1.0.0";
+    readonly description = "Plugin for testing scan functionality";
+    readonly supportedOperations: readonly ["import"];
+    testConnection(config: PluginConfig): Promise<boolean>;
+    scan(config: PluginConfig, options?: PluginImportOptions): Promise<ScanResult>;
+    import(config: PluginConfig, sources: DocumentSource[], targetDir: string): Promise<ImportResult[]>;
+    getConfigSchema(): Record<string, any>;
+    initialize(config: PluginConfig): Promise<void>;
+    destroy(): Promise<void>;
+}
+export default ScanPlugin;
+//# sourceMappingURL=index.d.ts.map

package/dist/__tests__/fixtures/plugins/scan-plugin/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/__tests__/fixtures/plugins/scan-plugin/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,YAAY,EAAE,UAAU,EAAE,YAAY,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAE9I,cAAM,UAAW,YAAW,oBAAoB;IAC9C,QAAQ,CAAC,IAAI,iBAAiB;IAC9B,QAAQ,CAAC,OAAO,WAAW;IAC3B,QAAQ,CAAC,WAAW,2CAA2C;IAC/D,QAAQ,CAAC,mBAAmB,sBAAuB;IAE7C,cAAc,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,OAAO,CAAC;IAItD,IAAI,CAAC,MAAM,EAAE,YAAY,EAAE,OAAO,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,UAAU,CAAC;IA8B9E,MAAM,CAAC,MAAM,EAAE,YAAY,EAAE,OAAO,EAAE,cAAc,EAAE,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAIzG,eAAe,IAAI,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IAOhC,UAAU,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAC/C,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAC/B;AAED,eAAe,UAAU,CAAC"}

package/dist/__tests__/fixtures/plugins/scan-plugin/index.js

@@ -0,0 +1,54 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+class ScanPlugin {
+    constructor() {
+        this.name = 'scan-plugin';
+        this.version = '1.0.0';
+        this.description = 'Plugin for testing scan functionality';
+        this.supportedOperations = ['import'];
+    }
+    async testConnection(config) {
+        return true;
+    }
+    async scan(config, options) {
+        const sources = [
+            {
+                id: 'doc-1',
+                name: 'document1.pdf',
+                path: '/folder/document1.pdf',
+                size: 1024,
+                mimeType: 'application/pdf',
+                lastModified: new Date('2024-01-01'),
+                metadata: { source: 'test' }
+            },
+            {
+                id: 'doc-2',
+                name: 'document2.docx',
+                path: '/folder/document2.docx',
+                size: 2048,
+                mimeType: 'application/vnd.openxmlformats-officedocument.wordprocessingml.document',
+                lastModified: new Date('2024-01-02'),
+                metadata: { source: 'test' }
+            }
+        ];
+        return {
+            sources,
+            totalCount: sources.length,
+            totalSize: sources.reduce((sum, s) => sum + s.size, 0),
+            errors: []
+        };
+    }
+    async import(config, sources, targetDir) {
+        return [];
+    }
+    getConfigSchema() {
+        return {
+            type: 'object',
+            properties: {}
+        };
+    }
+    async initialize(config) { }
+    async destroy() { }
+}
+exports.default = ScanPlugin;
+//# sourceMappingURL=index.js.map

package/dist/__tests__/fixtures/plugins/scan-plugin/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/__tests__/fixtures/plugins/scan-plugin/index.ts"],"names":[],"mappings":";;AAEA,MAAM,UAAU;IAAhB;QACW,SAAI,GAAG,aAAa,CAAC;QACrB,YAAO,GAAG,OAAO,CAAC;QAClB,gBAAW,GAAG,uCAAuC,CAAC;QACtD,wBAAmB,GAAG,CAAC,QAAQ,CAAU,CAAC;IAiDrD,CAAC;IA/CC,KAAK,CAAC,cAAc,CAAC,MAAoB;QACvC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,MAAoB,EAAE,OAA6B;QAC5D,MAAM,OAAO,GAAqB;YAChC;gBACE,EAAE,EAAE,OAAO;gBACX,IAAI,EAAE,eAAe;gBACrB,IAAI,EAAE,uBAAuB;gBAC7B,IAAI,EAAE,IAAI;gBACV,QAAQ,EAAE,iBAAiB;gBAC3B,YAAY,EAAE,IAAI,IAAI,CAAC,YAAY,CAAC;gBACpC,QAAQ,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE;aAC7B;YACD;gBACE,EAAE,EAAE,OAAO;gBACX,IAAI,EAAE,gBAAgB;gBACtB,IAAI,EAAE,wBAAwB;gBAC9B,IAAI,EAAE,IAAI;gBACV,QAAQ,EAAE,yEAAyE;gBACnF,YAAY,EAAE,IAAI,IAAI,CAAC,YAAY,CAAC;gBACpC,QAAQ,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE;aAC7B;SACF,CAAC;QAEF,OAAO;YACL,OAAO;YACP,UAAU,EAAE,OAAO,CAAC,MAAM;YAC1B,SAAS,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;YACtD,MAAM,EAAE,EAAE;SACX,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,MAAoB,EAAE,OAAyB,EAAE,SAAiB;QAC7E,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,eAAe;QACb,OAAO;YACL,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE,EAAE;SACf,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,MAAoB,IAAkB,CAAC;IACxD,KAAK,CAAC,OAAO,KAAmB,CAAC;CAClC;AAED,kBAAe,UAAU,CAAC"}

package/dist/__tests__/fixtures/plugins/test-plugin/index.d.ts

@@ -0,0 +1,15 @@
+import { DocumentSourcePlugin, PluginConfig, ScanResult, ImportResult, DocumentSource } from '../../../../types/plugins';
+declare class TestPlugin implements DocumentSourcePlugin {
+    readonly name = "test-plugin";
+    readonly version = "1.0.0";
+    readonly description = "Test plugin for unit tests";
+    readonly supportedOperations: readonly ["import"];
+    testConnection(config: PluginConfig): Promise<boolean>;
+    scan(config: PluginConfig): Promise<ScanResult>;
+    import(config: PluginConfig, sources: DocumentSource[], targetDir: string): Promise<ImportResult[]>;
+    getConfigSchema(): Record<string, any>;
+    initialize(config: PluginConfig): Promise<void>;
+    destroy(): Promise<void>;
+}
+export default TestPlugin;
+//# sourceMappingURL=index.d.ts.map

package/dist/__tests__/fixtures/plugins/test-plugin/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/__tests__/fixtures/plugins/test-plugin/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,YAAY,EAAE,UAAU,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAEzH,cAAM,UAAW,YAAW,oBAAoB;IAC9C,QAAQ,CAAC,IAAI,iBAAiB;IAC9B,QAAQ,CAAC,OAAO,WAAW;IAC3B,QAAQ,CAAC,WAAW,gCAAgC;IACpD,QAAQ,CAAC,mBAAmB,sBAAuB;IAE7C,cAAc,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,OAAO,CAAC;IAItD,IAAI,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,UAAU,CAAC;IAS/C,MAAM,CAAC,MAAM,EAAE,YAAY,EAAE,OAAO,EAAE,cAAc,EAAE,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAIzG,eAAe,IAAI,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IAOhC,UAAU,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAC/C,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAC/B;AAED,eAAe,UAAU,CAAC"}

package/dist/__tests__/fixtures/plugins/test-plugin/index.js

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+class TestPlugin {
+    constructor() {
+        this.name = 'test-plugin';
+        this.version = '1.0.0';
+        this.description = 'Test plugin for unit tests';
+        this.supportedOperations = ['import'];
+    }
+    async testConnection(config) {
+        return true;
+    }
+    async scan(config) {
+        return {
+            sources: [],
+            totalCount: 0,
+            totalSize: 0,
+            errors: []
+        };
+    }
+    async import(config, sources, targetDir) {
+        return [];
+    }
+    getConfigSchema() {
+        return {
+            type: 'object',
+            properties: {}
+        };
+    }
+    async initialize(config) { }
+    async destroy() { }
+}
+exports.default = TestPlugin;
+//# sourceMappingURL=index.js.map

package/dist/__tests__/fixtures/plugins/test-plugin/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/__tests__/fixtures/plugins/test-plugin/index.ts"],"names":[],"mappings":";;AAEA,MAAM,UAAU;IAAhB;QACW,SAAI,GAAG,aAAa,CAAC;QACrB,YAAO,GAAG,OAAO,CAAC;QAClB,gBAAW,GAAG,4BAA4B,CAAC;QAC3C,wBAAmB,GAAG,CAAC,QAAQ,CAAU,CAAC;IA4BrD,CAAC;IA1BC,KAAK,CAAC,cAAc,CAAC,MAAoB;QACvC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,MAAoB;QAC7B,OAAO;YACL,OAAO,EAAE,EAAE;YACX,UAAU,EAAE,CAAC;YACb,SAAS,EAAE,CAAC;YACZ,MAAM,EAAE,EAAE;SACX,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,MAAoB,EAAE,OAAyB,EAAE,SAAiB;QAC7E,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,eAAe;QACb,OAAO;YACL,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE,EAAE;SACf,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,MAAoB,IAAkB,CAAC;IACxD,KAAK,CAAC,OAAO,KAAmB,CAAC;CAClC;AAED,kBAAe,UAAU,CAAC"}

package/dist/__tests__/fixtures/plugins/workflow-plugin/index.d.ts

@@ -0,0 +1,16 @@
+import { DocumentSourcePlugin, PluginConfig, ScanResult, ImportResult, ExportResult, DocumentSource, PluginImportOptions, PluginExportOptions } from '../../../../types/plugins';
+declare class WorkflowPlugin implements DocumentSourcePlugin {
+    readonly name = "workflow-plugin";
+    readonly version = "1.0.0";
+    readonly description = "Plugin for testing complete workflows";
+    readonly supportedOperations: readonly ["import", "export", "both"];
+    testConnection(config: PluginConfig): Promise<boolean>;
+    scan(config: PluginConfig, options?: PluginImportOptions): Promise<ScanResult>;
+    import(config: PluginConfig, sources: DocumentSource[], targetDir: string, options?: PluginImportOptions): Promise<ImportResult[]>;
+    export(config: PluginConfig, localSources: DocumentSource[], options?: PluginExportOptions): Promise<ExportResult[]>;
+    getConfigSchema(): Record<string, any>;
+    initialize(config: PluginConfig): Promise<void>;
+    destroy(): Promise<void>;
+}
+export default WorkflowPlugin;
+//# sourceMappingURL=index.d.ts.map

package/dist/__tests__/fixtures/plugins/workflow-plugin/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/__tests__/fixtures/plugins/workflow-plugin/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,oBAAoB,EAAE,YAAY,EAAE,UAAU,EAAE,YAAY,EAAE,YAAY,EAAE,cAAc,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAEjL,cAAM,cAAe,YAAW,oBAAoB;IAClD,QAAQ,CAAC,IAAI,qBAAqB;IAClC,QAAQ,CAAC,OAAO,WAAW;IAC3B,QAAQ,CAAC,WAAW,2CAA2C;IAC/D,QAAQ,CAAC,mBAAmB,wCAAyC;IAE/D,cAAc,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,OAAO,CAAC;IAItD,IAAI,CAAC,MAAM,EAAE,YAAY,EAAE,OAAO,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,UAAU,CAAC;IAkF9E,MAAM,CAAC,MAAM,EAAE,YAAY,EAAE,OAAO,EAAE,cAAc,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAiClI,MAAM,CAAC,MAAM,EAAE,YAAY,EAAE,YAAY,EAAE,cAAc,EAAE,EAAE,OAAO,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAS1H,eAAe,IAAI,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IAShC,UAAU,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAC/C,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAC/B;AAED,eAAe,cAAc,CAAC"}

package/dist/__tests__/fixtures/plugins/workflow-plugin/index.js

@@ -0,0 +1,145 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const fs_extra_1 = __importDefault(require("fs-extra"));
+const path_1 = __importDefault(require("path"));
+class WorkflowPlugin {
+    constructor() {
+        this.name = 'workflow-plugin';
+        this.version = '1.0.0';
+        this.description = 'Plugin for testing complete workflows';
+        this.supportedOperations = ['import', 'export', 'both'];
+    }
+    async testConnection(config) {
+        return config.valid === true;
+    }
+    async scan(config, options) {
+        const sources = [
+            {
+                id: 'workflow-doc-1',
+                name: 'invoice-001.pdf',
+                path: '/accounting/invoices/invoice-001.pdf',
+                size: 125000,
+                mimeType: 'application/pdf',
+                lastModified: new Date('2024-01-15'),
+                metadata: {
+                    department: 'accounting',
+                    category: 'invoice',
+                    fiscalYear: '2024'
+                }
+            },
+            {
+                id: 'workflow-doc-2',
+                name: 'contract-abc.docx',
+                path: '/legal/contracts/contract-abc.docx',
+                size: 85000,
+                mimeType: 'application/vnd.openxmlformats-officedocument.wordprocessingml.document',
+                lastModified: new Date('2024-02-20'),
+                metadata: {
+                    department: 'legal',
+                    category: 'contract',
+                    client: 'ABC Corp'
+                }
+            },
+            {
+                id: 'workflow-doc-3',
+                name: 'report-q1.xlsx',
+                path: '/finance/reports/report-q1.xlsx',
+                size: 450000,
+                mimeType: 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet',
+                lastModified: new Date('2024-03-31'),
+                metadata: {
+                    department: 'finance',
+                    category: 'report',
+                    quarter: 'Q1',
+                    year: '2024'
+                }
+            },
+            {
+                id: 'workflow-doc-4',
+                name: 'presentation.pptx',
+                path: '/marketing/presentations/presentation.pptx',
+                size: 3500000,
+                mimeType: 'application/vnd.openxmlformats-officedocument.presentationml.presentation',
+                lastModified: new Date('2024-04-10'),
+                metadata: {
+                    department: 'marketing',
+                    category: 'presentation',
+                    event: 'Product Launch 2024'
+                }
+            },
+            {
+                id: 'workflow-doc-5',
+                name: 'photo.jpg',
+                path: '/media/photos/photo.jpg',
+                size: 2100000,
+                mimeType: 'image/jpeg',
+                lastModified: new Date('2024-05-01'),
+                metadata: {
+                    department: 'marketing',
+                    category: 'media',
+                    resolution: '4K'
+                }
+            }
+        ];
+        // Apply limit if specified
+        const limit = options?.limit || sources.length;
+        const filteredSources = sources.slice(0, limit);
+        return {
+            sources: filteredSources,
+            totalCount: filteredSources.length,
+            totalSize: filteredSources.reduce((sum, s) => sum + s.size, 0),
+            errors: []
+        };
+    }
+    async import(config, sources, targetDir, options) {
+        const results = [];
+        for (const source of sources) {
+            try {
+                // Simulate successful download
+                const localPath = path_1.default.join(targetDir, source.path);
+                const localDir = path_1.default.dirname(localPath);
+                // Create directory structure
+                await fs_extra_1.default.ensureDir(localDir);
+                // Create mock file
+                await fs_extra_1.default.writeFile(localPath, `Mock content for ${source.name}`);
+                results.push({
+                    success: true,
+                    source,
+                    localPath,
+                    bytesTransferred: source.size
+                });
+            }
+            catch (error) {
+                results.push({
+                    success: false,
+                    source,
+                    error: error.message
+                });
+            }
+        }
+        return results;
+    }
+    async export(config, localSources, options) {
+        return localSources.map(source => ({
+            success: true,
+            targetPath: (options?.targetPath || '') + '/' + source.path,
+            source,
+            bytesTransferred: source.size
+        }));
+    }
+    getConfigSchema() {
+        return {
+            type: 'object',
+            properties: {
+                valid: { type: 'boolean', required: true }
+            }
+        };
+    }
+    async initialize(config) { }
+    async destroy() { }
+}
+exports.default = WorkflowPlugin;
+//# sourceMappingURL=index.js.map

package/dist/__tests__/fixtures/plugins/workflow-plugin/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/__tests__/fixtures/plugins/workflow-plugin/index.ts"],"names":[],"mappings":"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"}