@sinoia/hubdoc-tools 1.3.10 → 1.5.1

package/docs/llm-usage.md

@@ -0,0 +1,314 @@
+# `hubdoc` — LLM / Headless usage guide
+
+This guide is written for autonomous agents (Claude, Corex IA agents, CI
+scripts) that need to drive HubDoc from a shell without human assistance.
+
+The MVP-A surface (workspaces, folders, files), plus search (MVP-B) and
+the Markdown/Typst editorial pipeline (composed-documents/parts/templates,
+MVP-D), are fully non-interactive when you pass `--json` and (for
+destructive ops) `--yes`.
+
+> The `hubdoc` and `hubdoc-tool` binaries are aliases of the same program.
+> Use `hubdoc` in agent scripts — it is shorter and easier on tokens.
+
+## Contract
+
+Every LLM-friendly subcommand obeys the same rules. An agent can rely on
+these without reading the per-command documentation:
+
+| Concern                | Behavior                                                                  |
+| ---------------------- | ------------------------------------------------------------------------- |
+| Stdout in `--json` mode| One parseable JSON value (object, array, or `{ ok, message, data }`)      |
+| Stderr                 | Reserved for errors and progress notes                                    |
+| Exit code              | `0` on success, `1` on any failure                                        |
+| Error shape (`--json`) | `{ "error": "...", "code": "unauthorized\|forbidden\|not_found\|...", "details": {...} }` |
+| Destructive ops        | Refuse to run in `--json` mode unless `--yes` is passed (no prompts)      |
+| Informational notes    | Suppressed in `--json` mode so stdout stays parseable                     |
+
+Error `code` values currently emitted:
+
+- `unauthorized` (HTTP 401)
+- `forbidden` (HTTP 403)
+- `not_found` (HTTP 404)
+- `unprocessable_entity` (HTTP 422)
+- `http_<status>` for any other HTTP error
+- Node error codes (e.g. `ECONNREFUSED`) when the request never reached HubDoc
+
+## Authentication
+
+The bearer token is a Doorkeeper access token. Two ways to obtain one:
+
+- **Personal Access Token (recommended)** — long-lived, manage from
+  HubDoc UI → *Profile › Personal Access Tokens*. Create, copy the
+  one-time plaintext value, revoke from the same page. Shipped in
+  corex#416. Shortcut: `hubdoc token open` launches the page in your
+  default browser.
+- **OAuth Authorization Code flow** — the legacy interactive wizard
+  (`hubdoc-tool` without args) still works.
+
+Three places the CLI looks for the token, in priority order:
+
+```bash
+# 1) Environment variable — highest priority. Best for ephemeral / CI use.
+export HUBDOC_API_TOKEN=hubdoc_pat_xxx...
+export HUBDOC_API_URL=https://rec.hubdoc.sinoia.cloud
+
+# 2) OS keychain (Keychain.app / libsecret / Windows Credential Vault).
+#    --keychain stores via keytar (optional dep; Linux needs libsecret-1-dev).
+hubdoc token set hubdoc_pat_xxx... --keychain --api-url=https://rec.hubdoc.sinoia.cloud
+
+# 3) Plaintext config file. `token set` writes to ~/.hubdoc-config.json
+#    by default so the token is reachable from any cwd.
+hubdoc token set hubdoc_pat_xxx... --api-url=https://rec.hubdoc.sinoia.cloud
+```
+
+Resolution chain (per request): **env → keychain → config**. `hubdoc whoami`
+reports which source served the current token via the `tokenSource` field
+(`env` / `keychain` / `config`).
+
+Config file resolution: `~/.hubdoc-config.json` is read by default
+(works from any cwd). If a `<cwd>/.hubdoc-config.json` also exists, it
+overrides the global one — useful for project-specific overrides.
+
+On Linux, `keytar` requires `libsecret-1-dev` (Debian/Ubuntu) or
+`libsecret-devel` (Fedora). Headless CI containers usually lack it — that's
+fine, just use the env var path there. If keytar fails to load, the CLI
+still works for env / config tokens; only `--keychain` becomes unavailable
+(with a clear error pointing this out).
+
+### Verifying auth
+
+```bash
+hubdoc whoami --json
+# → { "email": "...", "scopes": "read write", "tokenSource": "keychain", ... }
+#   (when /api/v1/me ships, augmented with the resolved tokenSource)
+# → { "authenticated": true, "tokenSource": "env", "subject": "...", ... }
+#   (fallback: token verified by listing workspaces + JWT decode)
+```
+
+A non-zero exit + `code: "unauthorized"` means the token is bad. Always run
+`whoami` once at the start of an agent session — it's the cheapest check and
+gives you the auth identity for logs/audits.
+
+## Command reference (MVP-A)
+
+### Workspaces
+
+```bash
+hubdoc workspaces ls --json
+hubdoc workspaces show <id> --json
+hubdoc workspaces create --name="Projet X" [--description="..."] [--icon=...] [--color=...] [--metadata='{"k":"v"}'] --json
+hubdoc workspaces update <id> [--name=...] [--description=...] [--icon=...] [--color=...] [--metadata='...'] --json
+hubdoc workspaces delete <id> --yes --json
+```
+
+Note: the API field is `label`. The CLI accepts `--name` for ergonomic
+consistency with folders/files and maps it to `label` on the wire.
+
+### Folders
+
+```bash
+hubdoc folders ls [--workspace=ID] [--parent=ID] [--page=N] [--per-page=N] [--sort=...] --json
+hubdoc folders show <id> --json
+hubdoc folders create --workspace=ID --name="..." [--parent=ID] [--description=...] [--icon=...] [--color=...] --json
+hubdoc folders rename <id> --name="..." --json     # alias for: update <id> --name=
+hubdoc folders move   <id> --to=PARENT_ID --json   # alias for: update <id> --parent=
+hubdoc folders update <id> [--name=...] [--description=...] [--icon=...] [--color=...] [--parent=...] [--workspace=...] --json
+hubdoc folders delete <id> --yes --json
+```
+
+### Files (documents)
+
+```bash
+hubdoc files ls [--folder=ID] [--workspace=ID] [--limit=N] [--page=N] --json
+hubdoc files show <id> --json
+hubdoc files upload <local-path> [--folder=ID | --workspace=ID] [--name="..."] [--metadata='{...}'] [--auto-classify] [--chunked] --json
+hubdoc files download <id> [--to=PATH] --json
+hubdoc files rename <id> --name="..." --json
+hubdoc files move   <id> --to=FOLDER_ID --json
+hubdoc files update <id> [--name=...] [--description=...] [--folder=...] [--workspace=...] [--metadata='...'] --json
+hubdoc files delete <id> --yes --json
+```
+
+Upload routing: files ≥ 50 MB (or `--chunked`) go through the
+`ChunkedUploadsApi` (init session → upload chunks → complete + finalize).
+Smaller files use a single `multipart/form-data` POST.
+
+## Example agent session
+
+A worked example: find all PDFs in a workspace, download the first one,
+rename it, then move it to an "archive" folder.
+
+```bash
+# 0) Verify auth.
+hubdoc whoami --json | jq -e '.authenticated // .email' >/dev/null
+
+# 1) Pick the target workspace by name.
+WS_ID=$(hubdoc workspaces ls --json | jq -r '.[] | select(.label=="Projet X") | .id')
+
+# 2) Find PDF documents under that workspace.
+PDFS=$(hubdoc files ls --workspace="$WS_ID" --limit=200 --json \
+  | jq '[.[] | select(.name | endswith(".pdf"))]')
+COUNT=$(echo "$PDFS" | jq 'length')
+echo "Found $COUNT PDFs"
+
+# 3) Download the first one.
+DOC_ID=$(echo "$PDFS" | jq -r '.[0].id')
+hubdoc files download "$DOC_ID" --to=./out.pdf --json
+
+# 4) Rename it server-side.
+hubdoc files rename "$DOC_ID" --name="archive-$(date +%Y%m%d).pdf" --json
+
+# 5) Make sure the archive folder exists, then move the file under it.
+ARCHIVE_ID=$(hubdoc folders ls --workspace="$WS_ID" --json \
+  | jq -r '.[] | select(.name=="Archive") | .id')
+if [ -z "$ARCHIVE_ID" ]; then
+  ARCHIVE_ID=$(hubdoc folders create --workspace="$WS_ID" --name="Archive" --json \
+    | jq -r '.data.id')
+fi
+hubdoc files move "$DOC_ID" --to="$ARCHIVE_ID" --json
+```
+
+Notice the pattern an agent should follow:
+
+1. `--json` on every command so output is parseable.
+2. Use `jq -e` to fail fast (non-zero exit on jq predicate failure).
+3. Capture IDs to variables; never re-list when you already know an ID.
+4. Always pass `--yes` for any `delete` in non-interactive mode.
+
+## Error handling
+
+When a command fails with `--json`, stderr contains a JSON object and the
+process exits non-zero. A robust agent pattern:
+
+```bash
+if ! out=$(hubdoc files show "$ID" --json 2>err.json); then
+  case "$(jq -r .code < err.json)" in
+    not_found)     echo "Doc $ID does not exist, recreating…" ;;
+    unauthorized)  echo "Token expired, refreshing…"; exit 2 ;;
+    *)             echo "Unexpected error:"; cat err.json; exit 1 ;;
+  esac
+fi
+```
+
+### Composed documents (MVP-D)
+
+The Markdown/Typst editorial pipeline. A composed document is built from a
+template, has zero-or-more editable parts, and produces a PDF on `export`.
+
+```bash
+hubdoc templates ls --json                        # discover available templates
+hubdoc templates show <key> --json                # see default_parts + page_settings
+
+hubdoc composed-documents ls [--workspace=ID] [--folder=ID] [--status=STATUS] --json
+hubdoc composed-documents show <id> --json
+hubdoc composed-documents create --template=KEY --name="..." \
+    [--description=...] [--variables='{"k":"v"}'] [--workspace=ID] [--folder=ID] --json
+hubdoc composed-documents update <id> [--name=...] [--description=...] \
+    [--variables='...'] [--page-settings='...'] [--metadata='...'] --json
+hubdoc composed-documents delete <id> --yes --json
+hubdoc composed-documents export <id> --json     # compile → attaches PDF, returns file_id
+```
+
+Short alias: `hubdoc composed ...`.
+
+### Parts (MVP-D)
+
+Parts live under one composed document — every part subcommand requires
+`--composed-document=ID`.
+
+```bash
+hubdoc parts ls --composed-document=CD --json
+hubdoc parts show <id> --composed-document=CD --json
+hubdoc parts update <id> --composed-document=CD \
+    [--content="markdown..." | --content-file=part.md] \
+    [--status=...] [--title=...] [--part-type=...] [--bsize=...] [--page-break] [--alignment=...] --json
+hubdoc parts delete <id> --composed-document=CD --yes --json
+hubdoc parts reorder --composed-document=CD --order=ID1,ID2,ID3 --json
+```
+
+For long Markdown/Typst blobs, `--content-file=path.md` reads the file
+from disk — much friendlier than escaping a multi-paragraph string on
+the command line.
+
+#### End-to-end edition example
+
+```bash
+# 1) Discover what's editable.
+TPL=$(hubdoc templates ls --json | jq -r '.[] | select(.key=="invoice") | .key')
+
+# 2) Spawn a composed document from the template.
+CD=$(hubdoc composed-documents create \
+       --template="$TPL" --name="Invoice 042" \
+       --variables='{"client":"Acme","amount":1500}' \
+       --workspace="$WS" --json | jq -r '.data.id')
+
+# 3) Edit one of its parts from a local Markdown file.
+PART=$(hubdoc parts ls --composed-document="$CD" --json | jq -r '.[0].id')
+hubdoc parts update "$PART" --composed-document="$CD" --content-file=./intro.md --status=ready --json
+
+# 4) Reorder a couple of parts.
+hubdoc parts reorder --composed-document="$CD" --order="$PART_INTRO,$PART_BODY,$PART_CONCLUSION" --json
+
+# 5) Compile and grab the resulting PDF.
+FILE_ID=$(hubdoc composed-documents export "$CD" --json | jq -r '.data.file_id')
+hubdoc files download "$FILE_ID" --to=./invoice-042.pdf --json
+```
+
+### Search (MVP-B)
+
+```bash
+hubdoc search "<query>" [--entity-type=files|folders|workspaces] [--workspace=ID] [--limit=N] --json
+```
+
+Wraps the same hybrid search (FTS + semantic + RRF fusion) as the
+advanced search UI, scoped to entities the user can access. Server caps
+`--limit` at 100; default is 25.
+
+Response shape (passed through unchanged in `--json` mode):
+
+```json
+{
+  "results": [
+    {
+      "entity_type": "Documents::File",
+      "entity_id": "...",
+      "name": "facture-edf.pdf",
+      "page_number": 2,
+      "excerpt": "first 300 chars of matching content",
+      "score": 0.852,
+      "source": "text|semantic|hybrid",
+      "updated_at": "2026-05-18T15:00:00Z",
+      "workspace_id": "...",
+      "folder_id": "..."
+    }
+  ],
+  "total": 7,
+  "limit": 25
+}
+```
+
+Errors: `{"error": "q is required", "code": "http_400"}` if the query is
+empty (caught client-side too, before any HTTP call).
+
+## Out of scope (planned)
+
+- `hubdoc templates create|update|delete` — depends on corex#417 backend
+  extension (the controller is read-only today). The CLI will follow once
+  the API is in place.
+- `hubdoc permissions ...` — to be scoped if/when demand confirms.
+- JSON-API for PAT management (`hubdoc auth tokens ls/revoke`) — the
+  Corex PAT controller is Inertia/web-only today.
+- `/api/v1/me` — not yet shipped; `whoami` falls back to JWT decode.
+- `/api/v1/documents/documents/:id/blob` — not yet shipped; `files
+  download` falls back to `download_url` if the document carries one.
+
+## Output mode selection
+
+| Flag           | Stdout                       | Stderr            | Confirmation prompts |
+| -------------- | ---------------------------- | ----------------- | -------------------- |
+| (none)         | Pretty tables, color, hints  | Errors (`❌ ...`) | Yes (inquirer)       |
+| `--json`       | Single JSON value            | JSON error object | **Refused**: pass `--yes` |
+
+Mix and match safely: `--json` can sit on a single command or be promoted
+to a global default via `hubdoc --json <subcommand> ...`.

package/package.json

@@ -1,119 +1,48 @@
 {
   "name": "@sinoia/hubdoc-tools",
-  "version": "1.3.10",
+  "version": "1.5.1",
   "description": "Professional command-line tool for HubDoc document management and bulk import/export",
-  "main": "dist/index.js",
-  "types": "dist/index.d.ts",
+  "main": "cli.js",
   "bin": {
-    "hubdoc-tool": "./dist/cli.js"
+    "hubdoc": "./cli.js",
+    "hubdoc-tool": "./cli.js"
   },
   "files": [
-    "dist",
+    "cli.js",
     "README.md",
-    "LICENSE"
+    "docs/"
   ],
-  "exports": {
-    ".": {
-      "types": "./dist/index.d.ts",
-      "require": "./dist/index.js",
-      "import": "./dist/index.js"
-    },
-    "./plugins/*": {
-      "types": "./dist/plugins/*/index.d.ts",
-      "require": "./dist/plugins/*/index.js",
-      "import": "./dist/plugins/*/index.js"
-    },
-    "./api/*": {
-      "types": "./dist/api/*.d.ts",
-      "require": "./dist/api/*.js",
-      "import": "./dist/api/*.js"
-    },
-    "./package.json": "./package.json"
-  },
-  "scripts": {
-    "build": "npm run build:main && npm run build:plugins && npm run fix:aliases",
-    "fix:aliases": "node scripts/fix-aliases.js",
-    "build:main": "tsc --project tsconfig.main.json && tsc-alias -p tsconfig.main.json",
-    "build:plugins": "tsc --project tsconfig.plugins.json && tsc-alias -p tsconfig.plugins.json && npm run copy:plugin-manifests",
-    "copy:plugin-manifests": "for dir in plugins/*/; do name=$(basename \"$dir\"); [ -f \"$dir/plugin.json\" ] && mkdir -p \"dist/plugins/$name\" && cp \"$dir/plugin.json\" \"dist/plugins/$name/\" || true; done",
-    "dev": "ts-node -r tsconfig-paths/register src/cli.ts",
-    "start": "node dist/cli.js",
-    "test": "jest",
-    "test:watch": "jest --watch",
-    "test:coverage": "jest --coverage",
-    "typecheck": "tsc --noEmit",
-    "test-api": "ts-node -r tsconfig-paths/register src/test/hubdoc-api-test.ts",
-    "test-connectors": "node test-engine-integration.js",
-    "test-box": "node test-box.js",
-    "test-s3": "node test-s3.js",
-    "test-azure": "node test-azure-blob.js",
-    "test-all": "node test-all-connectors.js",
-    "pkg": "pkg dist/cli.js --targets node18-win-x64 --output build/hubdoc-tool-windows.exe",
-    "pkg:all": "pkg dist/cli.js --targets node18-win-x64,node18-macos-x64,node18-linux-x64 --out-path build/",
-    "installer:win": "npm run build && npm run pkg",
-    "package:quick": "npm run build && npm run pkg",
-    "package:full": "./scripts/build-windows-installer.sh",
-    "distribute": "npm run package:quick && echo 'Ready for distribution: build/hubdoc-tool-windows.exe'",
-    "prepare:publish": "node scripts/prepare-publish.js",
-    "restore:package": "node scripts/restore-package.js",
-    "publish:test": "npm run prepare:publish && npm publish --dry-run && npm run restore:package",
-    "lint": "echo 'No linting configured yet'",
-    "prepublishOnly": "npm run build",
-    "generate:api": "./scripts/generate-api-client.sh"
-  },
-  "publishConfig": {
-    "access": "public"
-  },
   "keywords": [
     "hubdoc",
+    "sinoia",
+    "corex",
+    "cli",
     "import",
     "export",
     "documents",
-    "bulk"
+    "bulk",
+    "llm",
+    "agent",
+    "document-management"
   ],
-  "author": "",
+  "author": "Sinoia",
   "license": "MIT",
-  "dependencies": {
-    "@aws-sdk/client-s3": "^3.0.0",
-    "@aws-sdk/lib-storage": "^3.0.0",
-    "@azure/storage-blob": "^12.0.0",
-    "@types/xml2js": "^0.4.14",
-    "axios": "^1.5.0",
-    "chalk": "^4.1.2",
-    "commander": "^11.0.0",
-    "csv-parser": "^3.0.0",
-    "csv-writer": "^1.6.0",
-    "dotenv": "^16.3.0",
-    "form-data": "^4.0.0",
-    "fs-extra": "^11.1.0",
-    "glob": "^10.3.0",
-    "googleapis": "^128.0.0",
-    "inquirer": "^9.2.0",
-    "ora": "^5.4.1",
-    "xml2js": "^0.6.2"
+  "homepage": "https://code.plugandwork.net/sinoia/hubdoc-tools#readme",
+  "repository": {
+    "type": "git",
+    "url": "https://code.plugandwork.net/sinoia/hubdoc-tools.git"
   },
-  "devDependencies": {
-    "@types/fs-extra": "^11.0.0",
-    "@types/inquirer": "^9.0.0",
-    "@types/jest": "^29.5.14",
-    "@types/node": "^20.5.0",
-    "axios-mock-adapter": "^2.1.0",
-    "jest": "^29.7.0",
-    "pkg": "^5.8.1",
-    "ts-jest": "^29.4.1",
-    "ts-node": "^10.9.0",
-    "tsc-alias": "^1.8.16",
-    "tsconfig-paths": "^4.2.0",
-    "typescript": "^5.9.2"
+  "bugs": {
+    "url": "https://code.plugandwork.net/sinoia/hubdoc-tools/-/issues"
   },
-  "pkg": {
-    "assets": [
-      "plugins/**/*",
-      "docs/**/*",
-      "config-examples/**/*"
-    ],
-    "scripts": [
-      "dist/**/*.js"
-    ]
+  "engines": {
+    "node": ">=22"
+  },
+  "optionalDependencies": {
+    "keytar": "^7.9.0"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
   }
 }

package/LICENSE

@@ -1,21 +0,0 @@
-MIT License
-
-Copyright (c) 2024 Sinoia
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.

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

@@ -1,15 +0,0 @@
-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

@@ -1 +0,0 @@
-{"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

@@ -1,37 +0,0 @@
-"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

@@ -1 +0,0 @@
-{"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

@@ -1,15 +0,0 @@
-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

@@ -1 +0,0 @@
-{"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

@@ -1,54 +0,0 @@
-"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

@@ -1 +0,0 @@
-{"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

@@ -1,15 +0,0 @@
-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

@@ -1 +0,0 @@
-{"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"}