open-index/open-npm huggingface dataset:
npm package: @paroicms/converter
Description: CLI tool to migrate field data from Quill to Tiptap format in ParoiCMS databases
Latest version: 0.3.4

# @paroicms/converter

CLI tool to migrate field data from Quill format to Tiptap format in ParoiCMS main databases (SQLite).

## Usage

### Single Database Mode

```bash
npx @paroicms/converter \
  --database /path/to/main.sqlite \
  --quill-to-tiptap
```

This will:

1. Run a dry-run pass to detect errors
2. Run the actual conversion pass

### Multisite Mode

```bash
npx @paroicms/converter \
  --multisite-data-dir /path/to/data \
  --quill-to-tiptap
```

This will process all databases matching the pattern `${dataDir}/*/main.sqlite`:

1. Run a dry-run pass on all databases
2. If all databases pass without errors, run the actual conversion on all databases
3. If any database has errors in dry-run, abort the entire process

## CLI Options

- `--database <path>` (required*): Path to the SQLite database file
- `--multisite-data-dir <path>` (required*): Path to the multisite data directory
- `--quill-to-tiptap` (required): Activate Quill to Tiptap conversion
- `--dry-run` (optional): Run in dry-run mode only (no database changes)
- `--backup` (optional): Create a backup before conversion
- `--force` (optional): Skip dry-run pass and convert immediately

*You must specify either `--database` or `--multisite-data-dir`, but not both.

## Exit Codes

- `0`: All rows converted successfully
- `1`: One or more rows failed to convert (errors will be logged)

## Error Handling

The tool will:

- Skip failed rows and continue with others
- Log all errors with field name, nodeId, and language
- Return exit code 1 if any errors occurred
- In multisite mode: abort if any database has errors during dry-run pass