@paroicms/converter

@paroicms/converter

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

Usage

Single Database Mode

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

This will:

• Run a dry-run pass to detect errors
• Run the actual conversion pass

Multisite Mode

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

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

• Run a dry-run pass on all databases
• If all databases pass without errors, run the actual conversion on all databases
• 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